IDropSource::GiveFeedback 方法 (oleidl.h)
讓來源應用程式在拖放作業期間提供視覺回饋給終端使用者,方法是提供指定視覺效果的列舉值 DoDragDrop 函式。
語法
HRESULT GiveFeedback(
[in] DWORD dwEffect
);
參數
[in] dwEffect
最近呼叫 IDropTarget::D ragEnter、IDropTarget::D ragOver 或 IDropTarget::D ragLeave 所傳回的 DROPEFFECT 值。
傳回值
此方法會在成功時傳回S_OK。 其他可能的值包括下列專案。
傳回碼 | Description |
---|---|
|
表示方法成功完成,並要求 OLE 使用 OLE 提供的預設數據指標來更新數據指標。 |
備註
當您的應用程式偵測到使用者已啟動拖放作業時,它應該呼叫 DoDragDrop 函式。 DoDragDrop 會進入迴圈,當滑鼠第一次進入置放目標視窗時,呼叫 IDropTarget::D ragEnter,當滑鼠變更目標視窗內的位置時,IDropTarget :D::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 |