キーボードとクリップボードのイベント
このセクションでは、SUTのキーボードとクリップボードに対して作用するEggplant Functionalのコマンドと関数について説明します。
KeyDown コマンド
動作： 指定されたキーを押し続け、KeyUp コマンドで解放されるまで続きます。
パラメータ： キーボード文字（引用符で囲む）; TypeTextキーワード（引用符なし）。
構文：
KeyDown keysToPress
例：
KeyDown ControlKey, CommandKey, "d"
例：
// ファイルエクスプローラーやFinderで複数のアイテムを選択し、それらをコピーするためのこのようなコードを使用します
Click "FirstEntry" // 画像 "FirstEntry" のホットスポットをクリック
KeyDown ControlKey // コントロールキーを押し続けます
Click "LastEntry" // 画像 "LastEntry" のホットスポットをクリック
KeyUp ControlKey // コントロールキーを解放します
RightClick // 直前のマウスイベントと同じ場所で右クリックします
Click "CopyMenuItem"
関連： KeyUp コマンド
KeyUp コマンド
動作： KeyDown コマンドで押し続けられていたキーを解放します。
パラメータ： キーボード文字（引用符で囲む）; TypeTextキーワード（引用符なし）。
構文：
KeyUp keysToRelease
例：
KeyUp ControlKey, CommandKey, "d"
例：
KeyUp AllModifierKeys
例：
// ファイルエクスプローラーやFinderでアイテムのセクションを選択し、それらをコピーするためのこのようなコードを使用します
Click "FirstEntry" // 画像 "FirstEntry" のホットスポットをクリック
KeyDown ShiftKey // シフトキーを押し続けます
Click "LastEntry" // 画像 "LastEntry" のホットスポットをクリック
KeyUp ShiftKey // シフトキーを解放します
RightClick // 直前のマウスイベントと同じ場所で右クリックします
Click "CopyMenuItem"
AllKeys、AllModifierKeys、AllNonModifierKeysというキーワードを使うと、それぞれのグループのすべてのキーを解放することができます。
関連： KeyDown コマンド
RemoteClipboard 関数
このコマンドはSauce Labsではサポートされていません。
動作： SUTのクリップボードの現在のテキスト内容を返します。クリップボードが現在のVNC接続中に使用された場合のみ、戻り値は有効です。
パラメータ： オプションの最大待機時間。
構文：
remoteClipboard( {maxWaitTime} )
the remoteClipboard
戻り値： SUTクリップボードのテキスト内容。
最大待機時間を指定しない場合、RemoteClipboard 関数はSUTのクリップボードの 最後に知られている 内容を返します。
RemoteClipboard 関数に最大待機時間を含めると、関数はSUTでの 最後の操作 の結果として追加されたクリップボードの内容を返します。指定した時間パラメータ内に新しいクリップボードの内容が検出されない場合、エラーが発生します。
例：
log remoteclipboard(5) //前の5秒間にSUTに対して実行されたイベントにより追加されたリモートクリップボードからのコンテンツを返します
例：
assert the remoteClipboard is a number //リモートクリップボードの内容が数値であることを確認します
例：
DoubleClick "ConfirmationNumber" //フィールドをダブルクリックして内容を選択します
TypeText controlKey, "c" //SUTでコピー操作を行うためのキー ストロークを送信します
put remoteClipboard() into ConfNum //SUTのリモートクリップボードの内容を変数ConfNumに格納します
if ConfNum is not "8091283" then logWarning "数字が一致しません。" //ConfNumの値が予想値と一致するかどうかを検証し、一致しない場合は警告をログに記録します
SetRemoteClipboard コマンド
このコマンドはSauce Labsではサポートされていません。
動作： 与えられたテキストをSUTのクリップボードに入れます。ここから、SUT上で切り取ったりコピーしたりした他のテキストと同様に貼り付けることができます。
パラメータ： 一つのテキスト文字列。
構文：
SetRemoteClipboard text
例：
setremoteClipboard the time //現在のシステム時間をSUTのクリップボードに送信します
Click "TimeField"
TypeText ControlKey,"v" //SUTに貼り付け操作を行うキーストロークを送信します
例：
params HouseNumber //スクリプトをパラメータ化します。例のパラメータ値："2799"
setremoteclipboard HouseNumber //スクリプトに渡された値を使ってリモートクリップボードを設定します
//このようなコードは、モバイルでペーストメニューを表示することができます
Press "AddressField" //AddressField画像のホットスポット位置を押します
wait 2
Release //押下を解除します
tap "PasteDialog"
TypeHiddenText コマンド
動作： キーストロークをSUTに送信しますが、そのテキストはEggplant Functionalのログには表示されません。
パラメータ： クオーテーションマークで囲まれたテキスト文字列。VaultValueコマンドと一緒に使用することができます。
構文：
TypeHiddenText [text | keyword]
例：
TypeHiddenText "Bravely bold Sir Robin"
例：
TypeHiddenText GetVaultValue("myVaultID")
関連：
TypeText コマンド
動作： キーストロークをSUTに送信します。修飾キーが送信されると、コマンド全体が実行されたときに解放されます。自動的に解放されない修飾キーを送信するには、「up」および「down」修飾キーワード（ShiftUpやShiftDownなど）を使用します。自動的に解放されない任意のキーを送信するには、KeyDownとKeyUpコマンドを使用します。
パラメータ： クオーテーションマークで囲まれたテキスト文字列、非文字キーのキーワード、および二重角括弧（<< >>）で囲まれたテキストリテラル。これらのキーワードの完全なリストについては、TypeText キーワードを参照してください。
構文：
TypeText [text | keyword]
例：
Typetext<<Dear diary,
>>& the date
//文字列を入力し、次にリターンを入力し、最後にdate関数によって返された日付をSUTに入力します
例：
params Message
//何かを行う
typetext Message //変数 "Message"に格納されている値を入力します
例：
put {first:"Bob", last:"Walker", age:42} into Customer
TypeText Customer.age //SUTに42を入力します
例：
TypeText WindowsKey, "r" //Windows Runダイアログボックスを開くための必要なキーストロークをSUTに送信します
例：
TypeText AltKey,F4 //デスクトップのアプリを閉じるための必要なキーストロークをSUTに送信します
TypeTextパネルを使用してコマンドを作成するときは、挿入ボタンをクリックすると自動的にテキストパラメータが引用符で囲まれます。