Compartilhar via

Listboxitem

Um ListBoxItem representa um item selecionável individual dentro de um ListBox controle. Quando você adiciona itens a uma coleção ListBox, o WPF encapsula automaticamente cada item em um contêiner ListBoxItem.

O controle ListBoxItem fornece propriedades visuais e comportamentais para itens de lista individuais, incluindo:

  • Comportamento de seleção – manipula como o item responde à seleção do usuário.
  • Estados visuais – Gerencia as alterações de aparência quando o item é focalizado, selecionado ou focado.
  • Apresentação de conteúdo – Exibe os dados reais ou o conteúdo desse item específico.

Você pode personalizar a aparência e o comportamento dos contêineres ListBoxItem estilizando o ListBoxItem diretamente ou definindo um estilo de contêiner de item personalizado no ListBox pai.

Estilos e modelos

Você pode modificar o padrão ControlTemplate para dar ao ListBoxItem controle uma aparência exclusiva. Para obter mais informações, consulte O que são estilos e modelos? e Como criar um modelo para um controle.

Propriedade content

O ListBoxItem controle usa a Content propriedade como sua propriedade de conteúdo. Essa propriedade determina o que é exibido em cada item de lista e dá suporte a vários tipos de conteúdo, incluindo texto, imagens e elementos complexos da interface do usuário.

Partes

O ListBoxItem controle não define nenhuma parte de modelo nomeada.

Estados visuais

A tabela a seguir lista os estados visuais do ListBoxItem controle.

Nome do VisualState Nome do VisualStateGroup Description
Normal CommonStates O controle está em seu estado normal.
Mouseover CommonStates O mouse está sobre o controle.
Disabled CommonStates O controle está desabilitado.
Focused FocusStates O controle tem o foco do teclado.
Desfocado FocusStates O controle não tem o foco do teclado.
Selecionado Estados de Seleção O controle está selecionado.
SelecionadoDesfocado Estados de Seleção O controle está selecionado, mas não tem o foco do teclado.
Não selecionado Estados de Seleção O controle não está selecionado.
FocoInválido ValidationStates O controle tem um erro de validação e tem o foco do teclado.
InvalidUnfocused ValidationStates O controle tem um erro de validação, mas não tem o foco do teclado.
Válido ValidationStates O controle é válido e não tem erros de validação.

Consulte também

  • Last updated on