javax.swing.table
類別 JTableHeader

java.lang.Object
  java.awt.Component
      java.awt.Container
          javax.swing.JComponent
              javax.swing.table.JTableHeader

所有已實作的介面：

ImageObserver, MenuContainer, Serializable, EventListener, Accessible, TableColumnModelListener

public class JTableHeader
extends JComponent
implements TableColumnModelListener, Accessible

這是管理 JTable 的頭的物件。

警告：此類別的已序列化物件與以後的 Swing 版本不相容。當前的序列化支持適用於短期存儲或運行相同 Swing 版本的應用程序之間的 RMI。從 1.4 版本開始，已在 java.beans 套件中添加了支持所有 JavaBeans^TM 長期存儲的功能。請參見 XMLEncoder。

另請參見：

JTable

巢狀類別摘要

protected class

JTableHeader.AccessibleJTableHeader 此類別實作對 JTableHeader 類別的可存取性支持。

從類別 javax.swing.JComponent 繼承的巢狀類別/介面

JComponent.AccessibleJComponent

從類別 java.awt.Container 繼承的巢狀類別/介面

Container.AccessibleAWTContainer

從類別 java.awt.Component 繼承的巢狀類別/介面

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

欄位摘要

protected TableColumnModel	columnModel 表頭的 TableColumnModel。
protected TableColumn	draggedColumn 被拖動列的索引。
protected int	draggedDistance 列被拖離其初始位置的距離。
protected boolean	reorderingAllowed 如果為 true，則允許使用者重新排序各列；預設值為 true。
protected boolean	resizingAllowed 如果為 true，則允許使用者調整各列的大小；預設值為 true。
protected TableColumn	resizingColumn 進行大小調整的列的索引。
protected JTable	table 將此物件作為其頭的表，預設值為 null。
protected boolean	updateTableInRealTime 從 Java 2 platform v1.3 開始已過時。

從類別 javax.swing.JComponent 繼承的欄位

accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

從類別 java.awt.Component 繼承的欄位

BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

從介面 java.awt.image.ImageObserver 繼承的欄位

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

建構子摘要

JTableHeader()
建構具有預設 TableColumnModel 的 JTableHeader。

JTableHeader(TableColumnModel cm)
建構 JTableHeader，使用 cm 作為列模型對其進行初始化。

方法摘要

void	columnAdded(TableColumnModelEvent e) 將列添加到表列模型時調用。
int	columnAtPoint(Point point) 返回該 point 所處列的索引，如果列位於邊界外，則返回 -1。
void	columnMarginChanged(ChangeEvent e) 當列由於間距改變而被移動時調用。
void	columnMoved(TableColumnModelEvent e) 重新定位列時調用。
void	columnRemoved(TableColumnModelEvent e) 從表列模型中移除列時調用。
void	columnSelectionChanged(ListSelectionEvent e) 當 TableColumnModel 的選擇模型更改時調用。
protected TableColumnModel	createDefaultColumnModel() 返回預設的列模型物件，它是 DefaultTableColumnModel。
protected TableCellRenderer	createDefaultRenderer() 返回 TableColumn 未定義頭渲染器時所使用的預設渲染器。
AccessibleContext	getAccessibleContext() 獲取與此 JTableHeader 關聯的 AccessibleContext。
TableColumnModel	getColumnModel() 返回包含此表頭所有列資訊的 TableColumnModel。
TableCellRenderer	getDefaultRenderer() 返回 TableColumn 未定義 headerRenderer 時所使用的預設渲染器。
TableColumn	getDraggedColumn() 當且僅當正在進行拖動時，返回被拖動的列，否則返回 null。
int	getDraggedDistance() 當且僅當正在進行拖動時，返回該列到其初始位置的水平距離。
Rectangle	getHeaderRect(int column) 返回包含 column 處頭 tile 的矩形。
boolean	getReorderingAllowed() 如果允許使用者通過拖動各列的頭對其進行重新安排，則返回 true；否則返回 false。
boolean	getResizingAllowed() 如果允許使用者通過在頭間拖動來調整各列的大小，則返回 true；否則返回 false。
TableColumn	getResizingColumn() 返回正在調整其大小的列。
JTable	getTable() 返回與此頭關聯的表。
String	getToolTipText(MouseEvent event) 如果設置了提示文本，則允許使用渲染器的提示。
TableHeaderUI	getUI() 返回渲染此元件的外觀 (L&F) 物件。
String	getUIClassID() 返回用於建構外觀 (L&F) 類別名稱的後綴，該類別用於渲染此元件。
boolean	getUpdateTableInRealTime() 從 Java 2 platform v1.3 開始已過時。
protected void	initializeLocalVars() 使用預設值初始化區域變數和屬性。
protected String	paramString() 返回此 JTableHeader 的字元串表示形式。
void	resizeAndRepaint() 確定頭的大小並將其標記為需要顯示。
void	setColumnModel(TableColumnModel columnModel) 將此表的列模型設置為 newModel，並向偵聽器註冊來自新列模型的通知。
void	setDefaultRenderer(TableCellRenderer defaultRenderer) 設置 TableColumn 未定義 headerRenderer 時所使用的預設渲染器。
void	setDraggedColumn(TableColumn aColumn) 將頭的 draggedColumn 設置為 aColumn。
void	setDraggedDistance(int distance) 將頭的 draggedDistance 設置為 distance。
void	setReorderingAllowed(boolean reorderingAllowed) 設置使用者是否可以拖動列頭，以重新排序各列。
void	setResizingAllowed(boolean resizingAllowed) 設置使用者是否可以通過在頭間拖動來調整各列的大小。
void	setResizingColumn(TableColumn aColumn) 將頭的 resizingColumn 設置為 aColumn。
void	setTable(JTable table) 設置與此頭關聯的表。
void	setUI(TableHeaderUI ui) 設置渲染此元件的 (L&F) 物件。
void	setUpdateTableInRealTime(boolean flag) 從 Java 2 platform v1.3 開始已過時。
void	updateUI() UIManager 發出的關於 L&F 已更改的通知。

從類別 javax.swing.JComponent 繼承的方法

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

從類別 java.awt.Container 繼承的方法

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusBackward, transferFocusDownCycle, validate, validateTree

從類別 java.awt.Component 繼承的方法

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusUpCycle

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

欄位詳細資訊

table

protected JTable table

將此物件作為其頭的表，預設值為 null。

columnModel

protected TableColumnModel columnModel

表頭的 TableColumnModel。

reorderingAllowed

protected boolean reorderingAllowed

如果為 true，則允許使用者重新排序各列；預設值為 true。

resizingAllowed

protected boolean resizingAllowed

如果為 true，則允許使用者調整各列的大小；預設值為 true。

updateTableInRealTime

protected boolean updateTableInRealTime

從 Java 2 platform v1.3 開始已過時。為回應列拖動或調整大小而進行的實時重新繪製現在是無條件的。

resizingColumn

protected transient TableColumn resizingColumn

進行大小調整的列的索引。如果未調整大小，則為 null。

draggedColumn

protected transient TableColumn draggedColumn

被拖動列的索引。如果未拖動，則為 null。

draggedDistance

protected transient int draggedDistance

列被拖離其初始位置的距離。

建構子詳細資訊

JTableHeader

public JTableHeader()

建構具有預設 TableColumnModel 的 JTableHeader。

另請參見：

createDefaultColumnModel()

JTableHeader

public JTableHeader(TableColumnModel cm)

建構 JTableHeader，使用 cm 作為列模型對其進行初始化。如果 cm 為 null，則此方法將使用預設的 TableColumnModel 來初始化其表頭。

參數：

cm - 該表的列模型

另請參見：

createDefaultColumnModel()

方法詳細資訊

setTable

public void setTable(JTable table)

設置與此頭關聯的表。

參數：

table - 新表

getTable

public JTable getTable()

返回與此頭關聯的表。

返回：

table 屬性

setReorderingAllowed

public void setReorderingAllowed(boolean reorderingAllowed)

設置使用者是否可以拖動列頭，以重新排序各列。

參數：

reorderingAllowed - 如果表視圖應該允許重新排序，則為 true；否則為 false

另請參見：

getReorderingAllowed()

getReorderingAllowed

public boolean getReorderingAllowed()

如果允許使用者通過拖動各列的頭對其進行重新安排，則返回 true；否則返回 false。預設值為 true。無論此設置為多少都可以通過程式方式重新安排各列。

返回：

reorderingAllowed 屬性

另請參見：

setReorderingAllowed(boolean)

setResizingAllowed

public void setResizingAllowed(boolean resizingAllowed)

設置使用者是否可以通過在頭間拖動來調整各列的大小。

參數：

resizingAllowed - 如果表視圖應該允許調整大小，則為 true

另請參見：

getResizingAllowed()

getResizingAllowed

public boolean getResizingAllowed()

如果允許使用者通過在頭間拖動來調整各列的大小，則返回 true；否則返回 false。預設值為 true。無論此設置為多少都可以通過程式方式重新安排各列。

返回：

resizingAllowed 屬性

另請參見：

setResizingAllowed(boolean)

getDraggedColumn

public TableColumn getDraggedColumn()

當且僅當正在進行拖動時，返回被拖動的列，否則返回 null。

返回：

如果正在進行拖動，則返回被拖動的列；否則返回 null

另請參見：

getDraggedDistance()

getDraggedDistance

public int getDraggedDistance()

當且僅當正在進行拖動時，返回該列到其初始位置的水平距離。否則返回值無意義。

返回：

當且僅當正在進行拖動時，返回該列到其初始位置的水平距離；否則返回值無意義

另請參見：

getDraggedColumn()

getResizingColumn

public TableColumn getResizingColumn()

返回正在調整其大小的列。如果未調整列的大小，則此方法返回 null。

返回：

如果正在進行大小調整，則返回調整其大小的列；否則返回 null

setUpdateTableInRealTime

public void setUpdateTableInRealTime(boolean flag)

從 Java 2 platform v1.3 開始已過時。為回應列拖動或調整大小而進行的實時重新繪製現在是無條件的。

getUpdateTableInRealTime

public boolean getUpdateTableInRealTime()

從 Java 2 platform v1.3 開始已過時。為回應列拖動或調整大小而進行的實時重新繪製現在是無條件的。

setDefaultRenderer

public void setDefaultRenderer(TableCellRenderer defaultRenderer)

設置 TableColumn 未定義 headerRenderer 時所使用的預設渲染器。

參數：

defaultRenderer - 預設渲染器

從以下版本開始：

1.3

getDefaultRenderer

public TableCellRenderer getDefaultRenderer()

返回 TableColumn 未定義 headerRenderer 時所使用的預設渲染器。

返回：

預設渲染器

從以下版本開始：

1.3

columnAtPoint

public int columnAtPoint(Point point)

返回該 point 所處列的索引，如果列位於邊界外，則返回 -1。

返回：

該 point 所處列的索引，如果列位於邊界外，則返回 -1

getHeaderRect

public Rectangle getHeaderRect(int column)

返回包含 column 處頭 tile 的矩形。column 參數超出範圍時，此方法使用與 JTable 的 getCellRect 方法相同的約定。

返回：

包含 column 處頭 tile 的矩形

另請參見：

JTable.getCellRect(int, int, boolean)

getToolTipText

public String getToolTipText(MouseEvent event)

如果設置了提示文本，則允許使用渲染器的提示。

覆寫：

類別 JComponent 中的 getToolTipText

參數：

event - 標識正確渲染器和正確提示的事件位置

返回：

此元件的工具提示

getUI

public TableHeaderUI getUI()

返回渲染此元件的外觀 (L&F) 物件。

返回：

渲染此元件的 TableHeaderUI 物件

setUI

public void setUI(TableHeaderUI ui)

設置渲染此元件的 (L&F) 物件。

參數：

ui - TableHeaderUI L&F 物件

另請參見：

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

UIManager 發出的關於 L&F 已更改的通知。用來自 UIManager 的最新版本 UI 物件替換當前的 UI 物件。

覆寫：

類別 JComponent 中的 updateUI

另請參見：

JComponent.updateUI()

getUIClassID

public String getUIClassID()

返回用於建構外觀 (L&F) 類別名稱的後綴，該類別用於渲染此元件。

覆寫：

類別 JComponent 中的 getUIClassID

返回：

"TableHeaderUI" 字元串

另請參見：

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

setColumnModel

public void setColumnModel(TableColumnModel columnModel)

將此表的列模型設置為 newModel，並向偵聽器註冊來自新列模型的通知。

參數：

columnModel - 此表的新資料源

拋出：

IllegalArgumentException - 如果 newModel 為 null

另請參見：

getColumnModel()

getColumnModel

public TableColumnModel getColumnModel()

返回包含此表頭所有列資訊的 TableColumnModel。

返回：

columnModel 屬性

另請參見：

setColumnModel(javax.swing.table.TableColumnModel)

columnAdded

public void columnAdded(TableColumnModelEvent e)

將列添加到表列模型時調用。

應用程序程式碼不顯式地使用這些方法，它們由 JTable 在內部使用。

指定者：

介面 TableColumnModelListener 中的 columnAdded

參數：

e - 接收到的事件

另請參見：

TableColumnModelListener

columnRemoved

public void columnRemoved(TableColumnModelEvent e)

從表列模型中移除列時調用。

應用程序程式碼不顯式地使用這些方法，它們由 JTable 在內部使用。

指定者：

介面 TableColumnModelListener 中的 columnRemoved

參數：

e - 接收到的事件

另請參見：

TableColumnModelListener

columnMoved

public void columnMoved(TableColumnModelEvent e)

重新定位列時調用。

應用程序程式碼不顯式地使用這些方法，它們由 JTable 在內部使用。

指定者：

介面 TableColumnModelListener 中的 columnMoved

參數：

e - 接收到的事件

另請參見：

TableColumnModelListener

columnMarginChanged

public void columnMarginChanged(ChangeEvent e)

當列由於間距改變而被移動時調用。

應用程序程式碼不顯式地使用這些方法，它們由 JTable 在內部使用。

指定者：

介面 TableColumnModelListener 中的 columnMarginChanged

參數：

e - 接收到的事件

另請參見：

TableColumnModelListener

columnSelectionChanged

public void columnSelectionChanged(ListSelectionEvent e)

當 TableColumnModel 的選擇模型更改時調用。此方法當前無效（不重繪頭）。

應用程序程式碼不顯式地使用這些方法，它們由 JTable 在內部使用。

指定者：

介面 TableColumnModelListener 中的 columnSelectionChanged

參數：

e - 接收到的事件

另請參見：

TableColumnModelListener

createDefaultColumnModel

protected TableColumnModel createDefaultColumnModel()

返回預設的列模型物件，它是 DefaultTableColumnModel。子類別可以覆寫此方法，以返回不同的列模型物件。

返回：

預設的列模型物件

createDefaultRenderer

protected TableCellRenderer createDefaultRenderer()

返回 TableColumn 未定義頭渲染器時所使用的預設渲染器。

返回：

預設的表列渲染器

從以下版本開始：

1.3

initializeLocalVars

protected void initializeLocalVars()

使用預設值初始化區域變數和屬性。由建構子使用。

resizeAndRepaint

public void resizeAndRepaint()

確定頭的大小並將其標記為需要顯示。等效於 revalidate 後跟 repaint。

setDraggedColumn

public void setDraggedColumn(TableColumn aColumn)

將頭的 draggedColumn 設置為 aColumn。

應用程序程式碼不顯式地使用此方法，它們由列拖動機制在內部使用。

參數：

aColumn - 被拖動的列，如果沒有列被拖動，則為 null

setDraggedDistance

public void setDraggedDistance(int distance)

將頭的 draggedDistance 設置為 distance。

參數：

distance - 拖動的距離

setResizingColumn

public void setResizingColumn(TableColumn aColumn)

將頭的 resizingColumn 設置為 aColumn。

應用程序程式碼不顯式地使用此方法，它們由列大小調整機制在內部使用。

參數：

aColumn - 調整其大小的列，如果現在沒有調整列的大小，則為 null

paramString

protected String paramString()

返回此 JTableHeader 的字元串表示形式。此方法僅在進行除錯的時候使用，對於各個實作，所返回字元串的內容和格式可能有所不同。返回的字元串可能為空，但不可能為 null。

覆寫 paramString 以提供有關特定的新的 JFC 元件方面的資訊。

覆寫：

類別 JComponent 中的 paramString

返回：

此 JTableHeader 的字元串表示形式

getAccessibleContext

public AccessibleContext getAccessibleContext()

獲取與此 JTableHeader 關聯的 AccessibleContext。對於 JTableHeaders，AccessibleContext 採用 AccessibleJTableHeader 的形式。如有必要，則會創建一個新的 AccessibleJTableHeader 實例。

指定者：

介面 Accessible 中的 getAccessibleContext

覆寫：

類別 JComponent 中的 getAccessibleContext

返回：

一個 AccessibleJTableHeader，用作此 JTableHeader 的 AccessibleContext