Visual – Controles – Layouts, JFrame, Container, JLabel, JTextField, JButton e ActionListner – Java

Publicado: 8 de março de 2014 em Java

Por default o Eclipse não possui uma perspectiva para Design-Time para componentes AWT e SWING do Java, então escrever códigos de layout à mão pode ser um desafio. Se você não estiver interessado em aprender todos os detalhes de gerenciamento de layout, você pode preferir usar uma ferramenta de Design Time para definir o seu GUI. Uma dessas ferramentas é a da IDE do NetBeans.

Desenvolvedores puristas preferem escrever os layouts na mão, estes deixam o código mais limpo e mais leve e as vezes até mais rápido  do que IDEs de Design Time, que criam um arquivo extra para gerenciar os componentes e suas posições na tela.

Java AWT e Swing possuem muitas classes especificas para o design da GUI chamadas de Layout Manager:

  • BorderLayout
  • BoxLayout
  • CardLayout
  • FlowLayout
  • GridBagLayout
  • GridLayout
  • GroupLayout
  • SpringLayout

Cada uma das classes acima possui suas caracteristas especificas, neste post usaremos uma das mais flexiveis e que ainda possui uma classe de utilidades para adicionar mais poder a suas caracteristicas originais.

Mais informações sobre as classes de layout: http://docs.oracle.com/javase/tutorial/uiswing/layout/visual.html

SpringLayout

SpringLayout é um gerenciador de layout muito flexível que pode emular muitas das características de outros gerenciadores de layout. SpringLayout é, no entanto, de muito baixo nível e, como tal, você realmente só deve usá-lo com um construtor de GUI, ao invés de tentar codificar um gerenciador de layout na mão.

SpringLayout faz o seu trabalho através da definição de relações direcionais, ou restrições, entre as bordas de componentes. Por exemplo, você pode definir a borda esquerda de um componente é uma distância fixa (5 pixels, por exemplo) a partir da margem direita do outro componente.

Spring Utilities

Faz com que os componentes sejam dispostos com o mesmo tamanho lado a lado usando coluna e linha ou também que sejam dispostos em tamanhos diferentes utilizando colunas e linhas.

Action Listner

Toda vez que o usuário digita um caractere ou aperta um botão do mouse, ocorre um evento. Qualquer objeto pode ser notificado do evento. Tudo que o objeto tem que fazer é implementar a interface apropriada e ser registrado como um ouvinte de evento sobre a origem do evento apropriado.

JFrame

É um recipiente de nível superior JFC / Swing, um JFrame contém uma JRootPane como seu único filho. O painel de conteúdo fornecido pelo painel de raiz deve, como regra, conter todos os componentes não-menu apresentados pelo JFrame.

JLabel

Um objeto JLabel pode exibir texto, uma imagem, ou ambos, definir o alinhamento vertical e horizontal e etc.

JTextFielfd

É um componente leve que permite a edição de uma única linha de texto.

JButton

É uma implementação de um botão. Os botões podem ser configurados, e até certo ponto controlados por Ações. Usando uma ação com um botão tem muitos benefícios além de configurar diretamente um botão

Exemplo:

Neste exemplo desenvolvemos um programa visual para concatenar duas Strings, usamos os controles básicos para criar uma janela visual com os componentes de entrada e botões, também utilizamos layouts e a classe Spring Utilities para o design da tela.

Classe #1 – Java

import java.awt.Container;
import java.awt.event.ActionEvent;
import java.awt.event.ActionListener;
import javax.swing.JButton;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.JTextField;
import javax.swing.SpringLayout;

 class GUI implements ActionListener
{
	 // Declara Componentes
	 static JLabel label = new JLabel("Concatena Strings");
	 static JTextField jtexto1 = new JTextField("Digite um palavra");
	 static JTextField jtexto2 = new JTextField("Digite um palavra");
	 static JButton botao = new JButton("Somar");
	 static JLabel resultado = new JLabel("Resultado");

	public void inicalizaComponentes()
	{
        // Seta Valores para componentes e Cria Evento
		// uma void não estatica é necessario para o action listner
		botao.setToolTipText("Clique aqui para somar os valores acima.");
        botao.addActionListener(this);
	}

	 static void addPainel (Container painel)

	 {
		// Cria um layout
		SpringLayout layout  = new SpringLayout();

        // Adiciona layout no container
		painel.setLayout(layout);

        // Adiciona componentes no container
		painel.add(label);
        painel.add(jtexto1);
        painel.add(jtexto2);
        painel.add(botao, painel);
        painel.add(resultado);

        // Utiliza Oracle Spring Utilities
        SpringUtilities.makeCompactGrid(painel, 5, 1, 5, 5, 5, 5);

	 }

	public static void main(String[] args) {

		// Especifica Thread do Swing
		javax.swing.SwingUtilities.invokeLater(new Runnable() {
            public void run() {

            	// Cria um frame
            	JFrame formulario = new JFrame("Desenvolvimento Aberto");

            	// Adiciona o frame no container com os objetos
            	addPainel(formulario.getContentPane());

            	//inicializa os componentes
            	GUI comp = new GUI();
            	comp.inicalizaComponentes();

            	// Seta propriedades do formulario
            	formulario.setSize(300, 200);
                formulario.setVisible(true);

            }
        });

	}

	// Evento do botão
	public void actionPerformed(ActionEvent e)
	{
		String r =  jtexto1.getText() +  jtexto2.getText();
		resultado.setText(r);
	}

}

Classe #2 – SpringUtilities

/*
 * Copyright (c) 1995, 2008, Oracle and/or its affiliates. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 *   - Redistributions of source code must retain the above copyright
 *     notice, this list of conditions and the following disclaimer.
 *
 *   - Redistributions in binary form must reproduce the above copyright
 *     notice, this list of conditions and the following disclaimer in the
 *     documentation and/or other materials provided with the distribution.
 *
 *   - Neither the name of Oracle or the names of its
 *     contributors may be used to endorse or promote products derived
 *     from this software without specific prior written permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS
 * IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR
 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
 * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
 * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 */

import javax.swing.*;
import javax.swing.SpringLayout;
import java.awt.*;

/*
 * A 1.4 file that provides utility methods for
 * creating form- or grid-style layouts with SpringLayout.
 * These utilities are used by several programs, such as
 * SpringBox and SpringCompactGrid.
 */
public class SpringUtilities {
    /*
     * A debugging utility that prints to stdout the component's
     * minimum, preferred, and maximum sizes.
     */
    public static void printSizes(Component c) {
        System.out.println("minimumSize = " + c.getMinimumSize());
        System.out.println("preferredSize = " + c.getPreferredSize());
        System.out.println("maximumSize = " + c.getMaximumSize());
    }

    /*
     * Aligns the first <code>rows</code> * <code>cols</code>
     * components of <code>parent</code> in
     * a grid. Each component is as big as the maximum
     * preferred width and height of the components.
     * The parent is made just big enough to fit them all.
     *
     * @param rows number of rows
     * @param cols number of columns
     * @param initialX x location to start the grid at
     * @param initialY y location to start the grid at
     * @param xPad x padding between cells
     * @param yPad y padding between cells
     */
    public static void makeGrid(Container parent,
                                int rows, int cols,
                                int initialX, int initialY,
                                int xPad, int yPad) {
        SpringLayout layout;
        try {
            layout = (SpringLayout)parent.getLayout();
        } catch (ClassCastException exc) {
            System.err.println("The first argument to makeGrid must use SpringLayout.");
            return;
        }

        Spring xPadSpring = Spring.constant(xPad);
        Spring yPadSpring = Spring.constant(yPad);
        Spring initialXSpring = Spring.constant(initialX);
        Spring initialYSpring = Spring.constant(initialY);
        int max = rows * cols;

        //Calculate Springs that are the max of the width/height so that all
        //cells have the same size.
        Spring maxWidthSpring = layout.getConstraints(parent.getComponent(0)).
                                    getWidth();
        Spring maxHeightSpring = layout.getConstraints(parent.getComponent(0)).
                                    getHeight();
        for (int i = 1; i < max; i++) {
            SpringLayout.Constraints cons = layout.getConstraints(
                                            parent.getComponent(i));

            maxWidthSpring = Spring.max(maxWidthSpring, cons.getWidth());
            maxHeightSpring = Spring.max(maxHeightSpring, cons.getHeight());
        }

        //Apply the new width/height Spring. This forces all the
        //components to have the same size.
        for (int i = 0; i < max; i++) {
            SpringLayout.Constraints cons = layout.getConstraints(
                                            parent.getComponent(i));

            cons.setWidth(maxWidthSpring);
            cons.setHeight(maxHeightSpring);
        }

        //Then adjust the x/y constraints of all the cells so that they
        //are aligned in a grid.
        SpringLayout.Constraints lastCons = null;
        SpringLayout.Constraints lastRowCons = null;
        for (int i = 0; i < max; i++) {
            SpringLayout.Constraints cons = layout.getConstraints(
                                                 parent.getComponent(i));
            if (i % cols == 0) { //start of new row
                lastRowCons = lastCons;
                cons.setX(initialXSpring);
            } else { //x position depends on previous component
                cons.setX(Spring.sum(lastCons.getConstraint(SpringLayout.EAST),
                                     xPadSpring));
            }

            if (i / cols == 0) { //first row
                cons.setY(initialYSpring);
            } else { //y position depends on previous row
                cons.setY(Spring.sum(lastRowCons.getConstraint(SpringLayout.SOUTH),
                                     yPadSpring));
            }
            lastCons = cons;
        }

        //Set the parent's size.
        SpringLayout.Constraints pCons = layout.getConstraints(parent);
        pCons.setConstraint(SpringLayout.SOUTH,
                            Spring.sum(
                                Spring.constant(yPad),
                                lastCons.getConstraint(SpringLayout.SOUTH)));
        pCons.setConstraint(SpringLayout.EAST,
                            Spring.sum(
                                Spring.constant(xPad),
                                lastCons.getConstraint(SpringLayout.EAST)));
    }

    /* Used by makeCompactGrid. */
    private static SpringLayout.Constraints getConstraintsForCell(
                                                int row, int col,
                                                Container parent,
                                                int cols) {
        SpringLayout layout = (SpringLayout) parent.getLayout();
        Component c = parent.getComponent(row * cols + col);
        return layout.getConstraints(c);
    }

    /*
     * Aligns the first <code>rows</code> * <code>cols</code>
     * components of <code>parent</code> in
     * a grid. Each component in a column is as wide as the maximum
     * preferred width of the components in that column;
     * height is similarly determined for each row.
     * The parent is made just big enough to fit them all.
     *
     * @param rows number of rows
     * @param cols number of columns
     * @param initialX x location to start the grid at
     * @param initialY y location to start the grid at
     * @param xPad x padding between cells
     * @param yPad y padding between cells
     */
    public static void makeCompactGrid(Container parent,
                                       int rows, int cols,
                                       int initialX, int initialY,
                                       int xPad, int yPad) {
        SpringLayout layout;
        try {
            layout = (SpringLayout)parent.getLayout();
        } catch (ClassCastException exc) {
            System.err.println("The first argument to makeCompactGrid must use SpringLayout.");
            return;
        }

        //Align all cells in each column and make them the same width.
        Spring x = Spring.constant(initialX);
        for (int c = 0; c < cols; c++) {
            Spring width = Spring.constant(0);
            for (int r = 0; r < rows; r++) {
                width = Spring.max(width,
                                   getConstraintsForCell(r, c, parent, cols).
                                       getWidth());
            }
            for (int r = 0; r < rows; r++) {
                SpringLayout.Constraints constraints =
                        getConstraintsForCell(r, c, parent, cols);
                constraints.setX(x);
                constraints.setWidth(width);
            }
            x = Spring.sum(x, Spring.sum(width, Spring.constant(xPad)));
        }

        //Align all cells in each row and make them the same height.
        Spring y = Spring.constant(initialY);
        for (int r = 0; r < rows; r++) {
            Spring height = Spring.constant(0);
            for (int c = 0; c < cols; c++) {
                height = Spring.max(height,
                                    getConstraintsForCell(r, c, parent, cols).
                                        getHeight());
            }
            for (int c = 0; c < cols; c++) {
                SpringLayout.Constraints constraints =
                        getConstraintsForCell(r, c, parent, cols);
                constraints.setY(y);
                constraints.setHeight(height);
            }
            y = Spring.sum(y, Spring.sum(height, Spring.constant(yPad)));
        }

        //Set the parent's size.
        SpringLayout.Constraints pCons = layout.getConstraints(parent);
        pCons.setConstraint(SpringLayout.SOUTH, y);
        pCons.setConstraint(SpringLayout.EAST, x);
    }
}
Anúncios

Deixe um comentário

Preencha os seus dados abaixo ou clique em um ícone para log in:

Logotipo do WordPress.com

Você está comentando utilizando sua conta WordPress.com. Sair /  Alterar )

Foto do Google+

Você está comentando utilizando sua conta Google+. Sair /  Alterar )

Imagem do Twitter

Você está comentando utilizando sua conta Twitter. Sair /  Alterar )

Foto do Facebook

Você está comentando utilizando sua conta Facebook. Sair /  Alterar )

Conectando a %s