Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Um controle que permite que os usuários façam seleções entre opções fornecidas. Dá suporte para pesquisa e seleção múltipla.
Description
Um controle de caixa de combinação permite que você pesquise itens selecionados. A pesquisa é executada no lado do servidor na propriedade SearchField para que o desempenho não seja afetado por grandes fontes de dados.
O modo de seleção única ou múltipla é configurado por meio da propriedade SelectMultiple.
Ao pesquisar itens a serem selecionados, para cada item, você pode optar por mostrar um único valor de dados, dois valores ou uma imagem e dois valores (Pessoa) modificando as configurações de Layout no painel Dados.
Quando você exibe o controle em telas pequenas, o submenu da lista de itens se torna um controle de tela inteira para melhor usabilidade.
Observação
Se você quiser pesquisar itens com números, converta números em texto com a função Text( ). Por exemplo, Texto(12345).
Limitações
O controle de caixa de combinação tem estas limitações:
- Quando você usa um controle de caixa de combinação dentro de uma galeria, suas seleções não são mantidas quando o usuário rola a galeria. Isso não será um problema se você usar um controle de caixa de combinação dentro de uma galeria que não rola. Uma solução alternativa não está disponível no momento.
Seletor de pessoas
Para usar a caixa de combinação como um seletor de pessoas, escolha o modelo de Pessoa nas configurações de Layout no painel Dados e configure as propriedades de dados relacionadas a serem mostradas para a pessoa abaixo.
Principais propriedades
Itens – A fonte de dados da qual as seleções podem ser feitas.
DefaultSelectedItems – Os itens selecionados iniciais antes que o usuário interaja com o controle.
Observação
A propriedade padrão foi preterida, use DefaultSelectedItems .
SelectedItems – Lista de itens selecionados resultantes da interação do usuário.
Selecionado – o último item selecionado resultante da interação do usuário.
SelectMultiple – se o usuário pode selecionar um único item ou vários itens.
IsSearchable – se o usuário pode pesquisar itens antes de selecionar.
Observação
IsSearchable só pode ser habilitado em uma fonte de dados que contém pelo menos um campo de texto. A expressão Itens deve ser delegada para que as consultas sejam delegadas com a pesquisa. Ou seja, não há suporte para instruções dentro da expressão Itens .
SearchFields – os campos de dados da fonte de dados pesquisados quando o usuário está inserindo texto.
Observação
Para pesquisar em vários campos, defina a propriedade SearchFields neste formato: ["MyFirstColumn", "MySecondColumn"]. Há suporte apenas para campos de texto.
Propriedades adicionais
AccessibleLabel – Rótulo para leitores de tela.
BorderColor – A cor da borda de um controle.
BorderStyle – se a borda de um controle é Solid, Dashed, Dotted ou None.
BorderThickness – A espessura da borda de um controle.
DisplayFields – lista de campos mostrados para cada item retornado pela pesquisa. Mais fácil de configurar por meio do painel Dados na guia Opção Propriedades.
Observação
Para atualizar vários campos de exibição em determinado modelo, defina a propriedade DisplayFields neste formato: ["MyFirstColumn", "MySecondColumn"].
DisplayMode – se o controle permite a entrada do usuário (Editar), exibe apenas dados (Exibição) ou está desabilitado (Desabilitado).
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.
Altura – a distância entre as bordas superior e inferior de um controle.
InputTextPlaceholder – Texto instrucional mostrado aos usuários finais quando nenhum item é selecionado.
OnChange – Ações a serem executadas quando o usuário altera uma seleção.
OnNavigate – Ações a serem executadas quando o usuário seleciona um item.
OnSelect – Ações a serem executadas quando o usuário toca ou seleciona um controle.
TabIndex – Ordem de navegação do teclado em relação a outros controles.
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 a borda esquerda de um controle e a borda esquerda de seu contêiner pai (tela, se nenhum contêiner pai).
Y – a distância entre a borda superior de um controle e a borda superior do contêiner pai (tela, se nenhum contêiner pai).
Observação
As propriedades de borda de submenu são controladas por propriedades de borda .
Exemplos
Caixa de combinação básica
As etapas neste exemplo se aplicam a qualquer fonte de dados que forneça tabelas, mas para seguir essas etapas exatamente, use um ambiente com o banco de dados do Microsoft Dataverse com dados de exemplo.
Selecione Inserir>caixa de combinação deentrada> e nomeie-a como "Combobox1".
No painel Propriedades no lado direito da tela, abra a lista Selecionar uma fonte de dados (ao lado de Itens) e adicione ou selecione uma fonte de dados, como a tabela Contas.
No mesmo painel, selecione Editar (ao lado de Campos).
No painel Dados , abra a lista de texto primário e, em seguida, selecione a coluna Nome Primário que será exibida no controle de caixa de combinação.
Ao segurar a tecla Alt , selecione a seta para baixo para abrir o controle de caixa de combinação .
O controle mostra os dados do Nome Primário especificado na fonte de dados especificada.
(Opcional) Mostrar o primeiro registro por padrão
Defina a propriedade DefaultSelectedItems como esta expressão, substituindo DataSource pelo nome da fonte de dados:
First(DataSource)
(Opcional) Exibir o valor do Nome da Conta selecionado em um rótulo
Selecione Inserir>Rótulo de Texto e, em seguida, selecione Rótulo.
Defina a propriedade Text para essa expressão, substituindo Text pela seguinte fórmula:
If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")Observação
A instrução If verificará como os itens selecionados podem existir e os exibirá em um rótulo delimitado por vírgula ou em uma mensagem "NO SELECTED ITEM" quando estiver vazia.
Simular um comportamento simples de lista suspensa
Definindo IsSearchable como false e SelectMultiple como false, você pode obter a mesma funcionalidade de uma lista suspensa.
Selecione Inserir>Entrada e, em seguida, selecione Caixa de combinação.
No painel Propriedades no lado direito da tela, abra a lista Selecionar uma fonte de dados (ao lado de Itens) e adicione ou selecione uma fonte de dados.
No mesmo painel, selecione Editar (ao lado de Campos).
No painel Dados , abra a lista de texto primário e, em seguida, selecione a coluna que você deseja mostrar no controle de caixa de combinação .
Defina a propriedade IsSearchable como false.
Defina a propriedade SelectMultiple como false.
Ao segurar a tecla Alt , selecione a seta para baixo para abrir o controle de caixa de combinação .
O controle mostra os dados da coluna que você especificou na fonte de dados especificada.
Observação
O texto "Localizar itens" desapareceu e você só poderá selecionar um único item.
Diretrizes de acessibilidade
Contraste de cores
Deve haver contraste de cores adequado entre:
- ChevronFill e ChevronBackground
- ChevronHoverFill e ChevronHoverBackground
- SelectionColor e SelectionFill
- SelectionFill e Fill
- SelectionTagColor e SelectionTagFill
Isso é além dos requisitos de contraste de cores padrão.
Suporte ao leitor de tela
AccessibleLabel deve estar presente.
Observação
Em telas sensíveis ao toque, os usuários do leitor de tela podem navegar pelo conteúdo da caixa de combinação sequencialmente. A caixa de combinação atua como um botão que mostra ou oculta seu conteúdo quando selecionado.
Suporte ao teclado
TabIndex deve ser zero ou maior para que os usuários de teclado possam navegar até ele.
Indicadores de foco devem estar claramente visíveis. Use FocusedBorderColor e FocusedBorderThickness para conseguir isso.
Observação
A tecla tab navega para ou para longe da caixa de combinação. As teclas de direção navegam pelo conteúdo da caixa de combinação. A chave de escape fecha a lista suspensa quando aberta.