сообщение TVM_GETNEXTITEM

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

Параметры

wParam

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

Значение	Значение
TVGN_CARET	Извлекает выбранный элемент. Для отправки этого сообщения можно использовать макрос TreeView_GetSelection .
TVGN_CHILD	Извлекает первый дочерний элемент элемента, указанного параметром hitem . Для отправки этого сообщения можно использовать макрос TreeView_GetChild .
TVGN_DROPHILITE	Извлекает элемент, который является целевым объектом операции перетаскивания. Для отправки этого сообщения можно использовать макрос TreeView_GetDropHilight .
TVGN_FIRSTVISIBLE	Извлекает первый элемент, отображаемый в окне представления в виде дерева. Для отправки этого сообщения можно использовать макрос TreeView_GetFirstVisible .
TVGN_LASTVISIBLE	Версия 4.71. Извлекает последний развернутый элемент в дереве. При этом не извлекается последний элемент, видимый в окне представления в виде дерева. Для отправки этого сообщения можно использовать макрос TreeView_GetLastVisible .
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 .

lParam

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

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

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

Комментарии

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

Вы также можете использовать один из следующих связанных макросов:

TreeView_GetChild
TreeView_GetDropHilight
TreeView_GetFirstVisible
TreeView_GetLastVisible
TreeView_GetNextSibling
TreeView_GetNextVisible
TreeView_GetParent
TreeView_GetPrevSibling
TreeView_GetPrevVisible
TreeView_GetRoot
TreeView_GetSelection

Требования

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