キーボードとクリップボードのイベント
このセクションでは、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
Returns: Text contents of the SUT clipboard.
最大待機時間を指定しない場合、RemoteClipboard 関数はSUTのクリップボードの 最後に知られている 内容を返します。
If you do not specify a maximum wait time, the RemoteClipboard function returns the last known contents of the SUT's clipboard.
例:
log remoteclipboard(5) //前の5秒間にSUTに対して実行されたイベントにより追加されたリモートクリップボードからのコンテンツを返します
例:
assert the remoteClipboard is a number //リモートクリップボードの内容が数値であることを確認します
Example:
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上で切り取ったりコピーしたりした他のテキストと同様に貼り付けることができます。
Parameters: One text string.
構文：
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パネルを使用してコマンドを作成するときは、挿入ボタンをクリックすると自動的にテキストパラメータが引用符で囲まれます。