Controlo caixa de combinação no Power Apps

Um controlo que permite aos utilizadores efetuar as seleções a partir de escolhas fornecidas. Suporta a pesquisa e seleções múltiplas.

Descrição

Um controlo Caixa de combinação permite-lhe pesquisar os itens que irá selecionar. A pesquisa é executada do lado do servidor na propriedade SearchField, pelo que o desempenho não é afetado por origens de dados grandes.

O modo de seleção única ou múltipla é configurado através da propriedade SelectMultiple.

Ao pesquisar itens para selecionar, pode, para cada item, optar por mostrar um valor único de dados, dois valores ou uma imagem e dois valores (Pessoa), ao modificar as definições Esquema no painel Dados.

Ao ver em ecrãs pequenos, a lista de opções da lista de itens tornar-se-á um controlo de ecrã completo para uma melhor usabilidade.

Nota

Se pretender procurar itens com números, converta os números em texto com a função de Texto (). Por exemplo, Texto(12345).

Seletor de pessoas

Para utilizar a Caixa de combinação como um seletor de pessoas, escolha o modelo Pessoa nas definições de Esquema no painel Dados e configure as propriedades de dados relacionadas a apresentar para a pessoa abaixo.

Propriedades principais

Itens – a origem de dados a partir dos quais podem ser feitas as seleções.

DefaultSelectedItems – os itens iniciais selecionados antes de o utilizador interagir com o controlo.

SelectedItems – a lista de itens selecionados resultantes da interação do utilizador.

SelectMultiple – se o utilizador pode selecionar um item único ou vários itens.

IsSearchable – se o utilizador pode procurar itens antes de selecionar.

Nota

IsSearchable só pode ser ativado numa origem de dados que contenha pelo menos um campo de texto. A expressão Items tem de ser delegada para que as consultas sejam delegadas com a pesquisa. Ou seja, as declarações If dentro da expressão Items não forem suportadas.

SearchFields – os campos de dados da origem de dados que é pesquisada quando o utilizador introduz texto.

Nota

Para procurar em múltiplos campos, defina a propriedade ComboBox1.SearchFields = ["AMinhaPrimeiraColuna", "AMinhaSegundaColuna"]. Apenas os campos de texto são suportados.

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.

DisplayFields – lista de campos a mostrar para cada item devolvido pela pesquisa. É mais fácil de configurar através do painel Dados no separador da opção Propriedades.

DisplayMode – se o controlo permite a intervenção do utilizador (Editar), apenas apresenta os dados (Visualizar), ou está desativado (Desativado).

FocusedBorderColor – a cor do limite de um controlo quando o controlo é destacado.

FocusedBorderThickness – a espessura do limite de um controlo quando o controlo é destacado.

Altura – a distância entre as margens superiores e inferiores de um controlo.

InputTextPlaceholder – texto de instrução mostrado aos utilizadores finais quando não forem selecionados nenhuns itens.

OnChange – como a aplicação responde quando o utilizador altera uma seleção.

OnNavigate – como a aplicação responde quando o utilizador seleciona um item.

OnSelect – como a aplicação responde quando o utilizador toca ou seleciona um controlo.

TabIndex – a ordem de navegação no teclado em relação a outros controlos.

Visível – se um controlo é apresentado ou está oculto.

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

Exemplo

  1. No separador Inserir, abra o menu Controlos e depois selecione Caixa de combinação.

  2. No separador Propriedades do painel direito, abra a lista Selecionar origem de dados (junto a Itens), e depois adicione ou selecione uma origem de dados.

  3. No mesmo separador, selecione Editar (junto a Campos).

  4. No painel Dados, abra a lista Texto primário e, em seguida, selecione a coluna que pretende mostrar no controlo da Caixa de combinação.

  5. Mantendo a tecla Alt pressionada, selecione a seta para baixo para abrir o controlo da Caixa de combinação.

    O controlo mostra os dados da coluna que especificou na origem de dados que especificou.

  6. (opcional) Para mostrar o primeiro registo por predefinição, defina a propriedade DefaultSelectedItems para esta expressão, substituindo DataSource pelo nome da sua origem de dados:

    First(DataSource)

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 Preenchimento
  • SelectionTagColor e SelectionTagFill

Trata-se de uma adição aos requisitos de contraste de cor padrão.

Suporte a leitor de ecrã

  • AccessibleLabel tem de estar presente.

    Nota

    Nos ecrãs táteis, os utilizadores de leitor de ecrã podem navegar de forma sequencial no conteúdo da caixa de combinação. A caixa de combinação atua como um botão que mostra ou oculta o conteúdo, quando selecionado.

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

    A tecla de tabulação permite navegar para caixa de combinação ou na direção oposta. As teclas de setas navegam no conteúdo da caixa de combinação. A tecla Esc fecha a lista pendente, quando aberta.