Share via

Метод IImageList::GetDragImage (commoncontrols.h)

  • Статья

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

Синтаксис

HRESULT GetDragImage(
  [out] POINT  *ppt,
  [out] POINT  *pptHotspot,
  [out] REFIID riid,
  [out] void   **ppv
);

Параметры

[out] ppt

Тип: POINT*

Указатель на структуру POINT , которая получает текущую позицию перетаскивания. Может иметь значение NULL.

[out] pptHotspot

Тип: POINT*

Указатель на структуру POINT , которая получает смещение перетаскиваемого изображения относительно позиции перетаскивания. Может иметь значение NULL.

[out] riid

Тип: REFIID

Идентификатор IID для списка изображений.

[out] ppv

Тип: PVOID*

Адрес указателя на интерфейс списка изображений в случае успешного выполнения, в противном случае — NULL .

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Список временных образов удаляется при вызове IImageList::EndDrag . Чтобы начать операцию перетаскивания, используйте IImageList::BeginDrag.

Чтобы использовать IImageList::GetDragImage, укажите в манифесте Comctl32.dll версии 6. Дополнительные сведения о манифестах см. в разделе Включение визуальных стилей.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header commoncontrols.h
DLL Comctl32.dll (версия 6.0 или более поздняя)