4D Doc Center : PV SORT ONE

4D View v14

PV SORT ONE


PV SORT ONE ( area ; esquerda ; superior ; direita ; inferior ; endereço ; chave ; ordem )

Parâmetro	Tipo	Descrição
area	Inteiro longo	Área 4D View
esquerda	Inteiro longo	Número de coluna a esquerda
superior	Inteiro longo	Número da linha de cima
direita	Inteiro longo	Número da coluna a direita
inferior	Inteiro longo	Número de linha de abaixo
endereço	Inteiro	0 = Ordem de linhas; 1 = Ordem de colunas
chave	Inteiro longo	Coluna ou linha que contém os valores a ordenar
ordem	Inteiro	0 = Ascendente; 1 = Descendente

Descrição

O comando PV SORT ONE ordena o conteúdo da seleção delimitada por esquerda, superior, direita e inferior em relação com os valores contidos na linha ou coluna chave, na ordem definido por ordem.

endereço indica se deve ordenar linhas ou colunas:

Se passar 0, ordena as linhas em função dos valores da coluna chave.
Se passar 1, ordena as colunas em função dos valores da linha chave.

Este comando só funciona com os dados estáticos.
As áreas dinâmicas (arrays e campos relacionados), devem ser selecionados utilizando os comandos 4D, o principio consiste na ordem da fonte. Um exemplo de ordem de colunas dinâmicas associadas aos campos ao fazer clique no cabeçalho se apresenta na descrição do comando PV GET CELL FIELD. Tenha em conta que a ordem não é possível em arrays e campos de tipo imagem assim como em colunas calculadas (que chamam a um método de chamada e mostram seu resultado).

Exemplo

Este exemplo permite a ordem ascendente das colunas estática fazendo clique no cabeçalho da coluna. A área só contém colunas estáticas.

Começamos instalando o método de chamada de retorno HeaderSortMethod, que será chamada em caso de um clique na área:

PV ON EVENT(area;pv on clicked;"HeaderSortMethod")

O método HeaderSortMethod intercepta os cliques nos cabeçalhos das colunas e ordena os dados correspondentes (da linha 1 a 25) em ordem ascendente:

  `Método HeaderSortMethod

 C_BOOLEAN($0)

 C_LONGINT($1;$2;$3;$4;$5;$6)

 

 If($5=0) `Se o clique foi no cabeçalho

    $0:=True `Filtrar o evento

    PV SORT ONE(area;$4;1;$4;25;1;$4;0) `Ordem ascendente da coluna selecionada

 End if