Controlo Lista pendente no Power Apps
Uma lista que mostra apenas o primeiro item, a menos que o utilizador a abra.
Descrição
Um controlo Lista pendente conserva o estado real do ecrã, especialmente quando a lista contém um grande número de opções. O controlo ocupa apenas uma linha, a menos que o utilizador selecione a divisa para revelar mais opções. O controlo mostra um máximo de 500 itens.
Propriedades principais
Default – o valor inicial de um controlo antes de o utilizador especificar um valor diferente.
Items – a origem de dados que contém os itens que aparecem no controlo. Se a origem tiver várias colunas, defina a propriedade Value do controlo para a coluna de dados que pretende mostrar.
Value – a coluna de dados que pretende mostrar no controlo (por exemplo, se uma origem de dados tiver várias colunas).
Selected – o registo de dados que representa o item selecionado.
AllowEmptySelection – Se o controlo não pode ter itens selecionados. Se falso, haverá sempre um item selecionado, que inicialmente será o Predefinido ou o primeiro item.
Propriedades adicionais
AccessibleLabel – a etiqueta para os leitores de ecrãs.
BorderColor – a cor do limite de um controlo.
BorderStyle – se o limite do controlo é Sólido, Tracejado, Com pontos ou Nenhum.
BorderThickness – a espessura do limite de um controlo.
ChevronBackground – a cor por trás da seta para baixo numa lista pendente.
ChevronFill – a cor da seta para baixo numa lista pendente.
Color – a cor do texto num controlo.
DisplayMode – se o controlo permite a intervenção do utilizador (Editar), apenas apresenta os dados (Visualizar), ou está desativado (Desativado).
DisabledBorderColor – a cor do limite de um controlo se a propriedade DisplayMode do controlo estiver definida como Desativada.
DisabledColor – a cor do texto num controlo se a respetiva propriedade DisplayMode estiver definida como Desativada.
DisabledFill – a cor de fundo de um controlo se a respetiva propriedade DisplayMode estiver definida como Desativada.
Fill – a cor de fundo de um controlo.
FocusedBorderColor – a cor do limite de um controlo quando o controlo é destacado.
FocusedBorderThickness – a espessura do limite de um controlo quando o controlo é destacado.
Font – o nome da família dos tipos de letra que aparecem no texto.
FontWeight – a espessura do texto num controlo: Negrito, Seminegrito, Normal ou Mais leve.
Height – a distância entre as margens superiores e inferiores de um controlo.
HoverBorderColor – a cor do limite de um controlo quando o utilizador mantém o ponteiro do rato nesse controlo.
HoverColor – a cor do texto num controlo quando o utilizador mantém o ponteiro do rato no mesmo.
HoverFill – a cor de fundo de um controlo quando o utilizador mantém o ponteiro do rato no mesmo.
Italic – se o texto num controlo estiver em itálico.
OnChange – Ações a realizar quando o utilizador altera o valor de um controlo (por exemplo, ao ajustar um controlo de deslize).
OnSelect– Ações a realizar quando o utilizador toca ou clica num controlo.
PaddingBottom – a distância entre o texto num controlo e o limite inferior desse controlo.
PaddingLeft – a distância entre o texto num controlo e o limite esquerdo desse controlo.
PaddingRight – a distância entre o texto num controlo e o limite direito desse controlo.
PaddingTop – a distância entre o texto num controlo e o limite superior desse controlo.
PressedBorderColor – a cor do limite de um controlo quando o utilizador toca ou clica nesse controlo.
PressedColor – a cor do texto num controlo quando o utilizador toca ou clica nesse controlo.
PressedFill – a cor de fundo de um controlo quando o utilizador toca ou clica nesse controlo.
Reset – se um controlo é revertido para o valor predefinido.
SelectedText (Preterido) – um valor de cadeia que representa o item selecionado. Utilize Lista pendente1.SelectedText.Value em vez disso, substituindo "Lista pendente1" pelo nome de controlo suspenso na aplicação.
SelectionColor – a cor do texto de um item ou itens selecionados numa lista ou a cor da ferramenta de seleção num controlo de caneta.
SelectionFill – a cor de fundo de um item ou itens selecionados de uma lista ou uma área selecionada de um controlo de caneta.
Size – o tamanho do tipo de letra do texto que é apresentado num controlo.
Strikethrough – se é apresentada uma linha no meio do texto que aparece num controlo.
TabIndex – a ordem de navegação no teclado em relação a outros controlos.
Tooltip – o texto explicativo que aparece quando o rato passa por cima de um controlo.
Underline – se é apresentada uma linha sob o texto que aparece num controlo.
Visible – se um controlo é apresentado ou está oculto.
Width – a distância entre as margens esquerda e direita de um controlo.
X – a distância entre o limite esquerdo de um controlo e o limite esquerdo do respetivo recipiente principal (do ecrã, se não existir um recipiente principal).
Y – a distância entre o limite superior de um controlo e o limite superior do recipiente principal (do ecrã, se não existir um recipiente principal).
Nota
As propriedades do limite da lista de opções são controladas por propriedades FocusedBorder.
Exemplos
Lista simples
Adicione um controlo Lista pendente e, em seguida, defina a respetiva propriedade Items para esta expressão:
["Seattle", "Tokyo", "London", "Johannesburg", "Rio de Janeiro"]
Não sabe como adicionar, atribuir um nome e configurar um controlo?
Mostre os itens da lista selecionando a seta para baixo do controlo enquanto prime a tecla Alt.
Lista de uma origem de dados
Os princípios neste procedimento aplicam-se a qualquer origem de dados que forneça tabelas, mas, para seguir estes passos exatamente, tem de abrir um ambiente para o qual uma base de dados do Microsoft Dataverse tenha sido criada e tenham sido adicionados dados de exemplo.
Abra uma aplicação em branco e, em seguida, especifique a tabela Contas.
Adicione um controlo de Lista pendente e defina a respetiva propriedade Items para esta fórmula:
Distinct(Accounts, 'Address 1: City')
Esta fórmula mostra todas as cidades na tabela Contas. Se tiver mais de um registo com a mesma cidade, a função Distinct oculta a duplicação no seu controlo de lista pendente.
(opcional) Mude o nome do controlo de Lista pendente para Cities, adicione um controlo de Galeria vertical e defina a propriedade Items da galeria para esta fórmula:
Filter(Accounts, address1_city = Cities.Selected.Result)
A função Filter mostra apenas os registos existentes na tabela Contas, para a qual a cidade corresponde ao valor selecionado no controlo Cities.
Diretrizes de acessibilidade
Contraste de cor
Tem de existir contraste de cor adequado entre:
- ChevronFill e ChevronBackground
- ChevronHoverFill e ChevronHoverBackground
- SelectionColor e SelectionFill
- SelectionFill e Fill
Trata-se de uma adição aos requisitos de contraste de cor padrão.
Suporte a leitor de ecrã
- AccessibleLabel tem de estar presente.
Suporte de teclado
- TabIndex tem de ser zero ou superior para que os utilizadores do teclado possam navegar nele.
- Os indicadores de foco têm de estar claramente visíveis. Utilize FocusedBorderColor e FocusedBorderThickness para o conseguir.
Nota
Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)
O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).