Méthode IUIAutomationItemContainerPattern ::FindItemByProperty (uiautomationclient.h)

Article
03/03/2024

Récupère un élément dans un élément contenant, en fonction d’une valeur de propriété spécifiée.

Syntaxe

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

Paramètres

[in] pStartAfter

Type : IUIAutomationElement*

Pointeur vers 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, retval] pFound

Type : IUIAutomationElement**

Reçoit un pointeur vers l’élément correspondant.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Le fournisseur peut retourner une interface IUIAutomationElement réelle ou un espace réservé si l’élément correspondant est virtualisé.

Cette méthode retourne E_INVALIDARG si la propriété demandée n’est pas celle sur laquelle le conteneur prend en charge la recherche. Il est prévu que la plupart des conteneurs prennent en charge la propriété Name et, si approprié pour le conteneur, AutomationId et IsSelected.

Cette méthode peut être lente, car elle peut avoir besoin de parcourir plusieurs objets pour en trouver un correspondant. En cas d’utilisation dans une boucle pour retourner plusieurs éléments, aucun ordre spécifique n’est défini tant que chaque élément n’est retourné qu’une seule fois (autrement dit, la boucle doit se terminer). Cette méthode est également centrée sur les éléments et non sur l’interface utilisateur. Par conséquent, les éléments avec plusieurs représentations d’interface utilisateur ne doivent être atteints qu’une seule fois.

Lorsque le paramètre propertyId est spécifié comme 0 (zéro), le fournisseur est censé retourner l’élément suivant après pStartAfter. Si pStartAfter est spécifié comme NULL avec un propertyId de 0, le fournisseur doit retourner le premier élément dans le conteneur. Lorsque propertyId est spécifié comme 0, le paramètre value doit être VT_EMPTY.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Platform Update pour Windows Vista, Windows XP avec SP3 et Platform Update pour Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008, Windows Server 2003 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uiautomationclient.h (incluez UIAutomation.h)

Voir aussi

IUIAutomationItemContainerPattern

Réaliser

Référence

Partager via