Usar controles de árbol

El uso típico de un control de árbol (CTreeCtrl) sigue el siguiente patrón:

• El control se crea. Si el control se especifica en una plantilla de cuadro de diálogo o si usa CTreeView, la creación es automática cuando se crea el cuadro de diálogo o la vista. Si desea crear el control de árbol como una ventana secundaria de alguna otra ventana, use la función Crear miembro.

• Si desea que el control de árbol use imágenes, establezca una lista de imágenes llamando a SetImageList. También puede cambiar la sangría si llama a SetIndent. Un buen momento para hacerlo es en OnInitDialog (para controles en cuadros de diálogo) o OnInitialUpdate (para vistas).

• Coloque los datos en el control llamando a la función CTreeCtrl de una vez para cada elemento de datos. InsertItem devuelve un identificador al elemento que puede usar para hacer referencia a él más adelante, como al agregar elementos secundarios. Un buen momento para inicializar los datos está en OnInitDialog (para controles en cuadros de diálogo) o OnInitialUpdate (para vistas).

• A medida que el usuario interactúa con el control, enviará varios mensajes de notificación. Puede especificar una función para controlar cada uno de los mensajes que desea controlar agregando una macro de ON_NOTIFY_REFLECT en el mapa de mensajes de la ventana de control o agregando una macro de ON_NOTIFY al mapa de mensajes de la ventana primaria. Consulte Mensajes de notificación de control de árbol más adelante en este tema para obtener una lista de las posibles notificaciones.

• Llame a las distintas funciones miembro Set para establecer valores para el control. Los cambios que puede realizar incluyen establecer la sangría y cambiar el texto, la imagen o los datos asociados a un elemento.

• Use las diversas funciones Get para examinar el contenido del control. También puede recorrer el contenido del control de árbol con funciones que permiten recuperar identificadores de elementos primarios, secundarios y del mismo nivel de un elemento especificado. Incluso puede ordenar los elementos secundarios de un nodo determinado.

• Cuando haya terminado con el control, debe asegurarse de que se destruya correctamente. Si el control de árbol está en un cuadro de diálogo o es una vista, se destruirán automáticamente el control de árbol y el objeto CTreeCtrl. Si no es así, se debe asegurar de que tanto el control como el objeto CTreeCtrl se destruyan correctamente.

Consulte también

Uso de CTreeCtrl
Mandos