探秘JDK 7之三：JLayer裝飾Swing組件
51CTO在給各位介紹過“探秘JDK 7”和“再探JDK 7”之后，今天我們再次走上探秘JDK 7之旅。本文將為大家介紹JDK 7引入了一個新的Swing組件來裝飾其它Swing組件，這個新的組件是通過javax.swing.JLayer類，基于Swing實驗室項目Swing Helper的JXLayer實現的。JLayer結合javax.swing.plaf.LayerUI使用可以實現高級的繪制效果，并可以在它的邊界范圍內接收由java.awt.AWTEvents產生的所有通知。
JLayer和LayerUI概述
根據JDK的文檔描述，JLayer委托處理LayerUI對象的繪制和輸入事件，LayerUI負責裝飾，你可以使用這些類修改現有組件的外觀和行為使它們的裝飾效果更好。
實際上，你可以自己動手擴展LayerUI，廢除它們自帶的方法，自己定制繪制和事件處理方法，然后將這個類的實例和裝飾后的組件一道，傳遞給下面的JLayer構造器：
public JLayer(V view，LayerUI<V> ui)
第一個參數可以是任何類的延伸java.awt.Component，表示你要裝飾的Swing組件，這個組件可以是一個JPanel或其它容器，這個容器和它里面所有的組件都將被裝飾，第二個參數代表裝飾器。使用這些構造器創建JLayer時，可以延遲指定LayerUI實例和/或視圖。
如果初始化時不指定視圖，之后你可以調用JLayer's public void setView(V view)方法來提供一個視圖，這個類也提供了一個public V getView()方法返回組件是否被裝飾，沒有裝飾就返回null。
如果初始化時不指定LayerUI實例，之后你可以調用JLayer's public void setUI(LayerUI ui方法提供一個實例，這個類也提供了一個public LayerUI getUI()方法返回當前的裝飾器，沒有裝飾器就返回null。
JLayer自定義繪制
為了演示JLayer的自定義繪制特性，我創建了一個ReverseText程序，其代碼顯示在清單1中，當按下按鈕時，輸入到textfield中的文本將全部顛倒，這個程序使用JLayer在用戶界面后繪制了一個墻紙圖案。
清單1. ReverseText.java
- // ReverseText.java
- import java.awt.Color;
- import java.awt.EventQueue;
- import java.awt.GradientPaint;
- import java.awt.Graphics;
- import java.awt.Graphics2D;
- import java.awt.event.ActionEvent;
- import java.awt.event.ActionListener;
- import javax.swing.JButton;
- import javax.swing.JComponent;
- import javax.swing.JFrame;
- import javax.swing.JLabel;
- import javax.swing.JLayer;
- import javax.swing.JPanel;
- import javax.swing.JTextField;
- import javax.swing.plaf.LayerUI;
- public class ReverseText
- {
- private static Color PALE_YELLOW = new Color (1.0f，1.0f，0.0f，0.2f);
- private static Color PALE_GREEN = new Color (0.0f，1.0f，0.0f，0.2f);
- private static JLayer<JPanel> createLayer ()
- {
- LayerUI<JPanel> layerUI;
- layerUI = new LayerUI<JPanel> ()
- {
- public void paint (Graphics g，JComponent c)
- {
- // Paint the wallpaper.
- Graphics2D g2 = (Graphics2D) g;
- g2.setPaint (new GradientPaint (0，0，PALE_YELLOW,
- 5，0，PALE_GREEN，true));
- g2.fillRect (0，0，c.getWidth ()，c.getHeight ());
- // Make sure that layer's panel view is not opaque.
- JLayer l = (JLayer) c;
- if (l.getView ().isOpaque ())
- ((JPanel) l.getView ()).setOpaque (false);
- // Paint the view minus its background.
- super.paint (g，c);
- }
- };
- // Create a user interface to be decorated.
- JPanel pnl = new JPanel ();
- JLabel lblName = new JLabel ("Name:");
- pnl.add (lblName);
- final JTextField txtName = new JTextField (20);
- pnl.add (txtName);
- JButton btnReverse = new JButton ("Reverse");
- pnl.add (btnReverse);
- ActionListener al;
- al = new ActionListener ()
- {
- public void actionPerformed (ActionEvent ae)
- {
- String txt = txtName.getText ();
- txt = new StringBuffer (txt).reverse ().toString ();
- txtName.setText (txt);
- }
- };
- btnReverse.addActionListener (al);
- // Create the layer for the panel using our custom layerUI.
- return new JLayer<JPanel> (pnl，layerUI);
- }
- private static void createAndShowUI ()
- {
- JFrame frame = new JFrame ("Reverse Text");
- frame.setDefaultCloseOperation (JFrame.EXIT_ON_CLOSE);
- frame.add (createLayer ());
- frame.pack ();
- frame.setLocationRelativeTo (null);
- frame.setVisible (true);
- }
- public static void main (String [] args)
- {
- Runnable r = new Runnable ()
- {
- public void run ()
- {
- createAndShowUI ();
- }
- };
- EventQueue.invokeLater (r);
- }
- }
#p#
其中createLayer()方法是最重要的代碼，它創建了一個匿名LayerUI子類的實例，繪制了墻紙和JPanel視圖，創建了UI，在實例中包含了UI的面板容器。
繪制操作是由LayerUI's public void paint(Graphics g，JComponent c)方法實現的，第二個參數引用了視圖(被裝飾的組件)中的JLayer實例，不是引用的視圖。
在視圖后創建了漸變渲染墻紙后，調用paint()方法確保視圖(沒有嵌套面板的單一面板)是透明的，它將會隱藏墻紙，然后繪制視圖。
paint()對比paintLayer()
JDK文檔中除了提到paint()方法外，還提到了paintLayer()方法，我這里之所以選擇paint()方法，是因為LayerUI中不存在paintLayer()，此外，文檔還錯誤地引用paintLayer() doesn't exist in LayerUI. Furthermore，the documentation incorrectly refers to addPropertyChange()，configureGraphics()，processComponentEvent()，processFocusEvent()，processHierarchyBoundsEvent()，processHierarchyEvent()，processKeyEvent()，processMouseEvent()，processMouseMotionEvent()，processMouseWheelEvent()，and repaintLayer()這些在LayerUI中根本不存在的方法，當然這些方法也可能在JDK 7最終發布時會包含進來。
圖1顯示了有墻紙背景的UI。
圖1 在用戶界面后加了一層墻紙背景
ReverseText程序演示了自定義繪制，避開了事件觸發，不需要檢測事件，因為程序只關心墻紙的繪制效果。相反，清單2顯示了一個需要響應鼠標移動事件的程序代碼。
清單2. BrandedUI.java
- // BrandedUI.java
- import java.awt.AWTEvent;
- import java.awt.Color;
- import java.awt.Component;
- import java.awt.EventQueue;
- import java.awt.Font;
- import java.awt.GradientPaint;
- import java.awt.Graphics;
- import java.awt.Graphics2D;
- import java.awt.GridLayout;
- import java.awt.Point;
- import java.awt.event.MouseEvent;
- import javax.swing.JComponent;
- import javax.swing.JFrame;
- import javax.swing.JLabel;
- import javax.swing.JLayer;
- import javax.swing.JPanel;
- import javax.swing.JTextField;
- import javax.swing.SwingUtilities;
- import javax.swing.plaf.LayerUI;
- public class BrandedUI
- {
- private static Color PALE_BLUE = new Color (0.0f, 0.0f, 1.0f, 0.3f);
- private static Color PALE_RED = new Color (1.0f, 0.0f, 0.0f, 0.3f);
- private static Font BRAND_FONT = new Font ("Arial", Font.BOLD, 18);
- private static String MSG = "My brand";
- private static JLayer<JPanel> createLayer ()
- {
- LayerUI<JPanel> layerUI;
- layerUI = new LayerUI<JPanel> ()
- {
- private Color color = PALE_BLUE;
- public void installUI (JComponent c)
- {
- super.installUI (c);
- ((JLayer) c).setLayerEventMask (AWTEvent.MOUSE_MOTION_EVENT_MASK);
- }
- public void eventDispatched (AWTEvent e,
- JLayer <? extends JPanel> l)
- {
- MouseEvent me = (MouseEvent) e;
- Point pt = SwingUtilities.convertPoint ((Component) me.getSource (),
- me.getX (), me.getY (), l);
- int cx = l.getWidth ()/2;
- int cy = l.getHeight ()/2;
- if (pt.x > cx-45 && pt.x < cx+45 && pt.y > cy-10 && pt.y < cy+10)
- color = PALE_RED;
- else
- color = PALE_BLUE;
- l.repaint ();
- }
- public void paint (Graphics g, JComponent c)
- {
- // Paint the view.
- super.paint (g, c);
- // Paint the brand.
- g.setColor (color);
- g.setFont (BRAND_FONT);
- int width = g.getFontMetrics ().stringWidth (MSG);
- int height = g.getFontMetrics ().getHeight ();
- g.drawString (MSG, (c.getWidth ()-width)/2,
- c.getHeight ()/2+height/4);
- }
- public void uninstallUI (JComponent c)
- {
- super.uninstallUI (c);
- ((JLayer) c).setLayerEventMask (0);
- }
- };
- // Create a user interface to be decorated.
- JPanel pnlMain = new JPanel ();
- pnlMain.setLayout (new GridLayout (2, 1));
- JPanel pnlTemp = new JPanel ();
- JLabel lblName = new JLabel ("Name:");
- pnlTemp.add (lblName);
- JTextField txtName = new JTextField (20);
- pnlTemp.add (txtName);
- pnlMain.add (pnlTemp);
- pnlTemp = new JPanel ();
- JLabel lblAddr = new JLabel ("Address:");
- pnlTemp.add (lblAddr);
- JTextField txtAddr = new JTextField (20);
- pnlTemp.add (txtAddr);
- pnlMain.add (pnlTemp);
- // Create the layer for the main panel using our custom layerUI.
- return new JLayer<JPanel> (pnlMain, layerUI);
- }
- private static void createAndShowUI ()
- {
- JFrame frame = new JFrame ("Branded UI");
- frame.setDefaultCloseOperation (JFrame.EXIT_ON_CLOSE);
- frame.add (createLayer ());
- frame.pack ();
- frame.setLocationRelativeTo (null);
- frame.setVisible (true);
- }
- public static void main (String [] args)
- {
- Runnable r = new Runnable ()
- {
- public void run ()
- {
- createAndShowUI ();
- }
- };
- EventQueue.invokeLater (r);
- }
- }
上面的代碼渲染UI上的文本印記，我們通常使用印記提醒用戶使用的是試用軟件，印記文本是半透明的，以便背景可以全部顯示，我們不希望這個印記給用戶造成太大的干擾。
另一方面，我們希望用戶能注意到這個印記，讓他們下定決心購買這款軟件，清單2中的代碼通過改變印記的顏色(改成淡紅色)來達到這個目的，當鼠標移到初始值是綠色的印記面板上時，顏色就變成淡紅色。
#p#
事件檢測
JLayer和LayerUI結合起來可以檢測視圖任意區域上發生的事件(包括嵌套的子組件)，這些類共同提供了4個方法來檢測事件。
· public void setLayerEventMask(long layerEventMask)
調用這個JLayer方法時必須使用位掩碼AWTEvent常量選擇它檢測到的事件類型，如：setLayerEventMask (AWTEvent.KEY_EVENT_MASK | AWTEvent.FOCUS_EVENT_MASK);可以檢測到按鍵和焦點改變事件。
◆public void installUI(JComponent c)
這個LayerUI方法通常放在setLayerEventMask()方法之前，這個方法類的代碼首先調用超類方法(super.installUI (c);)，然后是引用JLayer的JComponent參數，最后使用setLayerEventMask(): ((JLayer) c).setLayerEventMask(AWTEvent.KEY_EVENT_MASK);返回的結果。
◆public void uninstallUI(JComponent c)
這個LayerUI方法放在沒有參數的setLayerEventMask()方法后，這個方法內的代碼首先調用超類方法(super.uninstallUI (c);)，然后是引用JLayer的JComponent參數，最后使用setLayerEventMask(): ((JLayer) c).setLayerEventMask(0);返回的結果。
◆public void eventDispatched(AWTEvent e, Jlayer l)
只要前面注冊的事件發生了，就會調用這個LayerUI方法，在這個方法中插入的代碼負責響應事件，并恰當地更新層，更新了不同的繪制屬性(如顏色)后，通過傳遞給這個方法的JLayer參數調用repaint()方法重新繪制視圖。
在清單2中，LayerUI的installUI()方法調用setLayerEventMask(AWTEvent.MOUSE_MOTION_EVENT_MASK)檢測鼠標移動事件，它又調用eventDispatched()方法返回結果。
這個方法首先調用javax.swing.SwingUtilities類的convertPoint()方法確定鼠標移動事件相對于層的坐標位置。
接下來這個方法通過檢查它的坐標是否落在圍繞UI中心的一個矩形區域內，檢測鼠標指針是否移到印記文本上方，如果坐標剛好落在這個矩形區域內，印記文本的顏色就變為淡紅色，除此以外，印記文本的顏色就恢復為藍色。
圖2顯示了鼠標移到印記文本上方前后的顏色變化。
圖2 鼠標指針移到文本上方時，重新繪制文本顏色給用戶一個不刺眼的提示
小結
JLayer對自定義繪制和事件檢測的支持讓你可以改進UI的各個組件，你可以將這個Swing組件和半透明及任意形狀窗口特性結合起來使用，讓你可以設計出更有趣的用戶界面。
【編輯推薦】
