VGridListDataView

Hereda de: VAbstractListDataView.
Esta clase representa a un objeto rejilla.
Indice de funciones
Generales
Boolean isSortingEnabled()
void setShowGrid( Boolean show )
void setSortingEnabled( Boolean set )
Boolean showGrid()
De columnas
Number columnCount()
Number columnWidth( Number column )
Boolean isColumnHidden( Number column )
void resetColumnVisibility( Number column )
void resizeColumnsToContents()
void resizeColumnToContents( Number column )
void setColumnVisible( Number column, Boolean visible )
void setColumnWidth( Number column, Number width )
Number visibleColumnCount()
De filas
Boolean isRowHidden( Number row )
void resizeRowsToContents()
void resizeRowToContents( Number row )
void setRowVisible( Number row, Boolean visible )
De edición
void editItem( Number row )
void editItem( Number row, Number column )
void editItem( Number row, String idColumn )
De data
Variant data( Number nRow, Number column )
void dataImage( Number row, Number column,  image )
Number dataType( Number column )
Enumeraciones
DataType
TypeNone = 0
TypeString = 1
TypeNumber = 2
TypeDate = 3
TypeTime = 4
TypeDateTime = 5
TypeImage = 6
Documentación de funciones
Funciones generales
Boolean isSortingEnabled()
Devuelve true si la ordenación de la rejilla haciendo clic en la cabecera de columnas está activada.
void setShowGrid( Boolean show )
Permite especificar si las líneas de grid de la rejilla se visualizarán o se ocultarán.
Parámetros:
show: true para que el grid esté visible, false para que el grid se oculte.
void setSortingEnabled( Boolean set )
Permite activar o desactivar la ordenación de la rejilla haciendo clic en las cabeceras de columna.
Parámetros:
set: true para que la ordenación esté activada, false para que la ordenación esté desactivada.
Boolean showGrid()
Devuelve true si el grid de la rejilla está visible y false si está oculto.
Funciones de columnas
Number columnCount()
Devuelve el número de columnas que contiene la rejilla.
Number columnWidth( Number column )
Devuelve el ancho en píxeles de la columna especificada en el parámetro.
Parámetros:
column: número de la columna.
Boolean isColumnHidden( Number column )
Devuelve true si la columna está oculta o false si la columna está visible.
Parámetros:
column: número de columna sobre la que se aplica la función.
void resetColumnVisibility( Number column )
Vuelve la columna al modo fórmula (que es el modo por defecto), en el modo fórmula se evalúa la fórmula de la propiedad condición de visible de la columna para determinar la visibilidad de la misma. Al aplicar esta función se refresca la visibilidad de la columna.
Parámetros:
column: número de columna sobre la que se aplica la función.
void resizeColumnsToContents()
Cambia el ancho de la todas las columnas en función de los datos visualizados en cada columna.
void resizeColumnToContents( Number column )
Cambia el ancho de la columna especificada en función de los datos visualizados en la columna.
Parámetros:
column: número de la columna.
void setColumnVisible( Number column, Boolean visible )
Al aplicar la función la columna entra en modo manual y deja de aplicarse la fórmula de la propiedad condición de visible. Al aplicar esta función se refresca la visibilidad de la columna.
Parámetros:
column: número de columna sobre la que se aplica la función.
visible: true para hacer la columna visible, false para ocultar la columna.
void setColumnWidth( Number column, Number width )
Permite fijar el ancho de una columna en píxeles.
Parámetros:
column: número de la columna.
width: ancho en píxeles a pintar en la columna.
Number visibleColumnCount()
Devuelve el número de columnas visible que tiene la rejilla. Si todas las columnas declaradas en la rejilla están visible el valor devuelvo coincidirá con el que devuelva la función columnCount().
Funciones de filas
Boolean isRowHidden( Number row )
Devuelve true si la fila especificada está oculta.
Parámetros:
row: número de la fila.
void resizeRowsToContents()
Cambia el alto de todas las filas en función de los datos visualizados.
void resizeRowToContents( Number row )
Cambia el alto de la fila especificada en función de los datos visualizados.
Parámetros:
row: número de la fila.
void setRowVisible( Number row, Boolean visible )
Permite cambiar el estado de visibilidad de una fila concreta.
Parámetros:
row: número de la fila.
visible: true para indicar que la fila será visible, false para indicar que la fila se oculte.
Funciones de edición
void editItem( Number row )
Activa el modo edición de la rejilla, editando la fila especificada. Se posiciona automáticamente en la primera columna visible y editable.
Parámetros:
row: número de la fila.
void editItem( Number row, Number column )
Activa el modo edición de la rejilla, editando la celda correspondiente a la fila y columna especificada.
Parámetro:
row: número de la fila.
column: número de la columna.
void editItem( Number row, String idColumn )
Activa el modo edición de la rejilla, editando la celda correspondiente a la fila y el identificador de la columna especificado.
Parámetro:
row: número de la fila.
idColumn: identificador del subobjeto columna.
Funciones data
Variant data( Number nRow, Number column )
Devuelve el contenido visualizado en una celda de la rejilla.
Parámetros:
row: número de la fila.
column: número de la columna.
void dataImage( Number row, Number column, VImage image )
Devuelve un objeto de la clase VImage que contiene la imagen que se está visualizando en una celda. La imagen se graba en el objeto especificado en el tercer parámetro:
Parámetros:
row: número de la fila.
column: número de la columna.
image: objeto de la clase VImage que contendrá la imagen visualizada en la celda.
Number dataType( Number column )
Devuelve el código correspondiente al tipo de dato de edición que se está visualizando en una columna. Por este motivo las fórmulas y los campos compuestos siempre devolverán el tipo String porque no son editables. Ver enum DataType para conocer la lista de tipos de datos.
Parámetro:
column: número de la columna. Ver enum DataType.
Ejemplos
1. Inhabilitar la ordenación al pulsar cabeceras de rejillas de una rejilla incrustada en un formulario
1
var formulario = theRoot.dataView();
2
var rejilla = formulario.control("LST");
3
rejilla.setSortingEnabled(false);
Copied!
2. Iniciar la edición en una rejilla editable incrustada en un formulario en una fila y columna concretas
1
//Forzar la edición de la primera fila, tercera columna
2
var formulario = theRoot.dataView();
3
var controlRejilla = formulario.control("VIS");
4
var rejilla = controlRejilla.root().dataView();
5
rejilla.editItem(0, 2);
Copied!
3. Ocultar las columnas de la tabla del formulario maestro 
Se trata de un manejador de evento que oculta las columnas de una rejilla de un campo maestro cuando la rejilla está incrustada en un formulario de dicho maestro. Se ejecutará desde la señal de post inicialización de la rejilla. Esto se hace partiendo de la base de que el identificador del campo enlazado se llama igual que la tabla (Ejemplo: identificador campo: #ART_M, identificador tabla enlazada ART_M).
1
//Inicialización de variables
2
var salir = false;
3
​
4
//Comprobar si la rejilla está incrustada en otro objeto
5
var padre = theRoot.dataView().parentDataView();
6
​
7
//Si lo está vamos navegando por los objetos padre hasta llegar al objeto principal
8
​
9
if (padre) {
10
	for (var i=0; !salir; ++i) {
11
		var top = padre.parentDataView();
12
		if (top) {
13
			var padre = top;
14
		}
15
		else {
16
			var salir = true;
17
		}
18
	}
19
	
20
	//Si el objeto principal es un formulario con origen
21
	//Componemos un identificador de campo a partir del identificador de la tabla
22
​
23
	if (padre.objectInfo().inputType() == 1) {
24
		tabla = "#" + padre.objectInfo().inputTable().id();
25
		
26
		//Obtenemos la vista de datos actual (la rejilla)
27
		var rejilla = theRoot.dataView();
28
		
29
		//Obtenemos el número columnas visibles de la rejilla
30
		var nColumnas = rejilla.visibleColumnCount();
31
​
32
		//Guardamos la longitud del identificador de campo que hemos compuesto a partir del ID de la tabla
33
		//Lo usaremos para extraer de la fórmula de cada colunma la parte izquierda
34
		longTabla = tabla.length;
35
​
36
		//Comprobamos si coincide la parte izquierda del contenido de la columna
37
		//con el identificador de campo que hemos compuesto
38
		//Si coincide, ocultamos la columna
39
		
40
		//Obtenemos la información de objeto de la rejilla para poder comprobar 
41
		//en el bucle el valor de la propiedad "contenido"
42
		infoRejilla=rejilla.objectInfo();
43
		
44
		//Comprobamos si en la fórmula de la columna coincide el identificador del campo
45
		//con el identificador de la tabla del formulario principal
46
		//Si coincide, ocultamos la columna
47
		for (var i=0; i<nColumnas;++i)
48
			{
49
			var subobjeto = infoRejilla.subObjectInfo(15,i);
50
			var formula = subobjeto.propertyData(9);
51
				iniFormula = formula.substr(0, longTabla)
52
				if ( tabla == iniFormula) {
53
					rejilla.setColumnVisible(i, false);
54
				}
55
			}
56
	}
57
}
Copied!