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

Статья
10/24/2024

Задает для образа состояния элемента значение "checked" или "unchecked". Вы также можете напрямую использовать сообщение TVM_SETITEM.

Синтаксис

UINT TreeView_SetCheckState(
   HWND      hwndTV,
   HTREEITEM hti,
   BOOL      fCheck
);

Параметры

hwndTV

Тип: HWND

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

hti

Тип: HTREEITEM

Дескриптор элемента.

fCheck

Тип: BOOL

Значение, указывающее, какое изображение состояния отображается. Установите для fCheck значение TRUE, чтобы отобразить проверенное изображение состояния или FALSE, чтобы отобразить снятое изображение.

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

Тип: UINT

Возвращаемое значение не используется.

Замечания

Элемент управления "Представление дерева" может содержать два списка изображений. Обычный список изображений сохраняет выбранные, неизбираемые и наложенные изображения. Флажки хранятся в списке изображений состояния и отображаются слева от соответствующего обычного изображения. Изображения состояния задаются одним индексом. Индекс нуля указывает на отсутствие образа состояния. Сведения о том, как обрабатывать изображения в виде дерева, см. в списков изображений Tree-View.

Если вы хотите определить собственные образы состояния, этот макрос предполагает, что проверенные и снятые изображения имеют те же индексы, что и стандартный список изображений: 1 для отмены и 2 для проверки.

Требования

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

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