Partager via


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

IItemContainerProvider

Identificateurs de propriété

Référence