Controle de caixa de listagem no PowerAppsList Box control in PowerApps

Uma lista na qual o usuário pode selecionar um ou vários itens.A list in which the user can select one or multiple items.

DescriçãoDescription

Um controle de caixa de listagem sempre mostra todas as opções disponíveis (ao contrário de um controle de lista suspensa) e no qual o usuário pode escolher mais de um item por vez (ao contrário de um controle Radio).A List Box control always shows all available choices (unlike a Drop down control) and in which the user can choose more than one item at a time (unlike a Radio control).

Propriedades-chaveKey properties

Default – o valor inicial de um controle antes de ele ser alterado pelo usuário.Default – The initial value of a control before it is changed by the user.

Items - a fonte de dados exibida em um controle como uma galeria, uma lista ou um gráfico.Items – The source of data that appears in a control such as a gallery, a list, or a chart.

Items The source of data that appears in a control such as a gallery, a list, or a chart.

When you add a gallery, a list, or a chart, the property list shows Items by default so that you can easily specify the data that the new control should show. For example, you might set the Items property of a gallery to the Account table in Salesforce, a table named Inventory that you created in Excel and uploaded to the cloud, or a SharePoint list named ConferenceSpeakers.

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.

FocusedBorderThickness – a espessura da borda do controle quando ele tem o foco do teclado.FocusedBorderThickness – The thickness of the control's border when it has keyboard focus.

Color – a cor do texto em um controle.Color – The color of text in a control.

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

DisabledBorderColor – a cor da borda de um controle se a propriedade DisplayMode do controle estiver definida como Desabilitado.DisabledBorderColor – The color of a control's border if the control's DisplayMode property is set to Disabled.

DisabledColor – a cor do texto em um controle se sua propriedade DisplayMode estiver definida como Desabilitado.DisabledColor – The color of text in a control if its DisplayMode property is set to Disabled.

DisabledFill – a cor da tela de fundo de um controle se sua propriedade DisplayMode estiver definida como Desabilitado.DisabledFill – The background color of a control if its DisplayMode property is set to Disabled.

Fill – a cor da tela de fundo de um controle.Fill – The background color of a control.

Font – o nome da família de fontes no qual o texto é exibido.Font – The name of the family of fonts in which text appears.

FontWeight – o peso do texto em um controle: Bold (negrito), Semibold, Normal ou Lighter (mais leve).FontWeight – The weight of the text in a control: Bold, Semibold, Normal, or Lighter.

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.

HoverBorderColor – a cor da borda do controle quando o usuário mantém o ponteiro do mouse nesse controle.HoverBorderColor – The color of a control's border when the user keeps the mouse pointer on that control.

HoverColor – a cor do texto em um controle quando o usuário mantém o ponteiro do mouse sobre ele.HoverColor – The color of the text in a control when the user keeps the mouse pointer on it.

HoverFill – a cor da tela de fundo de um controle quando o usuário mantém o ponteiro do mouse sobre ele.HoverFill – The background color of a control when the user keeps the mouse pointer on it.

Italic – se o texto em um controle está em itálico.Italic – Whether the text in a control is italic.

ItemPaddingLeft – a distância entre o texto em uma caixa de listagem e sua borda esquerda.ItemPaddingLeft – The distance between text in a listbox and its left edge.

LineHeight – a distância entre, por exemplo, linhas de texto ou itens em uma lista.LineHeight – The distance between, for example, lines of text or items in a list.

OnChange – como o aplicativo responde quando o usuário altera o valor de um controle (por exemplo, ajustando um controle deslizante).OnChange – How the app responds when the user changes the value of a control (for example, by adjusting a slider).

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.

PaddingBottom – a distância entre o texto em um controle e a borda inferior desse controle.PaddingBottom – The distance between text in a control and the bottom edge of that control.

PaddingLeft – a distância entre o texto em um controle e a borda esquerda desse controle.PaddingLeft – The distance between text in a control and the left edge of that control.

PaddingRight – a distância entre o texto em um controle e a borda direita desse controle.PaddingRight – The distance between text in a control and the right edge of that control.

PaddingTop – a distância entre o texto em um controle e a borda superior desse controle.PaddingTop – The distance between text in a control and the top edge of that control.

PressedBorderColor – a cor da borda do controle quando o usuário toca ou clica nesse controle.PressedBorderColor – The color of a control's border when the user taps or clicks that control.

PressedColor – a cor do texto em um controle quando o usuário toca ou clica nesse controle.PressedColor – The color of text in a control when the user taps or clicks that control.

PressedFill – a cor da tela de fundo de um controle quando o usuário toca ou clica nesse controle.PressedFill – The background color of a control when the user taps or clicks that control.

Reset – se um controle é revertido para seu valor padrão.Reset – Whether a control reverts to its default value.

SelectionColor – a cor do texto de um item ou itens selecionados em uma lista ou a cor da ferramenta de seleção em um controle de caneta.SelectionColor – The text color of a selected item or items in a list or the color of the selection tool in a pen control.

SelectionFill – a cor da tela de fundo de um item ou itens selecionados em uma lista ou uma área selecionada de um controle de caneta.SelectionFill – The background color of a selected item or items in a list or a selected area of a pen control.

SelectMultiple – se um usuário pode selecionar mais de um item em uma caixa de listagem.SelectMultiple – Whether a user can select more than one item in a listbox.

Size – o tamanho da fonte do texto que aparece em um controle.Size – The font size of the text that appears on a control.

Strikethrough – se uma linha é exibida cortando o texto que aparece em um controle.Strikethrough – Whether a line appears through the text that appears on a control.

TabIndex – personaliza a ordem de tabulação de controles em tempo de execução quando definida como um valor diferente de zero.TabIndex – Customizes the tab order of controls at runtime when set to a non-zero value.

Tooltip – um texto explicativo aparece quando o usuário passa o mouse sobre um controle.Tooltip – Explanatory text that appears when the user hovers over a control.

Underline – se uma linha é exibida sob o texto que aparece em um controle.Underline – Whether a line appears under the text that appears on 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).

Distinct( DataSource, ColumnName )Distinct( DataSource, ColumnName )

ExemploExample

  1. Adicione um controle de caixa de listagem, chame-o de CategoryList e defina sua propriedade Items como esta fórmula:Add a List box control, name it CategoryList, and set its Items property to this formula:
    ["Carpet","Hardwood","Tile"] ["Carpet","Hardwood","Tile"]

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

    Categorias de pavimento na caixa de listagem

  2. Adicione três controles de Lista suspensa, mova-os para baixo de CategoryList e chame-os de CarpetList, HardwoodList e TileList.Add three Drop down controls, move them under CategoryList, and name them CarpetList, HardwoodList, and TileList.
  3. Defina a propriedade Items de cada controle de lista suspensa como um destes valores:Set the Items property of each Drop down control to one of these values:

    • CarpetList: ["Caserta Stone Beige","Ageless Beauty Clay", "Lush II Tundra"]CarpetList: ["Caserta Stone Beige","Ageless Beauty Clay", "Lush II Tundra"]
    • HardwoodList: ["Golden Teak","Natural Hickory", "Victoria Mahogany"]HardwoodList: ["Golden Teak","Natural Hickory", "Victoria Mahogany"]
    • TileList: ["Honey Onyx Marble","Indian Autumn Slate", "Panaria Vitality Ceramic"]TileList: ["Honey Onyx Marble","Indian Autumn Slate", "Panaria Vitality Ceramic"]

      Nomes de pavimento em listas suspensas

  4. Defina a propriedade Visible de cada controle de lista suspensa como um destes valores:Set the Visible property of each Drop down control to one of these values:

    • CarpetList: If("Carpet" in CategoryList.SelectedItems.Value, true)CarpetList: If("Carpet" in CategoryList.SelectedItems.Value, true)
    • HardwoodList: If("Hardwood" in CategoryList.SelectedItems.Value, true)HardwoodList: If("Hardwood" in CategoryList.SelectedItems.Value, true)
    • TileList: If("Tile" in CategoryList.SelectedItems.Value, true)TileList: If("Tile" in CategoryList.SelectedItems.Value, true)

      Deseja saber mais sobre a função If ou sobre outras funções?Want more information about the If function or other functions?

  5. Pressione F5 e então escolha um ou mais itens em CategoryList.Press F5, and then choose one or more items in CategoryList.

    O controle ou controles de lista suspensa apropriados aparecem com base em sua opção ou opções.The appropriate Drop down control or controls appear based on your choice or choices.

    Nomes de pavimento em listas suspensas

  6. (opcional) Pressione Esc para retornar ao espaço de trabalho padrão.(optional) Press Esc to return to the default workspace.