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

  • Статья

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

Синтаксис

void TreeView_GetNextItem(
   hwnd,
   hitem,
   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 .

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

None

Remarks

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

Требования

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