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 |