Робот (Платформа Java SE 7)

java.lang. Объект
- java.awt. Робот

```
public class Robot
extends Object
```
Этот класс используется, чтобы генерировать собственные системные входные события в целях автоматизации тестирования, саморабочих демонстрационных примеров, и других приложений, где управление мыши и клавиатуры необходимо. Основная цель Робота состоит в том, чтобы облегчить автоматизированное тестирование реализаций платформы Java.
Используя класс, чтобы генерировать входные события отличается от регистрации событий к очереди событий AWT или компонентам AWT в этом, события сгенерированы в собственной входной очереди платформы. Например, Robot.mouseMove фактически переместит курсор мыши вместо того, чтобы только генерировать события перемещения мыши.
Отметьте, что некоторые платформы требуют специальных полномочий или расширений низкоуровневого элемента управления вводом доступа. Если текущая конфигурация платформы не позволяет элемент управления вводом, AWTException будет брошен, пытаясь создать объекты Робота. Например, X-оконные системы выдадут исключение, если XTEST 2.2 стандартных расширения не будет поддерживаться (или не включаться) X серверами.
Приложения, которые используют Робот в целях кроме самотестирования, должны обработать эти состояния ошибки корректно.

С тех пор:

1.3

Сводка конструктора

Конструкторы
Конструктор и Описание
`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()` Ожидает, пока все события в настоящий момент на очереди событий не были обработаны.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Деталь конструктора
  - Робот
```
public Robot()
      throws AWTException
```
    Создает объект Робота в системе координат основного экрана.
    
    Броски:
    
    AWTException - если конфигурация платформы не позволяет низкоуровневый элемент управления вводом. Это исключение всегда выдается, когда GraphicsEnvironment.isHeadless () возвращает true
    
    SecurityException - если createRobot разрешение не предоставляют
    См. Также:
    GraphicsEnvironment.isHeadless(), SecurityManager.checkPermission(java.security.Permission), AWTPermission
  - Робот
```
public Robot(GraphicsDevice screen)
      throws AWTException
```
    Создает Робот для данного экранного устройства. Координаты, которые передают к вызовам метода Робота как mouseMove и createScreenCapture, будут интерпретироваться как являющийся в той же самой системе координат как указанный экран. Отметьте, что в зависимости от конфигурации платформы, многократные экраны могут также:
    - совместно используйте ту же самую систему координат, чтобы сформировать объединенный виртуальный экран
    - используйте различные системы координат, чтобы действовать как независимые экраны
    Этот конструктор предназначается для последнего случая.
    Если экранные устройства реконфигурированы так, что, на систему координат влияют, поведение существующих объектов Робота неопределено.
    Параметры:
    screen - Экран GraphicsDevice, указывающий на систему координат Робот, будет работать в.
    
    Броски:
    
    AWTException - если конфигурация платформы не позволяет низкоуровневый элемент управления вводом. Это исключение всегда выдается, когда GraphicsEnvironment.isHeadless () возвращает true.
    
    IllegalArgumentException - если screen не экран GraphicsDevice.
    
    SecurityException - если createRobot разрешение не предоставляют
    См. Также:
    GraphicsEnvironment.isHeadless(), GraphicsDevice, SecurityManager.checkPermission(java.security.Permission), AWTPermission
- Деталь метода
  - mouseMove
```
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 Java
    
    IllegalArgumentException - если buttons маска содержит маску для дополнительной кнопки мыши, которая не существует на мыши, и поддержка расширенных кнопок мыши enabled Java
    См. Также:
    mouseRelease(int), InputEvent.getMaskForButton(int), Toolkit.areExtraMouseButtonsEnabled(), MouseInfo.getNumberOfButtons(), MouseEvent
  - mouseRelease
```
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 Java
    
    IllegalArgumentException - если buttons маска содержит маску для дополнительной кнопки мыши, которая не существует на мыши, и поддержка расширенных кнопок мыши enabled Java
    См. Также:
    mousePress(int), InputEvent.getMaskForButton(int), Toolkit.areExtraMouseButtonsEnabled(), MouseInfo.getNumberOfButtons(), MouseEvent
  - mouseWheel
```
public void mouseWheel(int wheelAmt)
```
    Поворачивает колесико прокрутки на оборудованных колесом мышах.
    
    Параметры:
    wheelAmt - число "меток", чтобы переместить Отрицательные величины колеса мыши указывает на перемещение/далеко от пользователя, положительные значения указывают на перемещение вниз/к пользователь.
    С тех пор:
    
    1.4
  - нажатие клавиши
```
public void keyPress(int keycode)
```
    Нажимает данную клавишу. Клавиша должна быть отпущена, используя keyRelease метод.
    Коды ключа, у которых есть больше чем один физический ключ, связанный с ними (например. KeyEvent.VK_SHIFT мог означать любого левая или правая клавиша Shift), отобразится на левый ключ.
    
    Параметры:
    keycode - Ключ, чтобы нажать (например. KeyEvent.VK_A)
    
    Броски:
    
    IllegalArgumentException - если keycode не допустимый ключ
    См. Также:
    keyRelease(int), KeyEvent
  - keyRelease
```
public void keyRelease(int keycode)
```
    Отпускает данную клавишу.
    Коды ключа, у которых есть больше чем один физический ключ, связанный с ними (например. KeyEvent.VK_SHIFT мог означать любого левая или правая клавиша Shift), отобразится на левый ключ.
    
    Параметры:
    keycode - Ключ, чтобы выпустить (например. KeyEvent.VK_A)
    
    Броски:
    
    IllegalArgumentException - если keycode не допустимый ключ
    См. Также:
    keyPress(int), KeyEvent
  - getPixelColor
```
public Color getPixelColor(int x,
                  int y)
```
    Возвращает цвет пикселя в данных экранных координатах.
    
    Параметры:
    x - X позиций пикселя
    y - Y позиция пикселя
    
    Возвраты:
    Цвет пикселя
  - createScreenCapture
```
public BufferedImage createScreenCapture(Rectangle screenRect)
```
    Создает изображение, содержащее пиксели, считанные из экрана. Это изображение не включает курсор мыши.
    
    Параметры:
    screenRect - Rect, чтобы получить в экранных координатах
    
    Возвраты:
    Полученное изображение
    
    Броски:
    
    IllegalArgumentException - если screenRect ширина и высота не больше чем нуль
    
    SecurityException - если readDisplayPixels разрешение не предоставляют
    См. Также:
    SecurityManager.checkPermission(java.security.Permission), AWTPermission
  - isAutoWaitForIdle
```
public boolean isAutoWaitForIdle()
```
    Возвраты, вызывает ли этот Робот автоматически waitForIdle после генерирования события.
    
    Возвраты:
    Ли waitForIdle автоматически вызывается
  - setAutoWaitForIdle
```
public void setAutoWaitForIdle(boolean isOn)
```
    Наборы, вызывает ли этот Робот автоматически waitForIdle после генерирования события.
    
    Параметры:
    isOn - Ли waitForIdle автоматически вызывается
  - getAutoDelay
```
public int getAutoDelay()
```
    Возвращает число миллисекунд этот Робот сны после генерирования события.
  - setAutoDelay
```
public void setAutoDelay(int ms)
```
    Определяет номер миллисекунд этот Робот сны после генерирования события.
    
    Броски:
    
    IllegalArgumentException - Если ms не между 0 и 60 000 миллисекунд включительно
  - задержка
```
public void delay(int ms)
```
    Сны в течение требуемого времени. Поймать любого InterruptedExceptions, которые происходят, Thread.sleep() может использоваться вместо этого.
    
    Параметры:
    ms - время, чтобы спать в миллисекундах
    
    Броски:
    
    IllegalArgumentException - если ms не между 0 и 60 000 миллисекунд включительно
    См. Также:
    Thread.sleep(long)
  - waitForIdle
```
public void waitForIdle()
```
    Ожидает, пока все события в настоящий момент на очереди событий не были обработаны.
    
    Броски:
    
    IllegalThreadStateException - если обращено поток диспетчеризации события AWT
  - toString
```
public String toString()
```
    Возвращает строковое представление этого Робота.
    
    Переопределения:
    
    toString в классе Object
    
    Возвраты:
    строковое представление.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Робот класса

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

Робот

Робот

Деталь метода

mouseMove

щелчок мышью

mouseRelease

mouseWheel

нажатие клавиши

keyRelease

getPixelColor

createScreenCapture

isAutoWaitForIdle

setAutoWaitForIdle

getAutoDelay

setAutoDelay

задержка

waitForIdle

toString