CTreeCtrl::GetNextItem

Статья
02/20/2013

Эта функция вызывается для получения элемент представления в виде дерева, в котором имеется заданное отношение, обозначенный параметром nCode, в hItem.

HTREEITEM GetNextItem(
   HTREEITEM hItem,
   UINT nCode 
) const;

Параметры

hItem
Дескриптор элемента дерева.
nCode
Пометить, указывающий тип ссылки на hItem.Этот пометить может принимать одно из следующих значений:
- TVGN_CARET извлекает выбранный элемент.
- TVGN_CHILD получает первый дочерний элемент элемента, определяемого параметром hItem.
- TVGN_DROPHILITE извлекает элемент, который является целевым объектом операции перетаскивания.
- TVGN_FIRSTVISIBLE извлекает первый видимый элемент.
- Разрезанная TVGN_LASTVISIBLE извлекает последний элемент в дереве.Это не извлекает последний элемент, видимый в окне представления в виде дерева.
- TVGN_NEXT извлекает следующий одноуровневый элемент.
- TVGN_NEXTVISIBLE извлекает следующий видимый элемент, который следует за заданным элементом.
- TVGN_PARENT возвращает родительский элемент указанного элемента.
- TVGN_PREVIOUS извлекает предыдущий элемент того же уровня.
- TVGN_PREVIOUSVISIBLE извлекает первый видимый элемент, который предшествует указанный элемент.
- TVGN_ROOT получает первый дочерний элемент корневого элемента что указанный элемент является частью.

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

Дескриптор следующего элемента, если успешно; в противном случае NULL.

Заметки

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

Пример

Пример использования GetNextItem в цикле см. в разделе CTreeCtrl::DeleteItem.

// find the currently selected item
HTREEITEM hCurSel = m_TreeCtrl.GetNextItem(TVI_ROOT, TVGN_CARET);

// report it to the user
if (hCurSel == NULL)
{
   AfxMessageBox(_T("There is no selected item"));
}
else
{
   CString str;
   str.Format(_T("The currently selected item is \"%s\""),
      (LPCTSTR)m_TreeCtrl.GetItemText(hCurSel));
   AfxMessageBox((LPCTSTR)str);
}