IDropTargetHelper-Schnittstelle (shobjidl_core.h)

  • Artikel

Macht Methoden verfügbar, mit denen Ablageziele ein Ziehbild anzeigen können, während sich das Bild über dem Zielfenster befindet.

Vererbung

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

Methoden

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

 
IDropTargetHelper::D ragEnter

Benachrichtigt den Drag-Image-Manager, dass die IDropTarget::D ragEnter-Methode des Ablageziels aufgerufen wurde.
IDropTargetHelper::D ragLeave

Benachrichtigt den Drag-Image-Manager, dass die IDropTarget::D ragLeave-Methode des Ablageziels aufgerufen wurde.
IDropTargetHelper::D ragOver

Benachrichtigt den Drag-Image-Manager, dass die IDropTarget::D ragOver-Methode des Ablageziels aufgerufen wurde.
IDropTargetHelper::D rop

Benachrichtigt den Drag-Image-Manager, dass die IDropTarget::D roprop-Methode des Ablageziels aufgerufen wurde.
IDropTargetHelper::Show

Benachrichtigt den Drag-Image-Manager, das Bild ein- oder auszublenden.

Hinweise

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

Diese Schnittstelle wird von Ablagezielen verwendet, um dem Drag-Image-Manager die Anzeige des Bilds zu ermöglichen, während sich das Bild über dem Zielfenster befindet. Die Schnittstellen IDragSourceHelper und IDropTargetHelper 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 In-Process-Server-Drag-Image-Manager-Objekt erstellen, indem Sie CoCreateInstance mit einem Klassenbezeichner (CLSID) von CLSID_DragDropHelper aufrufen. Rufen Sie Schnittstellenzeiger mithilfe von COM-Standardprozeduren (Component Object Model) ab.

Vier der IDropTargetHelper-Methoden entsprechen den vier IDropTarget-Methoden . Wenn Sie IDropTarget implementieren, sollte jede ihrer Methoden die entsprechende IDropTargetHelper-Methode aufrufen, um die Informationen an den Drag-Image-Manager zu übergeben. Die fünfte IDropTargetHelper-Methode benachrichtigt den Drag-Image-Manager, das Bild ein- oder auszublenden. Diese Methode wird verwendet, wenn Sie in einem Videomodus mit geringer Farbtiefe über ein Zielfenster ziehen. Das Ziel kann das Bild beim Zeichnen des Fensters ausblenden.

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 durch Aufrufen von IDataObject::GetData abgerufen. Um das Drag-and-Drop-Hilfsobjekt zu unterstützen, müssen die SetData - und GetData-Implementierungen des Datenobjekts beliebige private Formate akzeptieren und zurückgeben können.
 
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

Anforderung Wert
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 (shobjidl.h einschließen)

Weitere Informationen

IDragSourceHelper

Shelldatenobjekt