Baixe e descompacte o projeto gbcustomizer-basic-tutorial.zip em qualquer lugar no computador. 1.

Na aba Projetos do NetBeans DE 7.0, selecione Arquivo > Abrir projeto (alternativamente,
pressione Ctrl-Shift-O), navegue para o projeto gbcustomizer-basic-tutorial que voc
extraiu na etapa anterior e clique em Abrir projeto. A pasta do projeto pode estar contida em uma pasta
tambm chamada gbcustomizer-basic-tutorial.
2.
Expanda Pacotes de cdigo-fonte > Tutorial e clique duas vezes em
ContactsAdvancedInitial.java.
O formulrio de exemplo aberto na vista Construtor de projeto de GU.
3.
Viso geral do GridBag Customizer
O GridBag Layout um dos gerenciadores de layout mais flexvel e complexo que a plataforma Java fornece. O
Customizer coloca os componentes em uma grade de linhas e colunas, permitindo que componentes
especificados se expandam para mltiplas linhas ou colunas. Nem todas as linhas precisam necessariamente
ter a mesma altura. De forma similar, nem todas as colunas precisam necessariamente ter a mesma largura.
Essencialmente, o GridBagLayout coloca os componentes em retngulos (clulas) em uma grade e, a seguir,
usa os tamanhos predefinidos dos componentes para determinar o tamanho das clulas.
Para exibir o GridBag Customizer, siga as etapas abaixo:
Na vista Desenho, selecione o formulrio JFrame. 1.
Clique com o boto direito do mouse no formulrio e escolha Personalizar layout a partir do
menu de contexto.
A caixa de dilogo Personalizar layout aberta, como mostrado abaixo.
2.
Projetando um Iormulario Java basico usando o GridBag Customizer -... http://netbeans.org/kb/docs/java/gbcustomizer-basicptBR.html?prin...
2 de 8 09-10-2012 20:20
Arraste o rtulo Street:, o campo de texto adjacente e o boto Procurar adjacente para a
primeira das trs clulas da terceira linha.
2.
Arraste o rtulo City:, o campo de texto adjacente e o boto Procurar adjacente para a
primeira das trs clulas da quarta linha.
3.
Arraste o rtulo State: e a caixa de combinao adjacente para a primeira das duas clulas da
quinta linha.
4.
Os componentes esto agora colocados de acordo com o layout alvo.
Observao: Quando um componente for movido para as clulas alvo, ele ser realado em verde.
Redimensionando
Um componente pode ser redimensionado ao arrastar o pequeno quadrado de manipulador de
redimensionamento que aparece em trono de seu permetro quando for selecionado.
Para redimensionar os campos de texto First Name: e Surname: e fazer com que ocupem duas
clulas adjacentes, complete as etapas abaixo:
Pressione Ctrl+Clique nos dois componentes JTextField para selecion-los. 1.
Com ambos os JTextFields selecionados, posicione o cursor sobre a borda direita da clulas, clique
e arraste at que a linha guia laranja realada abrace as clulas adjacentes na coluna 3 na direita.
2.
Solte o cursor para redimensionar os componentes. 3.
Os campos de texto First Name: e Surname: so redimensionados para se estender entre as
duas clulas, como mostrado na ilustrao a seguir. As clulas ocupadas so realadas.
Especificando a restrio de preenchimento do layout
Apesar dos campos de texto First Name: e Surname: ocuparem duas clulas, eles tm o tamanho
preferencial e so colocados no meio da rea de exibio. Antes de continuar, precisamos preencher toda a
rea de clulas usando a restrio de layout Preencher.
Para tornar os campos de texto largos o suficiente para preencher suas reas horizontalmente sem alterar
suas alturas, na caixa de combinao Preencher na rea Folha de propriedades, selecione
Horizontal.
Projetando um Iormulario Java basico usando o GridBag Customizer -... http://netbeans.org/kb/docs/java/gbcustomizer-basicptBR.html?prin...
4 de 8 09-10-2012 20:20
Visualizando
Agora que voc completou com xito o layout do formulrio ContactsBasicInitial, pode testar sua
interface para ver os resultados. possvel visualizar o formulrio medida que trabalha clicando no boto
Testar o layout ( ) na barra de ferramentas do Customizer. O formulrio ser aberto em sua prpria janela,
permitindo que voc o teste antes da construo e execuo.
A visualizao til para testar o comportamento dinmico do layout, ou seja, como o layout se comporta
quando o container desenhado redimensionado.
Especificando as restries do peso X e do peso Y
A especificao de pesos tem um impacto significativo na aparncia dos componentes do GridBagLayout.
Os pesos so usados para determinar como distribuir o espao entre colunas (peso X) e entre linhas (peso
Y). sso importante para especificar o comportamento do redimensionamento.
Normalmente os pesos so especificados como 0.0 e 1.0 com os extremos. Os nmeros entre eles so
usados como necessrio. Nmeros maiores indicam que a linha ou coluna do componente deveria obter
mais espao.
Se voc tentar redimensionar na horizontal o container visualizado, poder ver que os componentes do
layout permanecem com o mesmo tamanho e permanecem acumulados no meio do container. At os
campos First Name: e Surname:, que tm a restrio Preencher definida como Horizontal, no
crescem, porque a restrio Preencher se refere rea interna da clula e no ao tamanho dela. Em outras
palavras, um componente com o atributo Preencher definido para um valor diferente de none alega que
"pode" crescer, mas no alega que "deseja" crescer.
As restries de layout Peso X e Peso Y determinam se um componente "deseja" crescer nas direes
horizontal e vertical.
Quando dois componentes em uma linha (ou coluna) tm uma restrio de valor no zero de Peso X (ou
Peso Y), os valores determinam como o componente individual cresce. Por exemplo, se os valores forem
0.6 e 0.4, ento o primeiro componente obtm 60% do espao disponvel e o segundo componente obtm
40%.
Para fazer com que o container desenhado seja corretamente redimensionado, faa o seguinte:
Selecione o campo de texto direita do rtulo First Name: na rea de grade do GridBag
Customizer.
1.
Digite 1.0 no campo de valor de restrio de layout, Peso X, e pressione Enter. 2.
Projetando um Iormulario Java basico usando o GridBag Customizer -... http://netbeans.org/kb/docs/java/gbcustomizer-basicptBR.html?prin...
5 de 8 09-10-2012 20:20
Selecione o 3.
campo de texto direita do rtulo Surname: na rea de grade do GridBag Customizer.
Digite 1.0 no campo de valor de restrio de layout, Peso X, e pressione Enter. 4.
Selecione o campo de texto direita do rtulo Street na rea de grade do GridBag Customizer. 5.
Selecione Horizontal na caixa de combinao Preencher e pressione Enter. 6.
Digite 1.0 no campo de valor de restrio de layout, Peso X, e pressione Enter. 7.
Selecione o campo de texto direita do rtulo Street na rea de grade do GridBag Customizer. 8.
Selecione Horizontal na caixa de combinao Preencher e pressione Enter. 9.
Digite 1.0 no campo de valor de restrio de layout, Peso X, e pressione Enter. 10.
Para verificar se o continer desenhado corretamente redimensionado na direo horizontal, clique no
boto Testar layout ( ) na barra de ferramentas do Customizer e arraste as bordas do formulrio
ContactsBasicInitial.
Ancorando
A ancoragem usada quando o componente for menor do que sua rea de exibio para determinar onde
(dentro da rea) colocar o componente.
Durante o redimensionamento horizontal do formulrio ContactsBasicInitial na seo anterior,
voc provavelmente observou que a caixa de combinao State se move para longe do rtulo State.
Como o tamanho preferido da caixa combo menor do que o tamanho da clula correspondentes, o
GridBagLayout coloca o componente no centro da clula por padro.
Para mudar este comportamento, especifique as restries do layout ncora como segue:
Selecione a caixa de combinao direita do rtulo State e clique no boto ( ) direita da caixa
de combinao ncora.
1.
Escolha Incio da linha na lista suspensa. 2.
A caixa de combinao State ancorada no lado esquerdo do formulrio quando a anterior agora
redimensionada na horizontal.
Para fazer com as legendas se alinhem na esquerda ao invs de no centro, como esto no momento,
complete as etapas abaixo:
Selecione os rtulos First name:, Surname:, Street, City e State. 1.
Observao: Voc pode selecionar vrios componentes ao pressionar o boto esquerdo do mouse
no primeiro componente, mant-lo pressionado e arrast-lo para o ltimo componente, como se
estivesse desenhando um retngulo que incorpora todos os rtulos. Aps voc soltar o boto do
Projetando um Iormulario Java basico usando o GridBag Customizer -... http://netbeans.org/kb/docs/java/gbcustomizer-basicptBR.html?prin...
6 de 8 09-10-2012 20:20
mouse, todos os cinco componentes so realados com bordas laranja e um plano de fundo verde,
como mostrado abaixo.
Altere a restrio do layout ncora dos rtulos para Incio da linha.
As legendas so ancoradas na esquerda.
2.
Espaamento
Por padro, cada componente no tem preenchimento externo. A restrio Suplemento especifica o
preenchimento externo do componente - a quantidade mnima de espao entre o componente e as bordas
de sua rea de exibio.
No layout atual, os componentes so colocados pertos uns dos outros. Para separ-los, faa o seguinte:
Pressione Ctrl+Clique para selecionar todos os componentes. 1.
Pressione o boto na direita do campo de texto Restrio de insero. 2.
Na caixa de dilogo exibida, altere os valores de Superior: e Esquerda: para 5 e clique em
OK.
Seu formulrio dever ter a aparncia do formulrio do arquivo ContactsBasicFinal.java
caso voc o abra.
3.
Resumo
Neste curto tutorial voc desenhou um formulrio simples. Ao editar o layout, voc aprendeu como usar os
recursos bsicos do GridBag Customizer.
Voc agora pode ir para a segunda parte de um tutorial em duas partes, onde modificar o formulrio
ContactsAdvancedInitial para se familiarizar com os recursos avanados do GridBag Customizer.
Siga para Projetando um formulrio Java avanado usando o GridBag Customizer
incio
Projetando um Iormulario Java basico usando o GridBag Customizer -... http://netbeans.org/kb/docs/java/gbcustomizer-basicptBR.html?prin...
7 de 8 09-10-2012 20:20
Envie-nos seus comentrios
Consulte tambm
Voc agora completou o tutorial Projetando um formulrio Java avanado usando o GridBag Customizer. Para
obter informaes sobre como adicionar funcionalidade s GUs que voc criar, consulte:
ntroduo construo GU
Manipulando imagens em um aplicativo de GU
Perguntas frequentes do Construtor de GU
Trilha de aprendizado dos aplicativos Java GU
incio
Projetando um Iormulario Java basico usando o GridBag Customizer -... http://netbeans.org/kb/docs/java/gbcustomizer-basicptBR.html?prin...
8 de 8 09-10-2012 20:20