Caixa de listagem

Um controlo ListBox exibe uma coleção de itens que os utilizadores podem selecionar. O ListBox suporta seleções únicas ou múltiplas e oferece navegação por teclado, capacidades de scroll e ligação de dados. É comumente usado em formulários e aplicações onde os utilizadores precisam de escolher entre opções pré-definidas.

Captura de ecrã de um controlo típico do ListBox mostrando uma lista de itens selecionáveis

Title Description
Vincular um ListBox a Dados Mostra como associar um ListBox a uma fonte de dados.
Obtenha um ListBoxItem Mostra como recuperar um ListBoxItem específico de um ListBox.
Melhorar o desempenho de deslocamento de uma ListBox Mostra como otimizar o desempenho de scroll numa ListBox com muitos itens.

Estilos e modelos

Podes modificar o padrão ControlTemplate para dar ao ListBox controlo uma aparência única. Para mais informações, veja O que são estilos e modelos? e Como criar um modelo para um controlo.

Quando cria um ControlTemplate para um ListBox, o seu modelo pode conter um ItemsPresenter dentro de um ScrollViewer. ItemsPresenter mostra cada item no ListBox, e o ScrollViewer permite o deslocamento dentro do controlo. Se o ItemsPresenter não for filho direto do ScrollViewer, deve dar ao ItemsPresenter o nome ItemsPresenter.

Propriedade de conteúdo

O ListBox controlo utiliza a Items propriedade como sua propriedade de conteúdo. Esta propriedade representa a coleção de itens apresentados na ListBox e suporta a ligação de dados a várias fontes de dados.

Partes

O ListBox controlo não define nenhuma parte de modelo nomeada.

Estados visuais

A tabela seguinte lista os estados visuais do ListBox controlo.

Nome VisualState Nome VisualStateGroup Description
FocadoInválido Estados de Validação O controlo apresenta um erro de validação e tem o foco do teclado.
InvalidUnfocused Estados de Validação O controlo tem um erro de validação mas não tem foco no teclado.
Válido Estados de Validação O controlo é válido e não tem erros de validação.

Consulte também

  • Last updated on