Compartir a través de

macro TreeView_GetNextItem (commctrl.h)

  • Artículo

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 descritas a continuación o enviar el mensaje TVM_GETNEXTITEM explícitamente.

Sintaxis

HTREEITEM TreeView_GetNextItem(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      code
);

Parámetros

hwnd

Tipo: HWND

Identificador del control de vista de árbol.

hitem

Tipo: HTREEITEM

Identificador de un elemento.

code

Tipo: UINT de

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

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 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 primero del control de vista de árbol. Puede usar la macro TreeView_GetRoot para enviar este mensaje.

Valor devuelto

Tipo: HTREEITEM

Devuelve el identificador al elemento si se ejecuta correctamente. En la mayoría de los casos, el mensaje devuelve un valor NULL para indicar un error. Consulte la sección Comentarios para obtener más información.

Observaciones

Esta macro devolverá NULL si el elemento que se recupera 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 Valor
cliente mínimo admitido Windows Vista [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de commctrl.h