IDropSource::GiveFeedback 方法 (oleidl.h)

讓來源應用程式在拖放作業期間提供視覺回饋給終端使用者,方法是提供指定視覺效果的列舉值 DoDragDrop 函式。

語法

HRESULT GiveFeedback(
  [in] DWORD dwEffect
);

參數

[in] dwEffect

最近呼叫 IDropTarget::D ragEnterIDropTarget::D ragOverIDropTarget::D ragLeave 所傳回的 DROPEFFECT 值。

傳回值

此方法會在成功時傳回S_OK。 其他可能的值包括下列專案。

傳回碼 Description
DRAGDROP_S_USEDEFAULTCURSORS
表示方法成功完成,並要求 OLE 使用 OLE 提供的預設數據指標來更新數據指標。

備註

當您的應用程式偵測到使用者已啟動拖放作業時,它應該呼叫 DoDragDrop 函式。 DoDragDrop 會進入迴圈,當滑鼠第一次進入置放目標視窗時,呼叫 IDropTarget::D ragEnter,當滑鼠變更目標視窗內的位置時,IDropTarget :D::D ragLeave

對於 IDropTarget::D ragEnterIDropTarget::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