Compartir a través de


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

Obtiene la lista de imágenes temporales que se usa para la imagen de arrastre. La función también recupera la posición de arrastre actual y el desplazamiento de la imagen de arrastre en relación con la posición de arrastre.

Sintaxis

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

Parámetros

[out] ppt

Tipo: POINT*

Puntero a una estructura POINT que recibe la posición de arrastre actual. Puede ser NULL.

[out] pptHotspot

Tipo: POINT*

Puntero a una estructura POINT que recibe el desplazamiento de la imagen de arrastre en relación con la posición de arrastre. Puede ser NULL.

[out] riid

Tipo: REFIID

IiD para la lista de imágenes.

[out] ppv

Tipo: PVOID*

Dirección de un puntero a la interfaz de la lista de imágenes si se ejecuta correctamente, NULL en caso contrario.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

La lista de imágenes temporales se destruye cuando se llama a IImageList::EndDrag . Para iniciar una operación de arrastre, use IImageList::BeginDrag.

Para usar IImageList::GetDragImage, especifique Comctl32.dll versión 6 en el manifiesto. Para obtener más información sobre los manifiestos, vea Habilitación de estilos visuales.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado commoncontrols.h
Archivo DLL Comctl32.dll (versión 6.0 o posterior)