макрос TreeView_CreateDragImage (commctrl.h)

Статья
10/24/2024

Создает растровое изображение перетаскивания для указанного элемента в элементе управления "Представление дерева". Макрос также создает список изображений для растрового изображения и добавляет растровое изображение в список изображений. Приложение может отображать изображение при перетаскивании элемента с помощью функций списка изображений. Этот макрос можно использовать или явно отправить сообщение TVM_CREATEDRAGIMAGE.

Синтаксис

HIMAGELIST TreeView_CreateDragImage(
   HWND      hwnd,
   HTREEITEM hitem
);

Параметры

hwnd

Тип: HWND

Обработка элемента управления "Дерево- представление".

hitem

Тип: HTREEITEM

Дескриптор элемента, получающего новое перетаскивание растрового изображения.

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

Тип: HIMAGELIST

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

Замечания

Если вы создаете элемент управления "Представление дерева" без связанного списка изображений, вы не можете использовать макрос TreeView_CreateDragImage для создания изображения для отображения во время операции перетаскивания. Необходимо реализовать собственный метод создания курсора перетаскивания.

Ваше приложение отвечает за уничтожение списка изображений, если он больше не нужен.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	commctrl.h

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