GWT - Widget DockPanel

Introdução

o DockPanel widget representa um painel que posiciona seus widgets filhos "encaixados" em suas bordas externas e permite que seu último widget ocupe o espaço restante em seu centro.

Declaração de Classe

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

@Deprecated
public class DockPanel
   extends CellPanel
      implements HasAlignment

Construtores de classe

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

DockPanel()

Construtor para DockPanel.

Métodos de aula

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

void add(Widget widget, DockPanel. DockLayoutConstant direction)

Descontinuada. Adiciona um widget à borda especificada da doca.
2

HasHorizontalAlignment. HorizontalAlignmentConstant getHorizontalAlignment()

Descontinuada. Obtém o alinhamento horizontal.
3

HasVerticalAlignment. VerticalAlignmentConstant getVerticalAlignment()

Descontinuada. Obtém o alinhamento vertical.
4

DockPanel. DockLayoutConstant getWidgetDirection(Widget w)

Descontinuada. Obtém a direção do layout do widget filho fornecido.
5

protected void onEnsureDebugId(java.lang. String baseID)

Descontinuada. DockPanel oferece suporte à adição de mais de uma célula em uma direção, portanto, um número inteiro será anexado ao final do id de depuração.
6

boolean remove(Widget w)

Descontinuada. Remove um widget filho.
7

void setCellHeight(Widget w, java.lang.String height)

Descontinuada. Define a altura da célula associada a determinado widget, em relação ao painel como um todo.
8

void set Cell Horizontal Alignment(Widget w, Has Horizontal Alignment. Horizontal Alignment Constant align)

Descontinuada. Define o alinhamento horizontal de um determinado widget em sua célula.
9

void set Cell Vertical Alignment (Widget w, HasVertical Alignment. Vertical Alignment Constant align)

Descontinuada. Define o alinhamento vertical de um determinado widget em sua célula.
10

void setCellWidth(Widget w, java.lang.String width)

Descontinuada. Define a largura da célula associada a um determinado widget, em relação ao painel como um todo.
11

void set Horizontal Alignment (Has Horizontal Alignment. Horizontal Alignment Constant align)

Descontinuada. Define o alinhamento horizontal padrão a ser usado para widgets adicionados a este painel.
12

void setVerticalAlignment(HasVerticalAlignment. VerticalAlignmentConstant align)

Descontinuada. Define o alinhamento vertical padrão a ser usado para widgets adicionados a este painel.

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.Panel

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

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

  • java.lang.Object

Exemplo de widget DockPanel

Este exemplo o levará por etapas simples para mostrar o uso de um widget DockPanel 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;
}
.dockpanel td {
   border: 1px solid #BBBBBB;
   padding: 3px;
}

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>DockPanel 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 DockPanel.

package com.tutorialspoint.client;

import com.google.gwt.core.client.EntryPoint;
import com.google.gwt.user.client.ui.DockPanel;
import com.google.gwt.user.client.ui.HTML;
import com.google.gwt.user.client.ui.RootPanel;
import com.google.gwt.user.client.ui.ScrollPanel;
import com.google.gwt.user.client.ui.VerticalPanel;

public class HelloWorld implements EntryPoint {

   public void onModuleLoad() {
      DockPanel dockPanel = new DockPanel();
      dockPanel.setStyleName("dockpanel");
      dockPanel.setSpacing(4);
      dockPanel.setHorizontalAlignment(DockPanel.ALIGN_CENTER);

      // Add text all around
      dockPanel.add(new HTML("This is the first north component."), 
      DockPanel.NORTH);
      dockPanel.add(new HTML("This is the first south component."), 
      DockPanel.SOUTH);
      dockPanel.add(new HTML("This is the east component."), 
      DockPanel.EAST);
      dockPanel.add(new HTML("This is the west component."), 
      DockPanel.WEST);
      dockPanel.add(new HTML("This is the second north component."), 
      DockPanel.NORTH);
      dockPanel.add(new HTML("This is the second south component"), 
      DockPanel.SOUTH);

      // Add scrollable text in the center
      HTML contents = new HTML("This is a ScrollPanel contained"
         +" at the center of a DockPanel. "
         +" By putting some fairly large contents in the middle"
         +" and setting its size explicitly, it becomes a scrollable area"
         +" within the page, but without requiring the use of an IFRAME."
         +" Here's quite a bit more meaningless text that will serve primarily"
         +" to make this thing scroll off the bottom of its visible area."
         +" Otherwise, you might have to make it really, really"
         +" small in order to see the nifty scroll bars!");
      ScrollPanel scroller = new ScrollPanel(contents);
      scroller.setSize("400px", "100px");
      dockPanel.add(scroller, DockPanel.CENTER);


      VerticalPanel vPanel = new VerticalPanel();
      vPanel.add(dockPanel);

      // Add the widgets to the root panel.
      RootPanel.get().add(vPanel);
   }
}

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 -