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

BOOL TreeView_Expand(
   HWND      hwnd,
   HTREEITEM hitem,
   UINT      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 de

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

Valor devuelto

Tipo: BOOL de

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

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 mensaje de TVM_EXPAND expande por primera vez un elemento, 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 notificaciones TVN_ITEMEXPANDING ni TVN_ITEMEXPANDED. 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 impredecible.

Es posible que se produzca un error en la operación de expansión si el propietario del control treeview deniega la operación en respuesta a una notificación de TVN_ITEMEXPANDING.

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