> For the complete documentation index, see [llms.txt](https://doc.velneo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.velneo.com/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md).
# VTreeItem
**Heredado por:** [VTreeItemRegister](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitemregister.md)
Esta clase es usada para gestionar cada una de los ítems que forman un control de la clase [VTreeWidget](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreewidget.md).
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](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreewidget.md) 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 | [columnCount](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#columncount)() |
| Number | [flags](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#flags)() |
| Boolean | [isExpanded](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#isexpanded)() |
| Boolean | [isHidden](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#ishidden)() |
| Boolean | [isRegisterType](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#isregistertype)() |
| Boolean | [isSelected](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#isselected)() |
| VTreeItem | [parentItem](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#parentitem)() |
| void | [setExpanded](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#setexpanded)( Boolean expanded ) |
| void | [setFlags](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#setflags)( Number flags ) |
| void | [setHidden](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#sethidden)( Boolean hidden ) |
| void | [setSelected](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#setselected)( Boolean select ) |
**De columna**
| Retorno | Función |
| ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Number | [backgroundColor](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#backgroundcolor)( Number column ) |
| Number | [checkState](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#checkstate)( Number column ) |
| [VFont](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vfont.md) | [font](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#font)( Number column ) |
| Number | [foregroundColor](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#foregroundcolor)( Number column ) |
| void | [setBackgroundColor](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#setbackgroundcolor)( Number column, Number r, Number g, Number b, Number a = 255 ) |
| void | [setCheckState](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#setcheckstate)( Number column, Number state ) |
| void | [setFont](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#setfont)( Number column, VFont font ) |
| void | [setForegroundColor](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#setforegroundcolor)( Number column, Number r, Number g, Number b, Number a = 255 ) |
| void | [setIcon](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#seticon)( Number column, VImage image ) |
| void | [setStatusTip](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#setstatustip)( Number column, String text ) |
| void | [setText](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#settext)( Number column, String text ) |
| void | [setTextAlignment](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#settextalignment)( Number column, Number alignFlags ) |
| void | [setToolTip](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#settooltip)( Number column, String text ) |
| void | [setWhatsThis](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#setwhatsthis)( Number column, String text ) |
| String | [statusTip](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#statustip)( Number column ) |
| String | [text](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#text)( Number column ) |
| Number | [textAlignment](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#textalignment)() |
| String | [toolTip](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#tooltip)( Number column ) |
| String | [whatsThis](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#whatsthis)( Number column ) |
**Child items**
| Retorno | Función |
| ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| VTreeItem | [addChild](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#addchild)() |
| [VTreeItemRegister](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitemregister.md) | [addChildRegister](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#addchildregister)( VRegister reg, VItemRegisterPatern patern ) |
| Number | [addChildRegisterList](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#addchildregisterlist)( VRegisterList regList, VItemRegisterPatern patern ) |
| VTreeItem | [child](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#child)( Number index ) |
| Number | [childCount](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#childcount)() |
| void | [deleteChild](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitem.md#deletechild)( Number index ) |
## 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](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitemregister.md) 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](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vfont.md) 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](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vfont.md) 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 ](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vimage.md)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](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vtreeitemregister.md) con el ítem creado.
Parámetros:
* reg: registro, objeto de la clase [VRegister](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vregister.md).
* 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](/28/velneo-vdevelop/scripts/lenguajes/javascript/clases/vregisterlist.md).
* 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.