Você vê a janela Propriedades de um componente Grupo de caixas de verificação
quando seleciona o componente em uma página que está editando no Visual Designer, depois de ter adicionado o componente à página. Este componente possui as propriedades a seguir.
Tipo: Stringid do componente. No bean de página, o valor desta propriedade é o nome do objeto CheckboxGroup.Tipo: int<table>. O número de linhas é definido pelo tamanho da matriz items. O número de colunas é definido pelo atributo de colunas. O layout padrão é uma única coluna vertical. Tipo: String for do rótulo está definida para a primeira caixa de seleção do grupo.
label não é tão flexível quanto o componente Rótulo. Você pode usar o componente Rótulo se quiser ter mais controle sobre a aparência do rótulo, tal como o seu posicionamento em relação ao componente. Tipo: int label estiver definida. Tipo: String position: absolute; left: 288px; top: 312px
Você pode inserir valores diretamente ou clicar no botão de reticências (...) para usar o Editor de estilo.
Para obter uma lista de estilos CSS2, consulte a página da Web em
Tipo: Stringstyle para obter uma explicação do porquê uma classe adicionada a esta propriedade talvez pareça não ter efeito no componente. As classes de estilo CSS defaulttheme deste componente são:
css_master.css
.CbDis, .RbDis {background-color:#E1E4E5;color:#848687}
.Cb {}
.Rb {}
.RbSpn input {vertical-align: 1px}
.CbSpn input {vertical-align: -1px}
.CbGrp td, .RbGrp td {text-align: left}
.CbGrp label, .RbGrp label {vertical-align: 6px}
css_ie55up.css
/* ADDITIONAL CSS FOR IE5.5+ SUPPORT */
.RbSpn input, .CbSpn input {vertical-align: 3px;}
Tipo: Conversorvalue selecionada. Tipo: Objeto com.sun.rave.web.ui.model.Option. Cada instância de Option representa uma caixa de seleção. A propriedade value de uma instância de Option representa o valor de uma caixa de verificação selecionada. Se a propriedade items estiver vazia ou a matriz, mapa ou coleção estiver vazia, nada será renderizado.
Para obter informações sobre com.sun.webui.jsf.model.Option, inclua esta classe no modo de visualização Java de uma página, coloque o cursor no nome da classe e pressione Alt-F1 para ver sua descrição de Javadoc.
Por padrão, esta propriedade é associada a um objeto com.sun.rave.web.ui.model.MultipleSelectOptionsList com um nome semelhante a checkboxGroup1DefaultOptions, cujo nó você vê na janela Navegador. Este objeto serve simplesmente para preencher o grupo com caixas de seleção padrão. Ele está no bean de página.
Tipo: booleanofor a este componente, será exibida uma mensagem de erro se o usuário tentar enviar a página sem selecionar um item.
Tipo: ObjetoO componente Grupo de caixas de seleção pode ter mais de um valor, o que tem implicações sobre qual tipo de valor pode ser usado.
Object ou uma matriz de primitivos. Os elementos individuais desta matriz representam os valores selecionados no momento no conjunto de todas as opções possíveis. checkboxGroup.getValue() será uma matriz Object.Uma forma comum de processar os valores escolhidos pelo usuário é vincular este componente a uma matriz Object e verificar os valores da matriz quando o usuário enviar a página. A propriedade selected deve ser uma expressão de vinculação de valor que é interpretada para ler e gravar um Object. Um valor Object lido a partir da expressão de vinculação de valor identifica a caixa de seleção selecionada. O valor Object deve ser igual ao atributo value de pelo menos uma instância de Option especificada na matriz obtida a partir da expressão de vinculação de valor atribuída à propriedade items.
O método de gravação da expressão de vinculação de valor da propriedade selected é chamado durante a UPDATE_MODEL_PHASE do ciclo de vida do JavaServer Faces. Se uma caixa de verificação for selecionada, um valor Object será passado como um argumento para o método write. A Object é o valor do botão de seleção selecionado.
Consulte o link para o tutorial dos componentes Caixa de listagem no fim da página para obter mais informações.
Tipo: MethodBinding(null), nenhum validador será chamado. Se você escolher um validador, selecione também a propriedade required para garantir que o validador seja usado.
Defina as propriedades do evento, clicando com o botão direito no mouse no Visual Designer e escolhendo Editar manipulador de eventos > nome do evento.
validator, clique com o botão direito do mouse no componente e escolha Editar manipulador de eventos > Validar. O nome padrão do método é id-do-componente_validate, onde id-do-componente é o valor da propriedade id do componente. Quando você define este método desta forma, as propriedades validator e validate são definidas automaticamente para você. Se você definir um validador, selecione também a propriedade required para garantir que esse validador seja usado.
validator. Se você definir o seu próprio método de validação, não altere separadamente o valor da propriedade validator, ou a conexão com o método de validação será perdida.null. Você geralmente define este método no bean de página, clicando com o botão direito do mouse no componente no Visual Designer e escolhendo Editar manipulador de eventos > processValueChange. O nome padrão do método é id-do-componente_processValueChange, onde id-do-componente é o valor da propriedade id do componente. Tipo: booleanoreadOnly sobre os efeitos do uso da propriedade disabled em comparação ao efeito do uso da propriedade readOnly. Tipo: booleanodisabled, o JavaServer Faces não detectará que algum valor tenha sido enviado. Tipo: String title do componente. O valor do texto desta propriedade será exibido se o usuário passar o cursor do mouse sobre o rótulo do grupo de caixas de seleção.
Tipo: booleanorendered. Tipo: String Tipo: String Tipo: String Tipo: String Tipo: String Tipo: String Tipo: String Tipo: String Tipo: String Tipo: String Tipo: String Tipo: booleanoO exemplo mais comum de uma ação imediata é um botão Cancelar. Você o torna imediato para que a validação normal e as etapas de atualização possam ser ignoradas, mas o manipulador de ações ainda poderá fazer o que for necessário. Geralmente, o manipulador de ações navegará de volta para alguma página anterior. Em alguns designs, o manipulador de ações também pode enfileirar uma mensagem informativa como "Transação cancelada". É possível fazer mais: por exemplo, uma aplicação deve registrar o fato de que o usuário cancelou a operação atual.
Tipo: booleanovisible em vez desta propriedade.
Você pode vincular esta propriedade a uma propriedade JavaBeans que determina quando o componente é renderizado. Por exemplo, um formulário de reserva de viagens pode mostrar um componente para passageiros freqüentes e não mostrá-lo para o público em geral. Para vincular esta propriedade, clique no botão de reticências (...) à direita da propriedade e escolha Usar vinculação na caixa de diálogo.
Tipo: MethodBindingvalueChange da seção Evento acima, que fornece uma forma mais fácil de definir o valor desta propriedade. A propriedade valueChangeListener é a propriedade MethodBinding que fica abaixo da propriedade do evento valueChange. A propriedade valueChangeListener é atualizada quando você define o método da propriedade do evento valueChange.
Se você clicar no botão de reticências ao lado da propriedade valueChange, poderá usar o editor de propriedade para escolher um método existente para se vincular, ou poderá criar um novo método ou desvincular um método existente. Se você for um especialista, em vez de usar a propriedade valueChange, pode digitar uma expressão MethodBinding diretamente nesta propriedade valueChangeListener, por exemplo, se quiser chamar um método que não esteja no bean de página.