IDropSource::GiveFeedback 方法 (oleidl.h)

通过向 DoDragDrop 函数提供指定视觉效果的枚举值,使源应用程序能够在拖放操作期间向最终用户提供视觉反馈。

语法

HRESULT GiveFeedback(
  [in] DWORD dwEffect
);

参数

[in] dwEffect

最近调用 IDropTarget::D ragEnter、IDropTarget::D ragOver 或 IDropTarget::D ragLeave 返回的DROPEFFECT 值。

返回值

此方法在成功时返回S_OK。 其他可能的值包括以下内容。

返回代码 说明
DRAGDROP_S_USEDEFAULTCURSORS
指示方法的成功完成,并请求 OLE 使用 OLE 提供的默认游标更新游标。

注解

当应用程序检测到用户已启动拖放操作时,它应调用 DoDragDrop 函数。 DoDragDrop 进入循环,当鼠标首次进入放置目标窗口时调用 IDropTarget::D ragEnter ;当鼠标在目标窗口中更改其位置时调用 IDropTarget::D ragOver ;当鼠标离开目标窗口时 ,IDropTarget::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