IImageList::GetDragImage 方法 (commoncontrols.h)
取得用於拖曳影像的暫存影像清單。 函式也會擷取目前拖曳位置以及拖曳影像相對於拖曳位置的位移。
語法
HRESULT GetDragImage(
[out] POINT *ppt,
[out] POINT *pptHotspot,
[out] REFIID riid,
[out] void **ppv
);
參數
[out] ppt
類型: POINT*
接收目前拖曳位置 之 POINT 結構的指標。 可以是 NULL。
[out] pptHotspot
類型: POINT*
POINT 結構的指標,接收相對於拖曳位置的拖曳影像位移。 可以是 NULL。
[out] riid
類型: REFIID
影像清單的 IID。
[out] ppv
類型: PVOID*
如果成功,則為影像清單介面的指標位址,否則為 NULL 。
傳回值
類型: HRESULT
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
備註
呼叫 ImageList::EndDrag 時,會終結暫存映像清單。 若要開始拖曳作業,請使用 IImageList::BeginDrag。
若要使用 IImageList::GetDragImage,請在指令清單中指定第 6 版 Comctl32.dll。 如需指令清單的詳細資訊,請參閱 啟用可視化樣式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | commoncontrols.h |
Dll | Comctl32.dll (6.0 版或更新版本) |