Propriedades específicas de colunas de list box

É possível selecionar uma coluna de list box no editor de formulários clicando na coluna quando o objeto de list box está selecionado:

Pode definir para cada coluna de List box as propriedades padrão (texto, cor de fundo, etc.); estas propriedades tem prioridade sobre as propriedades do objeto List box.

Você também tem acesso às propriedades específicas descritas nesta seção. 

• Expressão: a propriedade Expressão permite definir a expressão 4D para se associar à coluna:

• É possível introduzir:
• •  uma expressão 4D (expressão simples, fórmula ou método 4D). O resultado da expressão será mostrado automaticamente ao se passar para o modo Aplicação. A expressão será avaliada para cada registro da seleção (atual ou temporal) da tabela principal. Se estiver vazia, a coluna não mostrará nenhum resultado.
  • uma variável simples (neste caso, a variável deve ser declarada explicitamente para a compilação). É possível utilizar qualquer tipo de variável exceto BLOBs e arrays. O valor da variável será geralmente calculado no evento  On Display Detail.
  •  Um campo utilizando a sintaxe padrão [Tabela]Campo (exemplo: [Empregados]Sobrenome). Podem ser utilizados os seguintes tipos de campos:
    
    • Alfa
    • Texto
    • Numérico
    • Data
    • Hora
    • Imagem
    • Booleano
    
    É possível utilizar campos da tabela principal ou de outras tabelas.

Em todos os casos, é possível definir a expressão com a ajuda do editor de fórmulas de 4D clicando no botão [...] na lista de propriedades:

            Caso se passe uma expressão, a coluna não será editável inclusive se a opção Editável estiver selecionada.

Caso se utilize um campo ou variável, a coluna será editável ou não dependendo da opção Editável (e o atributo “Não modificável” no editor de estrutura).

Em modo Desenho, o tipo de fonte de dados é mostrado na primeira linha da coluna. Por exemplo, Campo=[Tabela1]MeuCampo. Se a expressão definida estiver incorreta, a coluna do list box mostrará uma mensagem de erro no modo Aplicação.

Pode utilizar campos da tabela principal ou de outras tabelas.

• Valores por padrão (list box de tipo array): faça clique no botão Edição... para mostrar uma caixa de diálogo de entrada que permite associar uma lista de valores por padrão para a coluna. Estes valores serão acessíveis automaticamente na variável array associada à coluna durante a execução do formulário. Deve introduzir uma lista de valores separados por dois retornos de carro logo validar a caixa de diálogo. Para maior informação sobre esta caixa de diálogo consulte o parágrafo Valores padrão na seção Controles de entrada de dados e ajuda de entrada.

• Tipo de dados: este menu permite definir o tipo de expressão ou da variável associada à coluna. Utiliza-se para indicar o formato de saída a ser aplicado e permite atualizar o menu Tipo de saída no tema “Mostrar”.

Se um campo é introduzido na área Expressão, não se mostra a propriedade Tipo de dados; utiliza-se o formato de saída correspondente ao tipo de campo.

• Lista de seleção: esta propriedade pode ser utilizada para associar uma Lista de valores a uma coluna do list box. Se você desenha uma lista, o usuário pode utilizar seus valores (mostrados em um menu suspenso) para modificar os valores da coluna e seu array associado:

Este tema agrupa as propriedades relacionadas com a largura da coluna do list box.

• Largura: largura padrão da coluna (em pixels). Este valor é atualizado quando se redimensiona a coluna utilizando o mouse no editor de formulários.

Se a propriedade Redimensionável está selecionada, o usuário também pode redimensionar manualmente a coluna.

• Largura mínima: largura mínima da coluna (em pixels). A largura da coluna não pode ser menor que este valor em caso de redimensionamento da coluna ou do formulário.

• Largura máxima: largura máxima da coluna (em pixels). A largura da coluna não pode ser maior que este valor em caso de redimensionamento da coluna ou do formulário.

Este tema só contém a opção Redimensionável (selecionada por padrão). Quando esta opção está selecionada, o usuário pode redimensionar a coluna movendo os lados da área de título.

Este tema agrupa todas as propriedades relacionadas com a entrada de dados à coluna do list box.

• Editável: autoriza a entrada de dados à coluna (selecionada por padrão). Para modificar o valor de uma célula, o usuário deve fazer um clique duplo no valor. Quando esta propriedade está desmarcada, os menus suspensos associados à coluna por meio da lista (temas “Fonte de dados” e “Faixa de valores”) são desativados.

• Nota: para maior informação sobre estes mecanismos implementados para a entrada nos list box, consulte o parágrafo Gestão de entrada no manual de Linguagem de 4D.

• Filtro de entrada: associa um filtro de entrada às células das colunas. Esta propriedade não é acessível se a propriedade Editável não estiver selecionada.

Este tema permite designar as listas utilizadas para controlar a entrada à coluna do list box.

• Lista de obrigatórios: permite designar uma lista onde somente estes valores podem ser inseridos na coluna. Os valores da lista são acessíveis utilizando um menu suspenso associado a cada célula (favor referir-se à propriedade “Lista de valores” no tema Fonte de dados).

Diferente da propriedade Lista de valores, quando uma lista obrigatória é definida, não é possível a entrada de dados utilizando o teclado, somente é permitida a seleção de um valor da lista utilizando o menu suspenso. Se várias listas são definidas utilizando as propriedades Lista de valores e Lista de obrigatórios, a propriedade Lista de obrigatórios tem prioridade.

• Lista de excluídos: permite designar uma lista cujos valores não podem ser introduzidos na coluna. Se um valor excluído é introduzido, o valor não é aceito e uma mensagem de erro aparece.

Este tema permite especificar o formato de visualização dos valores da coluna e a propriedade Invisível. O conteúdo deste tema varia de acordo com o tipo de variável definido no tema Objetos.

• Formato tipo: permite associar um formato de visualização aos dados da coluna. Os formatos propostos dependem do tipo de variável (list box de tipo array) ou do tipo de dados/do campo (list box de tipo seleção). Os formatos padrão de 4D que podem ser utilizados são: Alfa, Numérico, Data, Hora, Imagem e Booleano. O tipo de texto não tem formato de visualização específico. Os formatos personalizados existentes também estão disponíveis.

• Os arrays booleanos podem ser mostrados como caixas de seleção ou menus suspensos. Se você escolher a opção Caixa de Seleção, aparecerá a propriedade Título que lhe permite introduzir o título da caixa de seleção. Se você escolher a opção Meu Suspenso, aparecerão as propriedades Texto se verdadeiro e Texto se falso, permitindo-lhe definir as duas etiquetados menu suspenso.
• As colunas de valores numéricos podem ser mostradas como caixas de seleção de três estados. Esta opção encontra-se na lista suspensa Tipo de saída. Se você selecionar o tipo Caixa de seleção de três estados, serão mostrados os seguintes valores:
• • 0 = caixa não selecionada
  • 1 = caixa selecionada
  • 2 (ou qualquer valor >0) = caixa cheia semi selecionada (terceiro estado). Para a entrada de dados, este estado devolve o valor 2.
  • -1 = caixa invisível,
  • -2 = caixa não selecionada, não editável,
  • -3 = caixa seleccionada, não editável,
  • -4 = caixa semi selecionada, não editável

• A propriedade Invisível, quando está selecionada, permite ocultar a coluna no ambiente Aplicação.

No ambiente Desenho, é possível mostrar ou ocultar as colunas invisíveis utilizando o menu contextual associado ao list box. (clique em uma coluna ou em um título de coluna):