Você pode arrastar o componente Caixa de listagem
da categoria Básico da Paleta para o Visual Designer a fim de criar um componente que permita ao usuário selecionar itens em uma lista de itens. Se a caixa for muito pequena para abranger os itens da lista, a caixa de listagem inclui barras de rolagem.
Por padrão, é possível selecionar apenas um item da lista. A propriedade multiple determina se o usuário poderá selecionar um ou vários itens.
Você pode definir a propriedade items para associar o componente a uma tabela de banco de dados ou a uma matriz, um conjunto ou um mapa de objetos com.sun.rave.web.ui.model.Option para preencher a lista. Clique com o botão direito do mouse no componente e escolha Vincular aos dados para definir esta propriedade. Na janela Navegador, é possível visualizar o objeto padrão que preenche a lista, que possui um nome semelhante a listbox1DefaultOptions.
A propriedade selected pode ser definida para associar o componente a um objeto de modelo que toma os itens da lista selecionados pelo usuário. O objeto de modelo deve ser uma matriz de objetos cujos valores representam os valores dos objetos com.sun.rave.web.ui.model.Option na lista. Na primeira vez que o componente é renderizado, as opções que correspondem ao valor da propriedade selected, se houver opções, são marcadas como selecionadas.
Depois de adicionar um componente Caixa de listagem à pagina JSF Visual Web, você pode:
id do componente. No bean de página, o valor desta propriedade é o nome do objeto Listbox.rows como 1, a caixa de listagem é renderizada como uma lista suspensa na maioria dos navegadores.labelOnTop estiver definida ou ao lado da lista se a propriedade labelOnTop não estiver selecionada.
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.obrigatório. 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).items do componente a um objeto ou a um provedor de dados, conforme descrito em Caixa de diálogo Vincular aos dados.
items a um objeto, selecione a guia Vincular a objeto e, em seguida, selecione uma propriedade do Bean que será usada para preencher a lista. A propriedade do bean deve ser uma coleção, mapa ou matriz de Object cujos membros são todas as subclasses de com.sun.webui.jsf.model.Option.
items a um provedor de dados de uma tabela de banco de dados ou um objeto JavaBeans que será usado para preencher a lista, selecione a guia Vincular ao provedor de dados e escolha um provedor de dados.onclick de JavaScript do componente para 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 para que você possa avaliar o que o usuário seleciona depois que a página é enviada.