30
Velneo vDevelop
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
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 )

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, VTreeItem.AlignLeft | VTreeItem.AlignVCenter);
35
36
patternPeli.setIdFieldText(1, "AGNO");
37
patternPeli.setTextAlignment(1, VTreeItem.AlignLeft | VTreeItem.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(VTreeItem.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(VTreeItem.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, VTreeItem.AlignRight | VTreeItem.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!
Última actualización 1yr ago