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 pode não ter itens selecionados. Quando falso, sempre haverá um item selecionado, que será inicialmente o Padrão ou o primeiro item.
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
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?
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.
Abra um aplicativo em branco e, então, especifique a tabela Accounts.
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.
(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
- AccessibleLabel precisa estar presente.
Suporte de teclado
- TabIndex deve ser zero ou maior para que os usuários de teclado possam navegar para ela.
- Os indicadores de foco precisam ser evidentes. Use FocusedBorderColor e FocusedBorderThickness para fazer isso.
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).