Spec-Zone .ru
спецификации, руководства, описания, API
|
public class Robot extends Object
Используя class, чтобы генерировать входные события отличается от регистрации событий к очереди событий AWT или компонентам AWT в этом, события сгенерированы в собственной входной очереди платформы. Например, Robot.mouseMove
фактически переместит курсор мыши вместо того, чтобы только генерировать события перемещения мыши.
Отметьте, что некоторые платформы требуют специальных полномочий или расширений низкоуровневого элемента управления вводом доступа. Если текущая конфигурация платформы не позволяет элемент управления вводом, AWTException
будет брошен, пытаясь создать объекты Робота. Например, X-оконные системы выдадут исключение, если XTEST 2.2 стандартных расширения не будет поддерживаться (или не включаться) X серверами.
Приложения, которые используют Робот в целях кроме самотестирования, должны обработать эти состояния ошибки корректно.
Конструктор и Описание |
---|
Robot()
Создает объект Робота в системе координат основного экрана.
|
Robot(GraphicsDevice screen)
Создает Робот для данного экранного устройства.
|
Модификатор и Тип | Метод и Описание |
---|---|
BufferedImage |
createScreenCapture(Rectangle screenRect)
Создает изображение, содержащее пиксели, считанные из экрана.
|
void |
delay(int ms)
Сны в течение требуемого времени.
|
int |
getAutoDelay()
Возвращает число миллисекунд этот Робот сны после генерирования события.
|
Цвет |
getPixelColor(int x, int y)
Возвращает цвет пикселя в данных экранных координатах.
|
boolean |
isAutoWaitForIdle()
Возвраты, вызывает ли этот Робот автоматически
waitForIdle после генерирования события. |
void |
keyPress(int keycode)
Нажимает данную клавишу.
|
void |
keyRelease(int keycode)
Отпускает данную клавишу.
|
void |
mouseMove(int x, int y)
Указатель мыши перемещений на данные экранные координаты.
|
void |
mousePress(int buttons)
Нажатия одна или более кнопок мыши.
|
void |
mouseRelease(int buttons)
Выпуски одна или более кнопок мыши.
|
void |
mouseWheel(int wheelAmt)
Поворачивает колесико прокрутки на оборудованных колесом мышах.
|
void |
setAutoDelay(int ms)
Определяет номер миллисекунд этот Робот сны после генерирования события.
|
void |
setAutoWaitForIdle(boolean isOn)
Наборы, вызывает ли этот Робот автоматически
waitForIdle после генерирования события. |
Строка |
toString()
Возвращает строковое представление этого Робота.
|
void |
waitForIdle()
Ожидает, пока все события в настоящий момент на очереди событий не были обработаны.
|
public Robot() throws AWTException
AWTException
- если конфигурация платформы не позволяет низкоуровневый элемент управления вводом. Это исключение всегда выдается, когда GraphicsEnvironment.isHeadless () возвращает trueSecurityException
- если createRobot
разрешение не предоставляютGraphicsEnvironment.isHeadless()
, SecurityManager.checkPermission(java.security.Permission)
, AWTPermission
public Robot(GraphicsDevice screen) throws AWTException
Если экранные устройства реконфигурированы так, что, на систему координат влияют, поведение существующих объектов Робота неопределено.
screen
- Экран GraphicsDevice, указывающий на систему координат Робот, будет работать в.AWTException
- если конфигурация платформы не позволяет низкоуровневый элемент управления вводом. Это исключение всегда выдается, когда GraphicsEnvironment.isHeadless () возвращает true.IllegalArgumentException
- если screen
не экран GraphicsDevice.SecurityException
- если createRobot
разрешение не предоставляютGraphicsEnvironment.isHeadless()
, GraphicsDevice
, SecurityManager.checkPermission(java.security.Permission)
, AWTPermission
public void mouseMove(int x, int y)
x
- X позицийy
- Y позицияpublic void mousePress(int buttons)
mouseRelease(int)
метод.buttons
- маска Кнопки; комбинация одной или более масок кнопки мыши. Позволяется использовать только комбинацию допустимых значений как a buttons
параметр. Допустимая комбинация состоит из InputEvent.BUTTON1_DOWN_MASK
, InputEvent.BUTTON2_DOWN_MASK
, InputEvent.BUTTON3_DOWN_MASK
и значения, возвращенные InputEvent.getMaskForButton(button)
метод. Допустимая комбинация также зависит от a Toolkit.areExtraMouseButtonsEnabled()
значение следующим образом:
disabled
Java тогда позволяется использовать только следующие маски стандартной кнопки: InputEvent.BUTTON1_DOWN_MASK
, InputEvent.BUTTON2_DOWN_MASK
, InputEvent.BUTTON3_DOWN_MASK
. enabled
Java тогда позволяется использовать маски стандартной кнопки и маски для существующих расширенных кнопок мыши, если у мыши есть более тогда три кнопки. Таким образом позволяется использовать маски кнопки, соответствующие кнопкам в диапазоне от 1 до MouseInfo.getNumberOfButtons()
. InputEvent.getMaskForButton(button)
метод, чтобы получить маску для любой кнопки мыши ее числом. Следующие маски стандартной кнопки также принимаются:
InputEvent.BUTTON1_MASK
InputEvent.BUTTON2_MASK
InputEvent.BUTTON3_MASK
InputEvent.BUTTON1_DOWN_MASK
, InputEvent.BUTTON2_DOWN_MASK
, InputEvent.BUTTON3_DOWN_MASK
вместо этого. Любой расширялся _DOWN_MASK
или старый _MASK
значения должны использоваться, но обе тех модели не должны быть смешаны.IllegalArgumentException
- если buttons
маска содержит маску для дополнительной кнопки мыши, и поддержка расширенных кнопок мыши disabled
JavaIllegalArgumentException
- если buttons
маска содержит маску для дополнительной кнопки мыши, которая не существует на мыши, и поддержка расширенных кнопок мыши enabled
JavamouseRelease(int)
, InputEvent.getMaskForButton(int)
, Toolkit.areExtraMouseButtonsEnabled()
, MouseInfo.getNumberOfButtons()
, MouseEvent
public void mouseRelease(int buttons)
buttons
- маска Кнопки; комбинация одной или более масок кнопки мыши. Позволяется использовать только комбинацию допустимых значений как a buttons
параметр. Допустимая комбинация состоит из InputEvent.BUTTON1_DOWN_MASK
, InputEvent.BUTTON2_DOWN_MASK
, InputEvent.BUTTON3_DOWN_MASK
и значения, возвращенные InputEvent.getMaskForButton(button)
метод. Допустимая комбинация также зависит от a Toolkit.areExtraMouseButtonsEnabled()
значение следующим образом:
disabled
Java тогда позволяется использовать только следующие маски стандартной кнопки: InputEvent.BUTTON1_DOWN_MASK
, InputEvent.BUTTON2_DOWN_MASK
, InputEvent.BUTTON3_DOWN_MASK
. enabled
Java тогда позволяется использовать маски стандартной кнопки и маски для существующих расширенных кнопок мыши, если у мыши есть более тогда три кнопки. Таким образом позволяется использовать маски кнопки, соответствующие кнопкам в диапазоне от 1 до MouseInfo.getNumberOfButtons()
. InputEvent.getMaskForButton(button)
метод, чтобы получить маску для любой кнопки мыши ее числом. Следующие маски стандартной кнопки также принимаются:
InputEvent.BUTTON1_MASK
InputEvent.BUTTON2_MASK
InputEvent.BUTTON3_MASK
InputEvent.BUTTON1_DOWN_MASK
, InputEvent.BUTTON2_DOWN_MASK
, InputEvent.BUTTON3_DOWN_MASK
вместо этого. Любой расширялся _DOWN_MASK
или старый _MASK
значения должны использоваться, но обе тех модели не должны быть смешаны.IllegalArgumentException
- если buttons
маска содержит маску для дополнительной кнопки мыши, и поддержка расширенных кнопок мыши disabled
JavaIllegalArgumentException
- если buttons
маска содержит маску для дополнительной кнопки мыши, которая не существует на мыши, и поддержка расширенных кнопок мыши enabled
JavamousePress(int)
, InputEvent.getMaskForButton(int)
, Toolkit.areExtraMouseButtonsEnabled()
, MouseInfo.getNumberOfButtons()
, MouseEvent
public void mouseWheel(int wheelAmt)
wheelAmt
- число "меток", чтобы переместить Отрицательные величины колеса мыши указывает на перемещение/далеко от пользователя, положительные значения указывают на перемещение вниз/к пользователь.public void keyPress(int keycode)
keyRelease
метод. Коды клавиши, у которых есть больше чем один физический ключ, связанный с ними (например. KeyEvent.VK_SHIFT
мог означать любого левая или правая клавиша Shift), отобразится на левый ключ.
keycode
- Ключ, чтобы нажать (например. KeyEvent.VK_A
)IllegalArgumentException
- если keycode
не допустимый ключkeyRelease(int)
, KeyEvent
public void keyRelease(int keycode)
Коды клавиши, у которых есть больше чем один физический ключ, связанный с ними (например. KeyEvent.VK_SHIFT
мог означать любого левая или правая клавиша Shift), отобразится на левый ключ.
keycode
- Ключ, чтобы выпустить (например. KeyEvent.VK_A
)IllegalArgumentException
- если keycode
не допустимый ключkeyPress(int)
, KeyEvent
public Color getPixelColor(int x, int y)
x
- X позиций пикселяy
- Y позиция пикселяpublic BufferedImage createScreenCapture(Rectangle screenRect)
screenRect
- Rect, чтобы получить в экранных координатахIllegalArgumentException
- если screenRect
width и height не больше чем нульSecurityException
- если readDisplayPixels
разрешение не предоставляютSecurityManager.checkPermission(java.security.Permission)
, AWTPermission
public boolean isAutoWaitForIdle()
waitForIdle
после генерирования события.waitForIdle
автоматически вызываетсяpublic void setAutoWaitForIdle(boolean isOn)
waitForIdle
после генерирования события.isOn
- Ли waitForIdle
автоматически вызываетсяpublic int getAutoDelay()
public void setAutoDelay(int ms)
IllegalArgumentException
- Если ms
не между 0 и 60 000 миллисекунд включительноpublic void delay(int ms)
InterruptedException
s, которые происходят, Thread.sleep()
может использоваться вместо этого.ms
- время, чтобы спать в миллисекундахIllegalArgumentException
- если ms
не между 0 и 60 000 миллисекунд включительноThread.sleep(long)
public void waitForIdle()
IllegalThreadStateException
- если обращено поток диспетчеризации события AWT
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92