4D v16.3

QR GET INFO COLUMN

Inicio

 
4D v16.3
QR GET INFO COLUMN

QR GET INFO COLUMN 


 

QR GET INFO COLUMN ( area ; numColumna ; titulo ; objeto ; oculta ; tamaño ; valoresRepetidos ; formato {; varResultado} ) 
Parámetro Tipo   Descripción
area  Entero largo in Referencia del área
numColumna  Entero largo in Número de columna
titulo  Texto in Título de la columna
objeto  Texto in Objeto asignado a la columna
oculta  Entero largo in 0 = visible, 1 = oculto
tamaño  Entero largo in Largo de la columna
valoresRepetidos  Entero largo in 0 = no repetido, 1 = repetido
formato  Texto in Formato de visualización de los datos
varResultado  Texto in Nombre de la variable de fórmula

El comando QR GET INFO COLUMN permite recuperar los parámetros de una columna existente.

area es la referencia del área del informe rápido.

numColumna es el número de la columna a modificar.

titulo devuelve el título que será mostrado en el encabezado de la columna.

objeto devuelve el nombre del objeto de la columna (variable, campo o fórmula).

Nota: el comando no tiene en cuenta ninguna estructura virtual definida por medio de los comandos SET TABLE TITLES y SET FIELD TITLES. El nombre real del campo se devuelve en el parámetro objeto.

oculta indica si la columna es visible o está oculta:

  • si oculta es igual a 1, la columna está oculta;
  • si oculta es igual a 0, la columna es mostrada.

tamaño devuelve el tamaño de la columna en píxeles. Si el valor devuelto es negativo, el tamaño de la columna es automático.

valoresRepetidos devuelve el estado de la propiedad de repetición de datos. Por ejemplo, si el valor de un campo o variable no cambia de un registro a otro, es posible repetirlo o no en cada línea de la columna.

• Si valoresRepetidos es igual a 0, los valores no se repiten.
• Si valoresRepetidos es igual a 1, los valores se repiten.

formato devuelve el formato de salida. Los formatos de salida son los formatos 4D compatibles con los datos mostrados en la columna.

Cuando se pasa, el parámetro opcional varResultado devuelve el nombre de la variable asignada automáticamente por el editor de Informes rápidos a la columna de la fórmula (si lo hay): "C1" para la primera columna de la fórmula, "C2" para la segunda y así sucesivamente. 4D utiliza esta variable para almacenar los resultados de la última ejecución de la fórmula de la columna cuando se genera el informe.

Con este tipo de informe, el comando QR GET INFO COLUMN permite recuperar globalmente los mismos parámetros pero la referencia de las áreas a las cuales aplica es diferente y varia dependiendo del parámetro que quiera definir.

Además, los parámetros titulo, oculta, y valoresRepetidos no se utilizan cuando este comando se utiliza en informes tablas cruzadas.

El valor a pasar en el parámetro numColumna depende de la operación que quiera efectuar de si quiere definir el tamaño de la columna o la fuente de datos y el formato de visualización.

  • Tamaño de la columna

Este es un atributo “visual”, por lo tanto las columnas son numeradas de izquierda a derecha, como se muestra en la siguiente imagen:


La siguiente instrucción define el tamaño automático para todas las columnas en un informe tabla cruzada y deja los otros elemento intactos:

 For($i;1;3)
    QR GET INFO COLUMN(qr_area;$i;$titulo;$obj;$oculta;$tamaño;$rep;$format)
    QR SET INFO COLUMN(qr_area;$i;$titulo;$obj;$oculta;0;$rep;$format)
 End for

Notará que como quiere alterar únicamente el tamaño de la columna, tiene que utilizar QR GET INFO COLUMN para recuperar las propiedades de la columna y pasarlas a QR SET INFO COLUMN para dejarla intacta, excepto el tamaño de la columna.

  • Fuente de datos (objeto) y formato de salida

En este caso, la numeración de las columnas opera como se muestra a continuación:


Si pasa un número de area inválido, se genera el error -9850.
Si el parámetro numColumna es incorrecto se genera el error -9852.

Ejemplo  

Usted ha diseñado el siguiente informe:

Puede escribir:

 C_TEXT($vTitle;$vObject;$vDisplayFormat;$vResultVar)
 C_LONGINT($area;$vHide;$vSize;$vRepeatedValue)
 QR GET INFO COLUMN($area;3;$vTitle;$vObject;$vHide;$vSize;$vRepeatedValue;$vDisplayFormat;$vResultVar)
  //$vTitle = "Age"
  //$vObject = "[People]Birthdate-Current date"
  //$vHide = 0
  //$vSize = 57
  //$vRepeatedValue = 1
  //$vDisplayFormat = ""
  //$vResultVar = "C1"



Ver también 

QR Get info row
QR SET INFO COLUMN
QR SET INFO ROW

 
PROPIEDADES 

Producto: 4D
Tema: Informes rápidos
Número 766

Este comando modifica la variable sistema Error

 
HISTORIA 

Creado por: 4D 2003
Modificado: 4D v15 R3

 
ARTICLE USAGE

Manual de lenguaje 4D ( 4D v16)
Manual de lenguaje 4D ( 4D v16.1)
Manual de lenguaje 4D ( 4D v16.2)
Manual de lenguaje 4D ( 4D v16.3)