Saltar para o conteúdo principal
Versão: v20 R4 BETA

Drop-down List

Listas drop-down são objetos que permitem que os usuários selecionem de uma lista. Gerenciar os itens exibidos na lista drop down usando um array, uma lista de escolha ou uma ação padrão.

Em macOS, listas drop down são também chamadas de "menu pop up" Ambos os nomes referem aos mesmos objetos. Ambos os nomes referem aos mesmos objetos. Como no exemplo abaixo, a aparência desses objetos podem diferenciar levemente de acordo com a plataforma:

Tipos de listas pendentes

Pode criar diferentes tipos de listas pendentes com diferentes funcionalidades. Para definir um tipo, selecione os valores adequados Tipo de expressão e Tipo de dados na lista Propriedade ou utilize o seu equivalente JSON.

TipoFuncionalidadesTipo de expressãoTipo de dadosDefinição JSON
ObjectConstruído sobre uma colecçãoObjectNumeric, Text, Date, ou TimedataSourceTypeHint: object + numberFormat: <format> or textFormat: <format> ou dateFormat: <format> or timeFormat: <format>
ArrayConstruído sobre um arrayArrayNumeric, Text, Date, ou TimedataSourceTypeHint: arrayNumber ou arrayText ou arrayDate ou arrayTime
Lista de opções guardada como valorConstruído com base numa lista de opções (“padrão”)ListaValor do item seleccionadodataSourceTypeHint: text + saveAs: value
Salvar comoConstruído sobre numa lista de escolha. A posição do item é guardadaListaReferência do item seleccionadodataSourceTypeHint: integer + saveAs: reference
Lista de seleção hierárquicaPode apresentar conteúdos hierárquicosListaReferência da listadataSourceTypeHint: integer
Ação padrãoCriado automaticamente pela açãoanyqualquer exceto referência de listaany definition + action: <action> (+ focusable: false for actions applying to other areas)

Manuseamento de listas pendentes

Utilização de um objecto

Esta funcionalidade só está disponível em projectos 4D.

An object encapsulating a collection can be used as the data source of a drop-down list. O objeto deve conter as seguintes propriedades:

PropriedadeTipoDescrição
valuesCollectionObrigatório - Coleção de valores escalares. Todos os valores devem ser do mesmo tipo. Tipos suportados:
  • strings
  • números
  • datas
  • horas
  • Se estiver vazia ou não for definida, a lista pendente está vazia
    indexnumberIndex of the currently selected item (value between 0 and collection.length-1). Se -1 for definido, currentValue será exibido como uma cadeia de caracteres de marcador de posição
    currentValueigual a ColecçãoItem atualmente selecionado (utilizado como valor de marcador de posição se definido por código)

    Se o objeto contiver outras propriedades, estas são ignoradas.

    Objetos lista drop down são iniciados ao carregar uma lista de valores em um array. Pode fazer isso de várias maneiras:

    • Enter a list of default values in the object properties by selecting \&#060;Static List&#062; in the Data Source theme of the Property List. Os valores por defeito são carregados automaticamente para um objeto.

    • Executar código que cria o objeto e as suas propriedades. For example, if "myList" is the variable associated to the drop-down list, you can write in the On Load form event:

    // Form.myDrop é a datasource do objeto do formulário

    Form.myDrop:=New object
    Form.myDrop.values:=New collection("apples"; "nuts"; "pears"; "oranges"; "carrots")
    Form.myDrop.index:=-1 //currentValue é um placeholder
    Form.myDrop.currentValue:="Select a fruit"

    A lista suspensa é exibida com a string de placeholder:

    Depois de o utilizador selecionar um valor:

    Form.myDrop.values // ["apples","nuts","pears","oranges","carrots"]
    Form.myDrop.currentValue //"oranges" Form.myDrop.index //3

    Usar um array

    Um array é uma lista de valores na memória que são referenciados pelo nome do array. Uma lista drop down exibe um array como lista de valores quando clicar nela.

    Para inicializar o array associado à lista pendente, pode:

    • Enter a list of default values in the object properties by selecting \&#060;Static List&#062; in the Data Source theme of the Property List. Os valores padrão são carregados em um array automático. Pode fazer uma referência ao array usando o nome da variável associado com o objeto.

    • Antes que o objeto seja exibido, execute um código que atribua valores aos elementos do array. Por exemplo:

      ARRAY TEXT($aCities;6)
    $aCities{1}:="Philadelphia"
    $aCities{2}:="Pittsburg"
    $aCities{3}:="Grand Blanc"
    $aCities{4}:="Bad Axe"
    $aCities{5}:="Frostbite Falls"
    $aCities{6}:="Green Bay"

    Neste caso, o nome da variável associada ao objeto de formulário deve ser $aCities. Esse código pode ser colocado no método formulário e executado quando o evento de formulário On Load acontecer.

    • Antes que o objeto seja exibido, carregue os valores para uma lista em um array usando o comando LIST TO ARRAY. Por exemplo:
       LIST TO ARRAY("Cities";$aCities)

    Neste caso também o nome da variável asociada al objeto del formulario debe ser $aCities. Este código pode ser executado ao invés das sentenças de atribuição mostradas anteriormente.

    Se precisar salvar as escolhas do usuário em um campo, precisa usar uma declaração de atribuição que rode depois que o registro seja aceito. O código poderia ser assim:

      Caso de
    :(Form event=On Load)
    LIST TO ARRAY("Cities";aCities)
    If(Record number([People])<0) `novo registo
    aCities:=3 `apresentar um valor predefinido
    Else `registo existente, apresentar valor armazenado
    aCities:=Find in array(aCities;City)
    End if
    :(Form event=On Clicked) `o utilizador modificou a selecção
    City:=aCities{aCities} `o campo recebe um novo valor
    :(Form event=On Validate)
    City:=aCities{aCities}
    :(Form event=On Unload)
    CLEAR VARIABLE(aCities)
    End case

    Deve selecionar cada event que teste nas estruturas Case. Os arrays sempre contém um número finito de elementos. A lista de elementos é dinâmica e pode ser modificada por um método. Itens em um array podem ser modificados, ordenados e terem itens adicionados.

    Utilizar uma lista de seleção

    Se quiser usar uma lista drop down para gerenciar os valores de um campo ou lista variável, 4D permite referir o campo ou variável diretamente como fonte de dados do objeto. Isso facilita gerenciar variáveis/campos listados.

    Por exemplo, no caso de um campo "Cor" que só possa conter os valores "White", "Blue", "Green" ou "Red", agora é possível criar uma lista que contenha esses valores e associe-os a um objeto emergente menu que faça referência ao campo "Color". 4D então se encarrega automaticamente de gerenciar o input e exibir os valores atuais no formulário.

    Se usar uma lista hierárquica, só o primeiro nível é mostrado e pode ser selecionado. Se usar uma lista hierárquica, só o primeiro nível é mostrado e pode ser selecionado.

    Para associar um menu pop up/lista drop down ou um combo box com um campo ou variável, pode digitar o nome do campo ou variável diretamente no campo Variável ou Expressão do objeto na Lista Propriedade.

    Não é possível combinar esse princípio com o uso de um array para iniciar o objeto. Se digitar um nome de campo na área Nome da variável, deve usar uma lista de seleção.

    Quando o formulário for executado, 4D automaticamente gerencia o menu pop up ou com box durante a entrada ou a visualização: quando um usuário escolher um valor, é salvo no campo; esse valor de campo é mostrado no menu pop up quando o formulário for exibido:

    Valor do item selecionado ou Referência do item selecionado

    Quando associar um menu pop up/lista drop down com uma lista de escolhas e com um campo, pode usar a propriedade Save as Value/Reference. Essa opção permite otimizar o tamanho dos dados salvos.

    Se usar uma lista hierárquica, só o primeiro nível é mostrado e pode ser selecionado.

    A hierarchical drop-down list has a sublist associated with each item in the list. Eis um exemplo de uma lista pendente hierárquica:

    Nos formulários, as listas pendentes hierárquicas estão limitadas a dois níveis.

    You can assign the hierarchical choice list to the drop-down list object using the Choice List field of the Property List.

    You manage hierarchical drop-down lists using the Hierarchical Lists commands of the 4D Language. Todos os comandos que suportam a sintaxe (*; "name") podem ser utilizados com listas pendentes hierárquicas, por exemplo, List item parent.

    Usar uma ação padrão

    Pode atribuir uma ação padrão a menu pop up ou lista drop down (Action tema da Lista de Propriedades). Esta funcionalidade é suportada nos seguintes contextos:

    • Utilização da ação padrão gotoPage. In this case, 4D will automatically display the page of the form that corresponds to the number of the item that is selected. For example, if the user selects the 3rd item, 4D will display the third page of the current form (if it exists). At runtime, by default the drop-down list displays the page numbers (1, 2...).

    • Por exemplo, se selecionar a ação padrão backgroundColor, no tempo de execução o objeto mostrará uma lista automática de cores de fundo. Essa funcionalidade exige que:

      • a styled text area (4D Write Pro area or input with multistyle property) is present in the form as the standard action target.
      • the focusable property is not set to the drop-down list. At runtime the drop-down list will display an automatic list of values, e.g. background colors. Pode substituir esta lista automática atribuindo além disso uma lista de seleção na qual cada elemento tenha atribuída uma ação padrão personalizada.

    Esta funcionalidade não pode ser utilizada com uma lista pendente hierárquica.

    Propriedades compatíveis

    Formato Alfa - Negrita - Inferior - [Estilo del botón](properties_TextAndPicture. md#button-style) - Lista de opciones - Clase - Formato de fecha - [Tipo de expresión](properties_Object. md#expression-type) - Focusable - Fuente - Color de la fuente - [Tamaño de la fuente](properties_Text. md#font-size) - Altura - Consejo de ayuda - Tamaño horizontal - [Italic](properties_Text. md#italic) - Izquierda - No renderizado - [Nombre del objeto](properties_Object. md#object-name) - Derecha - Acción estándar - Guardar como - [Formato de tiempo](properties_Display. md#time-format) - Superior - Type - Subrayado - [Variable o expresión](properties_Object. md#variable-or-expression) - Tamaño vertical - Visibilidad - Ancho