Robot (Java Platform SE 8 )

java.lang.Object
- java.awt.Robot

```
public class Robot
extends Object
```
这个类是用来生成测试自动化的目的，本系统的输入事件，自动演示，和其他应用程序的鼠标和键盘的控制是必要的。机器人的主要目的是促进java平台实现自动化测试。
使用类来生成输入事件不同于发帖事件的AWT事件队列或AWT组件，事件是在平台的本地输入队列生成。例如，Robot.mouseMove会移动鼠标而不是生成鼠标移动事件。

请注意，一些平台需要特殊的权限或扩展以访问低级别的输入控制。如果当前平台配置不允许输入控件，一个AWTException将试图构建机器人对象时引发。例如，X-Window系统如果Xtest 2.2标准扩展不支持抛出异常（或不启用）由X服务器。

除了自我测试以外使用机器人的应用程序应该优雅地处理这些错误条件。

从以下版本开始：

一点三

构造方法摘要

构造方法
Constructor and Description
`Robot()` 在主屏幕坐标系中构造一个机器人对象。
`Robot(GraphicsDevice screen)` 为给定的屏幕设备创建一个机器人。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`BufferedImage`	`createScreenCapture(Rectangle screenRect)` 创建一个包含从屏幕上读取的像素的图像。
`void`	`delay(int ms)` 为指定的时间睡觉。
`int`	`getAutoDelay()` 返回这个机器人在生成一个事件后的毫秒数。
`Color`	`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`生成事件后。
`String`	`toString()` 返回此机器人的字符串表示形式。
`void`	`waitForIdle()` 等待，直到当前事件队列上的所有事件都被处理过了。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - Robot
```
public Robot()
      throws AWTException
```
    在主屏幕坐标系中构造一个机器人对象。
    
    异常
    
    AWTException如果平台配置不允许输入低电平控制。这个例外总是graphicsenvironment isheadless()返回true时抛出。
    
    SecurityException -如果 createRobot没有得到许可
    
    另请参见：
    
    GraphicsEnvironment.isHeadless()， SecurityManager.checkPermission(java.security.Permission)， AWTPermission
  - Robot
```
public Robot(GraphicsDevice screen)
      throws AWTException
```
    为给定的屏幕设备创建一个机器人。坐标传递给机器人的方法调用一样，createscreencapture MouseMove和将被视为在同一坐标系统指定的屏幕。请注意，根据平台配置多个屏幕可以：
    - 共享相同的坐标系统，形成一个组合的虚拟屏幕
    - 使用不同的坐标系统作为独立屏幕
    这个构造函数是后者。
    如果屏幕设备重新配置这样的坐标系统受到影响，现有机器人对象的行为是未定义的。
    参数
    
    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位置
  - mousePress
```
public void mousePress(int buttons)
```
    按一个或多个鼠标按钮。鼠标按钮释放应使用 mouseRelease(int)方法。
    参数
    buttons -按钮的面具；一个或多个的组合键的面具。
    它只允许使用一个有效值的组合作为buttons参数。一个有效的组合，包括InputEvent.BUTTON1_DOWN_MASK，InputEvent.BUTTON2_DOWN_MASK，由InputEvent.getMaskForButton(button)方法返回InputEvent.BUTTON3_DOWN_MASK和价值。有效组合还取决于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面膜含有额外的鼠标按钮和鼠标按钮支持扩展的面具是用java disabled
    
    IllegalArgumentException -如果 buttons面膜面膜额外的鼠标按钮不在鼠标和鼠标按钮的存在是 enabled扩展支持的java
    
    另请参见：
    
    mouseRelease(int)， InputEvent.getMaskForButton(int)， Toolkit.areExtraMouseButtonsEnabled()， MouseInfo.getNumberOfButtons()， MouseEvent
  - mouseRelease
```
public void mouseRelease(int buttons)
```
    释放一个或多个鼠标按钮。
    参数
    buttons -按钮的面具；一个或多个的组合键的面具。
    它只允许使用一个有效值的组合作为buttons参数。一个有效的组合，包括InputEvent.BUTTON1_DOWN_MASK，InputEvent.BUTTON2_DOWN_MASK，由InputEvent.getMaskForButton(button)方法返回InputEvent.BUTTON3_DOWN_MASK和价值。有效组合还取决于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面膜含有额外的鼠标按钮和鼠标按钮支持扩展的面具是用java disabled
    
    IllegalArgumentException -如果 buttons面膜面膜额外的鼠标按钮不在鼠标和鼠标按钮的存在是 enabled扩展支持的java
    
    另请参见：
    
    mousePress(int)， InputEvent.getMaskForButton(int)， Toolkit.areExtraMouseButtonsEnabled()， MouseInfo.getNumberOfButtons()， MouseEvent
  - mouseWheel
```
public void mouseWheel(int wheelAmt)
```
    在轮子上的旋转滚轮上装备的老鼠。
    
    参数
    
    wheelAmt -“缺口”移动鼠标滚轮的负值表明运动/远离用户数，正值表示运动向下/向用户。
    
    从以下版本开始：
    
    一点四
  - keyPress
```
public void keyPress(int keycode)
```
    按一个给定的键。关键要发布使用 keyRelease方法。
    有更多比与它们相关联的物理密钥代码（如KeyEvent.VK_SHIFT可能意味着无论是左或右Shift键）将Map左键。
    
    参数
    
    keycode键按下（如 KeyEvent.VK_A）
    
    异常
    
    IllegalArgumentException -如果 keycode不是有效的关键
    
    另请参见：
    
    keyRelease(int)， KeyEvent
  - keyRelease
```
public void keyRelease(int keycode)
```
    释放一个给定的键。
    有更多比与它们相关联的物理密钥代码（如KeyEvent.VK_SHIFT可能意味着无论是左或右Shift键）将Map左键。
    
    参数
    
    keycode键释放（如 KeyEvent.VK_A）
    
    异常
    
    IllegalArgumentException -如果 keycode不是有效的关键
    
    另请参见：
    
    keyPress(int)， KeyEvent
  - getPixelColor
```
public Color getPixelColor(int x,
                           int y)
```
    返回给定屏幕坐标下的像素的颜色。
    
    参数
    
    x -像素的位置
    
    y Y位置像素
    
    结果
    
    像素颜色
  - createScreenCapture
```
public BufferedImage createScreenCapture(Rectangle screenRect)
```
    创建一个包含从屏幕上读取的像素的图像。此图像不包括鼠标光标。
    
    参数
    
    screenRect直接捕捉屏幕坐标
    
    结果
    
    捕获的图像
    
    异常
    
    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和60000毫秒之间
  - delay
```
public void delay(int ms)
```
    为指定的时间睡觉。抓住任何 InterruptedExceptions发生， Thread.sleep()可以代替。
    
    参数
    
    ms -睡眠时间以毫秒为单位
    
    异常
    
    IllegalArgumentException -如果 ms不是0和60000毫秒之间
    
    另请参见：
    
    Thread.sleep(long)
  - waitForIdle
```
public void waitForIdle()
```
    等待，直到当前事件队列上的所有事件都被处理过了。
    
    异常
    
    IllegalThreadStateException如果呼吁awt事件调度线程
  - toString
```
public String toString()
```
    返回此机器人的字符串表示形式。
    
    重写：
    
    toString 方法重写，继承类 Object
    
    结果
    
    字符串表示。

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class Robot

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

Robot

Robot

方法详细信息

mouseMove

mousePress

mouseRelease

mouseWheel

keyPress

keyRelease

getPixelColor

createScreenCapture

isAutoWaitForIdle

setAutoWaitForIdle

getAutoDelay

setAutoDelay

delay

waitForIdle

toString