Método IUIAutomationDragPattern::GetCachedGrabbedItems (uiautomationclient.h)

Recupera uma coleção armazenada em cache de elementos que representam o conjunto completo de itens que o usuário está arrastando como parte de uma operação de arrastar.

Sintaxe

HRESULT GetCachedGrabbedItems(
  [out, retval, optional] IUIAutomationElementArray **retVal
);

Parâmetros

[out, retval, optional] retVal

Tipo: IAutomationElementArray**

A coleção armazenada em cache de elementos que o usuário está arrastando. Essa propriedade será NULL ou uma matriz vazia se apenas um único item estiver sendo arrastado. O valor padrão é uma matriz vazia.

Retornar valor

Tipo: HRESULT

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 item master dispara os eventos apropriados, para evitar ter um grande conjunto de eventos duplicados. O cliente pode consultar a propriedade GrabbedItems para obter a lista completa de itens capturados.

Requisitos

Confira também

IUIAutomationDragPattern