GWT - Widget ListBox

Introdução

o ListBox widget representa uma lista de opções para o usuário, como uma caixa de listagem ou uma lista suspensa.

Declaração de Classe

A seguir está a declaração para com.google.gwt.user.client.ui.ListBox classe -

public class ListBox
   extends FocusWidget
      implements SourcesChangeEvents, HasName

Regras de estilo CSS

As seguintes regras de estilo CSS padrão serão aplicadas a todos os widgets ListBox. Você pode substituí-lo de acordo com seus requisitos.

.gwt-ListBox {}

Construtores de classe

Sr. Não. Construtor e descrição
1

ListBox()

Cria uma caixa de listagem vazia no modo de seleção única.
2

ListBox(boolean isMultipleSelect)

Cria uma caixa de listagem vazia.
3

ListBox(Element element)

Este construtor pode ser usado por subclasses para usar explicitamente um elemento existente.

Métodos de aula

Sr. Não. Nome e descrição da função
1

void addItem(java.lang.String item)

Adiciona um item à caixa de listagem.
2

void addItem(java.lang.String item, java.lang.String value)

Adiciona um item à caixa de listagem, especificando um valor inicial para o item.
3

void clear()

Remove todos os itens da caixa de listagem.
4

int getItemCount()

Obtém o número de itens presentes na caixa de listagem.
5

java.lang.String getItemText(int index)

Obtém o texto associado ao item no índice especificado.
6

java.lang.String getName()

Obtém o nome do widget.
7

int getSelectedIndex()

Obtém o item atualmente selecionado.
8

java.lang.String getValue(int index)

Obtém o valor associado ao item em um determinado índice.
9

int getVisibleItemCount()

Obtém o número de itens visíveis.
10

void insertItem(java.lang.String item, int index)

Insere um item na caixa de listagem.
11

void insertItem(java.lang.String item, java.lang.String value, int index)

Insere um item na caixa de listagem, especificando um valor inicial para o item.
12

boolean isItemSelected(int index)

Determina se um item de lista individual é selecionado.
13

boolean isMultipleSelect()

Obtém se esta lista permite seleção múltipla.
14

void onBrowserEvent(Event event)

Disparado sempre que um evento do navegador é recebido.
15

protected void onEnsureDebugId(java.lang.String baseID)

Elementos afetados: -item # = a opção no índice especificado.
16

void removeChangeListener(ChangeListener listener)

Remove uma interface de ouvinte adicionada anteriormente.
17

void removeItem(int index)

Remove o item no índice especificado.
18

void setItemSelected(int index, boolean selected)

Define se um item de lista individual é selecionado.
19

void setItemText(int index,java.lang.String text)

Define o texto em determinado índice.
20

void setMultipleSelect(boolean multiple)

Define se esta lista permite várias seleções.
21

void setName(java.lang.String name)

Define o nome do widget.
22

void setSelectedIndex(int index)

Define o índice atualmente selecionado.
23

void setValue(int index, java.lang.String value)

Define o valor associado ao item em um determinado índice.
24

void setVisibleItemCount(int visibleItems)

Define o número de itens visíveis.
25

static ListBox wrap(Element element)

Cria um widget ListBox que envolve um elemento <select> existente.
26

void addChangeListener(ChangeListener listener)

Adiciona uma interface de ouvinte para receber eventos de mudança.

Métodos herdados

Esta classe herda métodos das seguintes classes -

  • com.google.gwt.user.client.ui.UIObject

  • com.google.gwt.user.client.ui.Widget

  • com.google.gwt.user.client.ui.FocusWidget

  • java.lang.Object

Exemplo do widget ListBox

Este exemplo o levará por etapas simples para mostrar o uso de um widget ListBox no GWT. Siga as etapas a seguir para atualizar o aplicativo GWT que criamos no GWT - capítulo Criar aplicativo -

Degrau Descrição
1 Crie um projeto com o nome HelloWorld em um pacote com.tutorialspoint conforme explicado no capítulo GWT - Criar aplicativo .
2 Modifique HelloWorld.gwt.xml , HelloWorld.css , HelloWorld.html e HelloWorld.java conforme explicado abaixo. Mantenha o resto dos arquivos inalterados.
3 Compile e execute o aplicativo para verificar o resultado da lógica implementada.

A seguir está o conteúdo do descritor do módulo modificado src/com.tutorialspoint/HelloWorld.gwt.xml.

<?xml version = "1.0" encoding = "UTF-8"?>
<module rename-to = 'helloworld'>
   <!-- Inherit the core Web Toolkit stuff.                        -->
   <inherits name = 'com.google.gwt.user.User'/>

   <!-- Inherit the default GWT style sheet.                       -->
   <inherits name = 'com.google.gwt.user.theme.clean.Clean'/>

   <!-- Specify the app entry point class.                         -->
   <entry-point class = 'com.tutorialspoint.client.HelloWorld'/>

   <!-- Specify the paths for translatable code                    -->
   <source path = 'client'/>
   <source path = 'shared'/>

</module>

A seguir está o conteúdo do arquivo de folha de estilo modificado war/HelloWorld.css.

body {
   text-align: center;
   font-family: verdana, sans-serif;
}

h1 {
   font-size: 2em;
   font-weight: bold;
   color: #777777;
   margin: 40px 0px 70px;
   text-align: center;
}

.gwt-ListBox{ 
   color:green;   
}

A seguir está o conteúdo do arquivo host HTML modificado war/HelloWorld.html.

<html>
   <head>
      <title>Hello World</title>
      <link rel = "stylesheet" href = "HelloWorld.css"/>
      <script language = "javascript" src = "helloworld/helloworld.nocache.js">
      </script>
   </head>

   <body>
      <h1>ListBox Widget Demonstration</h1>
      <div id = "gwtContainer"></div>
   </body>
</html>

Vamos ter o seguinte conteúdo do arquivo Java src/com.tutorialspoint/HelloWorld.java que demonstrará o uso do widget ListBox.

package com.tutorialspoint.client;

import com.google.gwt.core.client.EntryPoint;
import com.google.gwt.user.client.ui.ListBox;
import com.google.gwt.user.client.ui.RootPanel;
import com.google.gwt.user.client.ui.VerticalPanel;

public class HelloWorld implements EntryPoint {
   public void onModuleLoad() {

      // Make a new list box, adding a few items to it.
      ListBox listBox1 = new ListBox();
      listBox1.addItem("First");
      listBox1.addItem("Second");
      listBox1.addItem("Third");
      listBox1.addItem("Fourth");
      listBox1.addItem("Fifth");

      // Make a new list box, adding a few items to it.
      ListBox listBox2 = new ListBox();
      listBox2.addItem("First");
      listBox2.addItem("Second");
      listBox2.addItem("Third");
      listBox2.addItem("Fourth");
      listBox2.addItem("Fifth");

      // Make enough room for all five items 
      listBox1.setVisibleItemCount(5);
	  
      //setting itemcount value to 1 turns listbox into a drop-down list.
      listBox2.setVisibleItemCount(1);

      // Add listboxes to the root panel.
      VerticalPanel panel = new VerticalPanel();
      panel.setSpacing(10);
      panel.add(listBox1);
      panel.add(listBox2);

      RootPanel.get("gwtContainer").add(panel);
   }	
}

Quando você estiver pronto com todas as alterações feitas, vamos compilar e rodar a aplicação em modo de desenvolvimento como fizemos no capítulo GWT - Criar Aplicação . Se tudo estiver bem com sua aplicação, isso produzirá o seguinte resultado -