IImageList ::GetDragImage, méthode (commoncontrols.h)

Obtient la liste d’images temporaires utilisée pour l’image glisser. La fonction récupère également l'emplacement actuel de glissement et le décalage de l'image glissée par rapport à la position de glissement.

Syntaxe

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

Paramètres

[out] ppt

Type : POINT*

Pointeur vers une structure POINT qui reçoit la position de glissement actuelle. Peut être NULL.

[out] pptHotspot

Type : POINT*

Pointeur vers une structure POINT qui reçoit le décalage de l’image glisser par rapport à la position de glissement. Peut être NULL.

[out] riid

Type : REFIID

IID pour la liste d’images.

[out] ppv

Type : PVOID*

Adresse d’un pointeur vers l’interface de la liste d’images en cas de réussite, null sinon.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

La liste d’images temporaire est détruite lorsque IImageList ::EndDrag est appelé. Pour commencer une opération de glisser, utilisez IImageList ::BeginDrag.

Pour utiliser IImageList ::GetDragImage, spécifiez Comctl32.dll version 6 dans le manifeste. Pour plus d’informations sur les manifestes, consultez Activation des styles visuels.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	commoncontrols.h
DLL	Comctl32.dll (version 6.0 ou ultérieure)