UITechnologyManager.Search メソッド

[アーティクル]
08/09/2011

指定されたクエリ ID Cookie の条件に一致する親要素内の要素を検索します。

名前空間: Microsoft.VisualStudio.TestTools.UITest.Extension
アセンブリ: Microsoft.VisualStudio.TestTools.UITest.Extension (Microsoft.VisualStudio.TestTools.UITest.Extension.dll 内)

構文

'宣言
Public MustOverride Function Search ( _
    parsedQueryIdCookie As Object, _
    parentElement As IUITechnologyElement, _
    maxDepth As Integer _
) As Object()

public abstract Object[] Search(
    Object parsedQueryIdCookie,
    IUITechnologyElement parentElement,
    int maxDepth
)

public:
virtual array<Object^>^ Search(
    Object^ parsedQueryIdCookie, 
    IUITechnologyElement^ parentElement, 
    int maxDepth
) abstract

abstract Search : 
        parsedQueryIdCookie:Object * 
        parentElement:IUITechnologyElement * 
        maxDepth:int -> Object[]

public abstract function Search(
    parsedQueryIdCookie : Object, 
    parentElement : IUITechnologyElement, 
    maxDepth : int
) : Object[]

パラメーター

parsedQueryIdCookie
型: System.Object
ParseQueryId メソッドを使用して既に解析されているクエリ Cookie。

parentElement
型: Microsoft.VisualStudio.TestTools.UITest.Extension.IUITechnologyElement
IUITechnologyElement オブジェクト。

maxDepth
型: System.Int32
検索する対象のコントロール階層の深さを示す int。

戻り値

型: array<System.Object[]
クエリに一致する要素の配列。要素が見つからない場合は nullnull 参照 (Visual Basic では Nothing)。

実装

IUITechnologyManager.Search(Object, IUITechnologyElement, Int32)

例外

例外	条件
NotSupportedException	この実装はこのメソッドをサポートしていません。この例外を処理するために、テストフレームワークは、GetChildren メソッドを使用して、階層を走査して、各要素に対して MatchElement メソッドを使用して、クエリに一致するかどうかを判断します。

NotSupportedException

この実装はこのメソッドをサポートしていません。

この例外を処理するために、テストフレームワークは、GetChildren メソッドを使用して、階層を走査して、各要素に対して MatchElement メソッドを使用して、クエリに一致するかどうかを判断します。

解説

実装時の注意

このメソッドの実装は任意です。基になるテクノロジに、UI 階層を検索や移動するための豊富な API がある場合は、このメソッドを実装することによって、大幅に、再生パフォーマンスが向上します。ただし、このメソッドまたは MatchElement(UITechnologyElement, Object, Boolean%) メソッドのどちらかを実装する必要があります。