Share via

IDragProvider ::GetGrabbedItems, méthode (uiautomationcore.h)

  • Article

Récupère la collection d’éléments qui sont déplacés dans le cadre d’une opération de glissement.

Syntaxe

HRESULT GetGrabbedItems(
  [out, retval, optional] SAFEARRAY **pRetVal
);

Paramètres

[out, retval, optional] pRetVal

Tableau de pointeurs VT_UNKNOWN vers les interfaces IRawElementProviderSimple des éléments déplacés. Ce paramètre a la valeur NULL si un seul élément est déplacé.

Valeur retournée

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, pour éviter d’avoir un grand ensemble d’événements en double. Le client peut appeler GetGrabbedItems pour récupérer la liste complète des éléments saisis. Le fournisseur doit allouer un SAFEARRAY de longueur appropriée et ajouter les pointeurs COM (Component Object Model) des éléments qui font partie de l’opération de glissement.

Configuration requise

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

Voir aussi

IDragProvider