VTreeItem
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 VTreeItem 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.
Funciones
Generales
Retorno
Función
Number
Number
Boolean
Boolean
Boolean
Boolean
VTreeItem
void
void
void
void
De columna
Retorno
Función
Number
Number
Number
void
void
void
void
void
void
void
void
void
void
String
String
Number
String
String
Child items
Retorno
Función
VTreeItem
Number
VTreeItem
Number
void
Enumeraciones
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
Documentación de funciones
Funciones generales
Number columnCount()
Devuelve el nº de columnas declaradas en el ítem.
Number flags()
Devuelve el valor de los flags configurados para el ítem. Ver enum ItemFlag para conocer todos los valores configurables.
Boolean isExpanded()
Devuelve true si el ítem está expandido y false si está contraído.
Boolean isHidden()
Devuelve true el ítem está oculto y false si está visible.
Boolean isRegisterType()
Devuelve true si es un ítem de la clase VTreeItemRegister y false si es ítem de la clase VTreeItem.
Boolean isSelected()
Devuelve true si el ítem está seleccionado y false en caso contrario.
VTreeItem parentItem()
Devuelve el ítem padre del ítem en curso o nulo si es un top level ítem.
void setExpanded( Boolean expanded )
Se fija si el ítem se expandir (true) o se debe contraer (false).
Parámetros:
expanded: true para expandirlo o false para contraerlo.
void setFlags( Number flags )
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.
void setHidden( Boolean hidden )
Se fija si el ítem debe ocultarse (true) o visualizarse (false).
Parámetros:
hidden: true para ocultar o false para visualizarlo.
void setSelected( Boolean select )
Se fija si el ítem se mostrará seleccionado (true) o no seleccionado (false).
Parámetros:
select: true para seleccionarlo o false para desseleccionarlo.
Funciones de columna
Number backgroundColor( Number column )
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.
Number checkState( Number column )
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.
VFont font( Number column )
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.
Number foregroundColor( Number column )
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.
void setBackgroundColor( Number column, Number r, Number g, Number b, Number a = 255 )
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.
void setCheckState( Number column, Number state )
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.
void setFont( Number column, VFont font )
Fija la fuente de la columna.
Propiedades:
column: número de columna.
font: objeto de la clase VFont que representa a la fuente.
void setForegroundColor( Number column, Number r, Number g, Number b, Number a = 255 )
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.
void setIcon( Number column, VImage image )
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.
void setStatusTip( Number column, String text )
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.
void setText( Number column, String text )
Fija el texto que se mostrará en una columna del ítem.
Parámetros:
column: número de columna del ítem.
text: texto a visualizar.
void setTextAlignment( Number column, Number alignFlags )
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.
void setToolTip( Number column, String text )
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.
void setWhatsThis( Number column, String text )
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.
String statusTip( Number column )
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.
String text( Number column )
Devuelve el texto que contiene una columna del ítem.
Parámetros:
column: número de columna del ítem.
Number textAlignment()
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.
String toolTip( Number column )
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.
String whatsThis( Number column )
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.
Child items
VTreeItem addChild()
Devuelve un nuevo objeto de la clase VTreeItem que se corresponderá con un ítem hijo al ítem actual.
VTreeItemRegister addChildRegister( VRegister reg, VItemRegisterPatern patern )
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.
Number addChildRegisterList( VRegisterList regList, VItemRegisterPatern patern )
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.
VTreeItem child( Number index )
Devuelve un objeto de la clase VTreeItem correspondiente al ítem que ocupa la posición especificada en el parámetro.
Parámetros:
index: número del ítem.
Number childCount()
Devuelve el nº de ítems hijos.
void deleteChild( Number index )
Eliminar el ítem especificado en el parámetro.
Parámetros:
index: número del ítem a eliminar.
Última actualización