Метод IDropSource::GiveFeedback (oleidl.h)
Позволяет исходному приложению предоставлять пользователю визуальную обратную связь во время операции перетаскивания, предоставляя функции DoDragDrop значение перечисления, указывающее визуальный эффект.
Синтаксис
HRESULT GiveFeedback(
[in] DWORD dwEffect
);
Параметры
[in] dwEffect
Значение DROPEFFECT , возвращаемое последним вызовом IDropTarget::D ragEnter, IDropTarget::D ragOver или IDropTarget::D ragLeave.
Возвращаемое значение
Этот метод возвращает значение S_OK при успешном завершении. Ниже перечислены другие возможные значения.
| Код возврата | Описание |
|---|---|
|
Указывает на успешное завершение метода и запрашивает у OLE обновление курсора с помощью курсоров, предоставленных OLE по умолчанию. |
Комментарии
Когда приложение обнаруживает, что пользователь начал операцию перетаскивания, оно должно вызвать функцию DoDragDrop . DoDragDrop входит в цикл, вызывая IDropTarget::D ragEnter , когда мышь впервые входит в целевое окно перетаскивания, IDropTarget::D ragOver , когда мышь изменяет свое положение в целевом окне, и IDropTarget::D ragLeave , когда мышь покидает целевое окно.
Для каждого вызова IDropTarget::D ragEnter или IDropTarget::D ragOverDoDragDrop вызывает 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 |