Press (JA)

3.1.8 プレス

説明

Press - キーをデスクトップに送る。キーボードのキーを押すことに似ている。

SYNOPSIS

press [<修飾子_1>+...+<修飾子_N>+]<キー｜修飾子 [location=<standard|numpad|left|right>] [release=<true|false>] [count=<number>] [wait=<time>]

* 赤は必須パラメータ

オプション

key

-押すべきキーボードのキーの名前。ほとんどのキー名はキーボードに書かれているものに対応しています。例えば'A'、'Insert'、'Tab'などです。キーは修飾子のみで構成されることもあります。キーの大文字と小文字は区別されず、どのような文字でも指定することができる。

キー名は、java.awt.event.KeyEventクラスで宣言されているVK_キーコード定数から内部的に派生します。例えば、VK_ENTER定数があるので、キー名は "ENTER"、"Enter"、"enter "となります。キー名は実行時にJava Reflection APIを使用してKeyEventクラスから抽出されるため、T-Plan Robotを実行するJavaのバージョンによってサポートされるキーの範囲が異なる場合があります。サポートされるキー名の完全なマップは Supported Keys Window.

キーの前には、プラス「+」記号で区切られたShift、Alt、Ctrl修飾子の任意の組み合わせを付けることができます（例：「Ctrl+Alt+Delete」）。修飾名は大文字と小文字を区別しません。

修飾名は特定の物理キーに対応するものであり、それらが表す文字に対応するものではないことに注意してください。例えば、標準的な「-」マイナスキーを押すと、数字キーとは異なる内部キーコードが生成される。これらの2つのケースは、「Press -」（標準）と「Press SUBTRACT location=numpad」（numpad）という2つのPressコマンドでも表すことができる。ほとんどの場合、ターゲットシステムはこれらを同じように解釈するが、失敗する場合もある。例えば、コントロールプラス（「Press Ctrl++」）は、[Press Ctrl, Press '+', Release '+', Release Ctrl]というシーケンスとして生成される。このようなキーの組み合わせは、標準の'+'ASCII文字(0x2b)を取得するためにShiftキーも押す必要があるUSキーボードでは作成不可能であるため、このシーケンスはデスクトップによって正しく解釈されるかもしれないし、解釈されないかもしれない。キーが認識されない場合は、代わりにテンキー（「Press Ctrl+ADD location=numpad」）を使ってみてください。特定のNumpadキーのキー名を取得するには、サポートされているキーウィンドウを開き、"Press a key... "テキストフィールドにフォーカスがあるときに押してください。location=numpadパラメータを指定することをお勧めしますが、指定しなくても動作します。

このコマンドは、2.0.3以降、キー名以外にほとんどのASCII文字も受け付けます。を押す "や"@を押す "のようなコマンドを使うことができる。さらに、localion="numpad" パラメータによって、これらの文字を数字キーボードにマッピングすることもできます。例えば、テンキーの "0 "キーを押すには、"Press NUMPAD0 "を呼び出す必要がありましたが、新しいバージョンでは、より直感的な "Press 0 location=numpad "もサポートしています。これは、ADD（プラス'+'）、SUBTRACT（マイナス'-'）、MULTIPLY（アスタリスク'*'）、DIVIDE（スラッシュ'/'）、DECIMAL（ピリオド'.'）、SEPARATOR（カンマ','）などの他のテンキーにも適用されます。

転送可能なキーとキーの組み合わせは、デスクトップクライアント(プロトコル)によって適用される制限に従う。例えば、RFB (VNC)プロトコルは、Latin-1 (ISO 8859-1)文字セット以外の文字を転送できず、WinやContextMenuのようなWindowsネイティブキーのサポートは、一部の製品でのみサポートされています。逆に、ネイティブJavaクライアントは、文字セットに関係なく、ローカルのキーボードで生成できる文字だけを転送することができます。詳細は Release Notes#serversysreq や特定のクライアントのドキュメントを読んでください。

location=<standard|numpad|left|right>

-キーの位置。このオプションが意味を持つのは、一般的なキーボードに複数回存在するキーだけである。そのようなキーの例としては、数字キー '0'-'9' (標準の位置とテンキー) や修飾キー (キーボード左右の Ctrl と Alt) があります。サポートされている位置の値は、標準（デフォルト）、テンキー、左、右である。このコマンドは、[key,location]ペアが意味を持つかどうかを検証しないことに注意。例えば、アルファベット文字はほとんどのキーボードに一度だけ存在し、論理的に有効な位置はデフォルトの標準のものだけである。しかし、ほとんどのクライアントは、locationをヒントとしてのみ使用し、適用できないキーでは無視する。

release=<true|false>

-2.3.4からサポート。このパラメータがある場合、コマンドは完全なプレリリースシーケンスの代わりに、キープレス(release=false)またはキーリリース(release=true)だけを実行します。これにより、長いキー押下や、押下とマウスの複合イベントを自動化することができます。このパラメータを使って押下をシミュレートする場合は、キーが不要になったときに適切にキーをリリースするようにしてください。

count=<数値>

-キーを何回送るか。デフォルト値は1。複数の押下アクション間の遅延は、Press Command ユーザー設定の値によって定義される。

wait=<時間>

-イベント送信後の待機時間。このパラメータは、押されたキー/キーにサーバーが反応するまでに時間が必要な場合に便利です。これは、以下のコマンドが'Wait %26lt;time'.値はミリ秒か有効な値でなければならない。Time Values.デフォルト値は0（待機しない）である。スクリプトは、"Var _PRESS_WAIT=1s "のように、_PRESS_WAIT変数に希望する遅延時間を代入することで、デフォルト値を設定することができる。

RETURNS
コマンドは成功すると0（ゼロ）を返し、失敗すると1を返す。

例
Press Ctrl+Alt+Del

- デスクトップで Ctrl+Alt+Del キーを押す。

Press Tab count=5 wait=2s

- Tabキーを5回押し、2秒間待ってから次のコマンドに進む。

Press Ctrl location=right

- 右のCtrlキーを押す。

Var KEY_TO_PRESS=Alt+F4
<...>
Waitfor update area=x:340,y:220,w:240,h:160 extent=80% timeout=10s ontimeout="Var KEY_TO_PRESS=Right"
Press {KEY_TO_PRESS} wait=2s

- この例は、不要なポップアップ・ウィンドウを解決する方法を示している。与えられた座標にウィンドウがポップアップしたら、'KEY_TO_PRESS}を押す''コマンドはAlt+F4を使って確実に閉じます。ウィンドウが表示されない場合、Altキーが押されますが、通常ウィンドウに害はありません。