QR GET INFO COLUMN
QR GET INFO COLUMN ( area ; numColuna ; titulo ; objeto ; ocultar ; tamanho ; valoresRepetidos ; formato {; resultVar} )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| area | Integer | → | Referência da área |
| numColuna | Integer | → | Nº da coluna |
| titulo | Text | ← | Título da coluna |
| objeto | Text | ← | Objeto atribuído a coluna |
| ocultar | Integer | ← | 0=exibir, 1=ocultar |
| tamanho | Integer | ← | Tamanho da coluna |
| valoresRepetidos | Integer | ← | 0=não repetido, 1=repetido |
| formato | Text | ← | Formato de exibição dos dados |
| resultVar | Text | ← | Nome da variável da fórmula |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
Relatórios em lista
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.
Quando passar o parâmetro opcional varResultado, ele devolve o nome da variável atribuida automaticamente pelo editor de relatórios rápidos à coluna da fórmula (se houver): "C1" para a primeira coluna da fórmula, "C2" para a segunda e assim sucessivamente. 4D utiliza esta variável para armazenar os resultados da última execução da fórmula da coluna quando for gerado o relatório.
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)
 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 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.
Exemplo
Após criar o relatório abaixo:
Pode escrever:
var $vTitle;$vObject;$vDisplayFormat;$vResultVar : Text
var $area;$vHide;$vSize;$vRepeatedValue : Integer
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"