mensaje de TVM_EXPAND

El mensaje TVM_EXPAND expande o contrae la lista de elementos secundarios asociados al elemento primario especificado, si existe. Puede enviar este mensaje explícitamente o mediante la macro TreeView_Expand .

Parámetros

wParam

Marca de acción. Este parámetro puede ser uno o más de los siguientes valores:

Value	Significado
TVE_COLLAPSE	Contrae la lista.
TVE_COLLAPSERESET	Contrae la lista y quita los elementos secundarios. Se restablece la marca de estado TVIS_EXPANDEDONCE . Esta marca debe usarse con la marca TVE_COLLAPSE.
TVE_EXPAND	Expande la lista.
TVE_EXPANDPARTIAL	Versión 4.70. Expande parcialmente la lista. En este estado, los elementos secundarios están visibles y se muestra el signo más del elemento primario (+), que indica que se puede expandir. Esta marca debe usarse en combinación con la marca de TVE_EXPAND.
TVE_TOGGLE	Contrae la lista si se expande o la expande si está contraída.

lParam

Identificador del elemento primario para expandir o contraer.

Valor devuelto

Devuelve un valor distinto de cero si la operación se realizó correctamente o cero de lo contrario.

Observaciones

La expansión de un nodo que ya está expandido se considera una operación correcta y SendMessage devuelve un valor distinto de cero. Contraer un nodo devuelve cero si el nodo ya está contraído; de lo contrario, devuelve un valor distinto de cero. Si se intenta expandir o contraer un nodo que no tiene elementos secundarios, se considera un error y SendMessage devuelve cero.

Cuando un elemento se expande por primera vez mediante un mensaje de TVM_EXPAND , la acción genera TVN_ITEMEXPANDING y TVN_ITEMEXPANDED códigos de notificación y se establece la marca de estado TVIS_EXPANDEDONCE del elemento. Siempre que esta marca de estado permanezca establecida, los mensajes de TVM_EXPAND posteriores no generan TVN_ITEMEXPANDING ni TVN_ITEMEXPANDED notificaciones. Para restablecer la marca de estado de TVIS_EXPANDEDONCE , debe enviar un mensaje de TVM_EXPAND con las marcas TVE_COLLAPSE y TVE_COLLAPSERESET establecidas. Si se intenta establecer explícitamente TVIS_EXPANDEDONCE , se producirá un comportamiento imprevisible.

La operación de expansión puede producir un error si el propietario del control treeview deniega la operación en respuesta a una notificación de TVN_ITEMEXPANDING .

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