LISTBOX MOVE COLUMN
LISTBOX MOVE COLUMN ( {* ;} objeto ; colPosition )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| * | Operador | → | Se especificado, objeto é um nome de objeto (cadeia) Se omitido, objeto é uma variável |
| objeto | any | → | Nome do objeto (se especificado *) ou Variável (se omitido *) da coluna a mover |
| colPosition | Integer | → | Nova localização da coluna |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando LISTBOX MOVE COLUMN move por programação a coluna designada pelos parâmetros objeto e * no contexto do formulário em execução (modo Aplicação). O formulário original, gerado em modo Desenho, não se modifica.
Os parâmetros objeto e * designam a coluna a mover. Ao passar o parâmetro opcional * indica que o parâmetro objeto é um nome de coluna (cadeia). Se não passa este parâmetro, indica que o parâmetro objeto é uma variável de coluna. Neste caso, passe uma referência de variável no lugar de uma cadeia.
i
A coluna se move justo em frente da designada pelo parâmetro posicaoCol. Se o parâmetro posicaoCol é maior ao número total de colunas, logo a coluna se move até justo depois da última coluna.
Nota: Este comando não faz nada quando se aplica a primeira coluna de um list box que se mostra no modo hierárquico.
O comando em conta as propriedades das colunas estáticas e bloqueadas: por exemplo, se tentar mover uma coluna estática, o comando não faz nada.
Esta funcionalidade está presente em 4D em modo Aplicação: o usuário pode mover as colunas não estáticas utilizando o mouse. No entanto, a diferença do deslocamento realizado pelo usuário, este comando não gera o evento On Column Moved.
Exemplo
Você quer inverter a segunda e terceira coluna do list box:
LISTBOX MOVE COLUMN(*;"column2";3)