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

Статья
02/26/2024

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

Синтаксис

void TreeView_SetCheckState(
   hwndTV,
   hti,
   fCheck
);

Параметры

hwndTV

Тип: HWND

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

hti

Тип: HTREEITEM

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

fCheck

Тип: BOOL

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

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

None

Remarks

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

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

Требования

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