4D Doc Center : Get listbox information

4D v12.4

Get listbox information


Get listbox information ( {* ;} objeto ; info ) -> Resultado

Parâmetro	Tipo	Descrição
*		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)
info	Inteiro longo	informação a obter
Resultado	Inteiro longo	valor atual

Descrição

O comando LISTBOX Get information devolve diferente informação relacionada com o tamanho e a visibilidade dos títulos e as barras de rolagem do objeto list box designado usandoos parâmetros objeto e *.

Se passa 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 .

No parâmetro info, passe um valor indicando o tipo de informação que queira obter. Pode utilizar um valor ou uma das seguintes constantes do tema “List box”:

Constante	Tipo	Valor	Comentário
Display listbox header	Inteiro longo	0	0=oculto, 1=mostrado
Display listbox hor scrollbar	Inteiro longo	2	0=oculto, 1=mostrado
Display listbox ver scrollbar	Inteiro longo	4
Listbox header height	Inteiro longo	1	Altura em pixels
Listbox hor scrollbar height	Inteiro longo	3	Altura em pixels
Listbox ver scrollbar width	Inteiro longo	5	Largura em pixels.
Position listbox hor scrollbar	Inteiro longo	6	Posição do cursor em pixels
Position listbox ver scrollbar	Inteiro longo	7	Posição do cursor em pixels.

As primeiras seis constantes são úteis para calcular o tamanho de uma área de list box em um formulário.
Quando utilize as constantes Position listbox hor scrollbar ou Position listbox ver scrollbar, o comando LISTBOX Get information devolve a posição do cursor de rolagem em relação com sua posição original, ou seja, o tamanho da parte oculta da janela, expresso em píxels. Como padrão, esta posição corresponde a 0. Combinando, por exemplo, com informação relativa à altura da fila, este valor lhe permite encontrar o conteúdo mostrado no listbox.

Exemplo

Dado uma list box que contenha filas com uma altura de 20 píxels cada uma. Se executar a seguinte instrução:

$scroll:=LISTBOX Get information(*;"Listbox";Position listbox ver scrollbar)

Se, por exemplo, $scroll devolve 200, pode concluir que a décima-primeira fila é atualmente a primeira mostrada no list box (200/20=10, portanto 10 filas estão ocultas).