Compartir a través de


macro TreeView_GetNextItem (commctrl.h)

Recupera el elemento de vista de árbol que lleva la relación especificada con un elemento especificado. Puede usar esta macro, usar una de las macros de TreeView_Get que se describen a continuación o enviar el mensaje TVM_GETNEXTITEM explícitamente.

Sintaxis

void TreeView_GetNextItem(
   hwnd,
   hitem,
   code
);

Parámetros

hwnd

Tipo: HWND

Identificador del control de vista de árbol.

hitem

Tipo: HTREEITEM

Identificador de un elemento.

code

Tipo: UINT

Marca que especifica el elemento que se va a recuperar. Este parámetro puede ser uno de los valores siguientes:

Valor Significado
TVGN_CARET
Recupera el elemento seleccionado actualmente. Puede usar la macro TreeView_GetSelection para enviar este mensaje.
TVGN_CHILD
Recupera el primer elemento secundario del elemento especificado por el parámetro hitem . Puede usar la macro TreeView_GetChild para enviar este mensaje.
TVGN_DROPHILITE
Recupera el elemento que es el destino de una operación de arrastrar y colocar. Puede usar la macro TreeView_GetDropHilight para enviar este mensaje.
TVGN_FIRSTVISIBLE
Recupera el primer elemento visible. Puede usar la macro TreeView_GetFirstVisible para enviar este mensaje.
TVGN_NEXT
Recupera el siguiente elemento relacionado. Puede usar la macro TreeView_GetNextSibling para enviar este mensaje.
TVGN_NEXTSELECTED
Windows Vista y versiones posteriores. Recupera el siguiente elemento seleccionado. Puede usar la macro TreeView_GetNextSelected para enviar este mensaje.
TVGN_NEXTVISIBLE
Recupera el siguiente elemento visible que sigue al elemento especificado. El elemento especificado debe estar visible. Use el mensaje TVM_GETITEMRECT para determinar si un elemento está visible. Puede usar la macro TreeView_GetNextVisible para enviar este mensaje.
TVGN_PARENT
Recupera el elemento primario del elemento de vista de árbol especificado. Puede usar la macro TreeView_GetParent para enviar este mensaje.
TVGN_PREVIOUS
Recupera el elemento relacionado anterior. Puede usar la macro TreeView_GetPrevSibling para enviar este mensaje.
TVGN_PREVIOUSVISIBLE
Recupera el primer elemento visible que precede al elemento especificado. El elemento especificado debe estar visible. Use el mensaje TVM_GETITEMRECT para determinar si un elemento está visible. Puede usar la macro TreeView_GetPrevVisible para enviar este mensaje.
TVGN_ROOT
Recupera el elemento superior o muy primer del control de vista de árbol. Puede usar la macro TreeView_GetRoot para enviar este mensaje.

Valor devuelto

None

Observaciones

Esta macro devolverá NULL si el elemento que se va a recuperar es el nodo raíz del árbol. Por ejemplo, si usa esta macro con la marca TVGN_PARENT en un elemento secundario de primer nivel del nodo raíz de la vista de árbol, la macro devolverá NULL.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado commctrl.h