SwingX - JAVA

Esse artigo é baseado numa série de publicações sobre SwingX do blog Cotidiano em Wonderland. 
Introdução 

De acordo com o sítio do SwingX no Java.net, 
"[SwingX] contém extensões para o toolkit GUI Swing, incluindo novos e aprimorados componentes que fornecem funcionalidades comumente requisitadas por aplicativos que usem clientes ricos. Destaques incluem": 

* Ordenamento, filtragem, destaques (highlighting) para tabelas, árvores (trees) e listas 
* Find/Search 
* Auto-complemento 
* Framework para autenticação/login 
* Componente TreeTable 
* Collapsible Panel (painel dobrável) 
* Componente Date Picker (seletor de datas) 
* Componente Tip-of-the-Day (dica-do-dia) 

SwingX é um subprojeto do SwingLabs, que conta com suporte da Sun Microsystems e com a participação de alguns dos mais importantes engenheiros da Sun responsáveis pelo Swing. 

O SwingLabs serve para implementação e teste de idéias relacionadas à tecnologia voltada para o desenvolvimento de GUI's (Graphical User Interface) para clientes ricos. 

Experimentos bem-sucedidos serão considerados para inclusão em versões futuras do JDK (Java Development Kit). O projeto requer ao menos JDK 5 e é licenciado sob LGPL. 

Todos os componentes do projeto SwingLabs, incluindo portanto os componentes SwingX, são focados para uso em ambiente de produção. Entretanto, a Sun não oferece qualquer garantia de suporte e desenvolvimento presente ou futuro para qualquer desses componentes. 

É importante ressaltar que todos os componentes apresentados nesse artigo foram testados utilizando a versão SwingX 0.8.0. Ao utilizar versões diferentes, existe a possibilidade de algum código presente nesse artigo não funcionar como esperado. 

Alguns Componentes SwingX 
[list] 
[*] JXCollapsiblePane 
[*] JXComboBox 
[*] JXDatePicker 
[*] JXEditorPane 
[*] JXErrorPane 
[*] JXFindBar 
[*] JXFindPanel 
[*] JXFrame 
[*] JXGlassBox 
[*] JXHyperlink 
[*] JXImagePanel 
[*] JXList 
[*] JXLoginDialog 
[*] JXLoginPanel 
[*] JXmonthView 
[*] JXPanel 
[*] JXRadioGroup 
[*] JXRootPane 
[*] JXSearchPanel 
[*] JXStatusBar 
[*] JXTable 
[*] JXTableHeader 
[*] JXTaskPane 
[*] JXTaskPaneContainer 
[*] JXTipOfTheDay 
[*] JXTitledPanel 
[*] JXTree 
[*] JXTreeTable 
[/list] 

SwingX em IDE's 

Componentes SwingX são JavaBeans, por isso podem ser adicionados a paleta de componentes de uma IDE (NetBeans, Eclipse, Intellij) e usados para a contrução de GUI's. 

Idéias para o Futuro do SwingLabs 

O SwingLabs mantém uma página com uma série de idéias para futura implementação - uma espécie de repositório para brainstorming. 

Entre essas idéias estão os componentes Application Wellcome Screen (presente nas IDE's NetBeans e Eclipse), JXFontChooser, SpellChecking, JXImgTextField e JXPreferencesDialog. 

JXPanel 

JXPanel extende JPanel e adiciona suporte para transparência (translucency) e para gradient. Basicamente, JXPanel difere de JPanel porque possui a propriedade alpha. 

Usado extensamente pelos componentes SwingX e provável sucessor do JPanel, é difícil encontrar uma utilidade para o uso da transparência em JXPanel. 

A figura abaixo mostra um JXPanel contendo um JXMonthView com nenhuma transparência. Ou seja, alpha == 1, que é o valor padrão. 

 

Na próxima figura, o JXPanel tem uma transparência de 40%, obtida através de setAlpha(0.6). O valor do parâmetro alpha deve estar entre 0 e 1 inclusive. 

 

JXTitledPanel 

JXTitledPanel, subclasse de JXPanel, possui uma seção de título e outra seção de conteúdo. 

A seção de título possui uma barra em cores degradê, onde define-se o título. É possível adicionar componentes em um de seus cantos, como um JLabel ou JXHyperlink. A seção de conteúdo é usada da mesma forma que um JPanel comum. 

 

Customização 

Use setTitle(String title) para definir um título 

1 JXTitledPanel titledPanel = new JXTitledPanel(); 
2 titledPanel.setTitle("Seção de Título"); 


Use os métodos setTitleDarkBackground(Color colorDarkBackground) e setTitleLightBackground(Color colorLightBackground) para definir a cor degradê da seção de título. 

1. titledPanel.setTitleDarkBackground(new Color(0, 102, 204));  
2. titledPanel.setTitleLightBackground(new Color(184, 207, 249));  

É possível inserir qualquer subclasse de JComponent na seção de título. Para isso, use o método addLeftDecoration(JComponent decoration) ou addRightDecoration(JComponent decoration). Pode ser útil colocar um JXHyperlink no canto direito da seção de título. 

1. JXHyperlink hyperlink = new JXHyperlink();  
2. titledPane.addRightDecoration(hyperlink);  

JXHyperlink 

JXHyperlink imita o comportamento dos tradicionais hyperlinks em páginas da Web, oferecendo suporte para rollover e click-color. Extende JButton, diferindo muito pouco de sua superclasse. 

JXHyperlink in Action 

Na caixa de diálogo About abaixo, há dois hyperlinks: Rafael Fiume e ModelMat 0.3.0. O primeiro leva o usuário diretamente para o blog do desenvolvedor desse software, o segundo, para o sítio do projeto ModelMat. 

 

Use o construtor JXHyperlink(Action action) ou o método herdado setAction(Action action) para registrar um ouvinte (listener) para os cliques numa instância de JXHyperlink. 

1. JXHyperlink hyperlinkRF = new JXHyperlink(new LinkAction("Cotidiano em Wonderland", "rfiume.blogspot.com"));  
2. JXHyperlink hyperlinkMM = new JXHyperlink(new LinkAction("ModelMat Project's Page", "https://modelmat.dev.java.net"));  

LinkAction identifica a origem do evento - hyperlinkRF ou hyperlinkMM - e delega para BareBonesBrowserLaunch* a execução do navegador padrão. BareBonesBrowserLaunch é uma classe de domínio público. 

1. class LinkAction extends AbstractAction {  
2.   
3.      LinkAction(String linkText, String link) {  
4.           putValue(Action.NAME, linkText);  
5.           putValue(Action.SHORT_DESCRIPTION, link);  
6.      }  
7.   
8.      public void actionPerformed(ActionEvent e) {  
9.           String  link = (String) getValue(Action.SHORT_DESCRIPTION);  
10.           BareBonesBrowserLaunch.openURL(link);  
11.      }  
12. }  

Customização 
Use setClickedColor(Color color) e setUnclickedColor(Color color) 
para definir as cores do hyperlink quando clicado e não-clicado respectivamente. 

1. hyperlinkRF.setClickedColor(new Color(153, 0, 153));  
2. hyperlinkRF.setUnclickedColor(new Color(0, 51, 255));  

[list] 
[*]Se estiver utilizando o Java SE 6, prefira usar a Desktop API para interagir com aplicativos padrões do sistema operacional nativo, como navegadores de Internet e clientes de e-mail. 
[/list] 

JXMonthView 

Segundo a documentação do SwingX , JXMonthView é um 
componente que mostra um calendário mensal, que pode ser usado para selecionar um dia ou um conjunto de dias. Por padrão, JXMonthView mostrará um calendário simples usando o mês e ano atual e Calendar.SUNDAY como o primeiro dia da semana. 

 

Customização 

Para mostrar mais de um calendário mensal, use os métodos setPreferredCols(int cols) e setPreferredRows(int rows). 

1. JXMonthView monthView = new JXMonthView();  
2. monthView.setPreferredCols(2);  

 

JXMonthView pode ser configurado para mostrar outro dia além de Domingo como o primeiro dia da semana. 

monthView.setFirstDayOfWeek(Calendar.MONDAY); 

É possível mudar a representação dos dias da semana. 

monthView.setDaysOfTheWeek(new String[] {"Domingo", "Segunda", "Terça", "Quarta", "Quinta", "Sexta", "Sábado"}); 

 

Seleção de Datas 

Há quatro formas possíveis para selecionar datas num componente JXMonthView: NO_SELECTION, SINGLE_SELECTION, MULTIPLE_SELECTION e WEEK_SELECTION. O padrão é JXMonthView.SINGLE_SELECTION. 

1. monthView.setSelectionMode(JXMonthView.NO_SELECTION);  

JXMonthView pode registrar um ouvinte (listener) para ser notificado sempre que o usuário selecionar uma data, ou conjunto de datas, numa instância dessa classe. 

1. monthView.addActionListener(new ActionListener() {  
2.      public void actionPerformed(ActionEvent e) {  
3.          System.out.println(((JXMonthView) e.getSource()).getSelectedDateSpan());  
4.      }  
5. });  

Problemas ? 

É comum destacar dias da semana em calendários, e JXMonthView tem suporte para esse requisito. 

1. Calendar cal1 = Calendar.getInstance();  
2. Calendar cal2 = Calendar.getInstance();  
3. cal1.set(2007, 1, 1);  
4. cal2.set(2007, 1, 21);  
5.   
6. long[] flaggedDates flaggedDates = new long[] {  
7.      cal1.getTimeInMillis(),  
8.      cal2.getTimeInMillis(),  
9.      System.currentTimeMillis()  
10. };  
11.   
12. monthView.setFlaggedDates(flaggedDates);  

Mas durante os testes, setFlaggedDates() não funcionou - na última figura acima, os dias da semana 1/1/2007, 21/1/2007 e 23/01/2007 (a data atual quando esse artigo foi publicado) não estão destacados em negrito como deveriam. Há um bug impedindo que esse método funcione no SwingX 0.8.0. 

JXDatePicker 

Segundo sua documentação, JXDatePicker é "um componente que combina um botão, um campo editável e um componente JXMonthView. O usuário pode selecionar a data a partir do componente calendário, que aparece quando o botão é pressionado. A seleção da data no componente calendário será mostrada no campo editável. Uma data também pode ser modificada diretamente a partir do campo editável, usando um dos formatos de datas suportados." 

 
A fonte da imagem mostrando o JXDatePicker é Introduction to JXDatePicker 
Serviços 

Use o método getDate() ou getDateInMillis() para obter a data selecionada. 

1. JXDatePicker datePicker = new JXDatePicker();  
2. Date date = datePicker.getDate();  
3. long dateInMillis = datePicker.getDateInMillis();  

JXDatePicker dispara ActionEvent's quando uma seleção de data é feita, tanto por meio do componente JXMonthView, quanto do campo de texto. No último caso, como se trata de ActionEvent's, é preciso que o usuário pressione a tecla Enter para que os ouvintes (listeners) registrados sejam notificados do evento. 

1. datePicker.addActionListener(new ActionListener() {  
2.      public void actionPerformed(ActionEvent evt) {  
3.           System.out.println(datePicker.getDate().toString());  
4.      }  
5. });  

Customização (1) 
É possível customizar o formato aceitável das datas para a caixa de texto do JXDatePicker através dos métodos setFormats(String [] formats) e setFormats(DateFormat [] formats). As strings que compõem o argumento String [] formats devem estar de acordo com o padrão especificado em java.text.SimpleDateFormat. 

1. datePicker.setFormats(new String [] { "dd/MM/yyyy" });  

 

Cada valor no vetor formats é um formato aceitável para a entrada de uma data. Os usuários podem então selecionar datas da forma que melhor lhes convir, seja pelo componente JXMonthView, seja pelo campo de texto e, nesse último caso, com diferentes formatos de datas. Caso o usuário selecione a data pelo componente JXMonthView, JXDatePicker decide em qual formato mostrar a data no campo de texto, entre os vários formatos definidos, pelo valor do primeiro índice do vetor, ou pelo valor que usuário escolheu caso tenha inserido uma data manualmente. 

Customização (2) 

A mensagem mostrada no linkPanel - o painel mostrado na parte de baixo da popup JXMonthView - pode ser modificada através de setLinkDate(long linkDate, String linkFormatString). O argumento para linkFormatString deve estar de acordo com o padrão de java.text.MessageFormat. 

1. datePicker.setLinkDate(System.currentTimeMillis(), "Hoje é dia {0}");  

De outra forma, linkPanel pode ser totalmente re-implementado e adicionado à parte de baixo da popup JXMonthView com o método setLinkPanel(JPanel linkPanel). 

1. datePicker.setLinkPanel(aPanel);  

Problemas ? 

Talvez um aplicativo tenha como requisito restringir a seleção de datas de dias passados ou até um certo tempo no futuro. Isso inviabilizará o uso de JDatePicker nesse aplicativo, pois não há como limitar a seleção de uma data nesse componente. 

JXImagePanel 

JXImagePanel é um JXPanel especial para imagens. Pode ser editável e, nesse caso, permite que o usuário escolha outra imagem através de um JFileChooser. 

Futuramente, irá prover mais serviços para manipulação de imagens como tiling, scaling, resizing, cropping (recorte), segways e outros. 
 

Configuração 

Adicione uma imagem ao JXImagePanel com o método setImage(Image image) 

1. JXImagePanel imagePanel = new JXImagePanel();  
2. try {  
3.      BufferedImage img = ImageIO.read(  
4.                          JXImagePanelTest.class.getResourceAsStream("SoccerDukeSmall.png"));  
5.      imagePanel.setImage(img);  
6. } catch (Exception e) {  
7.      e.printStackTrace();  
8. }  

Defina se a imagem de JXImagePanel é ou não editável através de setEditable(Boolean editable). 

1. imagePanel.setEditable(true);?  

Serviços 

Ajuste o estilo da imagem de um JXImagePanel com o método setStyle(JXImagePanel.Style style). JXImagePanel.Style é um enum com três constantes (na versão SwingX 0.8.0): CENTERED, SCALED e TILED. 

1. imagePanel.setStyle(JXImagePanel.Style.CENTERED);  

JXStatusBar 

JXStatusBar é um componente para mostrar mensagens aos usuários. Geralmente, é localizado na parte mais em baixo de uma interface gráfica. 

Há dois modos para JXStatusBar relatar informações: atualização manual, ou através de listener API. 

JXStatusBar possui o seu próprio gerenciador de layout para organizar os componentes que lhe são adicionados. 

JXStatusBar in Action (1) 

O meio mais simples e direto de relatar informações na barra de estado JXStatusBar é manualmente, com os métodos setText(String messageText), setLeadingMessage(String messageText) e setTrailingMessage(String messageText). 

A diferença entre eles é que setText coloca uma mensagem não transiente no lado direito da barra de estado (status bar), setLeadingMessage coloca a mensagem no canto direito da barra e setTrailingMessage coloca o texto no canto esquerdo. 

1. JXStatusBar statusBar = new JXStatusBar();  
2. statusBar.setBorder(BorderFactory.createMatteBorder(1, 0, 1, 0, Color(0, 0, 153)));  
3.      
4. statusBar.setLeadingMessage("Concluído");  
5. statusBar.setTrailingMessage("");  

 

1. statusBar.setLeadingMessage("Erro");  
2. statusBar.setTrailingMessage("RemoteException");  

 

JXStatusBar in Action (2) 

A outra forma de publicar informações num JXStatusBar é através de listeners API. 

As interfaces envolvidas são MessageListener, MessageSource, ProgressListener e ProgressSource. JXStatusBar implementa MessageListener e MessageSource; classes interessadas em publicar informações num JXStatusBar devem implementar MessageSource, ProgressSource, ou ambas. 

MessageSource é fonte de MessageEvent's, e ProgressSource é fonte de ProgressEvent's. A classe auxiliar (helper) MessageSourceSupport é conveniente, pois implementa toda a lógica necessária para utilizar listeners API's, como adicionar/remover ouvintes (listeners) e disparar (fire) eventos. 

A classe TableInputModel, do projeto ModelMat, implementa MessageSource e ProgressSource através de MessageSourceSupport. 

1. public class TableInputModel implements TableModel, MessageSource, ProgressSource {  
2.             
3.      private final MessageSourceSupport messenger = new MessageSourceSupport(this);  
4.   
5.      public void addMessageListener(final MessageListener messageListener) {  
6.           messenger.addMessageListener(messageListener);  
7.      }  
8.      public void removeMessageListener(final MessageListener messageListener) {  
9.           messenger.removeMessageListener(messageListener);  
10.      }  
11.      public MessageListener[] getMessageListeners() {  
12.           return messenger.getMessageListeners();  
13.      }  
14.      public void addProgressListener(final ProgressListener progressListener) {  
15.           messenger.addProgressListener(progressListener);  
16.      }  
17.      public void removeProgressListener(final ProgressListener progressListener) {  
18.           messenger.removeProgressListener(progressListener);  
19.      }  
20.      public ProgressListener[] getProgressListeners() {  
21.           return messenger.getProgressListeners();  
22.      }  
23.      // Executa regress?o linear.  
24.      public void linearRegression() throws CoordinatedNumException, InsufficientDataException {  
25.           // Manda a mensagem para a barra de estado.  
26.           messenger.fireMessage("Running   ");  
27.           final LinearRegressionCommand command = new LinearRegressionCommand(matriz);  
28.           commandManager.setCommand(command);  
29.           commandManager.execRegression();  
30.           // Manda outra mensagem para a barra de estado.  
31.           messenger.fireMessage("Done.");  
32.      }     // Executa regress?o n?o-linear.  
33.      public void nonLinearRegression() throws CoordinatedNumException, InsufficientDataException {  
34.           // Avisa ao ouvinte que uma longa operaç?o teve início.  
35.           messenger.fireProgressStarted(0, 9);  
36.           final LinearRegressionCommand command = new LinearRegressionCommand(matriz);  
37.           // Avisa que houve um incremento no progresso do método.  
38.           messenger.fireProgressIncremented(2);  
39.           commandManager.setCommand(command);  
40.           messenger.fireProgressIncremented(2);  
41.           commandManager.execRegression();  
42.           messenger.fireProgressIncremented(6);  
43.           // Notifica ao ouvinte que a operaç?o terminou.  
44.           messenger.fireProgressEnded();  
45.      }  
46. }  

A implementação completa da classe TableInputModel está disponível no repositório do projeto ModelMat. 

JXTipOfTheDay 

JXTipOfTheDay é a implementação de uma técnica bastante comum para ajudar novos usuários a conhecer um aplicativo. Consiste num painel ou caixa de diálogo com dicas (tips) para ajudar os usuários a descobrir recursos interessantes, aumentar sua produtividade e tirar o melhor proveito desse aplicativo. 

 

eralmente, conta com a opção de mostrar ou não a dica do dia - do inglês tip of the day - a cada inicialização do software. 

Os tips podem ser definidos direto no código-fonte do software (hard-code), ou através de um arquivo de propriedade. 

JXTipOfTheDay in Action (1) 

A classe JXTipOfTheDayTest mostra uma caixa de diálogo com as dicas definidas diretamente no código-fonte. 

1. public class JXTipOfTheDayTest {  
2.      private static JXTipOfTheDay tipOfTheDay;  
3.   
4.      private JXTipOfTheDayTest() {  
5.           super();  
6.           tipOfTheDay = new JXTipOfTheDay(loadModel());  
7.      }  
8.      private TipOfTheDayModel loadModel() {  
9.           final List tips = Arrays.asList(  
10.                          new DefaultTip("Tip1", "Alguma dica aqui!"),  
11.                          new DefaultTip("Tip2", "Outra dica   "),  
12.                          new DefaultTip("Tip3", "Última    acho que já é o suficiente."));   
13.           return new DefaultTipOfTheDayModel(tips);  
14.      }  
15.      public static void main(String args[]) {  
16.           java.awt.EventQueue.invokeLater(new Runnable() {  
17.                public void run() {  
18.                     new JXTipOfTheDayTest();  
19.                     tipOfTheDay.showDialog(null);  
20.                }  
21.           });  
22.      }  
23. }  

JXTipOfTheDay in Action (2) 

A melhor opção pode ser definir tips num arquivo de propriedade. 

A classe TipOfTheDay abaixo procura pelas dicas no arquivo tip.properties, armazena a escolha do usuário para mostrar ou não o diálogo na próxima inicialização do aplicativo em Preferences e mostra o diálogo Tip of the Day. 

1. public final class TipOfTheDay {  
2.      private static JXTipOfTheDay tipOfTheDay;  
3.   
4.      private TipOfTheDay() {  
5.           super();  
6.      }  
7.   
8.      public static void show(final Component parentComponent) {  
9.           final Preferences userPreferences = Preferences.userRoot().node("ModelMat");  
10.           create().showDialog(parentComponent, userPreferences);  
11.      }  
12.   
13.      public static void show(final Component parentComponent, final boolean force) {  
14.           final JXTipOfTheDay tip = create();  
15.           final Preferences userPreferences = Preferences.userRoot().node("ModelMat");   
16.           if (force) {  
17.                tip.forceShowOnStartup(userPreferences);  
18.           }   
19.           tip.showDialog(parentComponent, userPreferences, force);  
20.      }   
21.   
22.    
23.      private static JXTipOfTheDay create() {  
24.           if (tipOfTheDay == null) {   
25.                final Properties prop = new Properties();  
26.                final InputStream input = TipOfTheDay.class.  
27.                               getResourceAsStream("/org/modelmat/gui/helper/tip.properties");  
28.                try {  
29.                     prop.load(input);   
30.                } catch (IOException ex) {  
31.                     ex.printStackTrace();  
32.                     return null;  
33.                }   
34.                final TipOfTheDayModel model = TipLoader.load(prop);  
35.                tipOfTheDay = new JXTipOfTheDay(model);   
36.                return tipOfTheDay;  
37.           }   
38.           return tipOfTheDay;  
39.      }  
40. }  

Os tips escritos no aquivo de propriedades devem seguir o padrão abaixo: 

1. # Pode-se usar tags html no texto da descrição.  
2. tip.1.description=<html>You can modify the columns names. To do that, select <code>Sheet -> Edit Column Name</code>.</html>  
3. tip.2.description=Currently, ModelMat can do only the simplest linear and non-linear regression.  
4. tip.3.name=Tip's Name - Opcional   
5. tip.3.description=<html>This project is subdivided in two parts: <ul><li>the core system</li> <li>and the graphical user interface (GUI).</li></ul></html>  

Finalmente, o método main na classe principal chama show, em TipOfTheDayFactory, para mostrar as dicas ao usuário. 

1. /* Classe principal em Main, do projeto ModelMat.*/  
2. public static void main(final String args[]) {  
3.      java.awt.EventQueue.invokeLater(new Runnable() {  
4.           public void run() {  
5.                try {  
6.                     UIManager.setLookAndFeel(new Plastic3DLookAndFeel());  
7.                } catch (UnsupportedLookAndFeelException ex) {  
8.                     ex.printStackTrace();  
9.                }  
10.                final ModelMat mm = new ModelMat();  
11.                mm.setVisible(true);  
12.                TipOfTheDay.show(mm);  
13.           }  
14.      });  
15. }  

 

JXTaskPane 

Use JXTaskPane para agrupar um conjunto de componentes visuais relacionados com uma mesma tarefa. JXTaskPane fornece controle para expandir e retrair o painel de conteúdo. 

Geralmente são agrupados num JXTaskPaneContainer. Consulte JXTaskPaneContainer para entender quais os benefícios de agrupar JXTaskPane's num JXTaskPaneContainer. 

 

JXTaskPane criará automaticamente hyperlinks através do método add(javax.swing.Action action). 

JXTaskPane in Action 

Segue a porção de código relevante para criar os três JTaskPane's agrupados num JXTaskPaneContainer, como na figura ao lado. 

1. JXTaskPaneContainer taskPaneContainer = new JXTaskPaneContainer();  
2. JXTaskPane tpPrincipal = new JXTaskPane();  
3. JXTaskPane tpCalendario = new JXTaskPane();  
4. JXMonthView monthView = new JXMonthView();  
5. JXTaskPane tpSearchUrl = new JXTaskPane();  
6. JLabel labelURL = new JLabel();  
7. JTextField tfURL = new JTextField();  
8. JButton bGo = new JButton();  
9. // DropShadowBorder faz parte da biblioteca SwingX.  
10. taskPaneContainer.setBorder(new DropShadowBorder());  
11. // Define o título.  
12. tpPrincipal.setTitle("Principal");  
13. // Define o ícone.  
14. tpPrincipal.setIcon(newImageIcon(getClass().getResource("/folder_home.png")));  
15. // Adiciona JXHyperlink's através de subclasses de javax.swing.Action.  
16. tpPrincipal.add(new IrParaHome());  
17. tpPrincipal.add(new IrParaCadastroPedido());  
18. tpPrincipal.add(new IrParaCadastroCompra());  
19. // Coloca tpPrincipal em taskPaneContainer.  
20. taskPaneContainer.add(tpPrincipal);  
21. tpCalendario.setTitle("Calendário");  
22. // Faz com que o JXTaskPane esteja retraído.  
23. tpCalendario.setExpanded(false);  
24. // Adiona JXMonthView, também parte do conjunto de componentes SwingX.  
25. tpCalendario.add(monthView);  
26. taskPaneContainer.add(tpCalendario);  
27. // Apenas um indicador para o UI plugável pintar diferente a área de título do JXTaskPane.  
28. tpSearchUrl.setTitle("Pesquisar na Web");  
29. tpSearchUrl.setSpecial(true);  
30. /* 
31. * Componentes labelURL, tfURL e bGo adicionados em tpSearchURL   
32. * através da Matisse do NetBeans. 
33. */  
34. taskPaneContainer.add(tpSearchUrl);  

Action 
Action's são interessantes quando mais de um componentes gráfico executa a mesma função, como pode acontecer com um item de menu e um botão da barra de ferramentas. 

Encapsulam num mesmo lugar informações como o texto do menu, ícone pequeno para o menu, ícone grande para a barra de ferramenta, tool tip text e o estado do componente (ativado/desativado). 

A classe IrParaHome extende AbstracAction - a implementação padrão da interface Action. Dessa forma, é preciso apenas definir o método actionPerformed() em IrParaHome. 

Segue a classe IrParaHome, utilizada no código acima. 

1. public class IrParaHome extends AbstractAction {  
2.      // Texto que aparece no menu e no hyperlink.  
3.      private static final String NAME = "Home";  
4.      private static final String ACTION = "go_home";  
5.      // Tool tip text.  
6.      private static final String SHORT_DESCRIPTION = "Mostra a tela principal";  
7.      private static final Icon SMALL_ICON;  
8.   
9.      static {  
10.           SMALL_ICON = new ImageIcon(IrParaCadastroPedido.class.getResource("/simpletest/taskpane/home.png"));  
11.      }   
12.      public IrParaHome() {  
13.           super();  
14.           putValue(Action.NAME, NAME);  
15.           putValue(Action.SHORT_DESCRIPTION, SHORT_DESCRIPTION);  
16.           putValue(Action.ACTION_COMMAND_KEY, ACTION);  
17.           putValue(Action.SMALL_ICON, SMALL_ICON);  
18.      }  
19.   
20.      public void actionPerformed(ActionEvent e) {  
21.           // Lógica de navegaç?o aqui.  
22.      }  
23. }  

JXTaskPaneContainer 

JXTaskPaneContainer é feito sob medida para JXTaskPane's que, embora possam ser adicionados em qualquer container, possuem um look and feel mais parecido com o sistema operacional nativo quando estão sobre o JXTaskPaneContainer. 


É aconselhável que o JXTaskPaneContainer esteja contido num JScrollPane para que a barra de rolagem vertical apareça nos casos onde o JXTaskPaneContainer não possa ser completamente visível. 

Configuração 

JXTaskPaneContainer possui seis look and feel's diferentes: 

[list] 
[*] Metal 
[*] Windows Classic 
[*] Windows Luna 
[*] Windows Homestead 
[*] Windows Silver 
[*] Glossy 
[/list] 

 

Veja o demo do SwingLabs para melhor conhecer os seis tipos de L&F's. 

Em alguns casos, é possível configurar o JXTaskPaneContainer programaticamente para alterar o look and feel padrão. Para isso, adicione os seguintes códigos na classe que contém o objeto JXTaskPaneContainer. 

Metal 

1. LookAndFeelAddons.setAddon(MetalLookAndFeelAddons.class);  
2. // Se a vers?o da JVM for 5.0 ou superior     
3. UIManager.getLookAndFeelDefaults().put(JXTaskPane.uiClassID,  
4.                "org.jdesktop.swingx.plaf.misc.GlossyTaskPaneUI");  

Windows Classic 

1. UIManager.put("win.xpstyle.name", null);  
2. LookAndFeelAddons.setAddon(WindowsClassicLookAndFeelAddons.class);  

Windows Luna 

1. UIManager.put("win.xpstyle.name", "luna");  
2. LookAndFeelAddons.setAddon(WindowsLookAndFeelAddons.class);  

Windows Homestead 

1. UIManager.put("win.xpstyle.name", "homestead");  
2. LookAndFeelAddons.setAddon(WindowsLookAndFeelAddons.class);  

Windows Silver 

1. UIManager.put("win.xpstyle.name", "metallic");  
2. LookAndFeelAddons.setAddon(WindowsLookAndFeelAddons.class);  

Glossy 

1. LookAndFeelAddons.setAddon(MacOSXLookAndFeelAddons.class);  

O look and feel Glossy não está disponível no SwingX 0.8.0. Se quiser fazer uso do L&F do Mac OS X, é preciso acessar o repositório do Java.net, módulo swingx, compilar, gerar o arquivo jar e adicioná-lo ao classpath do aplicativo. 


JXCollapsiblePane 

JXCollapsiblePane extende as funcionalidades de JPanel, acrescentando a capacidade de retração/expansão de sua área de conteúdo, com animação e efeitos do tipo fade-in/fade-out. 

A documentação do JXCollapsiblePane tem um exemplo para entender como utilizar JXCollapsiblePane. Os métodos importantes para seu manuseio são: 

[list] 
[*] setAnimated () / isAnimated (), que controlam a animação fade-in / fade-out. 
[*] setCollapsed () / isCollapsed (), que controlam a retração / expansão do painel. 
[/list] 

JXCollapsiblePane conta com um Action pronto para uso, que retrai / expande esse componente. Para obtê-lo use: 

1. JXCollapsiblePane collapsiblePane = new JXCollapsiblePane();  
2. Action action = collapsiblePane.getActionMap().get("toggle");  

JXCollapsiblePane in Action 
Na figura abaixo, o painel de listagem dos produtos está retraído. 

 

Após clicar no botão de listagem, o painel começa se expandir. 

 

Finalmente, os " itens cadastrados " tornam-se visíveis.