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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour