Compartilhar via


Método IImageList::GetDragImage (commoncontrols.h)

Obtém a lista de imagens temporárias usada para a imagem de arrastar. A função também recupera a posição de arrastar atual e o deslocamento da imagem de arrasto em relação à posição de arrastar.

Sintaxe

HRESULT GetDragImage(
  [out] POINT  *ppt,
  [out] POINT  *pptHotspot,
  [out] REFIID riid,
  [out] void   **ppv
);

Parâmetros

[out] ppt

Tipo: POINT*

Um ponteiro para uma estrutura POINT que recebe a posição de arrastar atual. Pode ser NULL.

[out] pptHotspot

Tipo: POINT*

Um ponteiro para uma estrutura POINT que recebe o deslocamento da imagem de arrastar em relação à posição de arrastar. Pode ser NULL.

[out] riid

Tipo: REFIID

Um IID para a lista de imagens.

[out] ppv

Tipo: PVOID*

O endereço de um ponteiro para a interface da lista de imagens se tiver êxito; caso contrário, NULL .

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

A lista de imagens temporárias é destruída quando IImageList::EndDrag é chamado. Para iniciar uma operação de arrastar, use IImageList::BeginDrag.

Para usar IImageList::GetDragImage, especifique Comctl32.dll versão 6 no manifesto. Para obter mais informações sobre manifestos, consulte Habilitando estilos visuais.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho commoncontrols.h
DLL Comctl32.dll (versão 6.0 ou posterior)