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

Статья
10/24/2024

Извлекает некоторые или все атрибуты элемента представления дерева. Этот макрос можно использовать или явно отправить сообщение TVM_GETITEM.

Синтаксис

BOOL TreeView_GetItem(
   HWND     hwnd,
   LPTVITEM pitem
);

Параметры

hwnd

Тип: HWND

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

pitem

Тип: LPTVITEM

Указатель на структуру TVITEM, указывающую сведения для получения и получения сведений об элементе. С версии 4.71 и более поздних версий вместо этого можно использовать структуру TVITEMEX.

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

Тип: BOOL

Возвращает TRUE, если выполнено успешно или FALSE в противном случае.

Замечания

Когда отправляется сообщение TVM_GETITEM, hItem член TVITEM или tvITEMEX определяет элемент для получения сведений, а элемент маски указывает атрибуты для извлечения.

Если флаг TVIF_TEXT задан в маске члена TVITEM или tvITEMEX, элемент pszText должен указывать на допустимый буфер, а элемент cchTextMax должен иметь число символов в этом буфере. Возвращаемый текст не обязательно будет храниться в исходном буфере, переданном приложением. Возможно, pszText указывает на текст в новом буфере, а не помещается в старый буфер.

Требования

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

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