Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Uma lista na qual o usuário pode selecionar um ou vários itens.
Description
Um controle List Box sempre mostra todas as opções disponíveis (ao contrário de um controle Suspenso ) e no qual o usuário pode escolher mais de um item por vez (ao contrário de um controle De rádio ).
Principais propriedades
Padrão – o valor inicial de um controle antes de ser alterado pelo usuário.
Observação
Você só pode ter um item selecionado padrão. Se você precisar de vários itens selecionados, use o controle Caixa de Combinação .
Itens – A fonte de dados que aparece 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 para a tabela Conta no Salesforce, uma tabela chamada Inventário que você criou no Excel e carregou na nuvem ou uma lista chamada ConferenceSpeakers.
Propriedades adicionais
AccessibleLabel – Rótulo para leitores de tela.
BorderColor – A cor da borda de um controle.
BorderStyle – se a borda de um controle é Solid, Dashed, Dotted ou None.
BorderThickness – A espessura da borda de um controle.
Cor – a cor do texto em um controle.
DisplayMode – se o controle permite a entrada do usuário (Editar), exibe apenas dados (Exibição) ou está desabilitado (Desabilitado).
DisabledBorderColor – A cor da borda de um controle se a propriedade DisplayMode do controle estiver definida como Desabilitada.
DisabledColor – A cor do texto em um controle se sua propriedade DisplayMode estiver definida como Desabilitada.
DisabledFill – A cor da tela de fundo de um controle se sua propriedade DisplayMode estiver definida como Desabilitada.
Fill – a cor da tela de fundo de um controle.
FocusedBorderColor – A cor da borda de um controle quando o controle está focado.
FocusedBorderThickness – A espessura da borda de um controle quando o controle está focado.
Fonte – o nome da família de fontes em que o texto é exibido.
FontWeight – O peso do texto em um controle: Negrito, Semiaberto, Normal ou Mais Leve.
Altura – a distância entre as bordas superior e inferior de um controle.
HoverBorderColor – A cor da borda de um 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.
Itálico – se o texto em um controle é 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 – Ações a serem executadas quando o usuário altera o valor de um controle (por exemplo, ajustando um controle deslizante).
OnSelect – Ações a serem executadas 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 de um 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.
Redefinição – se um controle é revertido para seu valor padrão.
Selected – o registro de dados que representa o item selecionado.
Observação
Você só pode ter um item selecionado padrão. Se você precisar de vários itens selecionados, use o controle Caixa de Combinação .
SelectedItems - Somente leitura. Representa uma tabela de dados de itens selecionados para uma caixa de listagem de várias seleções.
SelectedItemsText - Somente leitura. Representa uma tabela de dados de texto de itens selecionados para uma caixa de listagem multisseleção.
SelectedText (preterido) – um valor de cadeia de caracteres que representa o item selecionado.
SelectionColor – A cor do texto de um item ou itens selecionados em uma lista ou na 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 em uma área selecionada de um controle de caneta.
SelectMultiple – Se um usuário pode selecionar mais de um item em uma caixa de listagem.
Tamanho – o tamanho da fonte do texto que aparece em um controle.
Tachado – se uma linha aparece por meio do texto que aparece em um controle.
TabIndex – Ordem de navegação do teclado em relação a outros controles.
Dica de ferramenta – texto explicativo exibido quando o usuário passa o mouse sobre um controle.
Sublinhado – se uma linha aparece sob o texto que aparece em um controle.
Visível – se um controle aparece ou está oculto.
Largura – a distância entre as 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 (ou a 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 (ou a tela, se não houver contêiner pai).
Funções relacionadas
Distinct( DataSource, ColumnName )
Example
Adicione um controle de caixa de listagem , nomeie-o CategoryList e defina sua propriedade Items para esta fórmula:
["Carpet","Hardwood","Bloco"]Não sabe como adicionar, nomear e configurar um controle?
Adicione três controles suspensos , mova-os em CategoryList e nomeie-os CarpetList, HardwoodList e TileList.
Defina a propriedade Items de cada controle suspenso como um destes valores:
CarpetList: ["Caserta Stone Bege", "Ageless Beauty Clay", "Lush II Tundra"]
HardwoodList: ["Golden Teak", "Natural Hickory", "Victoria Mahogany"]
TileList: ["Honey Onyx Marble", "Indian Autumn Slate", "Panaria Vitality Ceramic"]
Defina a propriedade Visible de cada controle suspenso como um destes valores:
CarpetList: If("Carpet" em CategoryList.SelectedItems.Value, true)
HardwoodList: If("Hardwood" em CategoryList.SelectedItems.Value, true)
TileList: If("Tile" em CategoryList.SelectedItems.Value, true)
Deseja obter mais informações sobre a função If ou outras funções?
Pressione F5 e escolha um ou mais itens em CategoryList.
Os controles ou controles suspensos apropriados aparecem com base em suas escolhas ou escolhas.
(opcional) Pressione Esc para retornar ao workspace padrão.
Diretrizes de acessibilidade
Contraste de cores
Deve haver contraste de cores adequado entre:
- SelectionColor e SelectionFill
- SelectionFill e Fill
- HoverFill e Fill
- PressedFill e Fill
Isso é além dos requisitos de contraste de cores padrão.
Suporte ao leitor de tela
- AccessibleLabel deve estar presente.
Suporte ao teclado
TabIndex deve ser zero ou maior para que os usuários de teclado possam navegar até ele.
Indicadores de foco devem estar claramente visíveis. Use FocusedBorderColor e FocusedBorderThickness para conseguir isso.
Observação
A tecla tab navega para ou para longe da caixa Listar. As teclas de direção navegam pelo conteúdo da caixa Listar.