Uma lista na qual o usuário pode selecionar um ou vários itens.

Descrição

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

Propriedades-chave

Default – o valor inicial de um controle antes de ele ser alterado pelo usuário.

Items - a fonte de dados exibida em um controle como uma galeria, uma lista ou um gráfico.

Itens A fonte de dados exibida em um controle como uma galeria, uma lista ou um gráfico.

Quando você adiciona uma galeria, uma lista ou um gráfico, a lista de propriedades mostra Itens por padrão para que você possa especificar facilmente os dados que o novo controle deve mostrar. Por exemplo, você pode definir a propriedade Itens de uma galeria como a tabela Conta no Salesforce, uma tabela chamada Inventário que você criou no Excel e carregou para a nuvem ou uma lista do SharePoint denominada ConferenceSpeakers.

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.

FocusedBorderThickness – a espessura da borda do controle quando ele tem o foco do teclado.

Color – a cor do texto em um controle.

Disabled – se o usuário pode ou não interagir com o controle.

DisabledBorderColor – a cor da borda do controle se a propriedade Disabled do controle estiver definida como true.

DisabledColor – a cor do texto em um controle se sua propriedade Disabled estiver definida como true.

DisabledFill – a cor da tela de fundo de um controle se sua propriedade Disabled estiver definida como true.

Fill – a cor da tela de fundo de um controle.

Font – o nome da família de fontes no qual o texto é exibido.

FontWeight – o peso do texto em um controle: Bold (negrito), Semibold, Normal ou Lighter (mais leve).

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

HoverBorderColor – a cor da borda do controle quando o usuário mantém o ponteiro do mouse nesse controle.

HoverColor – a cor do texto em um controle quando o usuário mantém o ponteiro do mouse sobre ele.

HoverFill – a cor da tela de fundo de um controle quando o usuário mantém o ponteiro do mouse sobre ele.

Italic – se o texto em um controle está em itálico.

ItemPaddingLeft – a distância entre o texto em uma caixa de listagem e sua borda esquerda.

LineHeight – a distância entre, por exemplo, linhas de texto ou itens em uma lista.

OnChange – como o aplicativo responde quando o usuário altera o valor de um controle (por exemplo, ajustando um controle deslizante).

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

PaddingBottom – a distância entre o texto em um controle e a borda inferior desse controle.

PaddingLeft – a distância entre o texto em um controle e a borda esquerda desse controle.

PaddingRight – a distância entre o texto em um controle e a borda direita desse controle.

PaddingTop – a distância entre o texto em um controle e a borda superior desse controle.

PressedBorderColor – a cor da borda do controle quando o usuário toca ou clica nesse controle.

PressedColor – a cor do texto em um controle quando o usuário toca ou clica nesse controle.

PressedFill – a cor da tela de fundo de um controle quando o usuário toca ou clica nesse controle.

Reset – se um controle é revertido para seu valor padrão.

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.

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.

SelectMultiple – se um usuário pode selecionar mais de um item em uma caixa de listagem.

Size – o tamanho da fonte do texto que aparece em um controle.

Strikethrough – se uma linha é exibida cortando o texto que aparece em um controle.

TabIndex – personaliza a ordem de tabulação de controles em tempo de execução quando definida como um valor diferente de zero.

Tooltip – um texto explicativo aparece quando o usuário passa o mouse sobre um controle.

Underline – se uma linha é exibida sob o texto que aparece 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).

Funções relacionadas

Distinct( DataSource, ColumnName )

Exemplo

  1. Adicione um controle de caixa de listagem, chame-o de CategoryList e defina sua propriedade Items como esta fórmula:
    ["Carpet","Hardwood","Tile"]

    Não sabe como adicionar, nomear e configurar um controle?

    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.

  3. Defina a propriedade Items de cada controle de lista suspensa como um destes valores:

    • CarpetList: ["Caserta Stone Beige","Ageless Beauty Clay", "Lush II Tundra"]
    • HardwoodList: ["Golden Teak","Natural Hickory", "Victoria Mahogany"]
    • 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:

    • CarpetList: If("Carpet" in CategoryList.SelectedItems.Value, true)
    • HardwoodList: If("Hardwood" 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?

  5. Pressione F5 e então escolha um ou mais itens em CategoryList.

    O controle ou controles de lista suspensa apropriados aparecem com base em sua opção ou opções.

    Nomes de pavimento em listas suspensas

  6. (opcional) Pressione Esc para retornar ao espaço de trabalho padrão.