Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
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) |