Swing 元件速用表

JComponent（通用元件）

JComponent 是 Swing 圖型元件共同繼承的元件，使每個元件有共通的操作方式，因此放在前面最先參考。

void

add(Component)
加入元件。

float

getAlignmentX()
取得水平方向的對齊方式，0.0 為左，0.5 為中，1.0 為右。

float

getAlignmentY()
取得垂直方向的對齊方式，0.0 為上，0.5 為中，1.0 為下。

Component

getComponentAt(int x, int y)
檢查座標位置使否有元件，有的話傳回該元件。

Component

getComponentAt(Point)
檢查座標位置使否有元件，有的話傳回該元件。

Graphics

getComponentGraphics(Graphics)
將元件的外貌以圖形傳回。

Locale

getDefaultLocale()
取得時區語系。

Graphics

getGraphics()
取得繪圖區間。

int

getHeight()
取得高度。

Point

getLocation(Point)
取得左上角座標位置。

String

getName()
取得名稱。

JRootPane

getRootPane()
傳回 JRootPane。

Dimension

getSize()
取得目前尺寸。

Rectangle

getVisibleRect()
取得可見的矩形範圍。

int

getWidth()
取得寬度。

int

getX()
取得水平座標位置。

int

getY()
取得垂直座標位置。

void

invalidate()
使元件無效。

boolean

isDisplayable()
元件是否為可見的；有些元件看不到，例如計時器。

boolean

isEnabled()
元件是否已經啟用。

boolean

isShowing()
元件是否已經顯示。

boolean

isValid()
元件是否有效。

void

paint(Graphics)
繪圖區間繪製。

void

remove(Component)
移除所指定元件。

void

removeAll()
移除所有加入的元件。

void

removeNotify()
銷毀元件。

void

repaint()
重新繪製。

void

requestFocus()
請求獲得駐點。

void

revalidate()
使元件重新生效；相當於先 invalidate() 再 validate()。

void

setAlignmentX(float)
設定水平方向的對齊方式，0.0 為左，0.5 為中，1.0 為右。

void

setAlignmentY(float)
設定垂直方向的對齊方式，0.0 為上，0.5 為中，1.0 為下。

void

setBackground(Color)
設定背景顏色。

void

setBounds(int x, int y, int w, int h)
設定尺寸與位置。

void

setBorder(Border)
設定邊框樣式

void

setCursor(Cursor)
設定滑鼠游標。

void

setDefaultLocale(Locale)
設定時區語系。

void

setDoubleBuffered(boolean)
設定雙重緩衝繪圖機制。

void

setEnabled(boolean)
設定物件是否啟用。

void

setFont(Font)
設定字型。

void

setForeground(Color)
設定前景顏色。

void

setLayout(LayoutManager)
設定元件排列模式。

void

setName(String)
為元件命名。

void

setOpaque(boolean)
設定是否繪製邊界內的像素；設為 false 的話有透明效果。

void

setSize(int w, int h)
設定長寬尺寸。

void

setToolTipText(String)
設定提示文字。

void

setUI(ComponentUI)
設定物件外觀。

void

setVisible(boolean)
設定物件是顯示或隱藏。

void

updateUI()
更新物件的外觀。

void

update(Graphics)
更新物件的顯示狀態。

void

validate()
使元件生效。

JButton（按鈕）

void

setDisabledIcon(Icon)
設定無作用時的圖案。

void

setHorizontalAlignment(int)
設定標籤位置的水平對齊方式：
SwingConstants.BOTTOM（往下對齊）
SwingConstants.CENTER（置中對齊）
SwingConstants.TOP（往上對齊）

void

setHorizontalTextPosition(int)
設定文字相對於圖案的水平位置關係。

void

setIcon(Icon)
設定圖案。

void

setIconTextGap(int)
設定文字與圖案的間距。

void

setMargin(Insets)
設定間距。

void

setPressedIcon(Icon)
設定按下時的圖案。

void

setRolloverIcon(Icon)
設定滑鼠經過時的圖案。

void

setText(String)
設定文字內容；支援部分 HTML 語法。

void

setVerticalAlignment(int)
設定標籤位置的垂直對齊方式：
SwingConstants.CENTER（置中對齊）
SwingConstants.LEFT（向左對齊）
SwingConstants.RIGHT（向右對齊）

void

setVerticalTextPosition(int)
設定文字相對於圖案的垂直位置關係。

JCheckBox（核取方塊）

boolean

isSelected()
是否被選取。

void

setDisabledIcon(Icon)
設定無作用時的圖案。

void

setHorizontalAlignment(int)
設定標籤位置的水平對齊方式：
SwingConstants.CENTER（置中對齊）
SwingConstants.LEFT（向左對齊）
SwingConstants.RIGHT（向右對齊）

void

setHorizontalTextPosition(int)
設定文字相對於圖案的水平位置關係。

void

setIcon(Icon)
設定圖案。

void

setIconTextGap(int)
設定文字與圖案的間距。

void

setMargin(Insets)
設定間距。

void

setPressedIcon(Icon)
設定按下時的圖案。

void

setRolloverIcon(Icon)
設定滑鼠經過時的圖案。

void

setSelected(boolean)
設定是否被選取。

void

setSelectedIcon(Icon)
設定被選取時的圖案。

void

setText(String)
設定文字內容；支援部分 HTML 語法。

void

setVerticalAlignment(int)
設定標籤位置的垂直對齊方式：
SwingConstants.BOTTOM（往下對齊）
SwingConstants.CENTER（置中對齊）
SwingConstants.TOP（往上對齊）

void

setVerticalTextPosition(int)
設定文字相對於圖案的垂直位置關係。

通常核取方塊的應用場合，是允許在整群項目中複選多個出來。

JColorChooser（色彩選擇器）

Color

showDialog(Component, String, Color)
顯示選擇器。

JComboBox<E>（下拉式清單）

void

addItem(E)
新增項目。

getItemAt(int)
依索引值取得項目。

int

getItemCount
取得項目總數

int

getSelectedIndex()
取得被選取項目的索引值。

getSelectedItem()
取得被選取的項目。

void

insertItemAt(E, int)
插入項目。

void

removeAllItems()
清除所有項目。

void

removeItem(E)
移除項目。

void

removiItemAt(int)
依索引值移除項目。

void

setEditable(boolean)
設定是否能編輯清單中的項目。

JDesktopPane（桌面）

void

add(Component)
加入 JInternalFrame。

JInternalFrame[]

getAllFrames()
取得所有視窗。

JInternalFrame

getSelectedFrame()
取得正被使用的視窗。

void

remove(int)
移除第幾個視窗。

void

setComponentZOrder(Component, int)
設定視窗的重疊位置。

void

setSelectedFrame(JInternalFrame)
設定哪個視窗獲得駐點。

JEditorPane（圖文編輯器）

void

copy()
複製文字內容到剪貼簿。

void

cut()
剪下文字內容到剪貼簿。

Document

getDocument()
取得文件內容模型，藉以編輯文字。

int

getSelectionEnd(int)
取得選取文字的結束位置。

int

getSelectionStart(int)
取得選取文字的起點位置。

String

getSelectedText()
取得選取中的文字內容。

String

getText()
取得文字內容。

boolean

isEditable()
是否可編輯。

void

paste()
從剪貼簿貼上文字內容。

void

replaceSelection(String)
取代所選取文字的內容。

void

select(int start, int end)
選取指定範圍內的文字內容。

void

selectAll()
選取全部文字內容。

void

setEditable(boolean)
設定是否可輸入文字。

void

setHorizontalAlignment(int)
設定文字對齊方式。

void

setText(String)
設定文字內容。

JFileChooser（檔案選擇器）

File

getSelectedFile()
取得檔案。

File[]

getSelectedFiles()
取得多個檔案。

void

setCurrentDirectory(File)
設定預設的資料夾位置。

void

setSelectedFile(File)
設定預設的檔案。

void

setMultiSelectionEnabled(boolean)
設定是否選取多個檔案。

int

showOpenDialog(Component)
顯示開啟檔案視窗。

int

showSaveDialog(Component)
顯示儲存檔案視窗。

JFormattedTextField（格式化輸入欄；驗證型輸入欄）

建構式

JFormattedTextField(Format)
可用 java.text.DateFormat（日期）或 java.text.NumberFormat（數字）的 getInstance() 來建立格式。

Object

getValue()
取得輸入內容。

boolean

isEditValid()
檢查所輸入資料是否符合驗證。

void

setFocusLostBehavior(int)
設置為 JFormattedTextField.COMMIT 的話，不會清除驗證錯誤的資料。

void

setValue(Object)
設定輸入內容。

如果輸入的資料不符合格式，會自動清除或還原。而且會根據所指定的格式，改變資料的顯示方式，例如數字每三位數用 , 符號標示。

JFrame（視窗）

Component

getGlassPane()
取得容器的表層。

Container

getContentPane()
取得容器。

JLayeredPane

getLayeredPane()
取得疊層容器。

void

setIconImage(Image)
設定視窗標題列小圖示。

void

setJMenuBar(JMenuBar)
設定功能表。

void

setResizable(boolean)
是否可調整尺寸

JInternalFrame（子視窗）

void

setFrameIcon(Icon)
設定視窗標題列小圖示。

boolean

isClosed()
視窗是否已關閉。

void

moveToBack()
移到後面。

void

moveToFront()
移到前面。

void

reshape(int x, int y, int w, int h)
重新調整視窗位置與大小。

void

setClosable(boolean)
是否提供關閉鈕。

void

setIconifiable(boolean)
是否提供最小化鈕。

void

setJMenuBar(JMenuBar)
設定功能表。

void

setMaximizable(boolean)
是否提供最大化鈕。

void

setResizable(boolean)
是否可調整尺寸

JLabel（標籤）

Icon

getIcon()
取得圖案。

String

getText()
取得文字內容。

void

setDisplayedMnemonic(char)
設定哪個字做為 Alt+Key 快捷鍵記號。

void

setHorizontalAlignment(int)
設定標籤位置的水平對齊方式。

void

setHorizontalTextPosition(int)
設定文字相對於圖案的水平位置關係。

void

setIcon(Icon)
設定圖案。

void

setIconTextGap(int)
設定文字與圖案的間距。

void

setLabelFor(Component)
設定哪個元件做為快捷鍵對象。

void

setText(String)
設定文字內容；支援部分 HTML 語法。

void

setVerticalAlignment(int)
設定標籤位置的垂直對齊方式。

void

setVerticalTextPosition(int)
設定文字相對於圖案的垂直位置關係。

JLabel 並不只是文字標籤而已，也可以當作圖案貼紙。此外還具備使用 HTML 語法來展現文字的能力，以及輔助其它元件關聯到快捷鍵的功能。

JLayeredPane（疊層）

void	add(Component, int) 將 Component 加入為第 int 層元件。

JList<E>（清單）

int

getSelectedIndex()
取得目前所選擇項目的索引值。

int[]

getSelectedIndices()
取得所有選擇項目的索引值。

Object

getSelectedValue()
取得目前所選擇的項目。

Object[]

getSelectedValues()
取得所有選擇的項目。

void

setSelectionBackground(Color)
設定選擇項目時的背景顏色。

void

setSelectionForeground(Color)
設定選擇項目時的文字顏色。

void

setSelectionInterval(int start, int end)
設定連續選擇的項目。

void

setSelectionMode(int)
設定選擇模式，可用 javax.swing.ListSelectionModel 的常數來指定：
SINGLE_SELECTION（單選）
SINGLE_INTERVAL_SELECTION（連續選擇）
MULTIPLE_INTERVAL_SELECTION（跳躍選擇）

void

setSelectedIndex(int)
設定選擇第幾個項目。

void

setSelectedIndices(int[])
設定選擇哪幾個項目。

void

setSelectedValue(Object, boolean)
選擇指定的項目。

void

setVisibleRowCount(int)
設定清單每次可檢視的欄位數。

void

setLayoutOrientation(int)
設定清單項目的排列方式，可用 JLsit 本身的常數來指定：
HORIZONTAL_WRAP（跨頁式水平排列）
VERTICAL（垂直排列）
VERTICAL_WRAP（跨頁式垂直排列）

void

setListDate(Object[])
選擇多個項目。

通常搭配 JScrollPane 來捲動。

JMenu（選單）

JMenuItem

add(Action)
用動作加入選單項目。

void

add(JMenuItem)
加入選單項目。

JMenuItem

add(String)
用文字加入選單項目。

void

addSeparator()
加入分隔線。

JMenuBar（功能表）

void

add(JMenu)
加入選單。

void

setMargin(Insets)
設定間距。

JMenuItem（選單項目）

建構式

JMenuItem(Icon)
用圖示建立選單項目。

建構式

JMenuItem(String)
用文字建立選單項目。

建構式

JMenuItem(String, Icon)
用文字與圖示建立選單項目。

void

setAccelerator(KeyStroke)
設置快捷鍵。

void

setAction(Action)
連結事件。

JOptionPane（選項視窗）

int

showConfirmDialog(Component, Object, String, int)
顯示確認對話視窗。

String

showInputDialog(Component, Object, String, int)
顯示輸入對話視窗。

void

showMessageDialog(Component, Object, String, int)
顯示訊息對話視窗。

JPanel（元件容器；子面板）

看似沒有自己獨特的操作方式，用 setLayout() 決定元件排版模式，然後用 add() 加入元件，再用 setBounds() 設定好尺寸位置，最後加入到 JFrame 裡面，感覺很普通。

但管理一群 Swing 的圖形元件時，就像子面板一樣非常好用。例如整群按鈕先用 JPanel 放在一塊，再加入到視窗，不僅日後更方便管理這些按鈕的排列，也能一次決定這整塊元件的去向。

或者你想設計一個日曆或時鐘，就先把所有用到的元件都設計在 JPanel 裡面，日後再整塊 JPanel 拿來用，就是你專屬的 JCalendar 或 JClock 了。

JPasswordField（密碼輸入欄）

String

getPassword()
取得所輸入的密碼。

void

setEchoChar(char)
設定遮蔽符號。

JPopupMenu（滑鼠右鍵選單）

JMenuItem

add(Action)
依動作加入項目。

JMenuItem

add(JMenuItem)
加入 JMenuItem。

JMenuItem

add(String)
加入文字。

void

addSeparator()
加入分隔線。

void

show(Component, int x, int y)
顯示選單。

JProgressBar（進度列）

int

getValue()
取得當前的值。

void

setMaximum(int)
設定最大值。

void

setMinimum(int)
設定最小值。

void

setOrientation(int)
設定為水平顯示或垂直顯示：
SwingConstants.HORIZONTAL（水平）
SwingConstants.VERTICAL（垂直）

void

setValue(int)
設定當前的值

JRadioButton（圈選按鈕）

boolean

isSelected()
是否被選取。

void

setDisabledIcon(Icon)
設定無作用時的圖案。

void

setHorizontalAlignment(int)
設定標籤位置的水平對齊方式：
SwingConstants.CENTER（置中對齊）
SwingConstants.LEFT（向左對齊）
SwingConstants.RIGHT（向右對齊）

void

setHorizontalTextPosition(int)
設定文字相對於圖案的水平位置關係。

void

setIcon(Icon)
設定圖案。

void

setIconTextGap(int)
設定文字與圖案的間距。

void

setMargin(Insets)
設定間距。

void

setPressedIcon(Icon)
設定按下時的圖案。

void

setRolloverIcon(Icon)
設定滑鼠經過時的圖案。

void

setSelected(boolean)
設定是否被選取。

void

setSelectedIcon(Icon)
設定被選取時的圖案。

void

setText(String)
設定文字內容；支援部分 HTML 語法。

void

setVerticalAlignment(int)
設定標籤位置的垂直對齊方式：
SwingConstants.BOTTOM（往下對齊）
SwingConstants.CENTER（置中對齊）
SwingConstants.TOP（往上對齊）

void

setVerticalTextPosition(int)
設定文字相對於圖案的垂直位置關係。

通常圈選按鈕的應用場合，是在整群項目中，只能單選一個出來。

JRootPane（表面容器）

void	setDefaultButton(JButton) 設定預設按鈕，按 Enter 時直接觸發。

JScrollPane（捲動軸）

void

setVerticalScrollBarPolicy(int)
設定垂直捲動軸出現的時機：
JScrollPane.HORIZONTAL_SCROLLBAR_ALWAYS（顯示）
JScrollPane.HORIZONTAL_SCROLLBAR_AS_NEEDED（自動）
JScrollPane.HORIZONTAL_SCROLLBAR_NEVER（隱藏）

void

setHorizontalScrollBarPolicy(int)
設定水平捲動軸出現的時機：
JScrollPane.VERTICAL_SCROLLBAR_ALWAYS（顯示）
JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED（自動）
JScrollPane.VERTICAL_SCROLLBAR_NEVER（隱藏）

void

setViewportView(Component)
設置元件。

JSeparator（線段）

void	setOrientation(int) 設定為水平線段或垂直線段： SwingConstants.HORIZONTAL（水平） SwingConstants.VERTICAL（垂直）

JSlider（滑動桿；刻度列）

int

getValue()
取得當前的值。

void

setMaximum(int)
設定最大值。

void

setMinimum(int)
設定最小值。

void

setOrientation(int)
設定為水平顯示或垂直顯示：
SwingConstants.HORIZONTAL（水平）
SwingConstants.VERTICAL（垂直）

void

setValue(int)
設定當前的值

JSpinner（微調器）

（略）

JSplitPane（分割板）

建構式

JSplitPane(int)
建立分割板同時指定排列方式：
JSplitPane.HORIZONTAL_SPLIT（水平）
JSplitPane.VERTICAL_SPLIT（垂直）
雖然有 setOrientation() 可以事後指定，但建構式比較不會出錯。

void

resetToPreferredSizes()
重新排列面板尺寸。

void

setDividerLocation(double)
設定分隔軸的原點位置。

void

setDividerSize(int)
設定分隔軸的寬度。

void

setOneTouchExpandable(boolean)
是否可以展開與收起。

JTabbedPane（分頁）

void

add(String, Component)
新增頁籤，並加入元件。

int

getTabCount()
取得分頁數量。

void

remove(int)
移除第幾個頁籤。

void

setSelectedIndex(int)
跳到第幾個頁籤。

void

setTabPlacement(int)
設定頁籤標題的位置：
SwingConstants.BOTTOM（下）
SwingConstants.LEFT（左）
SwingConstants.RIGHT（右）
SwingConstants.TOP（上）

void

setTitleAt(int, String)
修改頁籤名稱。

JTable（表格）

操作複雜，請參考《JTable》的範例。

JTextArea（純文字編輯器；多行）

void

copy()
複製文字內容到剪貼簿。

void

cut()
剪下文字內容到剪貼簿。

int

getSelectionEnd(int)
取得選取文字的結束位置。

int

getSelectionStart(int)
取得選取文字的起點位置。

String

getSelectedText()
取得選取中的文字內容。

String

getText()
取得文字內容。

boolean

isEditable()
是否可編輯。

void

paste()
從剪貼簿貼上文字內容。

void

replaceSelection(String)
取代所選取文字的內容。

void

select(int start, int end)
選取指定範圍內的文字內容。

void

selectAll()
選取全部文字內容。

void

setEditable(boolean)
設定是否可輸入文字。

void

setHorizontalAlignment(int)
設定文字對齊方式。

void

setText(String)
設定文字內容。

JTextField（文字輸入欄；單行）

String

getText()
取得文字內容。

void

setColumns(int)
設定欄位寬度，即可輸入的字元數。

void

setText(String)
設定文字內容。

JTextPane（圖文容器）

void

copy()
複製文字內容到剪貼簿。

void

cut()
剪下文字內容到剪貼簿。

Document

getDocument()
取得文件內容模型，藉以編輯文字。

int

getSelectionEnd(int)
取得選取文字的結束位置。

int

getSelectionStart(int)
取得選取文字的起點位置。

String

getSelectedText()
取得選取中的文字內容。

String

getText()
取得文字內容。

boolean

isEditable()
是否可編輯。

void

paste()
從剪貼簿貼上文字內容。

void

replaceSelection(String)
取代所選取文字的內容。

void

select(int start, int end)
選取指定範圍內的文字內容。

void

selectAll()
選取全部文字內容。

void

setEditable(boolean)
設定是否可輸入文字。

void

setHorizontalAlignment(int)
設定文字對齊方式。

void

setText(String)
設定文字內容。

JToggleButton（開關式按鈕）

boolean

isSelected()
是否被選取。

void

setDisabledIcon(Icon)
設定無作用時的圖案。

void

setHorizontalAlignment(int)
設定標籤位置的水平對齊方式：
SwingConstants.CENTER（置中對齊）
SwingConstants.LEFT（向左對齊）
SwingConstants.RIGHT（向右對齊）

void

setHorizontalTextPosition(int)
設定文字相對於圖案的水平位置關係。

void

setIcon(Icon)
設定圖案。

void

setIconTextGap(int)
設定文字與圖案的間距。

void

setMargin(Insets)
設定間距。

void

setPressedIcon(Icon)
設定按下時的圖案。

void

setRolloverIcon(Icon)
設定滑鼠經過時的圖案。

void

setSelected(boolean)
設定是否被選取。

void

setSelectedIcon(Icon)
設定被選取時的圖案。

void

setText(String)
設定文字內容；支援部分 HTML 語法。

void

setVerticalAlignment(int)
設定標籤位置的垂直對齊方式：
SwingConstants.BOTTOM（往下對齊）
SwingConstants.CENTER（置中對齊）
SwingConstants.TOP（往上對齊）

void

setVerticalTextPosition(int)
設定文字相對於圖案的垂直位置關係。

JToolBar（工具列）

JButton

add(Action)
依事件加入按鈕。

void

addSeparator()
加入分隔線。

void

addSeparator(Dimension)
加入分隔線到指定位置。

void

setOrientation(int)
設定排列方向：
SwingConstants.HORIZONTAL（水平）
SwingConstants.VERTICAL（垂直）

void

setRollover(boolean)
是否啟用按鈕浮現效果。

void

setFloatable(boolean)
是否啟用工具列浮動效果。

JTree（樹狀表）

（略）

Border（外框）

（略）

ImageIcon（圖案）

建構式	ImageIcon(String) 依 String 所指的路徑與檔案來載入圖片。

Timer（計時器）

建構式	Timer(int, ActionListener) int 毫秒時間後，執行 ActionListener 事件。

ButtonGroup

void

add(ButtonModel)
加入按鈕。

void

clearSelection()
清除所有被選取的按鈕。

int

getButtonCount()
取得被選取的按鈕數目。

Enumeration
<AbstractButton>

getElements()
傳回被選取的按鈕。

ButtonModel

getSelection()
取得被選取的按鈕。

void

setSelected(ButtonModel, boolean)
設定按鈕是否選取。

boolean

isSelected(ButtonModel)
判斷按鈕是否被選取。

void

remove(ButtonModel)
移除按鈕。