VTreeItem
Última actualización
Última actualización
Heredado por: VTreeItemRegister
Esta clase es usada para gestionar cada una de los ítems que forman un control de la clase VTreeWidget.
Cada ítem puede contener una o varias columnas de datos en la que podemos incluir textos, etiquetas y un icono.
Los ítems se construyen con un padre que se corresponde con un ítem de primer nivel en el objeto de la clase VTreeWidget u otro ítem de la clase VTreeWidgetItem de nivel superior.
Cada columna en un ítem puede tener su propio color de fondo fijado con la función setBackgroundColor() y su color de texto fijado con la función setForegroundColor().
La principal diferencia entre los ítems de nivel principal y el resto de ítems inferiores del árbol es que los ítems de nivel superior o principal no tiene ítem padre, esta información puede ser útil a la hora de insertar o borrar ítems del árbol. Los ítem hijos pueden ser eliminados con la función deleteChild() o añadidos con la función addChild().
Cada ítem, por defecto es seleccionable, activable, etc. Esta configuración en el ítem se realiza a través de flags que pueden ser alterados con la función setFlags() aplicando los valores que se encuentran en el enum ItemFlag de esta clase.
Esta clase se ha incorporado al API en la versión 7.16.
Generales
De columna
Child items
Flags de alineamiento
AlignLeft = 0x0001
AlignRight = 0x0002
AlignHCenter = 0x0004
AlignJustify = 0x0008
AlignAbsolute = 0x0010
AlignTop = 0x0020
AlignBottom = 0x0040
AlignVCenter = 0x0080
AlignCenter = AlignVCenter | AlignHCenter
ItemFlag
0 = No tiene fijada ninguna propiedad
1 = Puede ser seleccionado
2 = Puede ser editado
16 = Puede ser marcado o desmarcado por el usuario
32 = El usuario puede interactuar con el ítem
64 = El ítem se puede marcar con 3 estados independientes
Devuelve el nº de columnas declaradas en el ítem.
Devuelve el valor de los flags configurados para el ítem. Ver enum ItemFlag para conocer todos los valores configurables.
Devuelve true si el ítem está expandido y false si está contraído.
Devuelve true el ítem está oculto y false si está visible.
Devuelve true si es un ítem de la clase VTreeItemRegister y false si es ítem de la clase VTreeItem.
Esta clase se ha incorporado al API en la versión 7.17.
Devuelve true si el ítem está seleccionado y false en caso contrario.
Devuelve el ítem padre del ítem en curso o nulo si es un top level ítem.
Esta clase se ha incorporado al API en la versión 7.17.
Se fija si el ítem se expandir (true) o se debe contraer (false).
Parámetros:
expanded: true para expandirlo o false para contraerlo.
Permite configurar diferentes valores del ítem como si es seleccionable, editable, arrastrable, etc. Ver enum ItemFlag para conocer todos los valores configurables.
Parámetros:
flags: valor numérico que combina los valores del enum ItemFlag.
Se fija si el ítem debe ocultarse (true) o visualizarse (false).
Parámetros:
hidden: true para ocultar o false para visualizarlo.
Se fija si el ítem se mostrará seleccionado (true) o no seleccionado (false).
Parámetros:
select: true para seleccionarlo o false para desseleccionarlo.
Devuelve el valor numérico que se corresponde con la representación decimal del valor hexadecimal de un color en formato RGBA.
Parámetros:
column: número de columna del ítem.
Devuelve el check de estado de la columna especificada en el parámetro del ítem en curso.
Parámetros:
column: número de la columna.
Obtiene un objeto de la clase VFont con las características de la fuente de la columna especificada en el parámetro.
Parámetros:
column: número de columna.
Esta clase se ha incorporado al API en la versión 7.17.
Devuelve el valor numérico que se corresponde con la representación decimal del valor hexadecimal de un color en formato RGBA.
Parámetros:
column: número de columna del ítem.
Fija el color de fondo de una columna del ítem pasándole por separado los colores del formato RGBA del color de fondo.
Parámetros:
column: número de columna del ítem.
r: número que se corresponde con la representación decimal del color rojo.
g: número que se corresponde con la representación decimal del color verde.
b: número que se corresponde con la representación decimal del color azul.
a: número que se corresponde con la representación decimal del canal alfa o transparencia.
Fija el estado de una columna del ítem en curso.
Parámetros:
column: número de la columna.
state: número que se corresponde con el valor del estado de la columna.
Fija la fuente de la columna.
Propiedades:
column: número de columna.
font: objeto de la clase VFont que representa a la fuente.
Esta clase se ha incorporado al API en la versión 7.17.
Fija el color del texto de una columna del ítem pasándole por separado los colores del formato RGBA del color de fondo.
Parámetros:
column: número de columna del ítem.
r: número que se corresponde con la representación decimal del color rojo.
g: número que se corresponde con la representación decimal del color verde.
b: número que se corresponde con la representación decimal del color azul.
a: número que se corresponde con la representación decimal del canal alfa o transparencia.
Fija el icono que se mostrará en una columna del ítem.
Parámetros:
column: número de columna del ítem.
image: objeto de la clase VImage que contiene el icono a visualizar.
Fija el texto que se mostrará en la barra de estado cuando se pone el ratón encima de la columna del ítem.
Parámetros:
column: número de columna del ítem.
text: texto a visualizar en la barra de estado de la ventana.
Fija el texto que se mostrará en una columna del ítem.
Parámetros:
column: número de columna del ítem.
text: texto a visualizar.
Configura la alineación de los textos en una columna del ítem en curso.
Parámetros:
column: número de la columna del ítem.
alignFlags: número de el valor de los flags de alineamiento. Ver enum de flags de alineamiento.
Fija el texto que se mostrará en el tooltip cuando se ponga el ratón encima de una columna del ítem.
Parámetros:
column: número de columna del ítem.
text: texto a visualizar en el tooltip.
Fija el texto que se mostrará en la ventana de ayuda cuando se pone el ratón encima de la columna del ítem y está activado el modo "What's this?".
Parámetros:
column: número de columna del ítem.
text: texto a visualizar en la ventana de ayuda.
Devuelve el texto a visualizar en la barra de estado cuando se sitúa el ratón encima de una columna del ítem.
Parámetros:
column: número de columna del ítem.
Devuelve el texto que contiene una columna del ítem.
Parámetros:
column: número de columna del ítem.
Devuelve un número que se corresponde con el valor de alineamiento de texto del ítem y columna en curso, ver enum flags de alineamiento.
Devuelve el texto a visualizar en el tooltip cuando se sitúa el ratón encima de una columna del ítem.
Parámetros:
column: número de columna del ítem.
Devuelve el texto a visualizar en la ventana de ayuda cuando se sitúa el ratón encima de una columna del ítem y está activado el modo "What's this?".
Parámetros:
column: número de columna del ítem.
Devuelve un nuevo objeto de la clase VTreeWidgetItem que se corresponderá con un ítem hijo al ítem actual.
Añade al control un ítem hijo del ítem en curso con el registro y patrón especificados en los parámetros y devuelve un objeto de la clase VTreeItemRegister con el ítem creado.
Parámetros:
reg: registro, objeto de la clase VRegister.
patern: patrón, objeto de la clase VItemRegisterPatern.
Esta clase se ha incorporado al API en la versión 7.17.
Añade al control un grupo de ítems hijos del ítem en curso con la lista de registros y patrón especificados en los parámetros y devuelve el número de ítems creados.
Parámetros:
regList: registro, objeto de la clase VRegisterList.
patern: patrón, objeto de la clase VItemRegisterPatern.
Esta clase se ha incorporado al API en la versión 7.17.
Devuelve un objeto de la clase VTreeWidgetItem correspondiente al ítem que ocupa la posición especificada en el parámetro.
Parámetros:
index: número del ítem.
Devuelve el nº de ítems hijos.
Eliminar el ítem especificado en el parámetro.
Parámetros:
index: número del ítem a eliminar.