WaitForObject メソッド (TestObject)

クラス

TestObject.

処理

指定したロケーターに一致するオブジェクトを待機します。 タイムアウト内に一致するオブジェクトが見つからない場合は、ObjectNotFoundException がスローされます。 デフォルトのタイムアウトは 5 秒で、オプション OPT_WAIT_RESOLVE_OBJDEF の値を設定してタイムアウト値を変更できます。 結果を表示する前にトランザクションが処理される場合など、AUT が特定のオブジェクトを表示するのに長時間かかる場合は、WaitForObject を使用してください。 デフォルトでは組み込みの同期が機能するため、UI の操作に対して WaitForObject は必要ありません。 通常のスクリプト実行中に不規則にタイムアウト エラーが発生する場合、WaitForObject ステートメントをスクリプトに追加するのではなく、デフォルトのタイムアウト値を増やすことを検討してください。

構文

testObject.WaitForObject(locator, [timeout])
変数 説明
locator XPath ロケーター。 オブジェクトを見つける場所を定義します。 例：

"//PushButton[@caption='ok']"

。 String。
timeout 省略可能: タイムアウト（ミリ秒）。 最初の検索で何も一致しなかった場合は、エージェントは指定されたタイムアウト値が経過するまでテスト オブジェクトの検索を繰り返します。 Integer。

例

次の例では、ウィンドウをアクティブに設定して、オブジェクトを見つけるために PushButton メソッドで使用されるタイムアウト (デフォルトでは 5 秒) のほかに、30 秒間ボタンを待機し、最後にボタンをクリックします。 
window.SetActive()
window.WaitForObject("//PushButton[@automationId='MySampleButton']", 30000)
window.PushButton("@automationId='MySampleButton'").Click()