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 esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retorna 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 mestre com um conjunto associado de elementos capturados. O elemento mestre 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 um SAFEARRAY de comprimento apropriado e adicionar os ponteiros COM (Component Object Model) dos elementos que fazem parte da operação de arrastar.

Requisitos

   
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)

Confira também

IDragProvider