IDragSourceHelper 介面 (shobjidl_core.h)
由殼層公開,以允許應用程式指定在殼層拖放作業期間顯示的影像。
繼承
IDragSourceHelper介面繼承自IUnknown介面。 IDragSourceHelper 也有下列類型的成員:
方法
IDragSourceHelper介面具有這些方法。
IDragSourceHelper::InitializeFromBitmap 初始化無視窗控制項的拖曳映射管理員。 |
IDragSourceHelper::InitializeFromWindow 使用視窗初始化控制項的拖曳影像管理員。 |
備註
此介面是由殼層的拖曳映射管理員公開。 它不是由應用程式實作。
使用此介面可指定在殼層拖放作業期間顯示的影像。 拖曳映射管理員物件會公開 IDragSourceHelper、 IDropTargetHelper和 IInitializeWithWindow 介面,以允許 IDropTarget 介面使用自訂拖曳影像。 若要使用上述任一介面,您必須呼叫 CoCreateInstance 搭配類別識別碼 (CLSID) CLSID_DragDropHelper,來建立同進程伺服器拖曳映射管理員物件。 使用標準元件物件模型 (COM) 程式取得介面指標。
IDragSourceHelper介面提供下列兩種方式來指定要當做拖曳影像使用的點陣圖。
- 具有視窗的控制項可以為其註冊DI_GETDRAGIMAGE視窗訊息,並使用 IDragSourceHelper::InitializeFromWindow初始化拖曳映射管理員。 收到DI_GETDRAGIMAGE訊息時,處理常式會將拖曳影像點陣圖資訊放在傳遞為訊息lParam值的SHDRAGIMAGE結構中。
- 無視窗控制項可以使用 IDragSourceHelper::InitializeFromBitmap來初始化拖曳影像管理員。 這個方法可讓應用程式直接指定點陣圖。
注意 拖放協助程式物件會呼叫 IDataObject::SetData ,將用於跨進程支援的私人格式載入資料物件。 稍後會藉由呼叫 IDataObject::GetData來擷取這些格式。 若要支援拖放協助程式物件,資料物件的 SetData 和 GetData 實作必須能夠接受並傳回任意私用格式。
注意 在 Windows Vista 之前,此介面已在 Shlobj.h 中宣告。
需求
最低支援的用戶端 | Windows 2000 Professional、Windows XP [僅限桌面應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | shobjidl_core.h (包含 Shobjidl.h) |