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 mostra uma seleção vazia se não tiver sido selecionado nenhum item. Os utilizadores da aplicação também podem desmarcar as opções selecionando o item em branco.

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).

Exemplos

Lista simples

1. 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?

2. 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.

1. Abra uma aplicação em branco e, em seguida, especifique a tabela Contas.

2. 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.

3. (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.