Método IDragProvider::GetGrabbedItems (uiautomationcore.h)
Recupera a coleção de elementos que estão sendo arrastados como parte de uma operação de arrastar.
Sintaxe
HRESULT GetGrabbedItems(
[out, retval, optional] SAFEARRAY **pRetVal
);
Parâmetros
[out, retval, optional] pRetVal
Uma matriz de ponteiros VT_UNKNOWN para as interfaces IRawElementProviderSimple dos elementos que estão sendo arrastados. Esse parâmetro será NULL se apenas um único item estiver sendo arrastado.
Retornar valor
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
Se o usuário estiver arrastando vários itens, os itens serão representados por um único elemento master com um conjunto associado de elementos capturados. O elemento master gera os eventos apropriados, para evitar ter um grande conjunto de eventos duplicados. O cliente pode chamar GetGrabbedItems para recuperar a lista completa de itens capturados. O provedor deve alocar uma SAFEARRAY de comprimento apropriado e adicionar os ponteiros COM (Component Object Model) dos elementos que fazem parte da operação de arrastar.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 8 [aplicativos da área de trabalho | Aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | uiautomationcore.h (include UIAutomation.h) |