Java Swing JButton 圖標覆蓋文字問題完美解決

問題描述

在使用 JButton.setIcon() 設置圖標後，按鈕原有的文字被圖標覆蓋，不再顯示。同樣設置背景圖片也會出現此問題。這是初學者常遇到的 Swing 佈局困擾。

核心解法

關鍵在於調整文字相對於圖標的位置，使用以下兩個方法組合：

• setHorizontalTextPosition(int textPosition) — 水平位置
• setVerticalTextPosition(int textPosition) — 垂直位置

代碼示例：圖標在上、文字在下（居中）

JButton btn = new JButton();
btn.setIcon(new ImageIcon("path/to/icon.png"));
btn.setText("我的文檔");
btn.setVerticalTextPosition(SwingConstants.BOTTOM);   // 文字在圖標下方
btn.setHorizontalTextPosition(SwingConstants.CENTER); // 文字水平居中

通過不同常量組合（TOP/BOTTOM/LEFT/RIGHT/CENTER），可實現圖文任意相對位置，完全避免覆蓋。