4D v16.3

QR SET INFO COLUMN

Página Inicial

 
4D v16.3
QR SET INFO COLUMN

QR SET INFO COLUMN 


 

QR SET INFO COLUMN ( area ; numColuna ; titulo ; objeto ; ocultar ; tamanho ; valoresRepetidos ; formato ) 
Parâmetro Tipo   Descrição
area  Inteiro longo in Referência da área
numColuna  Inteiro longo in Nº da coluna
titulo  String in Título da coluna
objeto  Campo, Variável in Objeto atribuido a coluna
ocultar  Inteiro longo in 0=exibir, 1=ocultar
tamanho  Inteiro longo in Tamanho da coluna
valoresRepetidos  Inteiro longo in 0=não repetido, 1= repetido
formato  String in Formatação dos dados

O comando QR SET INFO COLUMN permite definir os parâmetros de uma coluna existente.

area é a referência da área do relatório rápido.

numColuna é o número da coluna a definir.

titulo é o título que será mostrado no cabeçalho da coluna.

objeto é o objeto da coluna (variável, campo ou fórmula).

oculta especifica se a coluna é visível ou está oculta:

  • se oculta é igual a 1, a coluna está oculta;
  • se oculta é igual a 0, a coluna é mostrada.
tamanho é o tamanho em píxels a atribuir para coluna. Se tamanho for igual a -1, o tamanho da coluna é automático.

valoresRepetidos indica o estado da propriedade de repetição de dados. Por exemplo, se o valor de um campo ou variável não muda de um registro a outro, é possível repeti-lo ou não em cada linha da coluna.

• Se valoresRepetidos for igual a 0, os valores não são repetidos.
• Se valoresRepetidos for igual a 1, os valores são repetidos.

formato é o formato de saída. Os formatos de saída são os formatos 4D compatíveis com os dados mostrados na coluna.

A seguinte instrução define o título para a coluna #1, o conteúdo do Campo2, faz com que a coluna seja visível com uma largura de 150 píxels e define o formato de saída ###.##.
 QR SET INFO COLUMN(area;1;"Titulo";"[Tabela 1]Campo2";0;150;0;"###,##")

O comando QR SET INFO COLUMN permite definir globalmente os mesmos parâmetros mas a referencia das áreas as quais aplica é diferente e varia dependendo do parâmetro que queira definir.

Além disso, os parâmetros titulo, oculto, e valoresRepetidos não se utilizam quando este comando se utiliza em relatórios tabelas cruzadas. O valor a utilizar em numColuna varia dependendo se deseja definir o tamanho da coluna ou a fonte de dados e o formato de visualização.

    * Tamanho da coluna

Este é um atributo “visual”, portanto as colunas são numeradas de esquerda a direita, como se mostra na seguinte imagem:



O seguinte método define o tamanho automático para todas as colunas em relatório tabelas cruzadas e deixa os outros elementos intactos:

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

Notará que como queira modificar unicamente o tamanho da coluna, deve utilizar o comando QR GET INFO COLUMN para recuperar as propriedades atuais da coluna e passá-la a QR SET INFO COLUMN com o objetivo de conservá-la intacta, exceto pelo tamanho da coluna.

    * Fonte de dados (objeto) e formato de visualização

Neste caso a numeração das colunas é realizada da seguinte maneira:

Notará que não é possível direcionar todas as células utilizando o comando QR SET INFO COLUMN, as células que não são numeradas acima são direcionadas utilizando QR SET TOTALS DATA.

O código a seguir atribui as fontes de dados às três células necessárias para a criação de um relatório tabela cruzada simples:

 QR SET REPORT TABLE(qr_area;Table(->[Faturas]))
 ALL RECORDS([Faturas])
 QR SET REPORT KIND(qr_area;2)
 QR SET INFO COLUMN(qr_area;1;"";->[Faturas]Elemento;1;-1;1;"")
 QR SET INFO COLUMN(qr_area;2;"";->[Faturas]Data;1;-1;1;"")
 QR SET INFO COLUMN(qr_area;3;"";->[Faturas]Quantidade;1;-1;1;"")

Se gera a seguinte área de relatório:



Se passa um número de area inválido, se gera o erro -9850.
Se o parâmetro numColuna for incorreto, se gera o erro -9852.



Ver também 

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

 
PROPRIEDADES 

Produto: 4D
Tema: Quick Report
Número 765

Este comando modifica a variável sistema Error

 
HISTÓRIA 

Criado por: 4D 2003

 
ARTICLE USAGE

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