四. 文本輸入框、密碼輸入框
文本輸入框包括兩種，單行文本輸入框 (JTextField) 和多行文本輸入框 (JTextArea)。密碼輸入框則只有一種 (JPasswordField)。JPasswordField 是 JTextField 的子類，它們的主要區別是 JPasswordField 不會顯示出用戶輸入的東西，而只會顯示出程序員設定的一個固定字符，比如 '*'。
下面的示例圖和代碼是 JTextField、JPasswordField 和 JTextArea 的示例：
/**
* TestTexts.java
* @author Fancy
*/
import javax.swing.*;
import javax.swing.event.*;
public class TestTexts extends JFrame {
private JLabel label = new JLabel("Status");
private JTextField textField;
private JPasswordField pwdField;
private JTextArea textArea;
public TestTexts() {
super("Test Texts");
setDefaultCloseOperation(EXIT_ON_CLOSE);
getContentPane().setLayout(new java.awt.FlowLayout());
textField = new JTextField(15);
/* 監聽文本光標移動事件 */
textField.addCaretListener(new CaretListener() {
public void caretUpdate(CaretEvent e) {
// 如果改變了內容，就可以即時更新 label 顯示的內容
label.setText(textField.getText());
}
});
pwdField = new JPasswordField(15);
pwdField.setEchoChar('#');
textArea = new JTextArea(5, 15);
textArea.setLineWrap(true);
getContentPane().add(textField);
getContentPane().add(pwdField);
getContentPane().add(textArea);
getContentPane().add(label);
setSize(200, 200);
}
public static
void main(String[] args) {
TestTexts tt = new TestTexts();
tt.show();
}
}
上例中，我們構造了一個寬度爲 15 個字符的單行文本框 (textField = new JTextField(15);)，並使用 addCaretListener 方法添加了一個 CaretListener (textField.addCaretListener ...)。CaretListener 監聽文本光標的移動事件。當用戶使用鍵盤、鼠標等移動了文本光標在 JTextField 中的位置時觸發這個事件。我們需要重載 caretUpdate(CaretEvent e) 對事件進行處理 (public
void caretUpdate(CaretEvent e) ...)。這樣，我們可以在這裏做類似 VB 中 TextBox 的 OnChange 事件中做的事情。
JTextField 有 5 個構造方法，常用其中的四個：
JTextField()
JTextField(int columns)，如上例 textField = new JTextField(15);
JTextField(String text)
JTextField(String text, int columns)
其中，參數 text 是單行文本框的初始內容，而 columns 指定了單行文本框的寬度，以字符爲單位。JTextField 中的文本內容可以用 getText() 方法獲得。也可以用 setText 方法指定 JTextField 中的文本內容。
JPasswordField 是 JTextField 的子類，其構造方法也是類似的。JPasswordField 提供了 setEchoChar(char ch) 方法設置爲了隱藏密碼而顯示的字符，默認爲 '*' 字符，上例中則設置爲了 '#' 字符 (pwdField.setEchoChar('#');)。與 JTextField 一樣，JPasswordField 也用 getText 方法和 setText 獲得或者設置文本內容 (當然在用戶界面上是隱藏的)。
JTextField 是單行文本框，不能顯示多行文本，如果想要顯示多行文本，就只好使用多行文本框 JTextArea 了。JTextArea 有六個構造方法，常用的也是四個：
JTextArea()
JTextArea(int rows, int columns)
JTextArea(String text)
JTextArea(String text, int rows, int columns)
text 爲 JTextArea 的初始化文本內容；rows 爲 JTextArea 的高度，以行爲單位；columns 爲 JTextArea 的寬度，以字符爲單位。如上例中就構造了一個高 5 行，寬 15 個字符的多行文本框 (textArea = new JTextArea(5, 15);)。
多行文本框默認是不會自動折行的 (不過可以輸入回車符換行)，我們可以使用 JTextArea 的 setLineWrap 方法設置是否允許自動折行。setLineWrap(true) 是允許自動折行，setLineWrap(false) 則是不允許自動折行。多行文本框會根據用戶輸入的內容自動擴展大小，不信，自己做個實驗——如果不自動折行，那麼多行文本框的寬度由最長的一行文字確定的；如果行數據超過了預設的行數，則多行文本框會擴展自身的高度去適應。換句話說，多行文本框不會自動產生滾動條。怎麼辦？後面講到滾動窗格
(JScrollPane) 的時候，你就知道了。
多行文本框裏文本內容的獲得和設置，同樣可以使用 getText 和 setText 兩個方法來完成。
五. 窗格、滾動窗格和佈局管理
窗格 (JPanel) 和滾動窗格 (JScrollPane) 在圖形用戶界面設計中大量用於各種組件在窗口上的佈置和安排。這裏所謂的佈置和安排，就是佈局 (Layout)，因此不得不先說說佈局。
將加入到容器(通常爲窗口等) 的組件按照一定的順序和規則放置，使之看起來更美觀，這就是佈局。佈局由佈局管理器 (Layout Manager) 來管理。那麼，我們在什麼時候應該使用佈局管理器？應用選擇哪種佈局管理器？又該怎樣使用佈局管理器呢？
往往，我們設計一個窗口，其中是要添加若干組件的。爲了管理好這些管理的佈局，我們就要使用佈局管理器。比如說，設計一個簡單的編輯器，這個編輯器中只需要放置兩個按鈕和一個多行文本框。這些組件是讓 Java 自己任意安排呢？還是按照一定的位置關係較規範的安排呢？當然應該選擇後者。那麼，爲了按照一定的位置關係安排這些組件，我們就需要用到佈局管理器了。
然後我們遇到了一個選擇題——使用哪種佈局管理器。爲此，我們首先要知道有些什麼佈局管理器，它們的佈局特點是什麼。常用的佈局管理器有： FlowLayout、BorderLayout、GridLayout、BoxLayout 等，其中 FlowLayout 和 BorderLayout 最常用，本文主要也就只談談這兩種佈局管理器。下面列表說明它們的佈局特點：
就上述的編輯器爲例，如果選用 FlowLayout，那麼兩個按鈕和一個多行文本框就會排列在一行——當然這是窗口足夠寬的情況；如果窗口稍窄一些，則可能分兩行排列，第一行有兩個按鈕，而第二行是多行文本框——這是最理想的情況；如果窗口再窄一些，就可能分三行排列，第一行和第二行分別放置一個按鈕，第三行放置多行文本框。因此，如果窗口大小可以改變，那麼三個組件的位置關係也可能隨着窗口大小的變化而變化。所以，FlowLayout 不適用。其實上面所舉的例程中，大部分都是用的 FlowLayout，那是因爲我們沒有要求組件的佈局。
如果選用 BorderLayout 的情況又如何呢？我們可以試着加入一個窗格 (JPanel，稍後講解)，並將兩個按鈕放置在其中，然後將這個窗格加入到 BorderLayout 的北部 (即上部)；再將多行文本框加入到 BorderLayout 中部。結果類似使用 FlowLayout 的第二種可能，是最理想的情況。而且，如果改變窗口大小，它們的位置關係仍然是北-中的關係，不會隨之改變。
剩下的兩種佈局管理器，加以窗格 (JPanel) 的配合，也能夠很好的安排上述編輯器所需的三個組件。但是由於它們的使用稍爲複雜一些，所以就不講了。下面就講講如何使用 FlowLayout 和 BorderLayout。
任何佈局管理器，都需要用在容器上，比如 JFrame 的 Content Pane 和下面要說的 JPanel 都是容器。容器組件提供了一個 setLayout 方法，就是用來改變其佈局管理器的。默認情況下，JFrame 的 Content Pane 使用的是 BorderLayout，而 JPanel 使用的是 FlowLayout。但不管怎樣，我們都可以調用它們的 setLayout 方法來改變其佈局管理器。比如上述的編輯器中，我們要讓窗口 (JFrame 對象，假設爲 frame) 使用 BorderLayout，就可以使用
frame.getContentPane().setLayout(new BorderLayout()); 來改變其佈局管理器爲一個新的 BorderLayout 對象。
然後，我們對佈局管理器的直接操作就結束了，剩下的只需要往容器裏添加組件。如果使用 FlowLayout，我們只需要使用容器的 add(Component c) 方法添加組件就行了。但是，如果使用 BorderLayout 就不一樣了，因爲要指定是把組件添加到哪個區域啊。那我們就使用容器的 add(Component c, Object o) 方法添加組件，該方法的第二個參數就是指明添加到的區域用的。例如，上述編輯器中要添加一個多行文本框到 BorderLayout 的中部，就可以用 frame.getContentPane().add(new
JTextArea(5, 15), BorderLayout.CENTER) 來實現。
BorderLayout 的五個區域分別是用下列五個常量來描述的：
BorderLayout.EAST 東
BorderLayout.SOUTH 南
BorderLayout.WEST 西
BorderLayout.NORTH 北
BorderLayout.CENTER 中
剛纔已經提到了使用 JPanel。JPanel 作爲一個容器，可以包容一些組件，然後將這個 JPanel 對象作爲一個組件添加到另一個容器 (稱作父容器) 中。這個功能有什麼好處呢？
上面不是提到 BorderLayout 的一個區域中只能添加一個組件嗎？但是我們的編輯器需要添加兩個按鈕到它的北部，怎麼辦？上面的例子中，我們就是用的一個 JPanel 包容了這兩個按鈕，然後再將這個 JPanel 對象作爲一個組件添加到設置佈局管理器爲 BorderLayout 的 Content Pane 中。
上面說到各佈局管理器的佈局特點的時候，幾乎每一種都是一個區域只能添加一個組件，那我們想添加多個組件到一個區域的時候，就要用到 JPanel 了。如果還沒有明白，稍後看一段程序可能更易於理解。