Méthode IUIAutomationDragPattern ::GetCachedGrabbedItems (uiautomationclient.h)

Récupère une collection mise en cache d’éléments qui représentent l’ensemble complet d’éléments que l’utilisateur fait glisser dans le cadre d’une opération de glissement.

Syntaxe

HRESULT GetCachedGrabbedItems(
  [out, retval, optional] IUIAutomationElementArray **retVal
);

Paramètres

[out, retval, optional] retVal

Type : IAutomationElementArray**

Collection d’éléments mis en cache que l’utilisateur fait glisser. Cette propriété a la valeur NULL ou un tableau vide si un seul élément est déplacé. La valeur par défaut est un tableau vide.

Valeur retournée

Type : HRESULT

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

Remarques

Si l’utilisateur fait glisser plusieurs éléments, les éléments sont représentés par un seul élément master avec un ensemble associé d’éléments saisis. L’élément master déclenche les événements appropriés, afin d’éviter d’avoir un grand ensemble d’événements en double. Le client peut interroger la propriété GrabbedItems pour obtenir la liste complète des éléments saisis.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	uiautomationclient.h (incluez UIAutomation.h)

Voir aussi

IUIAutomationDragPattern