Класс Robot

public static final int DEFAULT_DELAY

См. также:

• Значения константных полей

public static final int DEFAULT_STEP_LENGTH

См. также:

• Значения константных полей

public Robot() throws AWTException

Выбрасывает:

AWTException — если конфигурация платформы не позволяет управлять вводом на низком уровне. Это исключение всегда выбрасывается, если GraphicsEnvironment.isHeadless() возвращает true

См. также:

• GraphicsEnvironment.isHeadless()

public Robot(GraphicsDevice screen) throws AWTException

Параметры:

screen — устройство отображения GraphicsDevice, задающее систему координат, в которой будет работать Robot.

Выбрасывает:

AWTException — если конфигурация платформы не позволяет управлять вводом на низком уровне. Это исключение всегда выбрасывается, если GraphicsEnvironment.isHeadless() возвращает true.

IllegalArgumentException — если screen не является устройством отображения GraphicsDevice.

См. также:

• GraphicsEnvironment.isHeadless()
• GraphicsDevice

public void mouseMove(int x, int y)

Параметры:

x — позиция X

y — позиция Y

Выбрасывает:

IllegalThreadStateException — если вызван в потоке диспетчеризации событий AWT и isAutoWaitForIdle вернул бы true

public void mousePress(int buttons)

Параметры:

buttons — маска кнопок; комбинация одной или нескольких масок кнопок мыши.

В качестве параметра buttons разрешено использовать только комбинацию допустимых значений. Допустимая комбинация состоит из InputEvent.BUTTON1_DOWN_MASK, InputEvent.BUTTON2_DOWN_MASK, InputEvent.BUTTON3_DOWN_MASK и значений, возвращаемых методом InputEvent.getMaskForButton(button). Допустимая комбинация также зависит от значения 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

IllegalThreadStateException — если вызван в потоке диспетчеризации событий AWT и isAutoWaitForIdle вернул бы true

См. также:

• mouseRelease(int)
• InputEvent.getMaskForButton(int)
• Toolkit.areExtraMouseButtonsEnabled()
• MouseInfo.getNumberOfButtons()
• MouseEvent

public void mouseRelease(int buttons)

Параметры:

buttons — маска кнопок; комбинация одной или нескольких масок кнопок мыши.

В качестве параметра buttons разрешено использовать только комбинацию допустимых значений. Допустимая комбинация состоит из InputEvent.BUTTON1_DOWN_MASK, InputEvent.BUTTON2_DOWN_MASK, InputEvent.BUTTON3_DOWN_MASK и значений, возвращаемых методом InputEvent.getMaskForButton(button). Допустимая комбинация также зависит от значения 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

IllegalThreadStateException — если вызван в потоке диспетчеризации событий AWT и isAutoWaitForIdle вернул бы true

См. также:

• mousePress(int)
• InputEvent.getMaskForButton(int)
• Toolkit.areExtraMouseButtonsEnabled()
• MouseInfo.getNumberOfButtons()
• MouseEvent

public void mouseWheel(int wheelAmt)

Параметры:

wheelAmt — количество «щелчков» прокрутки колеса мыши. Отрицательные значения указывают на движение вверх/от пользователя, положительные — на движение вниз/к пользователю.

Выбрасывает:

IllegalThreadStateException — если вызван в потоке диспетчеризации событий AWT и isAutoWaitForIdle вернул бы true

Начиная с:

1.4

public void keyPress(int keycode)

Параметры:

keycode — клавиша для нажатия (например, KeyEvent.VK_A)

Выбрасывает:

IllegalArgumentException — если keycode не является допустимой клавишей

IllegalThreadStateException — если вызван в потоке диспетчеризации событий AWT и isAutoWaitForIdle вернул бы true

См. также:

• keyRelease(int)
• KeyEvent

public void keyRelease(int keycode)

Параметры:

keycode — клавиша для отпускания (например, KeyEvent.VK_A)

Выбрасывает:

IllegalArgumentException — если keycode не является допустимой клавишей

IllegalThreadStateException — если вызван в потоке диспетчеризации событий AWT и isAutoWaitForIdle вернул бы true

См. также:

• keyPress(int)
• KeyEvent

public Color getPixelColor(int x, int y)

Примечание к API:

Рекомендуется не вызывать этот метод в потоке диспетчеризации событий AWT, поскольку захват экрана может занять много времени, особенно если требуется получить разрешения и это предполагает взаимодействие с пользователем.

Параметры:

x — позиция X пикселя

y — позиция Y пикселя

Возвращает:

Цвет пикселя

Выбрасывает:

SecurityException — если среда рабочего стола запрещает доступ к экрану

public BufferedImage createScreenCapture(Rectangle screenRect)

Примечание к API:

Рекомендуется не вызывать этот метод в потоке диспетчеризации событий AWT, поскольку захват экрана может занять много времени, особенно если требуется получить разрешения и это предполагает взаимодействие с пользователем.

Параметры:

screenRect — прямоугольник для захвата в экранных координатах

Возвращает:

Захваченное изображение

Выбрасывает:

IllegalArgumentException — если ширина и высота screenRect не больше нуля

SecurityException — если среда рабочего стола запрещает доступ к экрану

public MultiResolutionImage createMultiResolutionScreenCapture(Rectangle screenRect)

     Image nativeResImage;
     MultiResolutionImage mrImage = robot.createMultiResolutionScreenCapture(frame.getBounds());
     List<Image> resolutionVariants = mrImage.getResolutionVariants();
     if (resolutionVariants.size() > 1) {
         nativeResImage = resolutionVariants.get(1);
     } else {
         nativeResImage = resolutionVariants.get(0);
     }

Примечание к API:

Рекомендуется не вызывать этот метод в потоке диспетчеризации событий AWT, поскольку захват экрана может занять много времени, особенно если требуется получить разрешения и это предполагает взаимодействие с пользователем.

Параметры:

screenRect — прямоугольник для захвата в экранных координатах

Возвращает:

Захваченное изображение

Выбрасывает:

IllegalArgumentException — если ширина и высота screenRect не больше нуля

SecurityException — если среда рабочего стола запрещает доступ к экрану

Начиная с:

9

public boolean isAutoWaitForIdle()

Возвращает:

Вызывается ли автоматически waitForIdle

public void setAutoWaitForIdle(boolean isOn)

Примечание к API:

Если установить значение true, нельзя будет вызывать события управления мышью и клавиатурой в потоке диспетчеризации событий AWT

Параметры:

isOn — следует ли автоматически вызывать waitForIdle

public int getAutoDelay()

Возвращает:

длительность задержки в миллисекундах

public void setAutoDelay(int ms)

Параметры:

ms — длительность задержки в миллисекундах

Выбрасывает:

IllegalArgumentException — если ms не находится в диапазоне от 0 до 60 000 миллисекунд включительно

public void delay(int ms)

Примечание к API:

Рекомендуется не вызывать этот метод в потоке диспетчеризации событий AWT, поскольку задержка может быть продолжительной.

Параметры:

ms — время ожидания в миллисекундах

Выбрасывает:

IllegalArgumentException — если ms не находится в диапазоне от 0 до 60,000 миллисекунд включительно

public void waitForIdle()

Выбрасывает:

IllegalThreadStateException — если вызван в потоке диспетчеризации событий AWT

public String toString()

Переопределяет:

toString в классе Object

Возвращает:

строковое представление.

public void click(int buttons)

Параметры:

buttons — маска кнопок; комбинация одной или нескольких масок кнопок мыши.

Выбрасывает:

IllegalArgumentException — если маска buttons содержит маску дополнительной кнопки мыши, а поддержка дополнительных кнопок мыши отключена в Java

IllegalArgumentException — если маска buttons содержит маску дополнительной кнопки мыши, которой нет у мыши, а поддержка дополнительных кнопок мыши включена в Java

IllegalThreadStateException — если вызван в потоке диспетчеризации событий AWT

Начиная с:

26

См. также:

• DEFAULT_DELAY
• mousePress(int)
• mouseRelease(int)
• InputEvent.getMaskForButton(int)
• Toolkit.areExtraMouseButtonsEnabled()
• MouseEvent

public void click()

Выбрасывает:

IllegalThreadStateException — если вызван в потоке диспетчеризации событий AWT

Начиная с:

26

См. также:

• click(int)

public void waitForIdle(int delayValue)

Параметры:

delayValue — дополнительная длительность ожидания в миллисекундах до завершения синхронизации потоков

Выбрасывает:

IllegalThreadStateException — если вызван в потоке диспетчеризации событий AWT

IllegalArgumentException — если delayValue не находится в диапазоне от 0 до 60,000 миллисекунд включительно

Начиная с:

26

public void glide(int x, int y)

Требования к реализации:

Вызывает mouseMove с длиной шага 2 и задержкой между шагами 20.

Параметры:

x — координата X конечной точки

y — координата Y конечной точки

Выбрасывает:

IllegalThreadStateException — если вызван в потоке диспетчеризации событий AWT и isAutoWaitForIdle вернул бы true

Начиная с:

26

См. также:

• DEFAULT_STEP_LENGTH
• DEFAULT_DELAY
• glide(int, int, int, int, int, int)

public void glide(int srcX, int srcY, int dstX, int dstY)

Требования к реализации:

Вызывает mouseMove с длиной шага 2 и задержкой между шагами 20.

Параметры:

srcX — координата X исходной точки

srcY — координата Y исходной точки

dstX — координата X конечной точки

dstY — координата Y конечной точки

Выбрасывает:

IllegalThreadStateException — если вызван в потоке диспетчеризации событий AWT и isAutoWaitForIdle вернул бы true

Начиная с:

26

См. также:

• DEFAULT_STEP_LENGTH
• DEFAULT_DELAY
• glide(int, int, int, int, int, int)

public void glide(int srcX, int srcY, int destX, int destY, int stepLength, int stepDelay)

Параметры:

srcX — координата X исходной точки

srcY — координата Y исходной точки

destX — координата X конечной точки

destY — координата Y конечной точки

stepLength — предпочтительная длина одного шага в пикселях

stepDelay — задержка между шагами в миллисекундах

Выбрасывает:

IllegalArgumentException — если stepLength не больше нуля

IllegalArgumentException — если stepDelay не находится в диапазоне от 0 до 60,000 миллисекунд включительно

IllegalThreadStateException — если вызван в потоке диспетчеризации событий AWT и isAutoWaitForIdle вернул бы true

Начиная с:

26

См. также:

• mouseMove(int, int)
• delay(int)

public void type(int keycode)

Параметры:

keycode — клавиша для ввода (например, KeyEvent.VK_A)

Выбрасывает:

IllegalArgumentException — если keycode не является допустимой клавишей

IllegalThreadStateException — если вызван в потоке диспетчеризации событий AWT

Начиная с:

26

См. также:

• DEFAULT_DELAY
• keyPress(int)
• keyRelease(int)
• KeyEvent

public void type(char c)

Параметры:

c — вводимый символ (например, 'a')

Выбрасывает:

IllegalArgumentException — если keycode не является допустимой клавишей

IllegalThreadStateException — если вызван в потоке диспетчеризации событий AWT

Начиная с:

26

См. также:

• type(int)
• keyPress(int)
• keyRelease(int)
• KeyEvent