Controlo de Caixa de Lista nas Power Apps

Uma lista na qual o usuário pode selecionar um ou vários itens.

Description

Um controle de caixa de listagem sempre mostra todas as opções disponíveis (ao contrário de um controle suspenso ) e no qual o usuário pode escolher mais de um item de cada vez (ao contrário de um controle de rádio ).

Propriedades chave

Padrão – O valor inicial de um controle antes de ser alterado pelo usuário.

Itens – A fonte de dados que aparece em um controle, como uma galeria, uma lista ou um gráfico.

Quando você adiciona uma galeria, uma lista ou um gráfico, a lista de propriedades mostra Itens por padrão para que você possa especificar facilmente os dados que o novo controle deve mostrar. Por exemplo, você pode definir a propriedade Items de uma galeria como a tabela Account no Salesforce, uma tabela chamada Inventory que você criou no Excel e carregou na nuvem ou uma lista chamada ConferenceSpeakers.

Propriedades adicionais

AccessibleLabel – Etiqueta para leitores de tela.

BorderColor – A cor da borda de um controle.

BorderStyle – Se a borda de um controle é Sólida, Tracejada, Pontilhada ou Nenhuma.

BorderThickness – A espessura da borda de um controle.

Cor – A cor do texto em um controle.

DisplayMode – Se o controle permite a entrada do usuário (Editar), exibe apenas dados (View) ou está desativado (Disabled).

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

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

DisabledFill – A cor de plano de fundo de um controle se sua propriedade DisplayMode estiver definida como Disabled.

Preenchimento – A cor de fundo de um controlo.

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 na qual o texto aparece.

FontWeight – O peso do texto em um controle: negrito, seminegrito, 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 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 está em itálico.

ItemPaddingLeft – A distância entre o texto em uma caixa de listagem e sua borda esquerda.

LineHeight – A distância entre, por exemplo, linhas de texto ou itens em uma lista.

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 toca ou clica 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 de um 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 de fundo de um controlo quando o utilizador toca ou clica nesse controlo.

Redefinir – Se um controle reverte para seu valor padrão.

Selecionado – O registro de dados que representa o item selecionado.

SelectedItems - Somente leitura. Representa uma tabela de dados de itens selecionados para uma caixa de listagem de seleção múltipla.

SelectedItemsText - Somente leitura. Representa uma tabela de dados de texto de itens selecionados para uma caixa de listagem de seleção múltipla.

SelectedText (Deprecated) – Um valor de cadeia de caracteres que representa o item selecionado.

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

SelectionFill – A cor de plano de fundo de um item selecionado ou itens em uma lista ou uma área selecionada de um controle de caneta.

SelectMultiple – Se um usuário pode selecionar mais de um item em uma caixa de listagem.

Tamanho – O tamanho da fonte do texto que aparece em um controle.

Tachado – Se uma linha aparece através 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 que aparece 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 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).

Funções relacionadas

Distinct( DataSource, ColumnName )

Example

1. Adicione um controle de caixa de listagem , nomeie-o CategoryList e defina sua propriedade Items para esta fórmula:
   ["Tapete","Madeira","Azulejo"]

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

   

2. Adicione três controles suspensos, mova-os em CategoryList e nomeie-os CarpetList, HardwoodList e TileList.

3. Defina a propriedade Items de cada controle suspenso para um destes valores:

   • CarpetList: ["Caserta Stone Bege","Ageless Beauty Clay", "Lush II Tundra"]

   • HardwoodList: ["Teca Dourada","Hickory Natural", "Victoria Mahogany"]

   • TileList: ["Mármore Ônix Mel","Ardósia Indiana de outono", "Panaria Vitality Ceramic"]

     

4. Defina a propriedade Visible de cada controle suspenso para um destes valores:

   • CarpetList: If("Carpet" em CategoryList.SelectedItems.Value, true)

   • HardwoodList: If("Hardwood" em CategoryList.SelectedItems.Value, true)

   • TileList: If("Tile" em CategoryList.SelectedItems.Value, true)

     Quer obter mais informações sobre a função If ou outras funções?

5. Pressione F5 e escolha um ou mais itens em CategoryList.

   O controle suspenso apropriado ou controles aparecem com base em sua escolha ou escolhas.

   

6. (facultativo) Pressione Esc para retornar ao espaço de trabalho padrão.

Diretrizes de acessibilidade

Contraste de cor

Deve haver um contraste de cor adequado entre:

• SelectionColor e SelectionFill
• SeleçãoPreenchimento e Preenchimento
• HoverFill e Fill
• PressedFill e Fill

Isso é além dos requisitos de contraste de cor padrão.

Suporte a leitor de ecrã

• AccessibleLabel deve estar presente.

Suporte de teclado

• TabIndex deve ser zero ou maior para que os usuários do teclado possam navegar até ele.

• Os indicadores de focalização devem ser claramente visíveis. Use FocusedBorderColor e FocusedBorderThickness para conseguir isso.

  Observação

  A tecla tab navega para ou para fora da caixa Listagem. As teclas de seta navegam pelo conteúdo da caixa Listagem.