Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Um controle que permite que os usuários façam seleções a partir das escolhas fornecidas. Suporta pesquisa e várias seleções.
Description
Um controle de caixa de combinação permite que você procure os itens que você selecionará. A pesquisa é realizada 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ê visualiza o controle em telas pequenas, o submenu lista de itens se torna um controle de tela cheia 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, Text(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 é 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.
Selecionador de pessoas
Para usar a Caixa de combinação como um seletor de pessoas, escolha o modelo Pessoa nas configurações de Layout no painel Dados e configure as propriedades de dados relacionadas a serem mostradas para a pessoa abaixo.
Propriedades chave
Itens – A fonte de dados a partir da qual as seleções podem ser feitas.
DefaultSelectedItems – O(s) item(ns) inicial(is) selecionado(s) antes do usuário interagir com o controle.
Observação
A propriedade padrão foi preterida, use DefaultSelectedItems em vez disso.
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 pode ser habilitado somente em uma fonte de dados que contenha pelo menos um campo de texto. A expressão Items deve ser delegável para consultas a serem delegadas com a pesquisa. Ou seja, Se as instruções dentro da expressão Items não são suportadas.
SearchFields - Os campos de dados da fonte de dados pesquisada quando o usuário está inserindo texto.
Observação
Para pesquisar em vários campos, defina a propriedade SearchFields neste formato: ["MyFirstColumn", "MySecondColumn"]. Apenas campos de texto são suportados.
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.
DisplayFields – Lista de campos mostrados para cada item retornado pela pesquisa. Mais fácil de configurar através do painel Dados no separador de opções 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 (View) ou está desativado (Disabled).
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 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).
Observação
As propriedades de borda do submenu são controladas pelas propriedades de borda .
Examples
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 Microsoft Dataverse com dados de exemplo.
Selecione Inserir>caixa de combinaçãode entrada> e nomeie-a "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 Principal e selecione a coluna Nome Principal que será exibida no controle Caixa de combinação .
Enquanto mantém pressionada a tecla Alt , selecione a seta para baixo para abrir o controle Caixa de combinação .
O controle mostra os dados do Nome Principal que você especificou na fonte de dados que você especificou.
(Opcional) Mostrar o primeiro registo por predefinição
Defina a propriedade DefaultSelectedItems para esta expressão, substituindo DataSource pelo nome da sua fonte de dados:
First(DataSource)
(Opcional) Exibir o valor 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 esta 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írgulas ou uma mensagem "NO SELECTED ITEM" quando vazio.
Simule um comportamento simples de menu suspenso
Ao definir 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 Texto principal e selecione a coluna que deseja mostrar no controle Caixa de combinação .
Defina a propriedade IsSearchable como false.
Defina a propriedade SelectMultiple como false.
Enquanto mantém pressionada a tecla Alt , selecione a seta para baixo para abrir o controle Caixa de combinação .
O controle mostra os dados da coluna que você especificou na fonte de dados que você especificou.
Observação
O texto "Localizar itens" desapareceu e você só poderá selecionar um único item.
Diretrizes de acessibilidade
Contraste de cor
Deve haver um contraste de cor adequado entre:
- ChevronFill e ChevronBackground
- ChevronHoverFill e ChevronHoverBackground
- SelectionColor e SelectionFill
- SeleçãoPreenchimento e Preenchimento
- SelectionTagColor e SelectionTagFill
Isso é além dos requisitos de contraste de cor padrão.
Suporte a leitor de ecrã
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 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 de combinação. As teclas de seta navegam pelo conteúdo da caixa de combinação. A chave de escape fecha a lista suspensa quando aberta.