CTreeCtrl::GetNextItem

Artículo
02/19/2013

Llame a esta función para recuperar el elemento de vista de árbol con la relación especificada, indicado por el parámetro de nCode , a hItem.

HTREEITEM GetNextItem(
   HTREEITEM hItem,
   UINT nCode 
) const;

Parámetros

hItem
Identificador de un elemento de árbol.
nCode
Una marca que indica el tipo de relación a hItem.Este marcador puede ser uno de los siguientes valores:
- TVGN_CARET recupera el elemento actualmente seleccionado.
- TVGN_CHILD recupera el primer elemento secundario del elemento especificado por el parámetro de hItem .
- TVGN_DROPHILITE recupera el elemento de destino de una operación de arrastrar y colocar.
- TVGN_FIRSTVISIBLE recupera el primer elemento visible.
- TVGN_LASTVISIBLE recupera el elemento expandido pasado en el árbol.Esto no recupera el último elemento visible en la ventana de la vista de árbol.
- TVGN_NEXT recupera el siguiente elemento relacionado.
- TVGN_NEXTVISIBLE recupera el elemento visible siguiente después del elemento especificado.
- TVGN_PARENT recupera el elemento primario del elemento especificado.
- TVGN_PREVIOUS recupera el elemento relacionado anterior.
- TVGN_PREVIOUSVISIBLE recupera el primer elemento visible que precede al elemento especificado.
- TVGN_ROOT recupera el primer elemento secundario del elemento raíz del elemento especificado forma parte.

Valor devuelto

El identificador del siguiente elemento si correctamente; si no NULL.

Comentarios

Esta función devolverá NULL si el elemento que se está recuperando es el nodo raíz del árbol.Por ejemplo, si utiliza este mensaje con TVGN_PARENT marca en un elemento secundario del primer nodo raíz de la vista de árbol, el mensaje devolverá NULL.

Ejemplo

Para obtener un ejemplo de GetNextItem using en un bucle, vea 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);
}