IDragSourceHelper-Schnittstelle (shobjidl_core.h)

  • Artikel

Wird von der Shell verfügbar gemacht, damit eine Anwendung das Image angeben kann, das während eines Shell-Drag-and-Drop-Vorgangs angezeigt wird.

Vererbung

Die IDragSourceHelper-Schnittstelle erbt von der IUnknown-Schnittstelle . IDragSourceHelper verfügt auch über folgende Membertypen:

Methoden

Die IDragSourceHelper-Schnittstelle verfügt über diese Methoden.

 
IDragSourceHelper::InitializeFromBitmap

Initialisiert den Drag-Image-Manager für ein fensterloses Steuerelement.
IDragSourceHelper::InitializeFromWindow

Initialisiert den Drag-Image-Manager für ein Steuerelement mit einem Fenster.

Hinweise

Diese Schnittstelle wird vom Drag-Image-Manager der Shell verfügbar gemacht. Es wird nicht von Anwendungen implementiert.

Verwenden Sie diese Schnittstelle, um das Bild anzugeben, das während eines Shell-Drag-and-Drop-Vorgangs angezeigt wird. Die Schnittstellen IDragSourceHelper, IDropTargetHelper und IInitializeWithWindow werden vom Drag-Image-Manager-Objekt verfügbar gemacht, damit die IDropTarget-Schnittstelle benutzerdefinierte Ziehbilder verwenden kann. Um eine dieser Schnittstellen zu verwenden, müssen Sie ein Prozessserver-Drag-Image-Manager-Objekt erstellen, indem Sie CoCreateInstance mit einer CLSID (Class Identifier) von CLSID_DragDropHelper aufrufen. Abrufen von Schnittstellenzeigern mithilfe von COM-Standardprozeduren (Component Object Model).

Die IDragSourceHelper-Schnittstelle bietet die folgenden beiden Möglichkeiten, die Bitmap anzugeben, die als Bild ziehen verwendet werden soll.

  • Steuerelemente, die über ein Fenster verfügen, können eine DI_GETDRAGIMAGE-Fenstermeldung dafür registrieren und den Drag-Image-Manager mit IDragSourceHelper::InitializeFromWindow initialisieren. Wenn die DI_GETDRAGIMAGE Nachricht empfangen wird, legt der Handler die Bitmapinformationen zum Ziehen des Bilds in die SHDRAGIMAGE-Struktur , die als lParam-Wert der Nachricht übergeben wird.
  • Fensterlose Steuerelemente können den Drag-Image-Manager mit IDragSourceHelper::InitializeFromBitmap initialisieren. Mit dieser Methode kann eine Anwendung einfach die Bitmap angeben.
Hinweis Das Drag-and-Drop-Hilfsobjekt ruft IDataObject::SetData auf, um private Formate , die für die prozessübergreifende Unterstützung verwendet werden, in das Datenobjekt zu laden. Diese Formate werden später abgerufen, indem IDataObject::GetData aufgerufen wird. Zur Unterstützung des Drag-and-Drop-Hilfsobjekts müssen die SetData - und GetData-Implementierungen des Datenobjekts in der Lage sein, beliebige private Formate zu akzeptieren und zurückzugeben.
 
Weitere Informationen zu Shell-Drag-and-Drop-Vorgängen finden Sie unter Übertragen von Shelldaten mithilfe von Drag-and-Drop oder der Zwischenablage.
Hinweis Vor Windows Vista wurde diese Schnittstelle in Shlobj.h deklariert.
 

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (einschließlich Shobjidl.h)