IUIAutomationItemContainerPattern::FindItemByProperty-Methode (uiautomationclient.h)

Artikel
08/26/2023

Ruft ein Element in einem enthaltenden Element basierend auf einem angegebenen Eigenschaftswert ab.

Syntax

HRESULT FindItemByProperty(
  [in]          IUIAutomationElement *pStartAfter,
  [in]          PROPERTYID           propertyId,
  [in]          VARIANT              value,
  [out, retval] IUIAutomationElement **pFound
);

Parameter

[in] pStartAfter

Typ: IUIAutomationElement*

Ein Zeiger auf das Element, nach dem die Suche beginnt, oder NULL , um alle Elemente zu durchsuchen.

[in] propertyId

Typ: PROPERTYID

Der Eigenschaftenbezeichner. Eine Liste der Eigenschaften-IDs finden Sie unter Eigenschaftenbezeichner.

[in] value

Typ: VARIANT

Der Eigenschaftswert.

[out, retval] pFound

Typ: IUIAutomationElement**

Empfängt einen Zeiger auf das übereinstimmende Element.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der Anbieter gibt möglicherweise eine tatsächliche IUIAutomationElement-Schnittstelle oder einen Platzhalter zurück, wenn das übereinstimmende Element virtualisiert ist.

Diese Methode gibt E_INVALIDARG zurück, wenn die angeforderte Eigenschaft keine ist, die der Container durchsucht. Es wird erwartet, dass die meisten Container die Name-Eigenschaft und ggf. für den Container AutomationId und IsSelected unterstützen.

Diese Methode kann langsam sein, da sie möglicherweise mehrere Objekte durchlaufen muss, um ein übereinstimmende Zu finden. Wenn in einer Schleife zum Zurückgeben mehrerer Elemente verwendet wird, wird keine bestimmte Reihenfolge definiert, solange jedes Element nur einmal zurückgegeben wird (d. a. die Schleife sollte beendet werden). Diese Methode ist auch elementzentriert, nicht ui-zentriert, sodass Elemente mit mehreren UI-Darstellungen nur einmal getroffen werden müssen.

Wenn der propertyId-Parameter als 0 (null) angegeben wird, wird erwartet, dass der Anbieter das nächste Element nach pStartAfter zurückgibt. Wenn pStartAfter als NULL mit einer propertyId von 0 angegeben wird, sollte der Anbieter das erste Element im Container zurückgeben. Wenn propertyId als 0 angegeben wird, sollte der value-Parameter VT_EMPTY werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista, Windows XP mit SP3 und Plattformupdate für Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008, Windows Server 2003 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uiautomationclient.h (include UIAutomation.h)

Weitere Informationen

IUIAutomationItemContainerPattern

Erkennen

Referenz

Freigeben über