Méthode IItemContainerProvider ::FindItemByProperty (uiautomationcore.h)
Récupère un élément dans un élément conteneur, en fonction d’une valeur de propriété spécifiée.
Syntaxe
HRESULT FindItemByProperty(
[in] IRawElementProviderSimple *pStartAfter,
[in] PROPERTYID propertyId,
[in] VARIANT value,
[out] IRawElementProviderSimple **pFound
);
Paramètres
[in] pStartAfter
Type : IRawElementProviderSimple*
Le UI Automation fournisseur de l’élément après lequel la recherche commence, ou NULL pour rechercher tous les éléments.
[in] propertyId
Type : PROPERTYID
Identificateur de la propriété. Pour obtenir la liste des ID de propriété, consultez Identificateurs de propriétés.
[in] value
Type : VARIANT
Valeur de la propriété.
[out] pFound
Type : IRawElementProviderSimple**
Reçoit un pointeur vers le fournisseur UI Automation de l’élément .
Valeur retournée
Type : HRESULT
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Pour les listes virtuelles, l’élément retourné peut être un espace réservé. IVirtualizedItemProvider ::Realize peut ensuite être utilisé pour rendre l’élément entièrement disponible.
La méthode retourne E_INVALIDARG si la recherche par la propriété spécifiée n’est pas prise en charge. La plupart des conteneurs doivent prendre en charge UIA_NamePropertyId et, le cas échéant, UIA_AutomationIdPropertyId et UIA_SelectionItemIsSelectedPropertyId.
Si propertyId a la valeur 0, tous les éléments sont une correspondance. Cette valeur peut être utilisée avec pStartAfter égal à NULL pour obtenir le premier élément, puis pour obtenir les éléments successifs. Dans ce cas, la valeur doit être VT_EMPTY.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista, Windows XP avec SP3 et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows Server 2008 R2, Windows Server 2008 avec SP2 et Platform Update pour Windows Server 2008, Windows Server 2003 avec SP2 et Platform Update pour Windows Server 2008 [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | uiautomationcore.h (incluez UIAutomation.h) |
| DLL | Uiautomationcore.dll |
Voir aussi
Conceptuel
Référence