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


сообщение 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