Compartilhar via


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)

Confira também

IDragProvider