Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Uma lista que mostra apenas o primeiro item, a menos que o usuário o abra.
Description
Um controle suspenso conserva os imóveis de tela, especialmente quando a lista contém muitas opções. O controle ocupa apenas uma linha, a menos que o usuário selecione a divisa para revelar mais opções. O controle mostra um máximo de 500 itens.
Principais propriedades
Padrão – o valor inicial de um controle antes que o usuário especifique um valor diferente.
Itens – a fonte de dados que contém os itens que aparecem no controle. Se a origem tiver várias colunas, defina a propriedade Value do controle como a coluna de dados que você deseja mostrar.
Valor – 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 não pode ter itens selecionados. Quando false, sempre haverá um item selecionado, que inicialmente será o Padrão ou o primeiro item.
Propriedades adicionais
AccessibleLabel – Rótulo para leitores de tela.
BorderColor – A cor da borda de um controle.
BorderStyle – se a borda de um controle é Solid, Dashed, Dotted ou None.
BorderThickness – A espessura da borda de um 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.
Cor – a cor do texto em um controle.
DisplayMode – se o controle permite a entrada do usuário (Editar), exibe apenas dados (Exibição) ou está desabilitado (Desabilitado).
DisabledBorderColor – A cor da borda de um controle se a propriedade DisplayMode do controle estiver definida como Desabilitada.
DisabledColor – A cor do texto em um controle se sua propriedade DisplayMode estiver definida como Desabilitada.
DisabledFill – A cor da tela de fundo de um controle se sua propriedade DisplayMode estiver definida como Desabilitada.
Fill – a cor da tela de fundo de um controle.
FocusedBorderColor – A cor da borda de um controle quando o controle está focado.
FocusedBorderThickness – A espessura da borda de um controle quando o controle está focado.
Fonte – o nome da família de fontes em que o texto é exibido.
FontWeight – O peso do texto em um controle: Negrito, Semiaberto, Normal ou Mais Leve.
Altura – a distância entre as bordas superior e inferior de um controle.
HoverBorderColor – A cor da borda de um 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.
Itálico – se o texto em um controle é itálico.
OnChange – Ações a serem executadas quando o usuário altera o valor de um controle (por exemplo, ajustando um controle deslizante).
OnSelect – Ações a serem executadas quando o usuário seleciona 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 de um controle quando o usuário seleciona esse controle.
PressedColor – A cor do texto em um controle quando o usuário seleciona esse controle.
PressedFill – A cor da tela de fundo de um controle quando o usuário seleciona esse controle.
Redefinição – se um controle é revertido para seu valor padrão.
SelectedText (preterido) – um valor de cadeia de caracteres que representa o item selecionado. Em vez disso, 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 na 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 em uma área selecionada de um controle de caneta.
Tamanho – o tamanho da fonte do texto que aparece em um controle.
Tachado – se uma linha aparece por meio do texto que aparece em um controle.
TabIndex – Ordem de navegação do teclado em relação a outros controles.
Dica de ferramenta – texto explicativo exibido quando o usuário passa o mouse sobre um controle.
Sublinhado – se uma linha aparece sob o texto que aparece em um controle.
Visível – se um controle aparece ou está oculto.
Largura – 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 de submenu são controladas pelas propriedades FocusedBorder .
Exemplos
Lista simples
Adicione um controle suspenso e defina sua propriedade Items para 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 .
Listar de uma fonte de dados
Os princípios neste procedimento se aplicam a qualquer fonte de dados que forneça tabelas , mas, para seguir essas etapas exatamente, você deve abrir um ambiente para o qual um banco de dados do Microsoft Dataverse foi criado e dados de exemplo adicionados.
Abra um aplicativo em branco e adicione a tabela Contas do Dataverse.
Adicione um controle Suspenso e defina sua propriedade Items para esta fórmula:
Distinct(Accounts, 'Address 1: City')Esta fórmula mostra todas as cidades na tabela Contas . Se mais de um registro tiver a mesma cidade, a função Distinct ocultará a duplicação no controle suspenso.
(Opcional) Renomeie o controle Suspenso para Cidades, adicione um controle vertical da Galeria e defina a propriedade Itens da galeria como esta fórmula:
Filter(Accounts, address1_city == Cities.Selected.Result)Essa função Filtro mostra apenas os registros na tabela Contas para a qual a cidade corresponde ao valor selecionado no controle Cidades .
Diretrizes de acessibilidade
Contraste de cores
Deve haver contraste de cores adequado entre:
- ChevronFill e ChevronBackground
- ChevronHoverFill e ChevronHoverBackground
- SelectionColor e SelectionFill
- SelectionFill e Fill
Isso é além dos requisitos de contraste de cores padrão.
Suporte ao leitor de tela
- AccessibleLabel deve estar presente.
Suporte ao teclado
- TabIndex deve ser zero ou maior para que os usuários de teclado possam navegar até ele.
- Indicadores de foco devem estar claramente visíveis. Use FocusedBorderColor e FocusedBorderThickness para conseguir isso.