SHDRAGIMAGE 結構 (shobjidl_core.h)

包含建立拖曳映射所需的資訊。

語法

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

成員

sizeDragImage

類型： SIZE

具有拖曳影像長度和寬度的 SIZE 結構。

ptOffset

類型： POINT

POINT 結構，指定拖曳影像中游標的位置。 結構應該包含從拖曳影像左上角到游標位置的位移。

hbmpDragImage

類型： HBITMAP

拖曳影像的點。

crColorKey

類型： COLORREF

控件用來填滿拖曳影像背景的色彩。

備註

在 Windows Vista 中，此結構定義於 Shobjidl.idl 中。 在這之前，它定義於Shlobj.h中。

使用下列程式來建立拖曳影像。

1. 使用與螢幕相容的裝置內容句柄，建立 sizeDragImage 所指定大小的點陣圖 (HDC) 。
2. 繪製位圖。
3. 從建立的 HDC 中選取位圖。
4. 終結 HDC。
5. 將點陣圖句柄指派給 hbmpDragImage。

注意 在繪製文字時關閉反鋸齒功能。 否則，成品可能會在文字色彩與色彩索引鍵之間的邊緣發生。

 

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional with SP3、Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限桌面應用程式]
標頭	shobjidl_core.h (包含 Shobjidl.h)

另請參閱

IDragSourceHelper：：InitializeFromBitmap

IDragSourceHelper：：InitializeFromWindow