馴服 Tiger：Swing 免 ContentPane 痛苦，JFrame 直接加元件

Swing 開發者最熟悉的痛點莫過於：JFrame.setLayout() 拋錯、必須先 getContentPane() 才能加元件。Java 5 (Tiger) 徹底終結這段歷史——**頂層容器現在直接支援 add()、setLayout()、remove()**，內容窗格自動代理，讓 GUI 開發更直覺。

歷史包袱：為什麼需要 ContentPane？

Swing 頂層容器 (JFrame/JApplet/JDialog/JWindow) 內部由 JRootPane 管理，包含四層：

• GlassPane：透明覆蓋層，攔截事件、繪製覆蓋效果
• LayeredPane：分層管理，支援 Z-order、拖放、選單彈出
• ContentPane：實際裝載元件的容器，設定 LayoutManager、add 元件
• MenuBar：選單列區域

過去必須寫：

JFrame frame = new JFrame("Title");
Container cp = frame.getContentPane();  // 必須取得 ContentPane
cp.setLayout(new GridLayout(1,2));
cp.add(label);
cp.add(button);

直接對 frame.setLayout() 會拋錯：Do not use JFrame.setLayout() use JFrame.getContentPane().setLayout() instead。

Java 5 新方式：直接操作 JFrame

Tiger 讓 JFrame/JDialog/JApplet/JWindow 代理 add/setLayout/remove 至 ContentPane：

JFrame frame = new JFrame("Title");
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.setLayout(new GridLayout(1,2));  // 直接設定版面
frame.add(label);                       // 直接加元件
frame.add(button);
frame.pack();
frame.setVisible(true);

原理：RootPaneContainer 介面新增預設方法實作，委派給 getContentPane()。

仍需直接操作 ContentPane 的情況

雖 95% 場景可免 getContentPane()，但以下情況**必須**直接存取：

相容性與遷移建議

• 舊代碼無需修改：getContentPane() 仍有效，行為不變
• 新代碼建議直呼 JFrame：更簡潔、符合直覺、減少樣板代碼
• 教學/範例同步更新：避免誤導初學者

延伸：JRootPane 進階應用

理解 JRootPane 結構可解鎖進階功能：

• GlassPane：frame.setGlassPane(customPanel) 實現全域事件攔截、載入遮罩、工具提示增強
• LayeredPane：frame.getLayeredPane().add(component, JLayeredPane.MODAL_LAYER) 實現模態對話框、工具提示、拖放預覽
• MenuBar：frame.setJMenuBar(menuBar) 設定選單列 (已支援代理)

結語

Java 5 針對 Swing 最大痛點——ContentPane 樣板代碼——給出了優雅解法。頂層容器現在表現得像個正常容器，讓開發者專注佈局與元件組合，而非記憶委派規則。下次建立 JFrame 時，大膽地直接 frame.add(component) 吧！