Freigeben über


IItemContainerProvider::FindItemByProperty-Methode (uiautomationcore.h)

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

Syntax

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

Parameter

[in] pStartAfter

Typ: IRawElementProviderSimple*

Der Benutzeroberflächenautomatisierung Anbieter des Elements, 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 Wert der Eigenschaft.

[out] pFound

Typ: IRawElementProviderSimple**

Empfängt einen Zeiger auf den Benutzeroberflächenautomatisierung Anbieter des Elements.

Rückgabewert

Typ: HRESULT

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

Hinweise

Bei virtuellen Listen kann das zurückgegebene Element ein Platzhalter sein. IVirtualizedItemProvider::Realize kann dann verwendet werden, um das Element vollständig verfügbar zu machen.

Die -Methode gibt E_INVALIDARG zurück, wenn die Suche nach der angegebenen Eigenschaft nicht unterstützt wird. Die meisten Container sollten UIA_NamePropertyId und ggf . UIA_AutomationIdPropertyId und UIA_SelectionItemIsSelectedPropertyId unterstützen.

Wenn propertyId 0 ist, sind alle Elemente eine Übereinstimmung. Dieser Wert kann mit pStartAfter mit NULL verwendet werden, um das erste Element und dann aufeinander folgende Elemente abzurufen. In diesem Fall sollte der Wert VT_EMPTY sein.

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 [Desktop-Apps | UWP-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 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile uiautomationcore.h (uiAutomation.h einschließen)
DLL Uiautomationcore.dll

Siehe auch

Konzept

IItemContainerProvider

Eigenschaftsbezeichner

Referenz