Você pode arrastar o 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:
validate do componente para que você possa inserir o código para validar o valor do componente.processValueChange do componente para que você possa inserir o código que é executado quando o valor deste componente sofrer alterações (por exemplo, quando o usuário altera o valor de outro componente que está controlando o valor deste componente).common_timeoutSubmitForm(this.form, 'id-do-componente');. Em tempo de execução, este código faz com que o formulário seja enviado automaticamente se o usuário alterar o valor do componente. Depois de o formulário ter sido enviado, ocorre a conversão e a validação no servidor, quaisquer métodos ouvintes de alteração de valor são executados e, em seguida, a página é reexibida.
Um componente configurado como Enviar automaticamente ao alterar pode usar formulários virtuais para limitar os campos de entrada processados quando o formulário é enviado. Se o componente de envio automático for definido para enviar um formulário virtual, somente os participantes de tal formulário virtual serão processados quando o envio automático ocorrer.
selected a um objeto ou a um provedor de dados para que a aplicação possa avaliá-lo quando a página for enviada. Para obter mais informações, consulte Caixa de diálogo Vincular aos dados.selected, a outros objetos ou beans de propriedades que atualizam automaticamente estas propriedades do componente. 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.
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.
true indistinguíveis. 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.