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.
Funciones
Generales
Retorno
Función
Number
​flags()
Boolean
​setDeleteForm( String idRefForm )
Boolean
​setEditForm( String idRefForm )
void
​setFlags( Number flags )
Boolean
​setNewRecordForm( String idRefForm )
Boolean
​setTable( String idRefTable )
De columnas
Retorno
Función
Number
​backgroundColor( Number column )
Number
​columnCount()
​VFont​
​font( Number column )
Number
​foregroundColor( Number column )
​VImage​
​icon( Number column )
String
​idFieldIcon( Number column)
String
​idFieldText( Number column)
void
​setBackgroundColor( Number column, Number rgbaColor )
void
​setBackgroundColor( Number column, Number r, Number g, Number b, Number a = 255 )
void
​setFont( Number column, VFont font )
void
​setForegroundColor( Number column, Number rgbaColor )
void
​setForegroundColor( Number column, Number r, Number g, Number b, Number a = 255 )
void
​setIcon( Number column, VImage image )
void
​setIdFieldIcon( Number column, String idCampo )
void
​setIdFieldText( Number column, String idCampo )
void
​setTextAlignment( Number nCol, Number nAlignment )
Number
​textAlignment( Number column)
Patrones hijos
Retorno
Función
void
​addChildPattern( VItemRegisterPattern childPattern )
VItemRegisterPattern
​childPattern( Number index )
Number
​childPatternCount()
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.
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
1
// --------------------------------------------------------------------------------
2
// TreeWidget de películas y sus repartos
3
// --------------------------------------------------------------------------------
4
importClass ("VImage" );
5
​
6
// --------------------------------------------------------------------------------
7
// Preparamos y configuramos el control treewidget
8
// --------------------------------------------------------------------------------
9
var tree = theRoot.dataView().control("CONTROL" );
10
​
11
tree.setHeaderLabel(0, "Título");
12
tree.setHeaderLabel(1, "Año / Trabajo");
13
tree.setIconSize(64, 80);
14
​
15
// --------------------------------------------------------------------------------
16
// Creamos el top level del árbol con un icono basado en un objeto dibujo
17
// --------------------------------------------------------------------------------
18
var icoPelis = new VImage();
19
icoPelis.loadResource("CINE/CINE_32");
20
var itemCarpetaPeliculas = tree.addTopLevelItem();
21
​
22
itemCarpetaPeliculas.setText(0, "Películas");
23
itemCarpetaPeliculas.setIcon(0, icoPelis);
24
​
25
// --------------------------------------------------------------------------------
26
// Preparamos el patrón de películas
27
// --------------------------------------------------------------------------------
28
var patternPeli = tree.createItemRegPattern();
29
patternPeli.addChildPattern(patternReparto);
30
patternPeli.setTable("CINE_DAT/PELICULAS");
31
​
32
patternPeli.setIdFieldIcon(0, "CARTEL");
33
patternPeli.setIdFieldText(0, "NAME");
34
patternPeli.setTextAlignment(0, VTreeWidgetItem.AlignLeft | VTreeWidgetItem.AlignVCenter);
35
​
36
patternPeli.setIdFieldText(1, "AGNO");
37
patternPeli.setTextAlignment(1, VTreeWidgetItem.AlignLeft | VTreeWidgetItem.AlignVCenter);
38
​
39
patternPeli.setNewRecordForm("CINE/PELICULA");
40
patternPeli.setEditForm("CINE/PELICULA");
41
patternPeli.setDeleteForm("CINE/ELIMINAR_PELICULA");
42
​
43
// --------------------------------------------------------------------------------
44
// Preparamos el patrón de repartos
45
// --------------------------------------------------------------------------------
46
var patternReparto = tree.createItemRegPattern();
47
patternReparto.setTable("CINE_DAT/REPARTOS");
48
​
49
patternReparto.setIdFieldIcon(0, "PERSONAS.FOTO");
50
patternReparto.setIdFieldText(0, "PERSONAS.NAME");
51
​
52
patternReparto.setIdFieldText(1, "TRABAJOS.NAME");
53
​
54
patternReparto.setNewRecordForm("CINE/REPARTO_PRUEBAS");
55
patternReparto.setEditForm("CINE/REPARTO_PRUEBAS");
56
patternReparto.setDeleteForm("CINE/REPARTO_CARTEL_P");
57
​
58
// --------------------------------------------------------------------------------
59
// Leemos la lista de películas a cargar en el treewidget
60
// --------------------------------------------------------------------------------
61
var pelis = new VRegisterList(theRoot);
62
pelis.setTable("CINE_DAT/PELICULAS");
63
var a = new Array;
64
pelis.load("ID", a);
65
​
66
// --------------------------------------------------------------------------------
67
// Cargamos la lista de películas al treewidget aplicando el patrón
68
// --------------------------------------------------------------------------------
69
itemCarpetaPeliculas.addChildRegisterList(pelis ,patternPeli);
70
​
71
// --------------------------------------------------------------------------------
72
// Recorremos las películas del treewidget para incluir los repartos
73
// --------------------------------------------------------------------------------
74
var agnos = 0;
75
for(var x = 0 ; x < itemCarpetaPeliculas.childCount(); ++x)
76
{
77
    // Se lee la película del nodo en curso
78
    var itemPeli = itemCarpetaPeliculas.child(x);
79
    var curPeli = pelis.readAt(x);
80
​
81
    // Se leen los repartos de la película
82
    var reparto = curPeli.loadPlurals("REPARTOS_PELICULAS");
83
​
84
    // Se calcula el total años de la película (como ejemplo de cálculo de totales)
85
    agnos += curPeli.fieldToInt("AGNO");
86
​
87
    // --------------------------------------------------------------------------------
88
    // Se añaden los repartos como nodos hijos de la película aplicando el patrón
89
    // --------------------------------------------------------------------------------
90
    itemPeli.addChildRegisterList(reparto, patternReparto);
91
​
92
    // --------------------------------------------------------------------------------
93
    // Se añade un nodo hijo con el subtotal de personas de reparto de la película
94
    // --------------------------------------------------------------------------------
95
    var itemSubtotal = itemPeli.addChild();
96
    itemSubtotal.setFlags(VTreeWidgetItem.NoItemFlags);
97
​
98
    itemSubtotal.setBackgroundColor(0, 192, 192, 192);
99
    itemSubtotal.setForegroundColor(0, 0, 0, 128);
100
    itemSubtotal.setText(0, "Nº de personas: " + reparto.size());
101
​
102
    itemSubtotal.setBackgroundColor(1, 192, 192, 192);    
103
    itemSubtotal.setForegroundColor(1, 0, 0, 128);
104
};
105
​
106
// --------------------------------------------------------------------------------
107
// Se añade un nodo con los totales generales (películas y años)
108
// --------------------------------------------------------------------------------
109
var itemTotalPeliculas = itemCarpetaPeliculas.addChild();
110
itemTotalPeliculas.setFlags(VTreeWidgetItem.NoItemFlags);
111
​
112
itemTotalPeliculas.setBackgroundColor(0, 192, 192, 192);
113
itemTotalPeliculas.setForegroundColor(0, 255, 0, 0);
114
itemTotalPeliculas.setText(0, "Nº de películas: " + pelis.size());
115
​
116
itemTotalPeliculas.setBackgroundColor(1, 192, 192, 192);
117
itemTotalPeliculas.setForegroundColor(1, 255, 0, 0);
118
itemTotalPeliculas.setText(1, "" + agnos);
119
itemTotalPeliculas.setTextAlignment(1, VTreeWidgetItem.AlignRight | VTreeWidgetItem.AlignVCenter);
120
​
121
// --------------------------------------------------------------------------------
122
// Se expande el ítem de totales generales creado y se ajuste el ancho de las columnas del treewidget
123
// --------------------------------------------------------------------------------
124
tree.expandItem(itemCarpetaPeliculas);
125
tree.resizeColumnToContents(0);
126
​
127
// --------------------------------------------------------------------------------
128
// Como ejemplo, se añaden los géneros de las películas como nodos principales al treewidget
129
// --------------------------------------------------------------------------------
130
var patternGenero = tree.createItemRegPattern();
131
patternGenero.setTable("CINE_DAT/GENEROS");
132
patternGenero.setIdFieldText(0, "NAME");
133
​
134
var generos = new VRegisterList(theRoot);
135
generos.setTable("CINE_DAT/GENEROS");
136
var a = new Array;
137
generos.load("ID", a);
138
​
139
tree.addTopLevelItemRegisterList(generos, patternGenero);
Copied!

VInstances

VLabel

Última actualización 2yr ago

Copiar enlace

Contenidos

Funciones

Enumeraciones

Documentación de funciones

Funciones generales

Funciones de columnas

Patrones hijos

Ejemplos

Ejemplo de películas con repartos