VItemRegisterPattern

Con esta clase podemos configurar el patrón a aplicar al control TreeWidget.

En el patrón disponemos de funciones para configurar las columnas, formularios de alta, baja y modificación, los colores, fuentes y alineaciones a aplicar a los nodos del árbol añadidos a través del patrón.

Esta clase se ha incorporado al API en la versión 7.17.

Funciones

Generales

Retorno

Función

Number

Boolean

Boolean

void

Boolean

Boolean

De columnas

Retorno

Función

Number

Number

Number

String

String

void

void

void

void

void

void

void

void

void

Number

Patrones hijos

Retorno

Función

void

VItemRegisterPattern

Number

Enumeraciones

Flags de alineamiento

  • AlignLeft = 0x0001

  • AlignLeft = 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

  • 4 = Puede ser arrastrado

  • 8 = Puede ser usado como destino de un drop

  • 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 flags()

Devuelve el valor de los flags configurados para el ítem. Ver enum ItemFlag para conocer todos los valores configurables.

Boolean setDeleteForm( String idRefForm )

Establece el formulario de baja para el control TreeWidget para los ítem generados con el patrón.

Parámetros:

  • idRefForm: idRef del formulario de baja.

Boolean setEditForm( String idRefForm )

Establece el formulario de edición/modificación para el control TreeWidget para los ítem generados con el patrón.

Parámetros:

  • idRefForm: idRef del formulario de edición/modificación.

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.

Boolean setNewRecordForm( String idRefForm )

Establece el formulario de alta para el control TreeWidget para los ítem generados con el patrón.

Parámetros:

  • idRefForm: idRef del formulario de alta.

Boolean setTable( String idRefTable )

Establece la tabla a usar en el patrón para el control TreeWidget.

Parámetros:

  • idRefTable: idRef de la tabla.

Funciones de columnas

Number backgroundColor( Number column )

Devuelve un número que se corresponde con el color de fondo de una columna.

Parámetros:

  • column: número de columna (la primera es la 0).

Number columnCount()

Devuelve el nº de columnas que tiene el ítem en curso en el control TreeWidget.

VFont font( Number column )

Devuelve un objeto de la VFont con la fuente establecida para la columna especificada.

Parámetros:

  • columna: número de columna (la primera es la 0).

Number foregroundColor( Number column )

Devuelve un número que se corresponde con el color de texto de una columna.

Parámetros:

  • column: número de columna (la primera es la 0).

VImage icon( Number column )

Devuelve un objeto de la clase VImage con el icono que se visualiza en una columna del ítem.

Parámetros:

  • column: número de columna (la primera es la 0).

String idFieldIcon( Number column)

Devuelve el identificador del campo que contiene el icono que se visualiza en la columna.

Parámetros:

  • column: número de columna (la primera es la 0).

String idFieldText( Number column)

Devuelve el identificador del campo que contiene el contenido/texto que se visualiza en la columna.

Parámetros:

  • column: número de columna (la primera es la 0).

void setBackgroundColor( Number column, Number rgbaColor )

Fija el color de fondo de una columna del ítem pasándole un número que representa el valor RGBA de color.

Parámetros:

  • column: número de columna del ítem.

  • rgbaColor: número que se corresponde con la representación decimal del valor hexadecimal de un color en formato RGBA.

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 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.

Esta clase se ha incorporado al API en la versión 7.17.

void setForegroundColor( Number column, Number rgbaColor )

Fija el color del texto de una columna del ítem pasándole un número que representa el valor RGBA de color.

Parámetros:

  • column: número de columna del ítem.

  • rgbaColor: número que se corresponde con la representación decimal del valor hexadecimal de un color en formato RGBA.

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 setIdFieldIcon( Number column, String idCampo )

Fija el campo que se usará para mostrar el icono en la columna.

Parámetros:

  • column: número de columna del ítem.

  • idCampo: identificador del campo de tipo objeto imagen a visualizar.

void setIdFieldText( Number column, String idCampo )

Fija el campo que se usará para mostrar el contenido en la columna.

Parámetros:

  • column: número de columna del ítem.

  • idCampo: identificador del campo de tipo objeto imagen a visualizar.

void setTextAlignment( Number nCol, Number nAlignment )

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.

Number textAlignment( Number column)

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.

Patrones hijos

void addChildPattern( VItemRegisterPattern childPattern )

Añade un patrón como un nodo hijo del ítem en curso.

Parámetros:

  • childPatter: objeto de la clave VItemRegisterPattern que se usará para generar nodos hijos.

VItemRegisterPattern childPattern( Number index )

Devuelve un patrón seleccionado que se corresponde con un objeto de la clase VItemRegisterPattern.

Parámetros:

  • index: número de patrón (el primero es el 0).

Number childPatternCount()

Devuelve el número de patrones configurados en los nodos hijos del ítem.

Ejemplos

Ejemplo de películas con repartos

// --------------------------------------------------------------------------------
// TreeWidget de películas y sus repartos
// --------------------------------------------------------------------------------
importClass ("VImage" );

// --------------------------------------------------------------------------------
// Preparamos y configuramos el control treewidget
// --------------------------------------------------------------------------------
var tree = theRoot.dataView().control("CONTROL" );

tree.setHeaderLabel(0, "Título");
tree.setHeaderLabel(1, "Año / Trabajo");
tree.setIconSize(64, 80);

// --------------------------------------------------------------------------------
// Creamos el top level del árbol con un icono basado en un objeto dibujo
// --------------------------------------------------------------------------------
var icoPelis = new VImage();
icoPelis.loadResource("CINE/CINE_32");
var itemCarpetaPeliculas = tree.addTopLevelItem();

itemCarpetaPeliculas.setText(0, "Películas");
itemCarpetaPeliculas.setIcon(0, icoPelis);

// --------------------------------------------------------------------------------
// Preparamos el patrón de películas
// --------------------------------------------------------------------------------
var patternPeli = tree.createItemRegPattern();
patternPeli.addChildPattern(patternReparto);
patternPeli.setTable("CINE_DAT/PELICULAS");

patternPeli.setIdFieldIcon(0, "CARTEL");
patternPeli.setIdFieldText(0, "NAME");
patternPeli.setTextAlignment(0, VTreeWidgetItem.AlignLeft | VTreeWidgetItem.AlignVCenter);

patternPeli.setIdFieldText(1, "AGNO");
patternPeli.setTextAlignment(1, VTreeWidgetItem.AlignLeft | VTreeWidgetItem.AlignVCenter);

patternPeli.setNewRecordForm("CINE/PELICULA");
patternPeli.setEditForm("CINE/PELICULA");
patternPeli.setDeleteForm("CINE/ELIMINAR_PELICULA");

// --------------------------------------------------------------------------------
// Preparamos el patrón de repartos
// --------------------------------------------------------------------------------
var patternReparto = tree.createItemRegPattern();
patternReparto.setTable("CINE_DAT/REPARTOS");

patternReparto.setIdFieldIcon(0, "PERSONAS.FOTO");
patternReparto.setIdFieldText(0, "PERSONAS.NAME");

patternReparto.setIdFieldText(1, "TRABAJOS.NAME");

patternReparto.setNewRecordForm("CINE/REPARTO_PRUEBAS");
patternReparto.setEditForm("CINE/REPARTO_PRUEBAS");
patternReparto.setDeleteForm("CINE/REPARTO_CARTEL_P");

// --------------------------------------------------------------------------------
// Leemos la lista de películas a cargar en el treewidget
// --------------------------------------------------------------------------------
var pelis = new VRegisterList(theRoot);
pelis.setTable("CINE_DAT/PELICULAS");
var a = new Array;
pelis.load("ID", a);

// --------------------------------------------------------------------------------
// Cargamos la lista de películas al treewidget aplicando el patrón
// --------------------------------------------------------------------------------
itemCarpetaPeliculas.addChildRegisterList(pelis ,patternPeli);

// --------------------------------------------------------------------------------
// Recorremos las películas del treewidget para incluir los repartos
// --------------------------------------------------------------------------------
var agnos = 0;
for(var x = 0 ; x < itemCarpetaPeliculas.childCount(); ++x)
{
    // Se lee la película del nodo en curso
    var itemPeli = itemCarpetaPeliculas.child(x);
    var curPeli = pelis.readAt(x);

    // Se leen los repartos de la película
    var reparto = curPeli.loadPlurals("REPARTOS_PELICULAS");

    // Se calcula el total años de la película (como ejemplo de cálculo de totales)
    agnos += curPeli.fieldToInt("AGNO");

    // --------------------------------------------------------------------------------
    // Se añaden los repartos como nodos hijos de la película aplicando el patrón
    // --------------------------------------------------------------------------------
    itemPeli.addChildRegisterList(reparto, patternReparto);

    // --------------------------------------------------------------------------------
    // Se añade un nodo hijo con el subtotal de personas de reparto de la película
    // --------------------------------------------------------------------------------
    var itemSubtotal = itemPeli.addChild();
    itemSubtotal.setFlags(VTreeWidgetItem.NoItemFlags);

    itemSubtotal.setBackgroundColor(0, 192, 192, 192);
    itemSubtotal.setForegroundColor(0, 0, 0, 128);
    itemSubtotal.setText(0, "Nº de personas: " + reparto.size());

    itemSubtotal.setBackgroundColor(1, 192, 192, 192);    
    itemSubtotal.setForegroundColor(1, 0, 0, 128);
};

// --------------------------------------------------------------------------------
// Se añade un nodo con los totales generales (películas y años)
// --------------------------------------------------------------------------------
var itemTotalPeliculas = itemCarpetaPeliculas.addChild();
itemTotalPeliculas.setFlags(VTreeWidgetItem.NoItemFlags);

itemTotalPeliculas.setBackgroundColor(0, 192, 192, 192);
itemTotalPeliculas.setForegroundColor(0, 255, 0, 0);
itemTotalPeliculas.setText(0, "Nº de películas: " + pelis.size());

itemTotalPeliculas.setBackgroundColor(1, 192, 192, 192);
itemTotalPeliculas.setForegroundColor(1, 255, 0, 0);
itemTotalPeliculas.setText(1, "" + agnos);
itemTotalPeliculas.setTextAlignment(1, VTreeWidgetItem.AlignRight | VTreeWidgetItem.AlignVCenter);

// --------------------------------------------------------------------------------
// Se expande el ítem de totales generales creado y se ajuste el ancho de las columnas del treewidget
// --------------------------------------------------------------------------------
tree.expandItem(itemCarpetaPeliculas);
tree.resizeColumnToContents(0);

// --------------------------------------------------------------------------------
// Como ejemplo, se añaden los géneros de las películas como nodos principales al treewidget
// --------------------------------------------------------------------------------
var patternGenero = tree.createItemRegPattern();
patternGenero.setTable("CINE_DAT/GENEROS");
patternGenero.setIdFieldText(0, "NAME");

var generos = new VRegisterList(theRoot);
generos.setTable("CINE_DAT/GENEROS");
var a = new Array;
generos.load("ID", a);

tree.addTopLevelItemRegisterList(generos, patternGenero);

Última actualización