IDropTargetHelper インターフェイス (shobjidl_core.h)

  • [アーティクル]

ドロップ ターゲットがターゲット ウィンドウ上にある間にドラッグ イメージを表示できるようにするメソッドを公開します。

継承

IDropTargetHelper インターフェイスは、IUnknown インターフェイスから継承します。 IDropTargetHelper には、次の種類のメンバーもあります。

メソッド

IDropTargetHelper インターフェイスには、これらのメソッドがあります。

 
IDropTargetHelper::D ragEnter

ドロップ 先の IDropTarget::D ragEnter メソッドが呼び出されたことをドラッグ イメージ マネージャーに通知します。
IDropTargetHelper::D ragLeave

ドロップ ターゲットの IDropTarget::D ragLeave メソッドが呼び出されたことをドラッグ イメージ マネージャーに通知します。
IDropTargetHelper::D ragOver

ドロップ ターゲットの IDropTarget::D ragOver メソッドが呼び出されたことをドラッグ イメージ マネージャーに通知します。
IDropTargetHelper::D rop

ドロップ ターゲットの IDropTarget::D rop メソッドが呼び出されたことをドラッグ イメージ マネージャーに通知します。
IDropTargetHelper::Show

ドラッグ イメージを表示または非表示にするようにドラッグ イメージ マネージャーに通知します。

注釈

このインターフェイスは、シェルのドラッグ イメージ マネージャーによって公開されます。 アプリケーションでは実装されません。

このインターフェイスは、ドロップ ターゲットによって使用され、イメージがターゲット ウィンドウ上にある間、ドラッグ イメージ マネージャーがドラッグ イメージを表示できるようにします。 IDragSourceHelper インターフェイスと IDropTargetHelper インターフェイスは、ドラッグ イメージ マネージャー オブジェクトによって公開され、IDropTarget インターフェイスでカスタムドラッグイメージを使用できるようになります。 これらのインターフェイスのいずれかを使用するには、CLSID_DragDropHelperのクラス識別子 (CLSID) を使用して CoCreateInstance を呼び出して、インプロセス サーバー drag-image manager オブジェクトを作成する必要があります。 標準のコンポーネント オブジェクト モデル (COM) プロシージャを使用してインターフェイス ポインターを取得します。

IDropTargetHelper メソッドのうち 4 つは、4 つの IDropTarget メソッドに対応しています。 IDropTarget を実装する場合、各メソッドは対応する IDropTargetHelper メソッドを呼び出して、ドラッグ イメージ マネージャーに情報を渡す必要があります。 5 番目の IDropTargetHelper メソッドは、ドラッグ イメージを表示または非表示にするようにドラッグ イメージ マネージャーに通知します。 このメソッドは、低色深度のビデオ モードでターゲット ウィンドウ上をドラッグするときに使用されます。 これにより、ウィンドウの描画中にターゲットがドラッグイメージを非表示にすることができます。

メモ ドラッグ アンド ドロップ ヘルパー オブジェクトは IDataObject::SetData を呼び出して、プロセス間のサポートに使用されるプライベート形式をデータ オブジェクトに読み込みます。 後で IDataObject::GetData を呼び出してこれらの形式を取得します。 ドラッグ アンド ドロップ ヘルパー オブジェクトをサポートするには、データ オブジェクトの SetData と GetData の実装が任意のプライベート形式を受け入れて返すことができる必要があります。
 
シェルのドラッグ アンド ドロップ操作の詳細については、「 ドラッグ アンド ドロップまたはクリップボードを使用したシェル データの転送」を参照してください。
メモ Windows Vista より前のバージョンでは、このインターフェイスは Shlobj.h で宣言されていました。
 

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー shobjidl_core.h (Shobjidl.h を含む)

こちらもご覧ください

IDragSourceHelper

シェル データ オブジェクト