Метод IDropSource::GiveFeedback (oleidl.h)

Статья
08/25/2023

Позволяет исходному приложению предоставлять пользователю визуальную обратную связь во время операции перетаскивания, предоставляя функции DoDragDrop значение перечисления, указывающее визуальный эффект.

Синтаксис

HRESULT GiveFeedback(
  [in] DWORD dwEffect
);

Параметры

[in] dwEffect

Значение DROPEFFECT , возвращаемое последним вызовом IDropTarget::D ragEnter, IDropTarget::D ragOver или IDropTarget::D ragLeave.

Возвращаемое значение

Этот метод возвращает значение 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 и передает значение DROPEFFECT_NONE в параметре dwEffect .

Параметр dwEffect может включать DROPEFFECT_SCROLL, указывая, что источник должен разместить вариант перетаскивания прокрутки соответствующего указателя.

Примечания для разработчиков

Эта функция часто вызывается во время цикла DoDragDrop , поэтому вы можете получить преимущества производительности, если максимально оптимизировать реализацию.

IDropSource::GiveFeedback отвечает за изменение фигуры курсора или за изменение выделенного источника на основе значения параметра dwEffect . Если вы используете курсоры по умолчанию, можно вернуть DRAGDROP_S_USEDEFAULTCURSORS, что приводит к тому, что OLE обновляет курсор, используя его значения по умолчанию.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	oleidl.h

См. также раздел

Dodragdrop

IDropSource

IDropTarget

Поделиться через