IDropSource::GiveFeedback メソッド (oleidl.h)
DoDragDrop 関数に視覚効果を指定する列挙値を指定することで、ドラッグ アンド ドロップ操作中にソース アプリケーションからエンド ユーザーに視覚的なフィードバックを提供できるようにします。
構文
HRESULT GiveFeedback(
[in] DWORD dwEffect
);
パラメーター
[in] dwEffect
IDropTarget::D ragEnter、IDropTarget::D ragOver、または IDropTarget::DragLeave の最新の呼び出しによって返される DROPEFFECT 値。
戻り値
このメソッドは、成功したS_OKを返します。 その他の可能な値は次のとおりです。
| リターン コード | 説明 |
|---|---|
|
メソッドが正常に完了したことを示し、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 |