IDragProvider ::GetGrabbedItems, méthode (uiautomationcore.h)
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) |