4D Doc Center : QR SET SORTS

4D v14.3

QR SET SORTS


QR SET SORTS ( area ; aColunas {; aOrdem} )

Parâmetro	Tipo	Descrição
area	Inteiro longo	Referência da área
aColunas	Array real	Colunas
aOrdem	Array real	Ordenar

Descrição

O comando QR SET SORTS permite definir o sentido de ordenação de cada coluna do relatório rápido cuja referência é passada em area.

aColunas: deve armazenar neste array o número de cada coluna para a qual deseja definir um sentido de ordenação.

aOrdem: cada elemento deste array deve conter o sentido de ordenação para a coluna correspondente referenciada no array aColunas.

* Se aOrdem{$i} é igual a 1, o sentido da ordenação é ascendente.
* Se aOrdem{$i} é igual a - 1, o sentido da ordenação é descendente.

Tabela cruzada

No caso deste tipo de relatórios, o array não pode ter mais de dois elementos. Unicamente pode ordenar as colunas (1) e as filas (2). Os dados (situados na intersecção das colunas e das linhas) não podem ser ordenados com este comando.

Este é o código para ordenar só as linhas em caso de um relatório de tabelas cruzadas:

 ARRAY REAL($aColumnas;1)

 $aColunas{1}:=2

 ARRAY REAL($aOrdens;1)

 $aOrdem{1}:=-1 `Ordem alfabético das linhas

 QR SET SORTS(qr_area;$aColunas;$aOrdem)

Se passa um número de área inválido, se gera o erro -9850.