LISTBOX SET ROW HEIGHT

4D v16.3


LISTBOX SET ROW HEIGHT ( {* ;} objeto ; linha ; altura )

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 de objeto (se * for omitido) ou variável (se * omitido)
linha	Inteiro longo	Linha list box cuja altura você quer estabelecer
altura	Inteiro longo	Altura da linha de list box

4D View Pro

Este comando requer uma licença 4D View Pro. Se esta licença não estiver disponível, um erro é exibido na list box quando o formulário for executado.. Para saber mais, consulte 4D View Pro.

Descrição

O comando LISTBOX SET ROW HEIGHT lhe permite modificar a altura da fila especificada no objeto list box designado utilizando os parâmetros objeto e *.

Se passar o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (string). Se não passar este parâmetro, indica que o parâmetro objeto for uma variável. Neste caso, se passar uma referência variável ao invés de uma string. Para mais informação sobre nomes de objetos, consulte Propriedades dos objetos.

Se a fila especificada não existir no list box, o comando não faz nada.

A unidade utilizada para a altura especificada corresponde a definida globalmente para as filas de list box, seja na lista de propriedades ou por uma chamada anterior ao comando LISTBOX SET ROWS HEIGHT.

Nota: para mais informação sobre o cálculo da altura das filas, consulte o Manual de Desenho.

Se não houver um array de altura de fila associado ao list box, este comando cria um dinâmico; do contrário, se utilizar o array existente especificado na propriedade Array de altura de fila. O uso deste comando para estabelecer a altura de fila individual produz o mesmo resultado visual que a associação de um array de altura de fila; Entretanto, preencher um array com valores de altura da fila for muito mais rápido que chamar a este comando em um loop para ajustar a altura das filas de uma em uma para o list box.

Nota importante: se o comando LISTBOX SET ROWS HEIGHT for chamado posteriormente com uma unidade diferente a que se definiu previamente, este valor predeterminado substituirá e reinicializará o array de altura das filas existentes definidas utilizando LISTBOX SET ROW HEIGHT (ver o exemplo).

Exemplo 1

Se quiser mudar a altura de umas poucas linhas no list box abaixo:

Se executar este código:

  //a unidade atual é píxels

 LISTBOX SET ROW HEIGHT(*;"listboxname";3;40) //Kuwait

 LISTBOX SET ROW HEIGHT(*;"listboxname";7;14) //Sérbia

... obterá o seguinte resultado:

Exemplo 2

Se definir uma altura de fila predeterminada e depois definir vários valores de altura de fila individuais utilizando o comando LISTBOX SET ROW HEIGHT:

 LISTBOX SET ROWS HEIGHT(*;"listboxname";25;lk pixels) // altura global definida em píxels

 

 LISTBOX SET ROW HEIGHT(*;"listboxname";1;30) // linhaa 1: 30 píxels

 LISTBOX SET ROW HEIGHT(*;"listboxname";5;40) // linha 5: 40 píxels

 LISTBOX SET ROW HEIGHT(*;"listboxname";11;50) // linha 11: 50 píxels

Mais tarde, se for executado o código abaixo...

LISTBOX SET ROWS HEIGHT(*;"listboxname";18;lk pixels)

... Então a altura global de fila se estabelece em 18 píxels; Entretanto, já que a unidade não mudou, as filas 1, 5 e 11 manterão seus valores de altura específicos, ou seja, 30, 40 e 50 píxels como foi definido anteriormente pelo comando LISTBOX SET ROW HEIGHT.

Por outro lado, se o código abaixo for executado posteriormente...

LISTBOX SET ROWS HEIGHT(*;"listboxname";2;lk lines)

... Então as filas 1, 5 e 11 voltam para a altura global de fila predeterminada estabelecida por LISTBOX SET ROWS HEIGHT (ou seja, 2 linhas) já que a unidade mudou de píxels a linhas. Já que não há conversão automática aplicada, a mudança de unidades sempre resulta em altura de fila reinicializada no novo valor como padrão definido.

Ver também

LISTBOX Get row height
LISTBOX SET ROWS HEIGHT