LISTBOX Get property
LISTBOX Get property ( {* ;} objeto ; propriedade ) -> Resultado
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| * | Operador | → | Se especificado, objeto é um nome de objeto (string). Se omitido, objeto é uma variável |
| objeto | any | → | Nome objeto (se * for especificado) ou Variável (se * é omitido) |
| propriedade | Integer | → | Informação a obter |
| Resultado | Integer, Text | ← | Valor atual |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
Descrição
O comando LISTBOX Get property 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 Propriedades dos objetos .
Nota: se o list box ou coluna especificado utilizando os parâmetros objeto e * não existir, o comando LISTBOX Get property devolve -1 para as propriedades numéricas ou uma string vazia.
No parâmetro propriedade, 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 | Valor | Comentário |
|---|---|---|
| lk allow wordwrap | 14 | Propriedade Retorno de linha Aplica a: Coluna* Valores possíveis: lk no (0)lk yes (1) |
| lk auto row height | 31 | Propriedade Altura de fila automática. Aplica a: List box ou coluna Valores possíveis:lk yes lk no4D View Pro apenas: esta funcionalidade requer uma licença 4D View Pro. Para mais informação, consulte 4D View Pro. |
| lk background color expression | 22 | Propriedade Background Color Expression para list box de tipo seleção Aplica a: List box ou coluna |
| lk cell horizontal padding | 36 | Padding horizontal da célula em pixels (mesmo valor para a distância da borda ao conteúdo a partir da esquerda ou direita) Se aplica a: list box, coluna, cabeçalho rodapé |
| lk cell vertical padding | 37 | Padding vertical da célula em pixels (mesmo valor para a distância do conteúdo à borda superior ou inferior) Se aplica a: list box, coluna, cabeçalho, rodapé |
| lk column max width | 26 | Propriedade Maximum Width Aplica a: Coluna* |
| lk column min width | 25 | Minimum Width propriedade Aplicada a: Coluna* |
| lk column resizable | 15 | Propriedade Resizable Aplica a: Coluna* Valores possíveis: lk no (0)lk yes (1) |
| lk detail form name | 19 | Propriedade Detail Form Name para a seleção de tipo list box Aplica a: List box |
| lk display footer | 8 | 0=oculto, 1=mostrado |
| lk display header | 0 | 0=oculto, 1=mostrado |
| lk display type | 21 | Propriedade Tipo de visualização para colunas numéricas Aplica a: Coluna* Valores possíveis:** **lk numeric format (0): mostra valores em formato numéricolk three states checkbox (1): mostra valores como caixas de seleção de três estados |
| lk double click on row | 18 | Propriedade Duplo clique na linha para os list box de tipo seleção Aplica a: List box Valores possíveis:lk do nothing (0): não desencadeia nenhuma ação automáticalk edit record (1): mostra o registro correspondente em modo leitura-escrituralk display record (2): mostra o registro correspondente em modo de apenas leitura |
| lk extra rows | 13 | Propriedade Ocultar linhas vazias finais Aplica a: List box Valores possíveis:** **lk display (0)lk hide (1) |
| lk font color expression | 23 | Propriedade Expressão cor fontepara list box de tipo seleção Aplica a: List box ou coluna |
| lk font style expression | 24 | Propriedade Expressão estilo para list boxes de tipo seleção e coleção Aplica a: List box ou coluna |
| lk hide selection highlight | 16 | Propriedade Ocultar ressaltado de seleção Aplica a: List box Valores possíveis:** **lk no (0)lk yes (1) |
| lk highlight set | 27 | Highlight Set propriedade para seleção tipo list box Aplica a: List box |
| lk hor scrollbar height | 3 | Altura em pixels |
| lk movable rows | 35 | A propriedade Linhas móveis para list box de tipo array Se aplica a: List box (excluindo o modo hierárquico) Valores possíveis: lk no (0): as linhas não podem ser movidas o se pueden mover durante execução lk yes (1): as linhas podem ser movidas durante execução (pré-determinado) |
| lk multi style | 30 | Multi-style propriedade Aplica a: Column* Valores possíveis: lk no (0)lk yes (1) |
| lk named selection | 28 | Propriedade Named Selection para list box de tipo seleção Aplica a: List box |
| lk resizing mode | 11 | Column Auto-Resizing proriedade Aplica a: List box Possíveis valores: lk manual (0)lk automatic (2) |
| lk row height unit | 17 | Unidade de propriedade Row Height Aplica a: List box Possíveis valores:** **lk lines (1) lk pixels (0) |
| lk selection mode | 10 | Propriedade Selection Mode Aplica a: List box Valores possíveis: ** **lk none (0) lk single (1) lk multiple (2) |
| lk single click edit | 29 | Propriedade Single-Click Edit Aplica a: List box Possíveis valores: lk no (0)lk yes (1) |
| lk sortable | 20 | Propriedade Sortable Aplica a: List box Valores possíveis:** **lk no (0)lk yes (1) |
| lk truncate | 12 | Propriedade Truncate with ellipsis Aplica a: List box ou coluna Valores possiveis:** **lk without ellipsis (0)lk with ellipsis (1) |
| lk ver scrollbar width | 5 | Largura em pixels. |
*Estas propriedades só se aplicam às colunas list box; se passar um list box como parâmetro com uma destas propriedades, LISTBOX Get property devolve -1, ou uma string vazia, dependendo da propriedade passada.
Em geral, para indicar um resultado não válido LISTBOX Get property devolve -1 ao recuperar as propriedades que têm valores numéricos, ou uma string vazia; Entretanto, não são gerados erros. Mais específicamente, isto ocorre nos seguintes casos:
Se passar uma propriedade que não existir
Se passar uma propriedade que não está disponível para a list box ou coluna especificada, por exemplo, pode passar a propriedade lk font color expression com um list box de tipo array
Se passar uma coluna como parâmetro com uma propriedade que se aplique a um list box, e viceversa, se passar um list box como parâmetro com uma propriedade que se aplique a uma coluna (ver acima *)
Além disso, não é possível devolver valores de mais de uma coluna por vez; se tentar utilizar o símbolo "@" a parte do nome de coluna para indicar várias colunas com nomes similares, LISTBOX Get property devolve o primeiro valor coincidente que encontre; como resultado, o valor devolvido não tem verdadeira importância.
- As constantes lk display footer e lk display header são úteis para calcular o tamanho de uma área de list box em um formulário.
- Quando utilize as constantes lk hor scrollbar position ou lk ver scrollbar position, o comando LISTBOX Get property 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. Entretanto, estas constantes são obsoletas e podem ser substituídas pelo comando OBJECT GET SCROLL POSITION.
- A declaração LISTBOX Get property(vLB;lk footer height) retorna o mesmo valor que o comando LISTBOX Get footers height quando rodapés são exibidos. No entanto, se rodapés não são exibidos, LISTBOX Get property retornas 0 enquanto LISTBOX Get footers height ainda retorna a altura, neste caso teórico, dos rodapés.
Exemplo 1
Dado um listbox"MyListbox", é executada a seguinte instrução:
$Value:=LISTBOX Get property(*;"MyListbox";lk selection mode) // o valor devolvido indica o modo de seleção
Neste caso, o resultado devolvido indica se várias linhas podem ser selecionadas.
Exemplo 2
Dado um list box "MyListbox", é executada a seguinte instrução:
$resizable:=LISTBOX Get property(*;"MyListbox";lk column resizable)
LISTBOX Get property devolve -1 porque a propriedade lk column resizable aplica a colunas e um list box foi passado como parâmetro.