Windowsの基本操作

基本的なウィンドウ操作用のAutomationツールモジュールは、ウィンドウ、ダイアログ、コンテキストメニューを操縦し、スクリーンショットを撮り、クリップボード操作を実行することができます。

TBox Take Screenshot

このモジュールは、現在アクティブな画面のスクリーンショットを撮影します。このモジュールを使用するときに指定できる値は以下のとおりです。

値	説明
環境	デスクトップ、モバイルデバイス、またはブラウザのスクリーンショットを撮るかどうかを定義します。値を空のままにすると、Tosca Cloudはデスクトップのスクリーンショットを撮影します。
Storage Location Type	スクリーンショットをローカルディレクトリに保存するかどうかを任意で指定します。
ディレクトリ	スクリーンショットを保存するローカルパスを任意で指定します。
Filename	スクリーンショットのファイル名。この名前にファイル拡張子は含まれません。
Select Screen	オプションで、キャプチャする画面またはアプリケーションを指定します。以下のオプションから選択できます。：アクティブモニター：現在アクティブなアプリケーションがある画面をキャプチャします。アクティブウィンドウ：現在アクティブなアプリケーションウィンドウをキャプチャします。すべて：現在接続されているすべての画面をキャプチャします。整数<n>：インデックスで識別される特定の画面をキャプチャします。例えば、お使いのマシンに接続されたセカンドスクリーンをキャプチャするには、「2」と入力します。値を指定しない場合、Tosca Cloudは、接続されているすべての画面のスクリーンショットを撮影します。

TBox Clipboard

このモジュールを使用すると、Microsoft Windowsのクリップボードにテキストをコピーできます。クリップボード内のテキストを確認する、そのテキストをバッファに保存する、あるいはテキストがクリップボードに入るのを待つなどの操作にも使用できます。このモジュールを使用するときに指定できる値は以下のとおりです。

値	説明
Value	クリップボードにコピーする、確認する、バッファする、または待つ対象の値。望みのアクションに応じて、それぞれアクションモードの「入力、「確認する」、「バッファ」、または「WaitOn」を使用します。

値

説明

Value

クリップボードにコピーする、確認する、バッファする、または待つ対象の値。

望みのアクションに応じて、それぞれアクションモードの「入力、「確認する」、「バッファ」、または「WaitOn」を使用します。

TBox Dialog

このモジュールはダイアログウィンドウを操縦します。注：Microsoft Windowsのダイアログは、スキャンせずに操縦することができます。カスタマイズされたダイアログを操縦するには、まずそのダイアログをスキャンする必要があります。このモジュールを使用するときに指定できる値は以下のとおりです。

値	説明
キャプション	ステアリングしたいダイアログウィンドウのキャプション。このキャプションはダイアログウィンドウを示します。
Label	詳細識別のために、ダイアログウィンドウの最初の段落のテキストを任意で入力することもできます。全文を入力する必要はありません。
Button	Tosca Cloudがダイアログを確定するためにどのボタンをクリックすべきかを指定します。ボタンのテキストを入力します。

TBox Context Menu

このモジュールは、.NET、WinForms、Microsoft UI Automationフレームワークに基づいて、アプリケーションのコンテキストメニューを制御します。

注：操縦するコンテキストメニューは、Tosca Cloudが検出できるように開いている必要があります。

このモジュールを使用するときに指定できる値は以下のとおりです。

値	説明
メニュー	メニュー項目へのパス。->を使用してコンテキストメニューのパスを指定します。例：「挿入」->「画像」
Menu-><menuitem/>	または、代わりに制御階層でコンテキストメニューを操縦するためにこの値を使用することもできます。

TBox Send Keys

このモジュールは、WinFormsの関数SendKeysを使用し、ウィンドウにキーボードコマンドを送信します。

キーボードコマンドで動的な表現を使用するには、データタイプ「文字列」を選択してください。

このモジュールを使用するときに指定できる値は以下のとおりです。

値	説明
キャプション	操縦するウィンドウに割り当てられたキャプションを任意で入力します。Tosca Cloudは、ウィンドウを最前面に表示します。先頭と末尾のいずれかのワイルドカードを追加できます。例：文字列の先頭または末尾のワイルドカード。
Keys	ウィンドウに送信するキーボードコマンド。デフォルトのデータタイプはRawStringです。Tosca Cloudは、テスト中のシステムに入力されたとおりのRawStringデータを送信します。特殊文字をエスケープする必要はありません。 Tosca Cloudは、WinForms関数であるSendKeysを使用します。利用可能なSendKeysコマンドとその構文のリストについては、Microsoft SendKeysのドキュメント（新しいタブで開きます）をご覧ください。マシンでCAPS LOCKを有効にすると、Tosca Cloudは、キーを逆にして送信します。例えば、「Abc」の送信時にCAPS LOCKが有効になっていると、Tosca Cloudは、「aBC」を送信します。

値

説明

キャプション

操縦するウィンドウに割り当てられたキャプションを任意で入力します。Tosca Cloudは、ウィンドウを最前面に表示します。

先頭と末尾のいずれかのワイルドカードを追加できます。例：文字列の先頭または末尾のワイルドカード。

Keys

ウィンドウに送信するキーボードコマンド。

デフォルトのデータタイプはRawStringです。Tosca Cloudは、テスト中のシステムに入力されたとおりのRawStringデータを送信します。特殊文字をエスケープする必要はありません。

Tosca Cloudは、WinForms関数であるSendKeysを使用します。利用可能なSendKeysコマンドとその構文のリストについては、Microsoft SendKeysのドキュメント（新しいタブで開きます）をご覧ください。

マシンでCAPS LOCKを有効にすると、Tosca Cloudは、キーを逆にして送信します。例えば、「Abc」の送信時にCAPS LOCKが有効になっていると、Tosca Cloudは、「aBC」を送信します。

TBox Window Operation

このモジュールは、ウィンドウに特定のコマンドを送信します。このモジュールを使用するときに指定できる値は以下のとおりです。

値	説明
Caption	操縦するウィンドウのキャプション。このキャプションはウィンドウを識別します。
Child Window Caption	操縦する子ウィンドウのキャプション。このキャプションは子ウィンドウを識別します。
Operation	コントロールをステアリングするコマンド。下のテーブルに記載されている操作から選択できます。
Operation->Height	ウィンドウの必要な高さ（ピクセル単位）。「リサイズ」操作を選択した場合は必須です。
Operation->Width	ウィンドウの必要な幅（ピクセル単位）。「リサイズ」操作を選択した場合は必須です。
Window Index	Tosca Cloudが、指定されたOperationを適用するウィンドウ。これは任意ですが、指定した「キャプション」が複数のウィンドウに適用される場合に便利です。例：ワイルドカードを使用する場合。

Tosca Cloudは、以下の操作をサポートしています。

Operation	説明
Bring to Front	Tosca Cloudに対し、ウィンドウを前面に表示するように指示します。ウィンドウのUIの複雑さやマシンのパフォーマンスによっては、ウィンドウを前面に表示するのに時間がかかる場合があります。この操作の後にテストステップを追加して、Tosca Cloudがウィンドウにコントロールが表示されるのを待ってから、次のテストステップを実行するようにします。
Close	ウィンドウを閉じます。
最大化	ウィンドウを最大化します。
最小化	ウィンドウを最小化します。
センターへ移動	ウィンドウを画面の中央に移動します。
Normal	ウィンドウを元のサイズに戻します。
Resize	「高さ」と「幅」のフィールドで指定した高さと幅にウィンドウのサイズを変更します。
Try Bring To Front	ウィンドウを前面に表示することに失敗した場合は、次のテストステップに進みます。Automationは続行され、Tosca Cloudは、テストステップ「Try Bring To Front」を失敗として表示します。
Verify Window Exists	指定したウィンドウが開いているかどうかを確認します。
Close	指定したウィンドウが閉じているかどうかを確認します。
Wait On Close	この操作にはアクションモード「WaitOn」が必要です。この操作を値「Window Index」と組み合わせると、Tosca Cloudは、指定されたキャプションを持つ開かれているウィンドウの数が「Window Index」の値よりも少なくなるまで待ちます。
Wait On Open	この操作にはアクションモード「WaitOn」が必要です。この操作を値「Window Index」と組み合わせると、Tosca Cloudは、指定されたキャプションを持つ開かれているウィンドウの数が「Window Index」の値と等しいか、それ以上になるまで待ちます。

TBox Scroll Window Operation

このモジュールは、スクロール動作を定義します。このモジュールを使用するときに指定できる値は以下のとおりです。

値	説明
Caption	Tosca Cloudがスクロールするアプリケーションウィンドウのキャプション。このキャプションはアプリケーションウィンドウを識別します。
Window Index	Tosca Cloudが、開く順番に基づいてスクロールするウィンドウを指定します。この値は任意ですが、指定したキャプションが複数のウィンドウに適用される場合に便利です。例：ワイルドカードを使用する場合。
Vertical	Tosca Cloudが垂直軸に沿ってどこまでスクロールするかを、ピクセル単位（px）またはライン単位（lines）で指定します。測定単位なしで数値を指定すると、マウスホイールのノッチ数の分だけページがスクロールします。
Horizontal	Tosca Cloudが水平軸に沿ってどこまでスクロールするかを、ピクセル単位（px）またはライン単位（lines）で指定します。測定単位なしで数値を指定すると、マウスホイールのノッチ数の分だけページがスクロールします。注：この値は、アプリケーションウィンドウが水平スクロールをサポートしている場合にのみ機能します。
MousePolicy	Tosca Cloudはスクロール中のマウスポインタの位置を指定します。以下の値のいずれかを入力してください：「Center」（デフォルト）、「None」。
DirectionPolicy	Tosca Cloudが縦軸と横軸のどちらを先にスクロールするかを指定します。次の値のいずれかを入力してください：「NoDirectionPolicy」（デフォルト）、「HorizontalFirst」、「VerticalFirst」。
Delay	Tosca Cloudが縦軸と横軸のスクロールの間に待つ時間をミリ秒単位（ms）で指定します。

TBox Save As

このモジュールは、ダイアログウィンドウ「名前を付けて保存」を操縦します。これを操縦するには、「名前を付けて保存」ダイアログを開いておく必要があります。このモジュールを使用するときに指定できる値は以下のとおりです。

値	説明
キャプション	操縦する「名前を付けて保存」ダイアログのキャプション。Tosca Cloudは、画面の上部セクション（WindowText）のキャプションからダイアログを識別します。任意の文字列を入力できます。この値は必須です。
FileNameLabel	「名前を付けて保存」ダイアログにパスを入力する「入力」フィールドのラベル。入力フィールドが「ファイル名」ではない場合に限り、ラベルを指定する必要があります。ラベルが「ファイル名」の場合、Tosca Cloudはそれを自動的に操縦します。任意の文字列を入力できます。
FilePath	Tosca Cloudがファイルを保存するパス。この値は必須です。
Button	Tosca Cloudがどのボタンをクリックすべきかを指定します。 Tosca Cloudは、「保存」または「キャンセル」を自動的に選択します。ボタンが「保存」または「キャンセル」ではない場合にのみ、ボタンを指定する必要があります。この値は任意です。
ConfirmationPopupCaption	Tosca Cloudがファイルを保存するパス。この値は必須です。
ConfirmationPopupButton	Tosca Cloudがファイルを保存するパス。この値は必須です。