|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object java.awt.Robot
public class Robot
このクラスを用いると、テストの自動化、自動実行のデモ、およびマウスやキーボード制御が必要なアプリケーションのために、ネイティブなシステム入力イベントを生成することができます。Robot の主な目的は、Java プラットフォーム実装テストを自動化することです。
クラスを使用して、AWT イベントキューへのイベント転送またはプラットフォームのネイティブな入力キューで生成される AWT コンポーネントとは異なる、入力イベントを生成します。たとえば Robot.mouseMove
では、マウスの移動イベントを生成するだけではなく、マウスのカーソルを実際に動かします。
一部のプラットフォームでは、低レベル入力制御にアクセスするための、特別な特権または拡張機能が必要です。現在のプラットフォーム構成では入力制御を行えない場合、Robot オブジェクトを構築しようとすると AWTException
がスローされます。たとえば、X サーバーで XTEST 2.2 標準拡張機能がサポートされていない、または使用できない場合、X Window システムは例外をスローします。
セルフテスト以外の目的で Robot を使用するアプリケーションでは、これらの例外条件を正常に処理する必要があります。
コンストラクタの概要 | |
---|---|
Robot()
プライマリスクリーンの座標システムで Robot オブジェクトを構築します。 |
|
Robot(GraphicsDevice screen)
指定されたスクリーンデバイスに Robot を作成します。 |
メソッドの概要 | |
---|---|
BufferedImage |
createScreenCapture(Rectangle screenRect)
スクリーンから読み取るピクセルイメージを作成します。 |
void |
delay(int ms)
指定時間スリープします。 |
int |
getAutoDelay()
イベント生成後、この Robot がスリープする時間をミリ秒で返します。 |
Color |
getPixelColor(int x,
int y)
指定されたスクリーン座標でピクセルの色を返します。 |
boolean |
isAutoWaitForIdle()
イベント生成後、この Robot が waitForIdle を自動で起動するかどうかを返します。 |
void |
keyPress(int keycode)
指定されたキーを押します。 |
void |
keyRelease(int keycode)
指定されたキーを離します。 |
void |
mouseMove(int x,
int y)
指定したスクリーン座標にマウスポインタを移動します。 |
void |
mousePress(int buttons)
1 つまたは複数のマウスボタンを押します。 |
void |
mouseRelease(int buttons)
1 つまたは複数のマウスボタンを離します。 |
void |
mouseWheel(int wheelAmt)
ホイールマウスのホイールスクロールを回転させます。 |
void |
setAutoDelay(int ms)
イベント生成後、この Robot がスリープする時間をミリ秒で設定します。 |
void |
setAutoWaitForIdle(boolean isOn)
イベント生成後、この Robot が waitForIdle を自動で起動するかどうかを設定します。 |
String |
toString()
この Robot の文字列表現を返します。 |
void |
waitForIdle()
現在イベントキューにあるすべてのイベントが処理されるまで待機します。 |
クラス java.lang.Object から継承されたメソッド |
---|
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
スクリーンデバイスで座標系に影響がでるように再構成されている場合、既存の Robot オブジェクトの動作は保証されません。
screen
- Robot が動作する座標系を示す、
スクリーン 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
メソッドを使用する必要があります。
buttons
- Button マスク。次のフラグの 1 つまたは複数の
組み合わせ。
InputEvent.BUTTON1_MASK
InputEvent.BUTTON2_MASK
InputEvent.BUTTON3_MASK
IllegalArgumentException
- ボタンマスクが有効な組み合わせでは
ない場合mouseRelease(int)
public void mouseRelease(int buttons)
buttons
- Button マスク。次のフラグの 1 つまたは複数の
組み合わせ。
InputEvent.BUTTON1_MASK
InputEvent.BUTTON2_MASK
InputEvent.BUTTON3_MASK
IllegalArgumentException
- ボタンマスクが有効な組み合わせでは
ない場合mousePress(int)
public void mouseWheel(int wheelAmt)
wheelAmt
- マウスホイールを移動する「ノッチ」の数。
負の値はユーザーから見て上または離れる方向への移動を示し、
正の値はユーザーから見て下または近づく方向への移動を示すpublic void keyPress(int keycode)
keyRelease
メソッドを使用する必要があります。
2 つ以上の物理キーが関連付けられているキーコード (KeyEvent.VK_SHIFT
は左右両方のシフトキーを表す、など) は、左のキーにマップされます。
keycode
- 押す対象のキー (KeyEvent.VK_A
など)
IllegalArgumentException
- keycode
が
有効なキーの場合keyRelease(int)
,
KeyEvent
public void keyRelease(int keycode)
2 つ以上の物理キーが関連付けられているキーコード (KeyEvent.VK_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
の幅および高さが 0 よりも小さい場合
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
をキャッチするために、代わりに Thread.sleep()
が使用されます。
ms
- ミリ秒単位のスリープ時間
IllegalArgumentException
- ms
が 0 から 60,000 ミリ秒の範囲にない場合Thread.sleep(long)
public void waitForIdle()
IllegalThreadStateException
- 着信側の AWT イベントがスレッドをディスパッチしている場合public String toString()
Object
内の toString
|
JavaTM Platform Standard Ed. 6 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 入れ子 | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。