macro TreeView_Expand (commctrl.h)

La macro TreeView_Expand expande o contrae la lista de elementos secundarios asociados al elemento primario especificado, si existe. Puede usar esta macro o enviar el mensaje TVM_EXPAND explícitamente.

Sintaxis

void TreeView_Expand(
   hwnd,
   hitem,
   code
);

Parámetros

hwnd

Tipo: HWND

Identificador de un control de vista de árbol.

hitem

Tipo: HTREEITEM

Identificador del elemento primario que se expandirá o contraerá.

code

Tipo: UINT

Marca de acción. Para obtener una lista de los valores posibles, vea la descripción del parámetro flag en TVM_EXPAND.

Valor devuelto

None

Observaciones

Expandir un nodo que ya está expandido o contraer un nodo que ya está contraído se considera una operación correcta y la macro devuelve un valor distinto de cero. Si se intenta expandir o contraer un nodo que no tiene elementos secundarios, se considera un error y el valor devuelto es 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]
Plataforma de destino	Windows
Encabezado	commctrl.h