Controle Lista suspensa no Power Apps

Uma lista que mostra somente o primeiro item, a menos que o usuário o abra.

Descrição

Um controle Lista suspensa economiza espaço na tela, especialmente quando a lista contém um grande número de opções. O controle utiliza apenas uma linha, a menos que o usuário selecione a divisa para revelar mais opções. O controle mostrará um máximo de 500 itens.

Principais propriedades

Default – o valor inicial de um controle antes que o usuário especifique um valor diferente.

Items – a fonte de dados que contém os itens que aparecem no controle. Se a fonte tiver várias colunas, defina a propriedade Value do controle para a coluna de dados que você deseja mostrar.

Value – a coluna de dados que você deseja mostrar no controle (por exemplo, se uma fonte de dados tiver várias colunas).

Selected – o registro de dados que representa o item selecionado.

AllowEmptySelection - se o controle mostra uma seleção vazia, se nenhum item foi selecionado. Os usuários do aplicativo também podem limpar suas opções selecionando o item em branco.

Propriedades adicionais

AccessibleLabel – rótulo para leitores de tela.

BorderColor – a cor da borda do controle.

BorderStyle – se a borda do controle é Sólida, Tracejada, Pontilhada ou Nenhuma.

BorderThickness – a espessura da borda do controle.

ChevronBackground – a cor atrás da seta para baixo em uma lista suspensa.

ChevronFill – a cor da seta para baixo em uma lista suspensa.

Color – a cor do texto em um controle.

DisplayMode – se o controle permite entrada do usuário (Edição), apenas exibe dados (Exibição), ou está desabilitado (Desabilitado).

DisabledBorderColor – a cor da borda de um controle se a propriedade DisplayMode do controle estiver definida como Desabilitado.

DisabledColor – a cor do texto em um controle se sua propriedade DisplayMode estiver definida como Desabilitado.

DisabledFill – a cor da tela de fundo de um controle se sua propriedade DisplayMode estiver definida como Desabilitado.

Fill – a cor da tela de fundo de um controle.

FocusedBorderColor – a cor da borda do controle quando ele está focalizado.

FocusedBorderThickness – A espessura da borda de um controle quando ele está focalizado.

Font – o nome da família de fontes em que o texto é exibido.

FontWeight – o peso do texto em um controle: Negrito , Seminegrito, Normal ou Mais claro.

Height – a distância entre a parte superior do controle e as bordas inferiores.

HoverBorderColor – a cor da borda do controle quando o usuário mantém o ponteiro do mouse nesse controle.

HoverColor – a cor do texto em um controle quando o usuário mantém o ponteiro do mouse sobre ele.

HoverFill – a cor da tela de fundo de um controle quando o usuário mantém o ponteiro do mouse sobre ele.

Italic – se o texto em um controle está em itálico.

OnChange – ações a serem executadas quando o usuário alterar o valor de um controle (por exemplo, ajustando um controle deslizante).

OnSelect – Ações a serem executadas quando o usuário tocar ou clicar em um controle.

PaddingBottom – a distância entre o texto em um controle e a borda inferior desse controle.

PaddingLeft – a distância entre o texto em um controle e a borda esquerda desse controle.

PaddingRight – a distância entre o texto em um controle e a borda direita desse controle.

PaddingTop – a distância entre o texto em um controle e a borda superior desse controle.

PressedBorderColor – a cor da borda do controle quando o usuário toca ou clica nesse controle.

PressedColor – a cor do texto em um controle quando o usuário toca ou clica nesse controle.

PressedFill – a cor da tela de fundo de um controle quando o usuário toca ou clica nesse controle.

Reset – se um controle é revertido para seu valor padrão.

SelectedText (Deprecated) – um valor de cadeia de caracteres que representa o item selecionado. Use Dropdown1.SelectedText.Value, substituindo "Dropdown1" pelo nome do controle suspenso no aplicativo.

SelectionColor – a cor do texto de um item ou itens selecionados em uma lista ou a cor da ferramenta de seleção em um controle de caneta.

SelectionFill – a cor da tela de fundo de um item ou itens selecionados em uma lista ou uma área selecionada de um controle de caneta.

Size – o tamanho da fonte do texto que aparece em um controle.

Strikethrough – se uma linha é exibida cortando o texto que aparece em um controle.

TabIndex – ordem de navegação do teclado em relação a outros controles.

Tooltip – texto explicativo exibido quando o usuário passa o mouse sobre um controle.

Underline – se uma linha é exibida sob o texto que aparece em um controle.

Visible – se um controle é exibido ou está oculto.

Width – a distância entre as bordas esquerda e direita de um controle.

X – a distância entre a borda esquerda de um controle e a borda esquerda de seu contêiner pai (ou a tela, se não houver contêiner pai).

Y – a distância entre a borda superior de um controle e a borda superior de seu contêiner pai (ou a tela, se não houver contêiner pai).

Observação

As propriedades de borda do submenu são controladas pelas propriedades FocusedBorder.

Exemplos

Lista simples

  1. Adicione um controle Lista suspensa e defina sua propriedade Items como esta expressão:

    ["Seattle", "Tokyo", "London", "Johannesburg", "Rio de Janeiro"]

    Não sabe como adicionar, nomear e configurar um controle?

  2. Mostre os itens na lista, selecionando a seta para baixo do controle enquanto pressiona a tecla Alt.

Lista de uma fonte de dados

Os princípios neste procedimento se aplicam a qualquer fonte de dados que fornece tabelas mas, para seguir exatamente essas etapas, você deve abrir um ambiente para o qual um banco de dados do Microsoft Dataverse foi criado e os dados de amostra foram adicionados.

  1. Abra um aplicativo em branco e, então, especifique a tabela Accounts.

  2. Adicione um controle Lista suspensa e defina sua propriedade Items como esta fórmula:

    Distinct(Accounts, 'Address 1: City')

    Essa fórmula mostra todas as cidades na tabela Accounts. Se mais de um registro tiver a mesma cidade, a função Distinct ocultará a duplicação no seu controle Lista suspensa.

  3. (opcional) Renomeie seu controle Lista suspensa como Cities, adicione um controle Galeria vertical e defina a propriedade Items da galeria com esta fórmula:

    Filter(Accounts, address1_city = Cities.Selected.Result)

    Esta função Filter mostra apenas os registros na tabela Accounts em que a cidade corresponde ao valor selecionado no controle Cities.

Diretrizes de acessibilidade

Contraste de cores

É necessário haver um contraste de cores adequado entre:

  • ChevronFill e ChevronBackground
  • ChevronHoverFill e ChevronHoverBackground
  • SelectionColor e SelectionFill
  • SelectionFill e Fill

Isso é adicional aos requisitos de contraste de cores padrão.

Suporte ao leitor de tela

Suporte de teclado

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).