Freigeben über


SHDRAGIMAGE-Struktur (shobjidl_core.h)

Enthält die Informationen, die zum Erstellen eines Ziehbilds erforderlich sind.

Syntax

typedef struct SHDRAGIMAGE {
  SIZE     sizeDragImage;
  POINT    ptOffset;
  HBITMAP  hbmpDragImage;
  COLORREF crColorKey;
} SHDRAGIMAGE, *LPSHDRAGIMAGE;

Member

sizeDragImage

Typ: SIZE

Eine SIZE-Struktur mit der Länge und Breite des Ziehbilds.

ptOffset

Typ: POINT

Eine POINT-Struktur , die die Position des Cursors im Ziehbild angibt. Die -Struktur sollte den Offset von der oberen linken Ecke des Bilds an die Position des Cursors enthalten.

hbmpDragImage

Typ: HBITMAP

Das Bitmaphandle des Ziehbilds.

crColorKey

Typ: COLORREF

Die Farbe, die vom Steuerelement verwendet wird, um den Hintergrund des Bilds zu füllen.

Hinweise

In Windows Vista ist diese Struktur in Shobjidl.idl definiert. Zuvor wurde es in Shlobj.h definiert.

Verwenden Sie das folgende Verfahren, um das Ziehbild zu erstellen.

  1. Erstellen Sie eine Bitmap der von sizeDragImage angegebenen Größe mit einem Handle für einen Gerätekontext (HDC), der mit dem Bildschirm kompatibel ist.
  2. Zeichnen Sie die Bitmap.
  3. Wählen Sie die Bitmap aus dem HDC aus, mit dem sie erstellt wurde.
  4. Zerstören Sie die HDC.
  5. Weisen Sie hbmpDragImage das Bitmaphandle zu.
Hinweis Deaktivieren Sie das Antialiasing beim Zeichnen von Text. Andernfalls können Artefakte an den Rändern zwischen der Textfarbe und dem Farbschlüssel auftreten.
 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional mit SP3, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile shobjidl_core.h (shobjidl.h einschließen)

Weitere Informationen

IDragSourceHelper::InitializeFromBitmap

IDragSourceHelper::InitializeFromWindow