LISTBOX SORT COLUMNS

4D v19.8


LISTBOX SORT COLUMNS ( {* ;} objeto ; numColuna ; ordenar {; numColuna2 ; ordenar2 ; ... ; numColunaN ; ordenarN} )

Parâmetro	Tipo	Descrição
*	Operador	se especificado, objeto é um nome de objeto (string). Se omitido, objeto é uma variável
objeto	Objeto de formulário	Nome objeto (se * for especificado) ou Variável (se * é omitido)
numColuna	Inteiro longo	Número da coluna a ordenar
ordenar	Operador	">" para ordernar em ordem ascendente ou "<" para ordenar em ordem descendente

Descrição

O comando LISTBOX SORT COLUMNS [descv] ordena as filas do list box designado pelos parâmetros objeto e * em função dos valores de uma ou várias colunas.[#/descv]

Nota: uma ordenação padrão se aplica em bancos de dados a um único valor de coluna quando o usuário clicar no cabeçalho da coluna (ver Ordenação padrão).

Se passar o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (string). Se omitir este parâmetro, indica que o parâmetro objeto é uma variável. Nesse caso, não passa uma string, mas uma referência de variável. Para maior informação sobre nomes de objetos, consulte a seção Propriedades dos objetos.

Em numCol, passe o número de coluna cujos valores quer utilizar como critério de ordenação. Pode utilizar todo tipo de dados, a exceção de imagens e ponteiros.

Em ordem, passe o símbolo > ou < para indicar o critério de ordenação. Se ordem contém o símbolo “maior que”(>), o critério de ordenação é ascendente. Se ordem contém o símbolo “menor que” (<), o critério de ordenação es descendente.

Pode definir ordenações multiniveis: para fazer isso, passe tantos pares (numCol;orden) como seja necessário. O nível de ordenação é definido pela posição do parâmetro na chamada.

Conforme com o princípio de funcionamento do list box, as colunas estão sincronizadas, o que significa que a ordenação de uma coluna repercute automaticamente em todas as outras colunas do objeto.

Nota: O comando LISTBOX SORT COLUMNS não leva em consideração a propriedade de listbox Ordenável .