Caixa de Combinação

O controle ComboBox apresenta aos usuários uma lista de opções. A lista é mostrada e oculta à medida que o controle se expande e recolhe. Em seu estado padrão, a lista é recolhida, exibindo apenas uma opção. O usuário clica em um botão para ver a lista completa de opções.

A seguinte ilustração mostra uma ComboBox em diferentes estados.

Um controlo ComboBox mostrado em estados desativado, colapsado e expandido.

Estilos e modelos

Esta secção descreve os estilos e modelos para o ComboBox controle. Podes modificar o padrão ControlTemplate para dar ao 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

A Items propriedade é a propriedade de conteúdo do ComboBox controlo. Esta propriedade contém a lista de itens que a ComboBox apresenta.

Partes

A tabela seguinte lista as partes nomeadas para o ComboBox controlo.

Parte Tipo Description
PART_EditableTextBox TextBox A parte da caixa de texto editável usada quando IsEditable é true.
PART_Popup Popup A janela flutuante que contém a lista suspensa de itens.

Quando cria um ControlTemplate para um ComboBox, o seu modelo pode conter um ItemsPresenter dentro de um ScrollViewer. (O ItemsPresenter exibe cada item no ComboBox; o ScrollViewer permite deslocar-se dentro do controlo). Se o ItemsPresenter não for filho direto do ScrollViewer, deve dar ao ItemsPresenter o nome ItemsPresenter.

Estados visuais

A tabela seguinte lista os estados para o ComboBox 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.
Sem foco FocusStates O controlo não está focado no teclado.
Focused FocusStates O controlo tem foco no teclado.
FocusedDropDown FocusStates O controlo tem foco no teclado e o menu suspenso está aberto.
Editável EditStates O controlo está em modo editável.
Impossível de editar EditStates O controlo está em modo não editável.
Válido Estados de Validação O controlo é válido e não tem erros de validação.
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.

Peças ComboBoxItem

O ComboBoxItem controlo não tem partes nomeadas.

Estados visuais do ComboBoxItem

A tabela seguinte lista os estados para o ComboBoxItem controlo.

Nome VisualState Nome VisualStateGroup Description
Normal Estados Comuns O estado padrão.
Disabled Estados Comuns O controlo está desativado.
MouseOver Estados Comuns O ponteiro do rato está sobre o ComboBoxItem controlo.
Focused FocusStates O controlo tem foco.
Sem foco FocusStates O controlo não tem foco.
Selecionados Estados de Seleção O item está atualmente selecionado.
não selecionado Estados de Seleção O item não é selecionado.
SelecionadoSem Foco Estados de Seleção O item está selecionado, mas não tem foco.
Válido Estados de Validação O controlo usa a Validation classe e a Validation.HasError propriedade associada é false.
FocadoInválido Estados de Validação A Validation.HasError propriedade anexa é true e o controlo tem foco.
InvalidUnfocused Estados de Validação A Validation.HasError propriedade anexada é true e o controlo não tem foco.

Consulte também

ComboBox

  • Last updated on