UITechnologyManager.Search-Methode

  • Artikel

Sucht nach einem Element innerhalb des übergeordneten Elements, das der Bedingung des bereitgestellten Cookies der Abfrage-ID entspricht.

Namespace:  Microsoft.VisualStudio.TestTools.UITest.Extension
Assembly:  Microsoft.VisualStudio.TestTools.UITest.Extension (in Microsoft.VisualStudio.TestTools.UITest.Extension.dll)

Syntax

'Declaration
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[]

Parameter

  • maxDepth
    Typ: System.Int32
    Ein int, der die Suchtiefe für die Steuerelementhierarchie angibt.

Rückgabewert

Typ: array<System.Object[]
Ein Array von Elementen, die der Abfrage entsprechen, oder nullNULL-Verweis (Nothing in Visual Basic), wenn keine Elemente gefunden wurden.

Implementiert

IUITechnologyManager.Search(Object, IUITechnologyElement, Int32)

Ausnahmen

Ausnahme Bedingung
NotSupportedException

Diese Implementierung unterstützt diese Methode nicht.

Bei der Verarbeitung dieser Ausnahme verwendet das Testframework die Hierarchie mithilfe der GetChildren-Methode, und verwendet die MatchElement-Methode für jedes Element, um zu ermitteln, ob es mit der Abfrage übereinstimmt.

Hinweise

Hinweise zur Implementierung

Das Implementieren dieser Methode ist optional. Wenn die zugrunde liegende Technologie umfangreiche APIs zum Suchen und Navigieren der Benutzeroberflächen-Hierarchie hat, könnte diese Methode die Wiedergabeleistung erheblich verbessern. Sie müssen jedoch entweder diese Methode oder die MatchElement(UITechnologyElement, Object, Boolean%)-Methode implementieren.

.NET Framework-Sicherheit

Siehe auch

Referenz

UITechnologyManager Klasse

Microsoft.VisualStudio.TestTools.UITest.Extension-Namespace

GetChildren(UITechnologyElement, Object)

MatchElement(UITechnologyElement, Object, Boolean%)

ParseQueryId

UITechnologyElement