Controle de caixa de combinação no PowerAppsCombo box control in PowerApps

Um controle que permite que os usuários façam seleções entre opções fornecidas.A control that allows users to make selections from provided choices. Dá suporte para pesquisa e seleção múltipla.Supports search and multiple selections.

DescriçãoDescription

Um controle Caixa de combinação permite pesquisar itens que você seleciona.A Combo box control allows you to search for items you will select. A pesquisa é executada no servidor na propriedade SearchField para que o desempenho não seja afetado por fontes de dados muito grandes.The search is performed server-side on the SearchField property so performance is not affected by very large data sources.

O modo de seleção múltipla ou única é configurado por meio da propriedade SelectMultiple.Single or multi-select mode is configured via the SelectMultiple property.

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 as configurações de Layout no painel Dados.When searching for items to select, for each item you can choose to show a single data value, two values, or a picture and two values (Person) by modifying the Layout settings in the Data pane.

Seletor de pessoasPeople picker

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 para serem mostradas para a pessoa abaixo.To use Combo box as a people picker, choose the Person template from the Layout settings in the Data pane and configure the related data properties to be shown for the person below.

Propriedades-chaveKey properties

Itens – a fonte de dados da qual é possível fazer seleções.Items – The source of data from which selections can be made.

DefaultItems – os itens selecionados inicialmente antes do usuário interagir com o controle.DefaultItems – The initial selected item(s) before the user interacts with the control.

SelectedItems – lista de itens selecionados resultante da interação do usuário.SelectedItems – List of selected items resulting from user interaction.

SelectMultiple – se o usuário pode selecionar um único item ou vários itens.SelectMultiple – Whether the user can select a single item or multiple items.

IsSearchable – se o usuário pode pesquisar itens antes de selecionar.IsSearchable – Whether the user can search for items before selecting.

Propriedades adicionaisAdditional properties

BorderColor – a cor da borda do controle.BorderColor – The color of a control's border.

BorderStyle – se a borda do controle é Solid, Dashed, Dotted ou None.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – a espessura da borda do controle.BorderThickness – The thickness of a control's border.

Padrão – a seleção inicial antes que ele seja alterado pelo usuário no modo de seleção única.Default – The initial selection before it is changed by the user in single-select mode.

DisplayFields – lista de campos mostrados para cada item retornado pela pesquisa.DisplayFields – List of fields shown for each item returned by the search. Mais fácil de configurar por meio do painel Dados na guia Opções propriedades.Easiest to configure via the Data pane in the Properties option tab.

DisplayMode – se o controle permite entrada do usuário (Edição), apenas exibe dados (Exibição) ou está desabilitado (Desabilitado).DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

Height – a distância entre a parte superior do controle e as bordas inferiores.Height – The distance between a control's top and bottom edges.

InputTextPlaceholder – texto de instrução mostrado aos usuários finais quando nenhum item está selecionado.InputTextPlaceholder – Instructional text shown to end-users when no items are selected.

OnChange – como o aplicativo responde quando o usuário altera uma seleção.OnChange – How the app responds when the user changes a selection.

OnNavigate – como o aplicativo responde quando o usuário clica em um item.OnNavigate – How the app responds when the user clicks on an item.

OnSelect – como o aplicativo responde quando o usuário toca ou clica em um controle.OnSelect – How the app responds when the user taps or clicks a control.

Visible – se um controle é exibido ou está oculto.Visible – Whether a control appears or is hidden.

Width – a distância entre das bordas esquerda e direita de um controle.Width – The distance between a control's left and right edges.

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).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

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).Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

ExemploExample

  1. Adicione um controle caixa de combinação da guia Inserir, do menu Controles.Add a Combo box control from the Insert tab, Controls menu.
  2. Na guia Opções de propriedades, clique em Dados.In the Properties options tab, click on Data.
  3. Selecione a fonte de dados, o layout e as propriedades relacionadas abaixo.Select the data source, layout and related properties below.
  4. Defina a propriedade SelectMultiple na guia Avançado.Set the SelectMultiple property in the Advanced tab.

    Uma Caixa de combinação funcional aparecerá em seu aplicativo.A functional Combo box will appear in your app.

    Não sabe como adicionar e configurar um controle?Don't know how to add and configure a control?.