4D Doc Center : LISTBOX MOVE COLUMN

4D v14.3

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	Objeto de formulário	Nome do objeto (se especificado ) ou Variável (se omitido ) da coluna a mover
colPosition	Inteiro longo	Nova localização da coluna

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)