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

Voir aussi

IUIAutomationDragPattern