ListBoxItem

A ListBoxItem representa um item individual selecionável dentro de um ListBox controlo. Quando adiciona itens a uma coleção ListBox, o WPF envolve automaticamente cada item num contentor ListBoxItem.

O controlo ListBoxItem fornece propriedades visuais e comportamentais para itens individuais da lista, incluindo:

  • Comportamento de seleção - Trata de como o item responde à seleção do utilizador.
  • Estados visuais - Gere alterações na aparência quando o item é colocado sob o cursor, selecionado ou focado.
  • Apresentação do conteúdo - Mostra os dados ou conteúdos reais para esse item específico.

Pode personalizar a aparência e o comportamento dos contentores ListBoxItem estilizando diretamente o ListBoxItem ou definindo um ItemContainerStyle personalizado na ListBox principal.

Estilos e modelos

Podes modificar o padrão ControlTemplate para dar ao ListBoxItem 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.

Propriedade de conteúdo

O ListBoxItem controlo utiliza a Content propriedade como sua propriedade de conteúdo. Esta propriedade determina o que aparece em cada item da lista e suporta vários tipos de conteúdo, incluindo texto, imagens e elementos complexos de interface.

Partes

O ListBoxItem controlo não define nenhuma parte template nomeada.

Estados visuais

A tabela seguinte lista os estados visuais do ListBoxItem controlo.

Nome VisualState Nome VisualStateGroup Description
Normal Estados Comuns O controlo está no seu estado normal.
MouseOver Estados Comuns O rato está sobre o controlo.
Disabled Estados Comuns O controlo está desativado.
Focused FocusStates O controlo tem foco no teclado.
Sem foco FocusStates O controlo não está focado no teclado.
Selecionados Estados de Seleção O controlo é selecionado.
SelecionadoSem Foco Estados de Seleção O controlo está selecionado, mas não tem foco no teclado.
não selecionado Estados de Seleção O controlo não está selecionado.
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