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
Referenz