SwingX Tutorial - Etiqueta Busy (JXBusyLabel)

O que é um rótulo ocupado?

O ícone é utilizado para descrever uma tarefa que está em execução, que é de comprimento indeterminado. A tarefa pode demorar 10 minutos ou 10 segundos, não há nenhuma maneira de saber, eo usuário não pode realmente ter uma expectativa de quanto tempo esperar.

SwingX fornece uma implementação dessa funcionalidade na forma de JXBusyLabel e BusyPainter . Você pode usar o rótulo ocupado apenas como você faria com um normal, JXLabel , exceto que você pode adicionar um pintor a ele, que controla a pintura e animação do próprio rótulo ocupado.

Se você estiver usando versão v0.9.1 marco, então você ainda terá JXBusyLabel, mas um monte de funcionalidade descrita neste tutorial não estará disponível para você. Por que você deve baixar a última versão da API SwingX. Não se preocupe, uma compilação que trabalha está incluída nos arquivos do projeto que você pode baixar no final deste tutorial .

Exemplo de código fonte

No exemplo a seguir, vou criar dois componentes JXBusyLabel, que eu vou colocar em um JXPanel. Um irá trabalhar com versões mais antigas SwingX (a etiqueta simples) eo rótulo complexo vai exigir mais recente lançamento SwingX (após 0.9.1). Aqui está o que parece:

Este exemplo cria dois rótulos ocupado, uma simples e outra complexa. O rótulo simples ocupado irá trabalhar com versões mais antigas do SwingX (0.9.1), mas a um complexo requer compilações posteriores. Ambos os rótulos ocupadas começar desativado, e como você pode ver na imagem, que mistura no fundo quando eles são desativados. Quando você clica no botão "Start / Stop", que permite que os rótulos, e chama setBusy (true) sobre eles. Isto faz com que comece a girar e ficar animado. Quando você clica no botão novamente, o setBusy (false) método é chamado, parando a animação;eles ainda estão ativadas, mas não animado.

Etiqueta simples ocupado

Aqui está o código para criar um JXBusyLabel simples:

view plaincopy to clipboardprint? público JXBusyLabel createSimpleBusyLabel () {     Etiqueta JXBusyLabel = new JXBusyLabel ();     label.setToolTipText ( "label simples ocupado" );     retornar etiqueta;   }

O código é muito simples. É como criar um JLabel simples. Note que não é possível definir o tamanho deste JXBusyLabel usando esse construtor. Na verdade, esta é uma das razões pelas quais você deve usar a última versão do SwingX, que adiciona um novo construtor e muito mais funcionalidades para este componente. Com esse código resulta em um rótulo ocupado que se parece com isso:

Rótulo complexo ocupado

Aqui está o código para criar um JXBusyLabel mais complexa:

view plaincopy to clipboardprint? public JXBusyLabel createComplexBusyLabel() {     // this will not work in the 0.9.1 release of SwingX (need later builds)     JXBusyLabel label = new JXBusyLabel(new Dimension(38, 38));     BusyPainter painter = new BusyPainter(         new Rectangle2D.Float(0, 0, 8.0f, 8.0f),         new Rectangle2D.Float(5.5f, 5.5f, 27.0f, 27.0f));     painter.setTrailLength(4);     painter.setPoints(8);     painter.setFrame(-1);     painter.setBaseColor(Colors.LightBlue.color());     painter.setHighlightColor(Colors.Orange.color());     label.setPreferredSize(new Dimension(38, 38));     label.setIcon(new EmptyIcon(38, 38));     label.setBusyPainter(painter);     label.setToolTipText("complex busy label");     return label;   }

Há um par de coisas a notar sobre este código:

1. Quando você cria o JXBusyLabel, você pode passar um objeto Dimension com ele, para especificar o tamanho da etiqueta ocupado.
2. A fim de mudar o visual padrão do rótulo ocupado, você tem que aproveitar a classe BusyPainter, que na verdade controla o que o rótulo ocupado parece (fundo de destaque e cores, formato das entranhas de etiquetas, etc), e como ele anima (animação velocidade, etc). A boa notícia é que você não tem que codificar isso com a mão! Jan Haderka foi gentil o suficiente para fornecer um programa que permite que você configure tudo isso visualmente, e depois ele simplesmente cospe o código que você precisa inserir no seu programa! Eu recomendo que você jogar com o programa de Janeiro e tentar coisas diferentes; você vai se surpreender os diferentes tipos de rótulos ocupados você pode vir até com ... ele é limitado pela sua imaginação.
3. Você pode alterar as cores utilizadas pelo pintor ocupado usando setBaseColor () e setHighlightColor (). A cor base é a "base" cor da etiqueta ocupado, ea cor de destaque é o que é pintado sobre ele periodicamente. Então, se você usar uma cor de base de luz azul, e cor de destaque de laranja, você começa algo como isto:

Resto do código

Além dos rótulos ocupados, não há outra JXLabel usado neste exemplo que usa um pintor e um ícone:

Aqui está o código que torna isso possível:

view plaincopy to clipboardprint? public JXLabel createLabel() {     JXLabel label = new JXLabel();     label.setBorder(BorderFactory.createEmptyBorder(5, 5, 5, 5));     label.setFont(new Font("Segoe UI", Font.BOLD, 14));     label.setText("<html>BusyLabel Example...<br>click start/stop button</html>");     label.setIcon(Images.NetworkDisconnected.getIcon(40, 40));     label.setHorizontalAlignment(JXLabel.LEFT);     label.setBackgroundPainter(getPainter());     return label;   }   /** this painter draws a gradient fill */   public Painter getPainter() {     int width = 100;     int height = 100;     Color color1 = Colors.White.color(0.5f);     Color color2 = Colors.Gray.color(0.5f);     LinearGradientPaint gradientPaint =         new LinearGradientPaint(0.0f, 0.0f, width, height,                                 new float[]{0.0f, 1.0f},                                 new Color[]{color1, color2});     MattePainter mattePainter = new MattePainter(gradientPaint);     return mattePainter;   }

Há algumas coisas a notar sobre este código:

1. Eu costumava HTML para definir o texto deste rótulo, para que eu pudesse inserir uma quebra de linha.
2. O pintor que serve para tornar o fundo desta etiqueta usa um simples gradiente linear 2 stop.
3. Eu usei um EmptyBorder em torno da etiqueta para dar mais espaço ao redor do texto e imagem.

Lista completa fonte

view plaincopy to clipboardprint? import org.jdesktop.swingx.*;   import org.jdesktop.swingx.icon.*;   import org.jdesktop.swingx.painter.*;   import javax.swing.*;   import java.awt.*;   import java.awt.event.*;   import java.awt.geom.*;   /**  * BusyLabelExample  *  * @author Nazmul Idris  * @version 1.0  * @since Feb 2, 2008, 2:43:30 PM  */   public class BusyLabelExample {   /** simple main driver for this class */   public static void main(String[] args) {     SwingUtilities.invokeLater(new Runnable() {       public void run() {         new BusyLabelExample();       }     });   }   /** creates a JFrame and calls {@link #doInit} to create a JXPanel and adds the panel to this frame. */   public BusyLabelExample() {     JFrame frame = new JFrame("JXBusyLabel Example");     // add the panel to this frame     frame.add(doInit());     // when you close the frame, the app exits     frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);     // center the frame and show it     frame.setLocationRelativeTo(null);     frame.pack();     frame.setVisible(true);   }   /** creates a JXLabel and attaches a painter to it. */   private Component doInit() {     JXPanel panel = new JXPanel();     panel.setLayout(new BorderLayout());     // create a busylabel     final JXBusyLabel busylabel1 = createSimpleBusyLabel();     final JXBusyLabel busylabel2 = createComplexBusyLabel();     busylabel1.setEnabled(false);     busylabel2.setEnabled(false);     // create a label     final JXLabel label = createLabel();     // create a button     JButton button = new JButton("start/stop");     button.addActionListener(new ActionListener() {       public void actionPerformed(ActionEvent e) {         if (!busylabel1.isEnabled()){           busylabel1.setEnabled(true);           busylabel2.setEnabled(true);         }         if (busylabel1.isBusy()) {           label.setText("BusyLabel stopped");           busylabel1.setBusy(false);           busylabel2.setBusy(false);         }         else {           label.setText("BusyLabel started");           busylabel1.setBusy(true);           busylabel2.setBusy(true);         }       }     });     // set the transparency of the JXPanel to 50% transparent     panel.setAlpha(0.7f);     // add the label, busylables, and button to the panel     panel.add(label, BorderLayout.NORTH);     JXPanel busylabels = new JXPanel(new FlowLayout(FlowLayout.CENTER, 40, 5));     busylabels.add(busylabel1);     busylabels.add(busylabel2);     panel.add(busylabels, BorderLayout.CENTER);     panel.add(button, BorderLayout.SOUTH);     panel.setPreferredSize(new Dimension(250, 125));     return panel;   }   public JXBusyLabel createSimpleBusyLabel(){     JXBusyLabel label = new JXBusyLabel();     label.setToolTipText("simple busy label");     return label;   }   public JXBusyLabel createComplexBusyLabel() {     // this will not work in the 0.9.1 release of SwingX (need later builds)     JXBusyLabel label = new JXBusyLabel(new Dimension(38, 38));     BusyPainter painter = new BusyPainter(         new Rectangle2D.Float(0, 0, 8.0f, 8.0f),         new Rectangle2D.Float(5.5f, 5.5f, 27.0f, 27.0f));     painter.setTrailLength(4);     painter.setPoints(8);     painter.setFrame(-1);     painter.setBaseColor(Colors.LightBlue.color());     painter.setHighlightColor(Colors.Orange.color());     label.setPreferredSize(new Dimension(38, 38));     label.setIcon(new EmptyIcon(38, 38));     label.setBusyPainter(painter);     label.setToolTipText("complex busy label");     return label;   }   public JXLabel createLabel() {     JXLabel label = new JXLabel();     label.setBorder(BorderFactory.createEmptyBorder(5, 5, 5, 5));     label.setFont(new Font("Segoe UI", Font.BOLD, 14));     label.setText("<html>BusyLabel Example...<br>click start/stop button</html>");     label.setIcon(Images.NetworkDisconnected.getIcon(40, 40));     label.setHorizontalAlignment(JXLabel.LEFT);     label.setBackgroundPainter(getPainter());     return label;   }   /** this painter draws a gradient fill */   public Painter getPainter() {     int width = 100;     int height = 100;     Color color1 = Colors.White.color(0.5f);     Color color2 = Colors.Gray.color(0.5f);     LinearGradientPaint gradientPaint =         new LinearGradientPaint(0.0f, 0.0f, width, height,                                 new float[]{0.0f, 1.0f},                                 new Color[]{color1, color2});     MattePainter mattePainter = new MattePainter(gradientPaint);     return mattePainter;   }   }//end class BusyLabelExample

Há algumas coisas a notar sobre este código:

1. A JXPanel é usado para conter todos os componentes (etiquetas, botões, etc). E é a transparência é definida para 70% opaco, 30% claro. É por isso que o programa de amostra tem um olhar muito silenciado / mole para ele.
2. Certifique-se de lançar o seu programa no balanço do EDT e não o fio que está sendo executado através de seu método main ().
3. Uma chamada para setLocationRelativeTo do JFrame (null) centra o JFrame na tela do computador.

O código-fonte de download

Para fazer o download dos projetos ideia para exemplo de código fonte deste tutorial, clique aqui .