Partilhar via


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

Limitações

O controlo da caixa de combinação tem as seguintes limitações:

  • Quando utiliza o controlo de Caixa de Combinação numa galeria, as respetivas seleções não são mantidas quando o utilizador se desloca na galeria. Isto não será um problema se utilizar um controlo de Caixa de Combinação numa galeria que não se desloca. Neste momento, não está disponível nenhuma solução.

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

Items – 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.

Nota

A propriedade Default é preterida, em vez disso use DefaultSelectedItems.

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 pesquisar em vários campos, defina a propriedade SearchFields neste formato: ["MyFirstColumn", "MySecondColumn"]. 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.

Nota

Para atualizar vários campos de exibição num determinado modelo, defina a propriedade DisplayFields neste formato: ["MyFirstColumn", "MySecondColumn"].

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.

Height – 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 – Ações a executar quando o utilizador muda uma seleção.

OnNavigate – Ações a executar quando o utilizador seleciona um item.

OnSelect – Ações a realizar quando o utilizador toca ou seleciona um controlo.

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

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

Exemplos

Caixa de combinação básica

Os passos neste exemplo aplicam-se a qualquer origem de dados que forneça tabelas, mas para seguir exatamente estes passos, utilize um ambiente com base de dados do Microsoft Dataverse que tenha dados de amostra.

  1. Selecione Inserir > Introduzir > Caixa de combinação, e denomine-a "Combobox1".

  2. No painel Propriedades no lado direito do ecrã, abra a lista Selecionar uma origem de dados (ao lado de Items), e depois adicione ou selecione uma origem de dados como a tabela Contas.

  3. No mesmo painel, selecione Editar (ao lado de Campos).

  4. No painel de dados, abra a lista de textos primários e, em seguida, selecione a coluna Nome Primário que aparecerá 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 do Nome Primário que especificou na origem de dados que especificou.

(Opcional) Mostrar o primeiro registo por defeito

  1. Defina a propriedade DefaultSelectedItems para esta expressão, substituindo DataSource pelo nome da sua origem de dados:

    First(DataSource)
    

(Opcional) Mostrar valor de nome de conta selecionado numa etiqueta

  1. Selecione Inserir > Etiqueta de texto e, em seguida, selecione Etiqueta.

  2. Defina a propriedade Text para esta expressão, substituindo Text pela seguinte fórmula:

    If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")
    

    Nota

    A declaração Se irá verificar para ver como podem existir itens selecionados e exibi-los numa etiqueta delimitada em vírgula ou numa mensagem "NO SELECTED ITEM" quando estiverem vazios.

Simular um comportamento simples de queda

Ao configurar IsSearchable para falso e SelectMultiple para falso, pode obter a mesma funcionalidade de uma queda.

  1. Selecione Inserir > Entrada e, em seguida, selecione a Caixa de combinação.

  2. No painel Propriedades no lado direito do ecrã, abra a lista Selecionar uma origem de dados (ao lado de Items), e depois adicione ou selecione uma origem de dados.

  3. No mesmo painel, selecione Editar (ao lado de 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. Defina a propriedade IsSearchable para falsa.

  6. Defina a propriedade SelectMultiple para falsa.

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

    Nota

    O texto "Encontrar itens" desapareceu e só poderá selecionar um único item.

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

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