IDropSource::GiveFeedback メソッド (oleidl.h)

  • [アーティクル]

DoDragDrop 関数に視覚効果を指定する列挙値を指定することで、ドラッグ アンド ドロップ操作中にソース アプリケーションからエンド ユーザーに視覚的なフィードバックを提供できるようにします。

構文

HRESULT GiveFeedback(
  [in] DWORD dwEffect
);

パラメーター

[in] dwEffect

IDropTarget::D ragEnter、IDropTarget::D ragOver、または IDropTarget::DragLeave の最新の呼び出しによって返される DROPEFFECT 値。

戻り値

このメソッドは、成功したS_OKを返します。 その他の可能な値は次のとおりです。

リターン コード 説明
DRAGDROP_S_USEDEFAULTCURSORS
 メソッドが正常に完了したことを示し、OLE で指定された既定のカーソルを使用してカーソルを更新するように OLE に要求します。

注釈

アプリケーションは、ユーザーがドラッグ アンド ドロップ操作を開始したことを検出すると、 DoDragDrop 関数を呼び出す必要があります。 DoDragDrop はループに入り、マウスが最初にドロップ ターゲット ウィンドウに入ったときに IDropTarget::D ragEnter を呼び出し、マウスがターゲット ウィンドウ内の位置を変更したときに IDropTarget::D ragOver を呼び出し、マウスがターゲット ウィンドウから離れたときに IDropTarget::D ragLeave を呼び出します。

IDropTarget::D ragEnter または IDropTarget::D ragOver を呼び出すたびに、DoDragDrop は IDropSource::GiveFeedback を呼び出し、ドロップ ターゲット呼び出しから返された DROPEFFECT 値を渡します。

DoDragDrop は、マウスがターゲット ウィンドウを離れたときに IDropTarget::D ragLeave を呼び出します。 次 に、DoDragDrop は IDropSource::GiveFeedback を呼び出し、 dwEffect パラメーターにDROPEFFECT_NONE値を渡します。

dwEffect パラメーターには、DROPEFFECT_SCROLLを含めることができます。これは、ソースが適切なポインターのドラッグ スクロールバリエーションを配置する必要があることを示します。

実装者へのメモ

この関数は DoDragDrop ループ中に頻繁に呼び出されるため、実装を可能な限り最適化すると、パフォーマンス上の利点を得ることができます。

IDropSource::GiveFeedback は、カーソルの図形を変更するか、 dwEffect パラメーターの値に基づいて強調表示されたソースを変更します。 既定のカーソルを使用している場合は、DRAGDROP_S_USEDEFAULTCURSORSを返すことができます。これにより、OLE は既定のカーソルを使用してカーソルを更新します。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー oleidl.h

こちらもご覧ください

Dodragdrop

IDropSource

IDropTarget