Componente Caixa de verificação do JSF 1.1

Consulte também

Você pode arrastar o componente Caixa de seleção ícone do componente Caixa de seleção da categoria Básico da Paleta para o Visual Designer para criar uma caixa de seleção com um rótulo opcional.

Se quiser um conjunto de caixas de seleção que esteja pré-formatada com rótulos em um grupo, você pode usar um componente Grupo de caixas de seleção.

Você também pode soltar uma caixa de verificação em um componente de recipiente, como a célula de uma tabela ou uma caixa de grupo.

Uma caixa de verificação pode representar qualquer objeto, tanto se o objeto for de uma classe predefinida como Booleano, Byte, Caractere, Duplo, Flutuante, Inteiro, Longo, Curto, String quanto se for de uma classe definida por você. Uma caixa de verificação também pode representar um valor primitivo.

 

Uma única caixa de verificação pode ser usada para representar vários tipos de dados:

Um grupo de caixas de verificação pode ser usado para representar:

O componente Caixa de seleção pode ser útil em casos nos quais o layout do grupo de caixas de seleção não é desejado, como uma caixa de seleção usada para selecionar ou cancelar a seleção da linha de uma tabela.

Se clicar com o botão direito do mouse no componente, você pode escolher um dos seguintes itens no menu pop-up:

Detectando uma caixa de verificação selecionada

O componente Caixa de verificação usa as propriedades selected e selectedValue para passar informações sobre o status da seleção da caixa de verificação. A propriedade selected é usada para indicar que a caixa de seleção está selecionada e uma marca de verificação é exibida na página. A propriedade selectedValue é usada para passar o valor dos dados da caixa de verificação. Uma caixa de verificação é considerada selecionada quando o valor da propriedade selected é igual ao valor da propriedade selectedValue. Você pode exibir uma caixa de verificação como selecionada na visualização inicial da página atribuindo o mesmo valor às propriedades selectedValue e selected.

Se a propriedade selectedValue não for especificada ou o seu valor for null, a caixa de verificação se comportará como um controle booleano. Neste caso, se a caixa de verificação for selecionada, o valor da propriedade selected será uma instância Boolean verdadeira. Se a caixa de verificação não for selecionada, o valor da propriedade selected será uma instância Boolean falsa.

Uma expressão de vinculação de valor interpretada como um valor primitivo pode ser atribuída às propriedades selected e selectedValue.

Usando um componente Caixa de seleção como um controle booleano

Se a propriedade selectedValue não for especificada ou o seu valor for null, a caixa de verificação se comportará como um controle booleano.

Para usar uma caixa de verificação como um controle booleano, não especifique um valor para a propriedade selectedValue. A caixa de verificação é selecionada se a propriedade selected não for nula e tiver um valor de uma instância Boolean verdadeira ou valor booleano primitivo. Se a caixa de verificação não for selecionada, o valor da propriedade selected será uma instância Boolean falsa ou booleano primitivo.

Usando uma caixa de seleção para representar um valor definido pela aplicação

A propriedade selectedValue pode ser atribuída a um valor de objeto definido pela aplicação para representar o valor de uma caixa de seleção selecionada. Se a caixa de verificação for selecionada, o valor da propriedade selected será atribuído ao valor da propriedade selectedValue.

Se o valor da propriedade selectedValue for um objeto definido pela aplicação, um conversor deverá ser registrado para converter para e de um valor String. O conversor é usado para codificar o valor da caixa de seleção como o valor do elemento HTML <input> e para decodificar o valor enviado em uma solicitação. Além disso, para detectar uma caixa de verificação selecionada, o objeto deve suportar um método equals que retorne true quando o valor da propriedade selectedValue for comparado ao valor da propriedade selected para detectar uma caixa de verificação selecionada.

Consulte também
Janela Propriedades do componente Caixa de verificação
Vinculando propriedades do componente
Trabalhando com componentes
Tarefas de componente: referência rápida
Sobre a Paleta do Visual Web

Notificações legais