Crea una libreria TimeChooser – Selector de Tiempo

En este post crearemos un componente gráfico para java que nos permitirá seleccionar la hora del día de una manera sencilla y rápida.

Necesitamos

– Java

– IDE Netbeans 7.x o superior

Nivel: Avanzado

Tiempo: 30 minutos

1.- Crea u nuevo proyecto en Netbeans: FILE -> NEW PROJECT –> JAVA -> JAVA CLASS LIBRARY, coloca como nombre de proyecto «TimeChooser«.

Dale la siguiente estructura al proyecto:

En el paquete «time» tenemos una clase llamada TimeChooser, este sera nuestra componente en si, también tenemos otra clase llamada «TimePanel» este es un JPanel.

En el paquete «Resources» tenemos tres imágenes de tipo PNG, estos son dos flechas y una imagen de un reloj:

Puedes usar estas imágenes o sino utiliza el editor gráfico de tu preferencia y crea las tuyas, los nombres son importantes, colócalas tal cual las ves en la imagen de arriba.

2.- Cuando presionamos el botón de nuestro componente aparece un menú PopUp con una pequeña ventana que nos permite elegir la hora del día, esta ventana es un JPanel (TimePanel).

Podemos crear este TimePanel desde código, pero ese no es el objetivo de este tutorial, así que nos ayudaremos del editor gráfico de Netbeans para facilitarnos la tarea. Abre el JPanel que creaste en el paso 1 y en vista diseño trata de darle el siguiente aspecto:

Tomate tu tiempo, no tiene que quedar igual, pero si los nombres de los controles (numerados desde 1 al 12) deben ser los mismos que en la imagen. Si prefieres crear este Jpanel desde código, no hay ningún problema, pero cuidado con los nombres de los objetos.

3.- Una vez que estés satisfecho con tu trabajo, abre el TimePanel en modo código.

Primeramente debemos añadir las referencias a los diferentes paquetes que usaremos en este proyecto.

import java.awt.event.MouseAdapter;
import java.awt.event.MouseEvent;
import java.util.Calendar;
import javax.swing.JPopupMenu;
import javax.swing.JTextField;

A continuación declaramos las variables que usaremos, (04) una instancia a Calendar y (05) un JTextField

01 public class TimePanel extends javax.swing.JPanel {
02 
03     //--------------
04     Calendar cal = Calendar.getInstance();
05     private JTextField texto;

Cuando creamos el JPanel, netbeans automáticamente crea todo el código necesario para la interfaz, incluido su constructor de clase, esto muchas veces es más que suficiente para nuestra trabajo, en este caso no lo es, así que a continuación de este constructor, creamos un nuevo constructor pero con un parámetro de entrada de tipo JTextField que sera el componente padre de este JPanel

    public TimePanel() {
        initComponents();
    }

Nuevo constructor de clase

public TimePanel(JTextField jtextField) {
   initComponents();
   //aqui codigo
}

En este nuevo constructor pasamos el componente padre y ademas iniciamos valores de la hora y minuto del sistema gracias al Calendar.

Como trabajamos con netbeans en modo gráfico, este crea todos los eventos necesarios para cada uno de los controles del JPanel, sin embargo, para hacer maá comprensible este tutorial, declararemos estos eventos en el nuevo constructor de clase.

A continuación el código completo del nuevo constructor:

    /** 
 * Constructor de clase con parametro de entrada
 * @param JTextField componente padre
 */
    public TimePanel(JTextField jtextField) {
        initComponents();

        texto = jtextField;
        //Se coloca el tiempo del sistema
        Hora.setText( (cal.get(Calendar.HOUR)<10)?"0"+cal.get(Calendar.HOUR):String.valueOf(cal.get(Calendar.HOUR)) );
        Minuto.setText( (cal.get(Calendar.MINUTE)<10)?"0"+cal.get(Calendar.MINUTE):String.valueOf(cal.get(Calendar.MINUTE)) );

        if( cal.get( Calendar.AM_PM ) == 0 ){  
            AmPm.setText("AM");
        }else
        {
            AmPm.setText("PM");
        }

        //Eventos de los controles del componente
        btnHora1.addMouseListener(new MouseAdapter() {
            @Override
            public void mouseClicked(MouseEvent evt) {
                ajustarHora("-");                
            }
        });
        btnHora2.addMouseListener(new MouseAdapter() {
            @Override
            public void mouseClicked(MouseEvent evt) {
                ajustarHora("+");                
            }
        });

        btnMinuto1.addMouseListener(new MouseAdapter() {
            @Override
            public void mouseClicked(MouseEvent evt) {
                ajustarMinuto("-");                
            }
        });
        btnMinuto2.addMouseListener(new MouseAdapter() {
            @Override
            public void mouseClicked(MouseEvent evt) {
                ajustarMinuto("+");                
            }
        });
        btnAmPm1.addMouseListener(new MouseAdapter() {
            @Override
            public void mouseClicked(MouseEvent evt) {
                AmPm.setText( (AmPm.getText().equals("AM"))?"PM":"AM" );             
            }
        });
        btnAmPm2.addMouseListener(new MouseAdapter() {
            @Override
            public void mouseClicked(MouseEvent evt) {
                AmPm.setText( (AmPm.getText().equals("AM"))?"PM":"AM" );             
            }
        }); 
        btnCancel.addMouseListener(new MouseAdapter() {
            @Override
            public void mouseClicked(MouseEvent evt) {
                JPopupMenu menu = ((JPopupMenu) getParent());
                menu.setVisible(false);
            }
        }); 
        btnSet.addMouseListener(new MouseAdapter() {
            @Override
            public void mouseClicked(MouseEvent evt) {
                JPopupMenu menu = ((JPopupMenu) getParent());
                texto.setText( Hora.getText() + ":"+Minuto.getText() + " " + AmPm.getText() );
                menu.setVisible(false);
            }
        }); 
    }//end constructor

Para terminar con el TimePanel, declaramos dos métodos privados que nos sirven para ajustar la Hora y el Minuto del componente cada vez que presionemos las flechas

    /** 
 * Metodo privado que ajusta el valor de la hora
 * @param String value cadena que puede tener los valores 
 * "+" para incrementar el valor
 * "-" para decrementar el valor
 */
    private void ajustarHora(String value)
    {
        int h = Integer.valueOf( Hora.getText() );                

        if( value.equals("+"))
        {
            h = (h==12)?1:(h+1);    
        }
        else if( value.equals("-"))
        {
            h = (h==1)?12:(h-1);
        }
        String s = (h<10)?"0"+h:String.valueOf(h);
        Hora.setText(s);
    }

    /** 
 * Metodo privado que ajusta el valor del minuto
 * @param String value cadena que puede tener los valores 
 * "+" para incrementar el valor
 * "-" para decrementar el valor
 */
    private void ajustarMinuto(String value)
    {
        int m = Integer.valueOf( Minuto.getText() );                

        if( value.equals("+"))
        {
            m = (m==59)?0:(m+1);    
        }
        else if( value.equals("-"))
        {
            m = (m==1)?59:(m-1);
        }
        String s = (m<10)?"0"+m:String.valueOf(m);
        Minuto.setText(s);
    }

4.- Para terminar este post, abre la clase TimeChooser, esta clase que se extiende de un JTextField, es nuestra clase principal, nuestro componente swing en si. Es en este JtextField modificado que añadimos el botón en el lado derecho e implementamos el PopPup Menu para abrir y mostrar el TimePanel para seleccionar la Hora y el Minuto del día.

El código completo de la clase es el siguiente:

package org.bolivia.time;
import java.awt.Cursor;
import java.awt.Dimension;
import java.awt.Insets;
import java.awt.event.ComponentEvent;
import java.awt.event.ComponentListener;
import java.awt.event.InputEvent;
import java.awt.event.MouseEvent;
import java.awt.event.MouseListener;
import javax.swing.ImageIcon;
import javax.swing.JButton;
import javax.swing.JPopupMenu;
import javax.swing.JTextField;
/**
 * @web https://www.jc-mouse.net/
 * @author Mouse
 */
public class TimeChooser extends JTextField implements ComponentListener {

    //Dimensiones del componente
    private Dimension dimension = new Dimension(120,24);
    //Boton para abrir el panel selector de tiempo
    private final JButton button = new JButton();
    //menu emergente
    private JPopupMenu popup = new JPopupMenu();    
    private TimePanel timePanel;    

    /** Constructor de clase*/
    public TimeChooser()
    {
        //Propiedades del jtextfield
        setSize(dimension);
        setPreferredSize(dimension);
        setText("");

        //propiedades del boton
        button.setText("");                                
        button.setContentAreaFilled(true);
        button.setMargin(new Insets(1, 1, 1, 1));
        button.setVisible(true);
        button.setFocusPainted(false);
        button.setCursor(new Cursor(Cursor.HAND_CURSOR));
        button.setIcon(new ImageIcon(getClass().getResource("/org/bolivia/resources/clock.png")));
        updateButton();
        add( button );//se añade el boton al jtextfield

        //eventos del boton
        button.addMouseListener( new MouseListener(){

            //cuando se realice un clic sobre el boton, aparecera el menu emergente
            @Override
            public void mouseClicked(MouseEvent e) {   
                if((e.getModifiers() & InputEvent.BUTTON1_MASK) == InputEvent.BUTTON1_MASK){
                    popup.show( e.getComponent() , 0 , button.getParent().getSize().height );                    
                }                
            }

            @Override
            public void mousePressed(MouseEvent e) {/*...*/}

            @Override
            public void mouseReleased(MouseEvent e) {/*...*/}

            @Override
            public void mouseEntered(MouseEvent e) {/*...*/}

            @Override
            public void mouseExited(MouseEvent e) {/*...*/}

        });

        setVisible(true);
        addComponentListener(this);    

        timePanel = new TimePanel(this);
        popup.add(timePanel);
    }

    /** Ajusta la dimension y posicion del boton X*/
    private void updateButton()
    {
        //la altura del boton sera la misma que la del jtextfield 
        button.setSize( new Dimension(24, this.getSize().height));
        button.setPreferredSize( new Dimension(24, this.getSize().height) );        
        //posicion - extremo derecho
        button.setLocation(getWidth()-button.getWidth(), 0);        
    }

    //Metodos abstractos de ComponentListener
    @Override
    public void componentResized(ComponentEvent e) {
        //cuando el jtextfield cambie de tamaño, el boton tambien lo hara respecto a la altura
        //el ancho del boton es fijo
        updateButton(); 
    }

    @Override
    public void componentMoved(ComponentEvent e) {/*...*/}

    @Override
    public void componentShown(ComponentEvent e) {/*...*/}

    @Override
    public void componentHidden(ComponentEvent e) {/*...*/}

}

Compila el proyecto para crear el JAR y estará listo para usar en otros proyectos

Proyecto Netbeans

Enjoy!!!

Crea una libreria TimeChooser – Selector de Tiempo

Tags

Últimas entradas

Que es y como se usa la App de la ANH Abastecimiento

Fin de una era. RIP Skype 2003-2025

Ggwave: Conoce el idioma que usan las IAs para comunicarse

Como personalizar tus ToolTipText

FOCA: Herramienta para recolección y análisis de Metadatos

Artículos similares

Crear archivos JNLP con Netbeans

Matriz de Adyacencia: Representación de grafos en Java

Introducción a Spark Framework

Creación de mapas con shapes – Parte 3

MAUS :- Simulador y Editor de exámenes para dispositivos móviles

Pruebas instrumentadas con Espresso

JC Mouse | Bolivia