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