GWT - CheckBox Widget

Introdução

o Checkbox widget representa uma caixa de seleção padrão.

Declaração de Classe

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

public class CheckBox
   extends ButtonBase
      implements HasName

Regras de estilo CSS

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

.gwt-CheckBox {}

.gwt-CheckBox-disabled {}

Construtores de classe

Sr. Não.	Construtor e descrição
1	CheckBox() Construtor para CheckkBox.
2	CheckBox(Element element) Este construtor pode ser usado por subclasses para usar explicitamente um elemento existente.
3	CheckBox(java.lang.String label) Cria uma caixa de seleção com o rótulo de texto especificado.
4	CheckBox(java.lang.String label, boolean asHTML) Cria uma caixa de seleção com o rótulo de texto especificado e define seu conteúdo como HTML.

Métodos de aula

Sr. Não.	Nome e descrição da função
1	java.lang.String getName() Obtém o nome do widget.
2	int getTabIndex() Obtém a posição do widget no índice da guia.
3	java.lang.String getText() Obtém o texto deste objeto.
4	boolean isChecked() Determina se esta caixa de seleção está marcada.
5	boolean isEnabled() Obtém se este widget está habilitado.
6	protected void onEnsureDebugId(java.lang.String baseID) Elementos afetados: -label = rótulo ao lado da caixa de seleção.
7	protected void onLoad() Este método é chamado quando um widget é anexado ao documento do navegador.
8	protected void onUnload() Este método é chamado quando um widget é desanexado do documento do navegador.
9	protected void replaceInputElement(Element elem) Substitua o elemento de entrada atual por um novo.
10	void setAccessKey(char key) Define a 'chave de acesso' do widget.
11	void setChecked(boolean checked) Marca ou desmarca esta caixa de seleção.
12	void setEnabled(boolean enabled) Define se este widget está habilitado.
13	void setFocus(boolean focused) Focar / desfocar explicitamente este widget.
14	void setHTML(java.lang.String html) Define o conteúdo deste objeto via HTML.
15	void setName(java.lang.String name) Define o nome do widget.
16	void setTabIndex(int index) Define a posição do widget no índice da guia.
17	void setText(java.lang.String text) Define o texto deste objeto.
18	void sinkEvents(int eventBitsToAdd) Adiciona um conjunto de eventos a serem afundados por este objeto.
19	java.lang.String getHTML() Obtém o conteúdo deste objeto como HTML.

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 de widget CheckBox

Este exemplo o levará por etapas simples para mostrar o uso de um CheckBox Widget 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-CheckBox{ 
   color:green;   
}

.gwt-CheckBox-disabled {
   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>CheckBox 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 CheckBox.

package com.tutorialspoint.client;

import com.google.gwt.core.client.EntryPoint;
import com.google.gwt.user.client.ui.CheckBox;
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 check box, and select it by default.
      CheckBox checkBox1 = new CheckBox("Check Me!");
      CheckBox checkBox2 = new CheckBox("Check Me!");

      // set check box as selected
      checkBox1.setValue(true);

      //disable a checkbox
      checkBox2.setEnabled(false);

      checkBox1.addClickHandler(new ClickHandler() {

         @Override
         public void onClick(ClickEvent event) {
            CheckBox checkBox = (CheckBox)event.getSource();
            Window.alert("CheckBox is " +
               (checkBox.getValue() ? "" : "not") + " checked");
         }
      });


      // Add checkboxes to the root panel.
      VerticalPanel panel = new VerticalPanel();
      panel.setSpacing(10);            
      panel.add(checkBox1);
      panel.add(checkBox2);

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

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

Quando você clica Click Me CheckBox, ele mostrará uma mensagem de alerta dizendo CheckBox está marcada ou não marcada.

↰ Previous page