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

Статья
10/24/2024

Извлекает элемент представления дерева, который несет указанную связь с указанным элементом. Этот макрос можно использовать, использовать один из макросов TreeView_Get, описанных ниже, или явно отправить сообщение TVM_GETNEXTITEM.

Синтаксис

HTREEITEM TreeView_GetNextItem(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

Параметры

hwnd

Тип: HWND

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

hitem

Тип: HTREEITEM

Обработка элемента.

code

Тип: UINT

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

Ценность	Значение
TVGN_CARET	Извлекает выбранный в данный момент элемент. Для отправки этого сообщения можно использовать макрос TreeView_GetSelection.
TVGN_CHILD	Извлекает первый дочерний элемент элемента, указанного параметром hitem. Для отправки этого сообщения можно использовать макрос TreeView_GetChild.
TVGN_DROPHILITE	Извлекает элемент, который является целью операции перетаскивания. Для отправки этого сообщения можно использовать макрос TreeView_GetDropHilight.
TVGN_FIRSTVISIBLE	Извлекает первый видимый элемент. Для отправки этого сообщения можно использовать макрос TreeView_GetFirstVisible.
TVGN_NEXT	Извлекает следующий элемент с братом. Для отправки этого сообщения можно использовать макрос TreeView_GetNextSibling.
TVGN_NEXTSELECTED	Windows Vista и более поздние версии. Извлекает следующий выбранный элемент. Для отправки этого сообщения можно использовать макрос TreeView_GetNextSelected.
TVGN_NEXTVISIBLE	Извлекает следующий видимый элемент, который следует указанному элементу. Указанный элемент должен быть видимым. Используйте сообщение TVM_GETITEMRECT, чтобы определить, отображается ли элемент. Для отправки этого сообщения можно использовать макрос TreeView_GetNextVisible.
TVGN_PARENT	Извлекает родительский элемент указанного элемента. Для отправки этого сообщения можно использовать макрос TreeView_GetParent.
TVGN_PREVIOUS	Извлекает предыдущий элемент с братом. Для отправки этого сообщения можно использовать макрос TreeView_GetPrevSibling.
TVGN_PREVIOUSVISIBLE	Извлекает первый видимый элемент, предшествующий указанному элементу. Указанный элемент должен быть видимым. Используйте сообщение TVM_GETITEMRECT, чтобы определить, отображается ли элемент. Для отправки этого сообщения можно использовать макрос TreeView_GetPrevVisible.
TVGN_ROOT	Извлекает самый верхний или очень первый элемент элемента элемента управления "Представление дерева". Для отправки этого сообщения можно использовать макрос TreeView_GetRoot.

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

Тип: HTREEITEM

Возвращает дескриптор элементу в случае успешного выполнения. В большинстве случаев сообщение возвращает значение NULL для указания ошибки. Дополнительные сведения см. в разделе "Примечания".

Замечания

Этот макрос вернет NULL, если извлекаемый элемент является корневым узлом дерева. Например, если вы используете этот макрос с флагом TVGN_PARENT на корневом узле представления дерева первого уровня, макрос вернет NULL.

Требования

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

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