Controlo Caixa de combinação no PowerAppsCombo box control in PowerApps

Um controlo que permite aos utilizadores efetuar as seleções a partir de escolhas fornecidas.A control that allows users to make selections from provided choices. Suporta a pesquisa e seleções múltiplas.Supports search and multiple selections.

DescriçãoDescription

Um controlo Caixa de combinação permite-lhe pesquisar os itens que irá selecionar.A Combo box control allows you to search for items you will select. A pesquisa é executada do lado do servidor na propriedade SearchField, pelo que o desempenho não é afetado por origens 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 única ou múltipla é configurado através da propriedade SelectMultiple.Single or multi-select mode is configured via the SelectMultiple property.

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

Selecionador de pessoasPeople picker

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

Itens – a origem de dados a partir dos quais podem ser feitas as seleções.Items – The source of data from which selections can be made.

DefaultItems – os itens iniciais selecionados antes de o utilizador interagir com o controlo.DefaultItems – The initial selected item(s) before the user interacts with the control.

SelectedItems – a lista de itens selecionados resultantes da interação do utilizador.SelectedItems – List of selected items resulting from user interaction.

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

IsSearchable – se o utilizador pode procurar itens antes de selecionar.IsSearchable – Whether the user can search for items before selecting.

Propriedades adicionaisAdditional properties

BorderColor – a cor do limite de um controlo.BorderColor – The color of a control's border.

BorderStyle – se o limite do controlo é Sólido, Tracejado, Com pontos ou Nenhum.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – a espessura do limite de um controlo.BorderThickness – The thickness of a control's border.

Predefinição – a seleção inicial antes de ser alterada pelo utilizador 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 a mostrar para cada item devolvido pela pesquisa.DisplayFields – List of fields shown for each item returned by the search. É mais fácil de configurar através do painel Dados no separador da opção Propriedades.Easiest to configure via the Data pane in the Properties option tab.

DisplayMode – se o controlo permite a intervenção do utilizador (Editar), apenas apresenta os dados (Visualizar) ou está desativado (Desativado).DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

Altura – a distância entre as margens superiores e inferiores de um controlo.Height – The distance between a control's top and bottom edges.

InputTextPlaceholder – texto de instrução mostrado aos utilizadores finais quando não forem selecionados nenhuns itens.InputTextPlaceholder – Instructional text shown to end-users when no items are selected.

OnChange – como a aplicação responde quando o utilizador altera uma seleção.OnChange – How the app responds when the user changes a selection.

OnNavigate – como a aplicação responde quando o utilizador clica num item.OnNavigate – How the app responds when the user clicks on an item.

OnSelect – como a aplicação responde quando o utilizador toca ou clica num controlo.OnSelect – How the app responds when the user taps or clicks a control.

Visível – se um controlo é apresentado ou está oculto.Visible – Whether a control appears or is hidden.

Largura – a distância entre as margens esquerda e direita de um controlo.Width – The distance between a control's left and right edges.

X – A distância entre o limite esquerdo de um controlo e o limite esquerdo do respetivo contentor principal (do ecrã, se não existir um contentor principal).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 o limite superior de um controlo e o limite superior do contentor principal (do ecrã, se não existir um contentor principal).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 controlo Caixa de combinação a partir do separador Inserir, menu Controlos.Add a Combo box control from the Insert tab, Controls menu.
  2. No separador da opção Propriedades, clique em Dados.In the Properties options tab, click on Data.
  3. Selecione a origem de dados, o esquema e as propriedades relacionadas abaixo.Select the data source, layout and related properties below.
  4. Defina a propriedade SelectMultiple no separador Avançadas.Set the SelectMultiple property in the Advanced tab.

    Uma Caixa de combinação aparecerá na aplicação.A functional Combo box will appear in your app.

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