Compartir a través de


Elementos primarios y secundarios del control de árbol

Cualquier elemento de un control de árbol (CTreeCtrl) puede tener una lista de subelementos, que se llaman elementos secundarios, asociado.Un elemento que tiene uno o más elementos secundarios se denomina elemento primario.Un elemento secundario se muestra debajo de su elemento primario y se aplica sangría para indicar que es subordinado al elemento primario.Un elemento que no tiene ningún elemento primario está en la parte superior de la jerarquía y se denomina elemento raíz.

En un momento dado, el estado de la lista de un elemento primario de elementos secundarios puede ser expandida o contraer.Cuando expanda el estado, los elementos secundarios se muestran debajo del elemento primario.Cuando se contrae, los elementos secundarios no se muestran.En la lista alterna automáticamente entre estados expandidos y contraídas cuando el usuario hace doble clic en el elemento primario o, si el elemento primario tiene el estilo de TVS_HASBUTTONS , cuando el usuario hace clic en el botón asociado con el elemento primario.Una aplicación puede expandir o contraer elementos secundarios mediante el miembro de Expandir funcione.

Agrega un elemento a un control de árbol llamando a la función miembro de InsertItem .Esta función devuelve un identificador del tipo de HTREEITEM , que identifica el elemento.Al agregar un elemento, debe especificar el identificador del elemento primario del nuevo elemento.Si especifica NULL o el valor de TVI_ROOT en lugar de un identificador de elemento primario en la estructura de TVINSERTSTRUCT o el parámetro de hParent , se agrega como elemento raíz.

Un control de árbol envía un mensaje de notificación de TVN_ITEMEXPANDING cuando la lista de un elemento primario de elementos secundarios está a punto de ser expandida o contraer.La notificación ofrece la oportunidad de evitar el cambio o establecer los atributos del elemento primario que depende del estado de la lista de elementos secundarios.Después de cambiar el estado de la lista, el control de árbol envía un mensaje de notificación de TVN_ITEMEXPANDED .

Cuando se expande una lista de elementos secundarios, se aplica sangría con relación al elemento primario.Puede establecer la cantidad de sangría utilizando la función miembro de SetIndent o recuperar cantidad actual utilizando la función miembro de GetIndent .

Vea también

Referencia

Mediante CTreeCtrl

Conceptos

Controles (MFC)