クラスRobot

java.lang.Object
java.awt.Robot
public class Robot extends Object
このクラスを用いると、テストの自動化、自動実行のデモ、およびマウスやキーボード制御が必要なアプリケーションのために、ネイティブなシステム入力イベントを生成することができます。 Robotの主な目的は、Javaプラットフォーム実装テストを自動化することです。

クラスを使用して、AWTイベント・キューへのイベント転送またはプラットフォームのネイティブな入力キューで生成されるAWTコンポーネントとは異なる、入力イベントを生成します。 たとえばRobot.mouseMoveでは、マウスの移動イベントを生成するだけではなく、マウスのカーソルを実際に動かします。

APIのノート:
autoWaitForIdle()が有効な場合、AWT EDTでマウスおよびキー関連のメソッドをコールできません。 これは、autoWaitForIdle()が有効な場合、マウス・メソッドとキー・メソッドは暗黙的にwaitForIdle()をコールし、AWT EDTでコールされたときにIllegalThreadStateExceptionをスローするためです。 また、スクリーン・キャプチャ操作に時間がかかり、delay(long ms)によって遅延が明確に挿入されるため、EDTでこれらもコールしないでください。 つまり、できるだけこのクラスのメソッドをEDTでコールしないでください。

一部のプラットフォームでは、低レベル入力制御にアクセスするための、特別な特権または拡張機能が必要です。 現在のプラットフォーム構成では入力制御を行えない場合、Robotオブジェクトを構築しようとするとAWTExceptionがスローされます。 たとえば、XサーバーでXTEST 2.2標準拡張機能がサポートされていない、または使用できない場合、X Windowシステムは例外をスローします。

セルフ・テスト以外の目的でRobotを使用するアプリケーションでは、これらの例外条件を正常に処理する必要があります。

プラットフォームおよびデスクトップ環境では、Robotクラスのすべての機能を実装するために必要なアクセスに制限または制限が課される場合があります。 たとえば:

  • 実行中のアプリケーションによって所有されていないデスクトップまたはデスクトップ上のウィンドウの内容にアクセスできないようにします。
  • ウィンドウ装飾を非所有コンテンツとして扱う。
  • ウィンドウを操作するための特定のリクエストを無視または制限します。
  • ロボットの特定のリクエストを無視または制限すると、キーボードやマウスなどに関連する (合成)イベントが生成されます。
  • ウィンドウの内容、アプリケーション所有のコンテンツ、またはイベントの限定的な合成を実行するための特定の権限またはグローバル権限が必要です。
Robot API仕様では、これらの許可を完全な操作のために付与する必要があります。 付与されていない場合は、ここで説明するようにAPIが低下します。 関連する特定のAPIメソッドにより、より具体的な制限および要件が文書化される場合があります。 デスクトップ環境のポリシーに応じて、前述の承認は次のようになります:
  • 毎回必要
  • もしくはアプリケーション期間中、
  • または複数のユーザー・デスクトップ・セッションで永続
  • ファイングレイン権限
  • 特定のバイナリ・アプリケーション、またはバイナリ・アプリケーションのクラスに関連付けられます。
そのような承認を対話的に与える必要がある場合、承認されるまでアプリケーションの通常の動作を妨げる可能性があります。また、承認が拒否されたり不可能になったり、永続的にすることができなかったりすると、このクラスの機能が低下し、それに依存するアプリケーションの操作の一部が低下します。

導入されたバージョン:
1.3

  • フィールドのサマリー

    フィールド
    修飾子と型
    フィールド
    説明
    static final int
    DEFAULT_DELAY
    マウスglide、typeおよびclickのデフォルト遅延(ミリ秒)。
    static final int
    DEFAULT_STEP_LENGTH
    マウスglideのデフォルトのピクセル・ステップ長。

  • コンストラクタのサマリー

    コンストラクタ
    コンストラクタ
    説明
    Robot()
    プライマリ・スクリーンの座標システムでRobotオブジェクトを構築します。
    Robot(GraphicsDevice screen)
    指定されたスクリーン・デバイスにRobotを作成します。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    void
    click()
    マウスボタン1をクリックする便利な方法。
    void
    click(int buttons)
    mousePress、mouseReleaseおよびwaitForIdleをコールしてマウス・ボタンのクリックをシミュレートする簡易メソッド。
    MultiResolutionImage
    createMultiResolutionScreenCapture(Rectangle screenRect)
    スクリーンから読み取るピクセルを含むイメージを作成します。
    BufferedImage
    createScreenCapture(Rectangle screenRect)
    スクリーンから読み取るピクセルを含むイメージを作成します。
    void
    delay(int ms)
    指定時間スリープします。
    int
    getAutoDelay()
    イベント生成後、このRobotがスリープする時間をミリ秒で返します。
    Color
    getPixelColor(int x, int y)
    指定されたスクリーン座標でピクセルの色を返します。
    void
    glide(int x, int y)
    マウスを現在の位置から宛先座標まで複数のステップで移動する便利なメソッド。
    void
    glide(int srcX, int srcY, int dstX, int dstY)
    ソース座標から宛先座標まで、複数のステップでマウスを移動する便利なメソッド。
    void
    glide(int srcX, int srcY, int destX, int destY, int stepLength, int stepDelay)
    特定のstepLengthおよびstepDelayを使用して、ソース・ポイントから宛先ポイントへの複数のステップでマウスを移動する便利なメソッド。
    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
    type(char c)
    keyPressおよびkeyReleaseをコールしてcharの入力をシミュレートする簡易メソッド。
    void
    type(int keycode)
    keyPressおよびkeyReleaseをコールしてキーの入力をシミュレートする簡易メソッド。
    void
    waitForIdle()
    現在イベント・キューにあるすべてのイベントが処理されるまで待機します。
    void
    waitForIdle(int delayValue)
    waitForIdleをコールする簡易メソッドは、指定された追加のdelayValue時間をミリ秒単位で待機します。

    クラスオブジェクトで宣言されたメソッド

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    protected Object
    clone()
    このオブジェクトのコピーを作成して、返します。
    boolean
    equals(Object obj)
    このオブジェクトと他のオブジェクトが等しいかどうかを示します。
    protected void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は非推奨であり、将来のリリースで削除される可能性があります。
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    int
    hashCode()
    このオブジェクトに対するハッシュ・コード値を返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • フィールド詳細

    • DEFAULT_DELAY

      public static final int DEFAULT_DELAY
      マウスglide、typeおよびclickのデフォルト遅延(ミリ秒)。
      関連項目:

    • DEFAULT_STEP_LENGTH

      public static final int DEFAULT_STEP_LENGTH
      マウスglideのデフォルトのピクセル・ステップ長。
      関連項目:

  • コンストラクタの詳細

    • Robot

      public Robot() throws AWTException
      プライマリ・スクリーンの座標システムでRobotオブジェクトを構築します。
      スロー:
      AWTException - プラットフォーム構成で低レベルの入力制御が許可されない場合。 この例外はGraphicsEnvironment.isHeadless()がtrueを返す場合に必ずスローされる
      関連項目:

    • Robot

      public Robot(GraphicsDevice screen) throws AWTException
      指定されたスクリーン・デバイスにRobotを作成します。 mouseMove、getPixelColor、createScreenCaptureなどのRobotメソッド・コールに渡される座標は、指定された画面と同じ座標系にあると解釈されます。 プラットフォーム構成によっては、複数スクリーンで次のことが行えます。
      • 同じ座標系を共有し、仮想スクリーンを結合する
      • 異なる座標系を使用し、個々のスクリーンのように動作する

      スクリーン・デバイスで座標系に影響がでるように再構成されている場合、既存のRobotオブジェクトの動作は保証されません。

      パラメータ:
      screen - Robotが動作する座標系を示す、スクリーンGraphicsDevice。
      スロー:
      AWTException - プラットフォーム構成で低レベルの入力制御が許可されない場合。 この例外はGraphicsEnvironment.isHeadless()がtrueを返す場合に必ずスローされる。
      IllegalArgumentException - screenがスクリーンGraphicsDeviceではない場合。
      関連項目:

  • メソッドの詳細

    • mouseMove

      public void mouseMove(int x, int y)
      指定したスクリーン座標にマウス・ポインタを移動します。

      一部のプラットフォームではマウス・ポインタが視覚的に移動しない場合がありますが、後続のmousePressおよびmouseReleaseは正しいロケーションに配信できます

      パラメータ:
      x - X位置
      y - Y位置
      スロー:
      IllegalThreadStateException - AWTイベント・ディスパッチ・スレッドでコールされ、isAutoWaitForIdleがtrueを返す場合

    • mousePress

      public void mousePress(int buttons)
      1つまたは複数のマウス・ボタンを押します。 マウス・ボタンを離すにはmouseRelease(int)メソッドを使用する必要があります。
      パラメータ:
      buttons - Buttonマスク。1つ以上のマウス・ボタン・マスクの組み合わせ。

      buttonsパラメータとして有効な値の組み合わせのみの使用が許可されます。 有効な組み合わせは、InputEvent.getMaskForButton(button)メソッドによって返されたInputEvent.BUTTON1_DOWN_MASK、InputEvent.BUTTON2_DOWN_MASK、InputEvent.BUTTON3_DOWN_MASK、および値で構成されます。 有効な組み合わせは、次のようにToolkit.areExtraMouseButtonsEnabled()値によっても異なります。

      • 拡張マウス・ボタンのサポートがJavaでdisabledにされている場合は、標準ボタン・マスクInputEvent.BUTTON1_DOWN_MASK、InputEvent.BUTTON2_DOWN_MASK、InputEvent.BUTTON3_DOWN_MASKのみを使用できます。
      • 拡張マウス・ボタンのサポートがJavaでenabledにされている場合は、標準ボタン・マスクを使用でき、マウスに4つ以上のボタンがあれば、存在する拡張マウス・ボタンのマスクを使用できます。 そのようにして、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マスクに、マウス上に存在しない追加のマウス・ボタンのマスクが含まれ、拡張されたマウス・ボタンのサポートがJavaによってenabledになっている場合
      IllegalThreadStateException - AWTイベント・ディスパッチ・スレッドでコールされ、isAutoWaitForIdleがtrueを返す場合
      関連項目:

    • mouseRelease

      public void mouseRelease(int buttons)
      1つまたは複数のマウス・ボタンを離します。
      パラメータ:
      buttons - Buttonマスク。1つ以上のマウス・ボタン・マスクの組み合わせ。

      buttonsパラメータとして有効な値の組み合わせのみの使用が許可されます。 有効な組み合わせは、InputEvent.getMaskForButton(button)メソッドによって返されたInputEvent.BUTTON1_DOWN_MASK、InputEvent.BUTTON2_DOWN_MASK、InputEvent.BUTTON3_DOWN_MASK、および値で構成されます。 有効な組み合わせは、次のようにToolkit.areExtraMouseButtonsEnabled()値によっても異なります。

      • 拡張マウス・ボタンのサポートがJavaでdisabledにされている場合は、標準ボタン・マスクInputEvent.BUTTON1_DOWN_MASK、InputEvent.BUTTON2_DOWN_MASK、InputEvent.BUTTON3_DOWN_MASKのみを使用できます。
      • 拡張マウス・ボタンのサポートがJavaでenabledにされている場合は、標準ボタン・マスクを使用でき、マウスに4つ以上のボタンがあれば、存在する拡張マウス・ボタンのマスクを使用できます。 そのようにして、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マスクに、マウス上に存在しない追加のマウス・ボタンのマスクが含まれ、拡張されたマウス・ボタンのサポートがJavaによってenabledになっている場合
      IllegalThreadStateException - AWTイベント・ディスパッチ・スレッドでコールされ、isAutoWaitForIdleがtrueを返す場合
      関連項目:

    • mouseWheel

      public void mouseWheel(int wheelAmt)
      ホイール・マウスのホイール・スクロールを回転させます。
      パラメータ:
      wheelAmt - マウス・ホイールを移動する「ノッチ」の数。負の値はユーザーから見て上または離れる方向への移動を示し、正の値はユーザーから見て下または近づく方向への移動を示す。
      スロー:
      IllegalThreadStateException - AWTイベント・ディスパッチ・スレッドでコールされ、isAutoWaitForIdleがtrueを返す場合
      導入されたバージョン:
      1.4

    • keyPress

      public void keyPress(int keycode)
      指定されたキーを押します。 キーを離すにはkeyReleaseメソッドを使用する必要があります。

      複数の物理的なキーが関連付けられているキー・コード(たとえば、KeyEvent.VK_SHIFTは左または右のShiftキーを示す可能性がある)は、左のキーにマップされます。

      パラメータ:
      keycode - 押す対象のキー(KeyEvent.VK_Aなど)
      スロー:
      IllegalArgumentException - keycodeが有効なキーでない場合
      IllegalThreadStateException - AWTイベント・ディスパッチ・スレッドでコールされ、isAutoWaitForIdleがtrueを返す場合
      関連項目:

    • keyRelease

      public void keyRelease(int keycode)
      指定されたキーを離します。

      複数の物理的なキーが関連付けられているキー・コード(たとえば、KeyEvent.VK_SHIFTは左または右のShiftキーを示す可能性がある)は、左のキーにマップされます。

      パラメータ:
      keycode - 離す対象のキー(KeyEvent.VK_Aなど)
      スロー:
      IllegalArgumentException - keycodeが有効なキーでない場合
      IllegalThreadStateException - AWTイベント・ディスパッチ・スレッドでコールされ、isAutoWaitForIdleがtrueを返す場合
      関連項目:

    • getPixelColor

      public Color getPixelColor(int x, int y)
      指定されたスクリーン座標でピクセルの色を返します。

      デスクトップ環境で画面コンテンツを取得するための権限を付与する必要があり、必要な権限が付与されていない場合、SecurityExceptionがスローされるか、戻されたColorのコンテンツが未定義になります。

      APIのノート:
      AWTイベント・ディスパッチ・スレッドでこのメソッドをコールすることは避けることをお薦めします。これは、特に権限の取得が必要で、ユーザーとの対話が必要な場合に、スクリーン・キャプチャが長い操作になる可能性があるためです。
      パラメータ:
      x - ピクセルのX位置
      y - ピクセルのY位置
      戻り値:
      ピクセルの色
      スロー:
      SecurityException - デスクトップ環境によって画面へのアクセスが拒否された場合

    • createScreenCapture

      public BufferedImage createScreenCapture(Rectangle screenRect)
      スクリーンから読み取るピクセルを含むイメージを作成します。

      デスクトップ環境で画面コンテンツを取得するための権限を付与する必要があり、必要な権限が付与されていない場合、SecurityExceptionがスローされるか、または戻されたBufferedImageの内容が定義されていません。

      APIのノート:
      AWTイベント・ディスパッチ・スレッドでこのメソッドをコールすることは避けることをお薦めします。これは、特に権限の取得が必要で、ユーザーとの対話が必要な場合に、スクリーン・キャプチャが長い操作になる可能性があるためです。
      パラメータ:
      screenRect - スクリーン座標で取り込むRect
      戻り値:
      取り込んだイメージ
      スロー:
      IllegalArgumentException - screenRectの幅および高さが0以下の場合
      SecurityException - デスクトップ環境によって画面へのアクセスが拒否された場合

    • createMultiResolutionScreenCapture

      public MultiResolutionImage createMultiResolutionScreenCapture(Rectangle screenRect)
      スクリーンから読み取るピクセルを含むイメージを作成します。 このメソッドは、ユーザー領域から画面(device)領域へのスケーリング変換がある場合に使用できます。 通常、これはディスプレイが高解像度の画面であることを意味しますが、厳密には、このような変換が存在する場合を意味します。 MultiResolutionImageを返します。

      非スケール表示の場合、MultiResolutionImageには1つのイメージ・バリアントがあります:

      • ユーザーが指定したサイズのベース・イメージ。

      スケーリング変換がある高解像度表示の場合、MultiResolutionImageには2つのイメージ・バリアントがあります:

      • ユーザーが指定したサイズのベース・イメージ。 これは画面からスケーリングされます。
      • デバイス・サイズ・ピクセルによるネイティブ・デバイス解像度イメージ。

      例: 

           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 - スクリーン座標で取り込むRect
      戻り値:
      取り込んだイメージ
      スロー:
      IllegalArgumentException - screenRectの幅および高さが0以下の場合
      SecurityException - デスクトップ環境によって画面へのアクセスが拒否された場合
      導入されたバージョン:
      9

    • isAutoWaitForIdle

      public boolean isAutoWaitForIdle()
      イベントを生成したあと、このRobotがwaitForIdleを自動的に呼び出すかどうかを返します。
      戻り値:
      waitForIdleが自動で呼び出されるかどうか

    • setAutoWaitForIdle

      public void setAutoWaitForIdle(boolean isOn)
      イベントを生成したあと、このRobotがwaitForIdleを自動的に呼び出すかどうかを設定します。
      APIのノート:
      これをtrueに設定すると、AWTイベント・ディスパッチ・スレッドでマウスおよびキー制御イベントをコールできません
      パラメータ:
      isOn - waitForIdleが自動で起動されるかどうか

    • getAutoDelay

      public int getAutoDelay()
      イベント生成後、このRobotがスリープする時間をミリ秒で返します。
      戻り値:
      遅延時間(ミリ秒単位)

    • setAutoDelay

      public void setAutoDelay(int ms)
      イベント生成後、このRobotがスリープする時間をミリ秒で設定します。
      パラメータ:
      ms - 遅延時間(ミリ秒単位)
      スロー:
      IllegalArgumentException - msが0から60,000ミリ秒の範囲にない場合

    • delay

      public void delay(int ms)
      指定時間スリープします。

      起動中のスレッドが待機中に中断された場合、中断されたステータスが設定された状態でただちに戻ります。 中断ステータスがすでに設定されている場合、このメソッドは中断ステータスが設定された状態でただちに戻ります。

      APIのノート:
      AWTイベント・ディスパッチ・スレッドでこのメソッドをコールしないことをお薦めします。これは、遅延が長い操作になる可能性があるためです。
      パラメータ:
      ms - ミリ秒単位のスリープ時間
      スロー:
      IllegalArgumentException - msが0から60,000ミリ秒の間 (包含)にない場合

    • waitForIdle

      public void waitForIdle()
      現在イベント・キューにあるすべてのイベントが処理されるまで待機します。
      スロー:
      IllegalThreadStateException - AWTイベント・ディスパッチ・スレッドに対して呼び出された場合

    • toString

      public String toString()
      このRobotの文字列表現を返します。
      オーバーライド:
      toString、クラスObject
      戻り値:
      文字列表現。

    • click

      public void click(int buttons)
      mousePress、mouseReleaseおよびwaitForIdleをコールしてマウス・ボタンのクリックをシミュレートする簡易メソッド。 waitForIdleを、mousePressおよびmouseReleaseコール後のデフォルトの遅延20ミリ秒で起動します。 有効な入力の詳細は、mousePress(int)を参照してください。
      パラメータ:
      buttons - ボタン・マスク。1つ以上のマウス・ボタン・マスクの組合せ。
      スロー:
      IllegalArgumentException - buttonsマスクに余分なマウス・ボタンのマスクが含まれ、拡張マウス・ボタンのサポートがJavaによって無効になっている場合
      IllegalArgumentException - buttonsマスクに、マウスに存在しない追加のマウス・ボタンのマスクが含まれ、拡張マウス・ボタンのサポートがJavaによって有効化されている場合
      IllegalThreadStateException - AWTイベント・ディスパッチ・スレッドに対して呼び出された場合
      導入されたバージョン:
      26
      関連項目:

    • click

      public void click()
      マウスボタン1をクリックする便利な方法。
      スロー:
      IllegalThreadStateException - AWTイベント・ディスパッチ・スレッドに対して呼び出された場合
      導入されたバージョン:
      26
      関連項目:

    • waitForIdle

      public void waitForIdle(int delayValue)
      waitForIdleをコールする簡易メソッドは、指定された追加のdelayValue時間をミリ秒単位で待機します。
      パラメータ:
      delayValue - スレッド同期が完了するまで待機する追加の遅延長(ミリ秒)
      スロー:
      IllegalThreadStateException - AWTイベント・ディスパッチ・スレッドに対して呼び出された場合
      IllegalArgumentException - delayValueが0から60,000ミリ秒の間でない場合
      導入されたバージョン:
      26

    • glide

      public void glide(int x, int y)
      マウスを現在の位置から宛先座標まで複数のステップで移動する便利なメソッド。
      実装要件:
      ステップ長が2でステップ遅延が20のmouseMoveを起動します。
      パラメータ:
      x - 宛先ポイントx座標
      y - 宛先ポイントy座標
      スロー:
      IllegalThreadStateException - AWTイベント・ディスパッチ・スレッドでコールされ、isAutoWaitForIdleがtrueを返す場合
      導入されたバージョン:
      26
      関連項目:

    • glide

      public void glide(int srcX, int srcY, int dstX, int dstY)
      ソース座標から宛先座標まで、複数のステップでマウスを移動する便利なメソッド。
      実装要件:
      ステップ長が2でステップ遅延が20のmouseMoveを起動します。
      パラメータ:
      srcX - ソース・ポイントx座標
      srcY - ソース・ポイントy座標
      dstX - 宛先ポイントx座標
      dstY - 宛先ポイントy座標
      スロー:
      IllegalThreadStateException - AWTイベント・ディスパッチ・スレッドでコールされ、isAutoWaitForIdleがtrueを返す場合
      導入されたバージョン:
      26
      関連項目:

    • glide

      public void glide(int srcX, int srcY, int destX, int destY, int stepLength, int stepDelay)
      特定のstepLengthおよびstepDelayを使用して、ソース・ポイントから宛先ポイントへの複数のステップでマウスを移動する便利なメソッド。
      パラメータ:
      srcX - ソース・ポイントx座標
      srcY - ソース・ポイントy座標
      destX - 宛先ポイントx座標
      destY - 宛先ポイントy座標
      stepLength - 1ステップの優先長(ピクセル単位)
      stepDelay - ステップ間の遅延(ミリ秒)
      スロー:
      IllegalArgumentException - stepLengthがゼロより大きくない場合
      IllegalArgumentException - stepDelayが0から60,000ミリ秒の間でない場合
      IllegalThreadStateException - AWTイベント・ディスパッチ・スレッドでコールされ、isAutoWaitForIdleがtrueを返す場合
      導入されたバージョン:
      26
      関連項目:

    • type

      public void type(int keycode)
      keyPressおよびkeyReleaseをコールしてキーの入力をシミュレートする簡易メソッド。 keyPressおよびkeyReleaseコール後、20ミリ秒の遅延でwaitForIdleを呼び出します。

      複数の物理的なキーが関連付けられているキー・コード(たとえば、KeyEvent.VK_SHIFTは左または右のShiftキーを示す可能性がある)は、左のキーにマップされます。

      パラメータ:
      keycode - 入力するキー(例: KeyEvent.VK_A)
      スロー:
      IllegalArgumentException - keycodeが有効なキーでない場合
      IllegalThreadStateException - AWTイベント・ディスパッチ・スレッドに対して呼び出された場合
      導入されたバージョン:
      26
      関連項目:

    • type

      public void type(char c)
      keyPressおよびkeyReleaseをコールしてcharの入力をシミュレートする簡易メソッド。 charのExtendedKeyCodeを取得し、type(int keycode)をコールします。
      パラメータ:
      c - 入力する文字(例: 'a')
      スロー:
      IllegalArgumentException - keycodeが有効なキーでない場合
      IllegalThreadStateException - AWTイベント・ディスパッチ・スレッドに対して呼び出された場合
      導入されたバージョン:
      26
      関連項目: