Compartir a través de


mensaje de TVM_GETNEXTITEM

Recupera el elemento de vista de árbol que lleva la relación especificada con un elemento especificado. Puede enviar este mensaje explícitamente mediante la macro TreeView_GetNextItem .

Parámetros

wParam

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 que está visible en la ventana de vista de árbol. Puede usar la macro TreeView_GetFirstVisible para enviar este mensaje.
TVGN_LASTVISIBLE
Versión 4.71. Recupera el último elemento expandido del árbol. Esto no recupera el último elemento visible en la ventana de vista de árbol. Puede usar la macro TreeView_GetLastVisible 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 primero del control de vista de árbol. Puede usar la macro TreeView_GetRoot para enviar este mensaje.

lParam

Identificador de un elemento.

Valor devuelto

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. Para obtener información detallada, consulte la sección Comentarios.

Comentarios

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

También puede usar una de estas macros relacionadas:

TreeView_GetChild
TreeView_GetDropHilight
TreeView_GetFirstVisible
TreeView_GetLastVisible
TreeView_GetNextSibling
TreeView_GetNextVisible
TreeView_GetParent
TreeView_GetPrevSibling
TreeView_GetPrevVisible
TreeView_GetRoot
TreeView_GetSelection

Requisitos

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