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.

Descrição

Um controle Caixa de combinação permite pesquisar itens que você seleciona. A pesquisa é executada no servidor na propriedade SearchField para que o desempenho não seja afetado por fontes de dados muito grandes.

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

Ao procurar por 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 a configuração de Layout no painel Dados.

Propriedades-chave

Itens – a fonte de dados da qual é possível fazer seleções.

DefaultItems – os itens selecionados inicialmente antes do usuário interagir com o controle.

SelectedItems – lista de itens selecionados 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.

Propriedades adicionais

BorderColor – a cor da borda do controle.

BorderStyle – se a borda do controle é Solid, Dashed, Dotted ou None.

BorderThickness – a espessura da borda do controle.

Padrão – a seleção inicial antes que ele seja alterado pelo usuário no modo de seleção única.

DisplayFields – lista de campos mostrados para cada item retornado pela pesquisa. Mais fácil de configurar por meio do painel Dados na guia Opções propriedades.

DisplayMode – se o controle permite entrada do usuário (Edição), apenas exibe dados (Exibição) ou está desabilitado (Desabilitado).

Height – a distância entre a parte superior do controle e as bordas inferiores.

InputTextPlaceholder – texto de instrução mostrado aos usuários finais quando nenhum item está selecionado.

OnChange – como o aplicativo responde quando o usuário altera uma seleção.

OnNavigate – como o aplicativo responde quando o usuário clica em um item.

OnSelect – como o aplicativo responde quando o usuário toca ou clica em um controle.

Visible – se um controle é exibido ou está oculto.

Width – a distância entre das 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 não houver contêiner pai).

Y – a distância entre a borda superior de um controle e a borda superior de seu contêiner pai (tela, se não houver contêiner pai).

Exemplo

  1. Adicione um controle caixa de combinação da guia Inserir, do menu Controles.
  2. Na guia Opções de propriedades, clique em Dados.
  3. Selecione a fonte de dados, o layout e as propriedades relacionadas abaixo.
  4. Defina a propriedade SelectMultiple na guia Avançado.

    Uma Caixa de combinação funcional aparecerá em seu aplicativo.

    Não sabe como adicionar e configurar um controle?