Interface IDragSourceHelper (shobjidl_core.h)

Exposé par l’interpréteur de commandes pour permettre à une application de spécifier l’image qui sera affichée lors d’une opération de glisser-déplacer shell.

Héritage

L’interface IDragSourceHelper hérite de l’interface IUnknown. IDragSourceHelper a également les types de membres suivants :

Méthodes

L’interface IDragSourceHelper utilise ces méthodes.

 
IDragSourceHelper::InitializeFromBitmap

Initialise le gestionnaire de glisser-image pour un contrôle sans fenêtre.
IDragSourceHelper::InitializeFromWindow

Initialise le gestionnaire de glisser-image pour un contrôle avec une fenêtre.

Remarques

Cette interface est exposée par le gestionnaire de glisser-image de l’interpréteur de commandes. Il n’est pas implémenté par les applications.

Utilisez cette interface pour spécifier l’image affichée lors d’une opération de glisser-déplacer de l’interpréteur de commandes. Les interfaces IDragSourceHelper, IDropTargetHelper et IInitializeWithWindow sont exposées par l’objet drag-image manager pour permettre à l’interface IDropTarget d’utiliser des images de glissement personnalisées. Pour utiliser l’une de ces interfaces, vous devez créer un objet gestionnaire de glisser-image de serveur in-process en appelant CoCreateInstance avec un identificateur de classe (CLSID) de CLSID_DragDropHelper. Obtenez des pointeurs d’interface à l’aide de procédures COM (Component Object Model) standard.

L’interface IDragSourceHelper fournit les deux méthodes suivantes pour spécifier la bitmap à utiliser comme image de glissement.

  • Les contrôles qui ont une fenêtre peuvent inscrire un message de fenêtre DI_GETDRAGIMAGE pour celle-ci et initialiser le gestionnaire de glisser-image avec IDragSourceHelper::InitializeFromWindow. Lorsque le message DI_GETDRAGIMAGE est reçu, le gestionnaire place les informations bitmap de l’image de glissement dans la structure SHDRAGIMAGE qui est passée en tant que valeur lParam du message.
  • Les contrôles sans fenêtre peuvent initialiser le gestionnaire de glisser-image avec IDragSourceHelper::InitializeFromBitmap. Cette méthode permet à une application de spécifier simplement la bitmap.
Note L’objet d’assistance glisser-déplacer appelle IDataObject::SetData pour charger des formats privés (utilisés pour la prise en charge inter-processus) dans l’objet de données. Il récupère ensuite ces formats en appelant IDataObject::GetData. Pour prendre en charge l’objet d’assistance par glisser-déplacer, les implémentations SetData et GetData de l’objet de données doivent être en mesure d’accepter et de retourner des formats privés arbitraires.
 
Pour plus d’informations sur les opérations de glisser-déplacer de l’interpréteur de commandes, consultez Transfert de données de l’interpréteur de commandes à l’aide du glisser-déplacer ou du Presse-papiers.
Note Avant Windows Vista, cette interface était déclarée dans Shlobj.h.
 

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête shobjidl_core.h (incluez Shobjidl.h)