4D Doc Center : QR GET INFO COLUMN

4D v14.3

QR GET INFO COLUMN


QR GET INFO COLUMN ( area ; numColuna ; titulo ; objeto ; ocultar ; tamanho ; valoresRepetidos ; formato )

Parâmetro	Tipo	Descrição
area	Inteiro longo	Referência da área
numColuna	Inteiro longo	Nº da coluna
titulo	cadeia	Título da coluna
objeto	Campo, Variável	Objeto atribuído a coluna
ocultar	Inteiro longo	0=exibir, 1=ocultar
tamanho	Inteiro longo	Tamanho da coluna
valoresRepetidos	Inteiro longo	0=não repetido, 1=repetido
formato	Texto	Formato de exibição dos dados

O comando QR GET INFO COLUMN permite recuperar os parâmetros de uma coluna existente.

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

numCol é o número da coluna a modificar.

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

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

Nota: o comando não leva em conta nenhuma estrutura virtual definida por meio dos comandos SET TABLE TITLES e SET FIELD TITLES. O nome real do campo se devolve no parâmetro objeto.

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

se oculta for igual a 1, a coluna está oculta;
se oculta for igual a 0, a coluna é mostrada.

tamanho devolve o tamanho da coluna em píxels. Se o valor devolvido for negativo, o tamanho da coluna é automático.

valoresRepetidos devolve 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 repetí-lo ou não em cada linha da coluna.

• Se valoresRepetidos for igual a 0, os valores não se repetem.
• Se valoresRepetidos for igual a 1, os valores se repetem.

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

Relatório tabelas cruzadas

Com este tipo de relatório, o comando QR GET INFO COLUMN permite recuperar globalmente os mesmos parâmetros mas a referência das áreas às quais aplica é diferente e varia dependendo do parâmetro que queira definir.

Além disso, os parâmetros titulo, ocultar, e valoresRepetidos não se utilizam quando este comando se utiliza em relatórios tabelas cruzadas.

O valor a passar no parâmetro numCol depende da operação que queira realizar e 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:

A seguinte instrução define o tamanho automático para todas as colunas em um relatório tabela cruzada e deixa os outros elemento intactos:

 For($i;1;3)

    &NBSP;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)

    &NBSP;End for

Notará que como queira alterar unicamente o tamanho da coluna, tem que utilizar QR GET INFO COLUMN para recuperar as propriedades da coluna e passa-las a QR SET INFO COLUMN para deixa-la intacta, exceto o tamanho da coluna.

Fonte de dados (objeto) e formato de saída

Nesse caso, a numeração das colunas opera como se mostra a continuação:

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

4D v14.3

QR GET INFO COLUMN

QR GET INFO COLUMN

Descrição

Relatórios em lista

Relatório tabelas cruzadas