Metodo IDragProvider::GetGrabbedItems (uiautomationcore.h)
Recupera la raccolta di elementi trascinati come parte di un'operazione di trascinamento.
Sintassi
HRESULT GetGrabbedItems(
[out, retval, optional] SAFEARRAY **pRetVal
);
Parametri
[out, retval, optional] pRetVal
Matrice di puntatori VT_UNKNOWN alle interfacce IRawElementProviderSimple degli elementi trascinati. Questo parametro è NULL se viene trascinato solo un singolo elemento.
Valore restituito
Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
Se l'utente trascina più elementi, gli elementi vengono rappresentati da un singolo elemento master con un set associato di elementi afferrati. L'elemento master genera gli eventi appropriati per evitare di avere un set elevato di eventi duplicati. Il client può chiamare GetGrabbedItems per recuperare l'elenco completo di elementi afferrati. Il provider deve allocare un valore SAFEARRAY di lunghezza appropriata e aggiungere i puntatori Component Object Model (COM) degli elementi che fanno parte dell'operazione di trascinamento.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2012 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | uiautomationcore.h (includere UIAutomation.h) |