tecgraf.javautils.gui
Class GBC

java.lang.Object
  java.awt.GridBagConstraints
      tecgraf.javautils.gui.GBC

All Implemented Interfaces:

Serializable, Cloneable

public class GBC
extends GridBagConstraints

Classe "wrapper" para grid-bag-constraints. Exemplo de uso:

add(new JButton(action), new GBC(0, 0).both().right(4));

O código acima adiciona o botão com x = 0, y = 0, com fill = BOTH, e com um objeto 'insets' cujo 'right' tem valor = 4.

Author:

Evan Summers (versão original)

See Also:

gridbaglady.dev.java.net, GBCSample, Serialized Form

Field Summary

Fields inherited from class java.awt.GridBagConstraints

ABOVE_BASELINE, ABOVE_BASELINE_LEADING, ABOVE_BASELINE_TRAILING, anchor, BASELINE, BASELINE_LEADING, BASELINE_TRAILING, BELOW_BASELINE, BELOW_BASELINE_LEADING, BELOW_BASELINE_TRAILING, BOTH, CENTER, EAST, fill, FIRST_LINE_END, FIRST_LINE_START, gridheight, gridwidth, gridx, gridy, HORIZONTAL, insets, ipadx, ipady, LAST_LINE_END, LAST_LINE_START, LINE_END, LINE_START, NONE, NORTH, NORTHEAST, NORTHWEST, PAGE_END, PAGE_START, RELATIVE, REMAINDER, SOUTH, SOUTHEAST, SOUTHWEST, VERTICAL, weightx, weighty, WEST

Constructor Summary

GBC()
Construtor.

GBC(GBC other)
Cria um GBC a partir de outro.

GBC(int gridx, int gridy)
Construtor.

GBC(int gridx, int gridy, Insets insets)
Construtor.

GBC(int gridx, int gridy, int anchor, int fill, Insets insets)
Construtor.

Method Summary

GBC	both() Define fill = BOTH, com pesos em X e em Y sendo '1.0'.
GBC	both(double wx, double wy) Define fill = BOTH.
GBC	bottom(int bottom) Define insets.bottom = bottom.
GBC	center() Define anchor = CENTER.
GBC	east() Define anchor = EAST.
GBC	fillx() Faz com que o elemento aproveite espaço horizontal disponível mas não compita com os demais na distribuição de espaço (weightx == 0.0).
GBC	fillxy() Faz com que o elemento aproveite espaço disponível em ambas as direções mas não compita com os demais na distribuição de espaço.
GBC	filly() Faz com que o elemento aproveite espaço vertical disponível mas não compita com os demais na distribuição de espaço (weighty == 0.0).
GBC	gridheight(int gh) Define quantas células o elemento ocupará na vertical.
GBC	gridwidth(int gw) Define quantas células o elemento ocupará na horizontal.
GBC	gridx(int gx) Define a coordenada X no grid.
GBC	gridy(int gy) Define a coordenada Y no grid.
GBC	height(int height) Define a altura (gridheight).
GBC	horizontal() Define fill = HORIZONTAL, com peso em X sendo '1.0'.
GBC	horizontal(double wx) Define fill = HORIZONTAL.
GBC	insets(Insets _insets) Define insets [margem entre o componente e sua 'célula' no grid].
GBC	insets(int defaultValue) Define insets [margem entre o componente e sua 'célula' no grid].
GBC	insets(int top, int left, int bottom, int right) Define insets [margem entre o componente e sua 'célula' no grid].
GBC	left(int left) Define insets.left = left.
GBC	none() Define fill = NONE.
GBC	north() Define anchor = NORTH.
GBC	northeast() Define anchor = NORTHEAST.
GBC	northwest() Define anchor = NORTHWEST.
GBC	pushx() Associa o peso default (1.0) à direção X, anulando a expansão nesta direção.
GBC	pushx(double wx) Associa um peso à direção X, anulando a expansão nesta direção.
GBC	pushxy() Associa o peso default (1.0) a ambas as direções, definindo fill == NONE,
GBC	pushxy(double wx, double wy) Associa pesos a ambas as direções, definindo fill == NONE.
GBC	pushy() Associa o peso default (1.0) à direção Y, anulando a expansão nesta direção.
GBC	pushy(double wy) Associa um peso à direção Y, anulando a expansão nesta direção.
GBC	right(int right) Define insets.right = right.
GBC	south() Define anchor = SOUTH.
GBC	southeast() Define anchor = SOUTHEAST.
GBC	southwest() Define anchor = SOUTHWEST.
GBC	top(int top) Define insets.top = top.
String	toString() Texto depurativo associado ao objeto GBC com seus atributos internos e parametrizações.
GBC	vertical() Define fill = VERTICAL, com peso em Y sendo '1.0'.
GBC	vertical(double wy) Define fill = VERTICAL
GBC	weights(double wx, double wy) Define os pesos nas direções horizontal e vertical.
GBC	weightx(double wx) Define o peso na direção horizontal.
GBC	weighty(double wy) Define o peso na direção vertical.
GBC	west() Define anchor = WEST.
GBC	width(int width) Define a largura (gridwidth).

Methods inherited from class java.awt.GridBagConstraints

clone

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

GBC

public GBC(int gridx,
           int gridy,
           int anchor,
           int fill,
           Insets insets)

Construtor.

Parameters:

gridx -

gridy -

anchor -

fill -

insets -

GBC

public GBC(int gridx,
           int gridy,
           Insets insets)

Construtor. Recebe as coordenadas (x, y) e os insets; os demais valores permanecem com os defaults:

 anchor = CENTER
 fill = NONE
 

Parameters:

gridx -

gridy -

insets -

GBC

public GBC(int gridx,
           int gridy)

Construtor. Recebe as coordenadas (x, y); os demais valores permanecem com os defaults:

 anchor = CENTER
 fill = NONE
 insets = (0, 0, 0, 0)
 

Parameters:

gridx -

gridy -

GBC

public GBC()

Construtor. Assume todos os valores default, sendo eles:

 gridx = 0
 gridy = 0
 anchor = CENTER
 fill = NONE
 insets = (0, 0, 0, 0)
 

GBC

public GBC(GBC other)

Cria um GBC a partir de outro. Todas as propriedades são copiadas.

Parameters:

other - GBC de referência

Method Detail

none

public GBC none()

Define fill = NONE.

Returns:

o próprio elemento (para permitir concatenação de operações)

both

public GBC both()

Define fill = BOTH, com pesos em X e em Y sendo '1.0'.

Returns:

o próprio elemento (para permitir concatenação de operações)

both

public GBC both(double wx,
                double wy)

Define fill = BOTH.

Parameters:

wx - - peso em X (deve ser maior ou igual a zero)

wy - - peso em Y (deve ser maior ou igual a zero)

Returns:

o próprio elemento (para permitir concatenação de operações)

vertical

public GBC vertical()

Define fill = VERTICAL, com peso em Y sendo '1.0'.

Returns:

o próprio elemento (para permitir concatenação de operações)

vertical

public GBC vertical(double wy)

Define fill = VERTICAL

Parameters:

wy - - peso em Y (deve ser maior ou igual a zero)

Returns:

o próprio elemento (para permitir concatenação de operações)

horizontal

public GBC horizontal()

Define fill = HORIZONTAL, com peso em X sendo '1.0'.

Returns:

o próprio elemento (para permitir concatenação de operações)

horizontal

public GBC horizontal(double wx)

Define fill = HORIZONTAL.

Parameters:

wx - - peso em X (deve ser maior ou igual a zero)

Returns:

o próprio elemento (para permitir concatenação de operações)

center

public GBC center()

Define anchor = CENTER.

Returns:

o próprio elemento (para permitir concatenação de operações)

north

public GBC north()

Define anchor = NORTH.

Returns:

o próprio elemento (para permitir concatenação de operações)

northeast

public GBC northeast()

Define anchor = NORTHEAST.

Returns:

o próprio elemento (para permitir concatenação de operações)

east

public GBC east()

Define anchor = EAST.

Returns:

o próprio elemento (para permitir concatenação de operações)

southeast

public GBC southeast()

Define anchor = SOUTHEAST.

Returns:

o próprio elemento (para permitir concatenação de operações)

south

public GBC south()

Define anchor = SOUTH.

Returns:

o próprio elemento (para permitir concatenação de operações)

southwest

public GBC southwest()

Define anchor = SOUTHWEST.

Returns:

o próprio elemento (para permitir concatenação de operações)

west

public GBC west()

Define anchor = WEST.

Returns:

o próprio elemento (para permitir concatenação de operações)

northwest

public GBC northwest()

Define anchor = NORTHWEST.

Returns:

o próprio elemento (para permitir concatenação de operações)

pushxy

public GBC pushxy()

Associa o peso default (1.0) a ambas as direções, definindo fill == NONE,

Returns:

o próprio elemento (para permitir concatenação de operações)

See Also:

pushxy(double, double), none()

pushx

public GBC pushx()

Associa o peso default (1.0) à direção X, anulando a expansão nesta direção.

Returns:

o próprio elemento (para permitir concatenação de operações)

See Also:

pushx(double)

pushy

public GBC pushy()

Associa o peso default (1.0) à direção Y, anulando a expansão nesta direção.

Returns:

o próprio elemento (para permitir concatenação de operações)

See Also:

pushy()

pushxy

public GBC pushxy(double wx,
                  double wy)

Associa pesos a ambas as direções, definindo fill == NONE.

Parameters:

wx - - peso no eixo X

wy - - peso no eixo Y

Returns:

o próprio elemento (para permitir concatenação de operações)

See Also:

pushxy(), none()

pushx

public GBC pushx(double wx)

Associa um peso à direção X, anulando a expansão nesta direção.

Parameters:

wx - - peso X

Returns:

o próprio elemento (para permitir concatenação de operações)

pushy

public GBC pushy(double wy)

Associa um peso à direção Y, anulando a expansão nesta direção.

Parameters:

wy - - peso Y

Returns:

o próprio elemento (para permitir concatenação de operações)

fillx

public GBC fillx()

Faz com que o elemento aproveite espaço horizontal disponível mas não compita com os demais na distribuição de espaço (weightx == 0.0).

O fill horizontal será adicionado ao fill existente da seguinte forma:

• none --> horizontal
• horizontal --> horizontal
• vertical --> both
• both --> both

Returns:

o próprio elemento (para permitir concatenação de operações)

See Also:

filly(), fillxy()

filly

public GBC filly()

Faz com que o elemento aproveite espaço vertical disponível mas não compita com os demais na distribuição de espaço (weighty == 0.0).

O fill vertical será adicionado ao fill existente da seguinte forma:

• none --> vertical
• horizontal --> both
• vertical --> vertical
• both --> both

Returns:

o próprio elemento (para permitir concatenação de operações)

See Also:

fillx(), fillxy()

fillxy

public GBC fillxy()

Faz com que o elemento aproveite espaço disponível em ambas as direções mas não compita com os demais na distribuição de espaço. Equivale a both(0.0, 0.0).

Returns:

o próprio elemento (para permitir concatenação de operações)

See Also:

fillx(), filly()

insets

public GBC insets(Insets _insets)

Define insets [margem entre o componente e sua 'célula' no grid].

Parameters:

_insets - - elemento do tipo Insets

Returns:

o próprio elemento (para permitir concatenação de operações)

insets

public GBC insets(int top,
                  int left,
                  int bottom,
                  int right)

Define insets [margem entre o componente e sua 'célula' no grid].

Parameters:

top -

left -

bottom -

right -

Returns:

o próprio elemento (para permitir concatenação de operações)

insets

public GBC insets(int defaultValue)

Define insets [margem entre o componente e sua 'célula' no grid]. O valor indicado é usado nos 4 cantos [top, left, bottom e right].

Parameters:

defaultValue - - valor único aplicado em top, left, bottom e right.

Returns:

o próprio elemento (para permitir concatenação de operações)

top

public GBC top(int top)

Define insets.top = top.

Parameters:

top -

Returns:

o próprio elemento (para permitir concatenação de operações)

bottom

public GBC bottom(int bottom)

Define insets.bottom = bottom.

Parameters:

bottom -

Returns:

o próprio elemento (para permitir concatenação de operações)

right

public GBC right(int right)

Define insets.right = right.

Parameters:

right -

Returns:

o próprio elemento (para permitir concatenação de operações)

left

public GBC left(int left)

Define insets.left = left.

Parameters:

left -

Returns:

o próprio elemento (para permitir concatenação de operações)

weightx

public GBC weightx(double wx)

Define o peso na direção horizontal.

Parameters:

wx - - peso

Returns:

o próprio elemento (para permitir concatenação de operações)

weighty

public GBC weighty(double wy)

Define o peso na direção vertical.

Parameters:

wy - - peso

Returns:

o próprio elemento (para permitir concatenação de operações)

weights

public GBC weights(double wx,
                   double wy)

Define os pesos nas direções horizontal e vertical.

Parameters:

wx - - peso na direção horizontal

wy - - peso na direção vertical

Returns:

o próprio elemento (para permitir concatenação de operações)

width

public GBC width(int width)

Define a largura (gridwidth).

Parameters:

width -

Returns:

o próprio elemento (para permitir concatenação de operações)

height

public GBC height(int height)

Define a altura (gridheight).

Parameters:

height -

Returns:

o próprio elemento (para permitir concatenação de operações)

gridx

public GBC gridx(int gx)

Define a coordenada X no grid.

Parameters:

gx - - coordenada X no grid

Returns:

o próprio elemento (para permitir concatenação de operações)

gridy

public GBC gridy(int gy)

Define a coordenada Y no grid.

Parameters:

gy - - coordenada Y no grid

Returns:

o próprio elemento (para permitir concatenação de operações)

gridwidth

public GBC gridwidth(int gw)

Define quantas células o elemento ocupará na horizontal.

Parameters:

gw - - número de células ocupadas pelo componente na horizontal

Returns:

o próprio elemento (para permitir concatenação de operações)

gridheight

public GBC gridheight(int gh)

Define quantas células o elemento ocupará na vertical.

Parameters:

gh - - número de células ocupadas pelo componente na vertical

Returns:

o próprio elemento (para permitir concatenação de operações)

toString

public String toString()

Texto depurativo associado ao objeto GBC com seus atributos internos e parametrizações.

Overrides:

toString in class Object

Returns:

um texto depurativo.