|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.awt.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 |
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
- プラットフォーム構成で低レベル入力制御ができない場合SecurityException
- createRobot
アクセス権が許可されていない場合SecurityManager.checkPermission(java.security.Permission)
,
AWTPermission
public Robot(GraphicsDevice screen) throws AWTException
スクリーンデバイスで座標体系に影響がでるように再構成されている場合、既存の Robot オブジェクトの動作は保証されません。
screen
- Robot が動作する座標体系を示す、スクリーン GraphicsDeviceAWTException
- プラットフォーム構成で低レベル入力制御ができない場合IllegalArgumentException
- screen
がスクリーン GraphicsDevice ではない場合SecurityException
- createRobot
アクセス権が許可されない場合GraphicsDevice
,
SecurityManager.checkPermission(java.security.Permission)
,
AWTPermission
メソッドの詳細 |
public void mouseMove(int x, int y)
x
- X 位置y
- Y 位置public void mousePress(int buttons)
buttons
- ボタンマスク (InputEvent.BUTTON1/2/3_MASK
の組み合わせ)IllegalArgumentException
- ボタンマスクが有効な組み合わせではない場合public void mouseRelease(int buttons)
buttons
- ボタンマスク (InputEvent.BUTTON1/2/3_MASK
の組み合わせ)IllegalArgumentException
- ボタンマスクが有効な組み合わせではない場合public void keyPress(int keycode)
2 つ以上の物理キーが関連付けられているキーコード (たとえば、KeyEvent.VK_SHIFT
は左右両方のシフトキーを表す) は、左のキーにマップされます。
keycode
- 押す対象のキー (KeyEvent.VK_A
など)IllegalArgumentException
- keycode
が有効なキーではない場合public void keyRelease(int keycode)
2 つ以上の物理キーが関連付けられているキーコード (たとえば、KeyEvent.VK_SHIFT
は左右両方のシフトキーを表す) は、左のキーにマップされます。
keycode
- 離す対象のキー (KeyEvent.VK_A
など)IllegalArgumentException
- keycode
が有効なキーではない場合public Color getPixelColor(int x, int y)
x
- ピクセルの X 位置y
- ピクセルの Y 位置public BufferedImage createScreenCapture(Rectangle screenRect)
screenRect
- スクリーン座標で取り込む RectIllegalArgumentException
- 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)
ms
- ミリ秒単位のスリープ時間IllegalArgumentException
- ms
が 0 から 60,000 ミリ秒の範囲にない場合public void waitForIdle()
IllegalThreadStateException
- 着信側の AWT イベントがスレッドをディスパッチしている場合public String toString()
Object
内の toString
|
JavaTM 2 Platform Std. Ed. v1.3 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.