JavaTM 2 Platform
Std. Ed. v1.3

javax.swing.table
クラス JTableHeader

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--javax.swing.table.JTableHeader
すべての実装インタフェース:
Accessible, EventListener, ImageObserver, MenuContainer, Serializable, TableColumnModelListener

public class JTableHeader
extends JComponent
implements TableColumnModelListener, Accessible

JTable のヘッダを管理するオブジェクトです。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。今後の Swing リリースでは、長期間の持続性をサポートする予定です。

関連項目:
JTable, 直列化された形式

内部クラスの概要
protected  class JTableHeader.AccessibleJTableHeader
          このクラスは JTableHeader クラス用のユーザ補助機能のサポートを実装しています。
 
クラス javax.swing.JComponent から継承した内部クラス
JComponent.AccessibleJComponent
 
クラス java.awt.Container から継承した内部クラス
Container.AccessibleAWTContainer
 
クラス java.awt.Component から継承した内部クラス
Component.AccessibleAWTComponent
 
フィールドの概要
protected  TableColumnModel columnModel
          テーブルヘッダの TableColumnModel です。
protected  TableColumn draggedColumn
          ドラッグされている列のインデックスです。
protected  int draggedDistance
          列がドラッグされた元の位置からの距離です。
protected  boolean reorderingAllowed
          true の場合、ユーザが列の順序を変更できます。
protected  boolean resizingAllowed
          true の場合、ユーザによる列のサイズ変更が許可されます。
protected  TableColumn resizingColumn
          サイズ変更されている列のインデックスです。
protected  JTable table
          このオブジェクトがヘッダであるテーブルです。
protected  boolean updateTableInRealTime
          Java 2 プラットフォーム 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()
          デフォルトの TableColumnModelJTableHeader を構築します。
JTableHeader(TableColumnModel cm)
          cm を列モデルとして初期化される JTableHeader を構築します。
 
メソッドの概要
 void columnAdded(TableColumnModelEvent e)
          テーブル列モデルに列が追加されるときに呼び出されます。
 int columnAtPoint(Point point)
          point のある列のインデックスを返します。
 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()
          TableColumnheaderRenderer を定義しないときに使われるデフォルトのレンダリングを返します。
 TableColumn getDraggedColumn()
          ドラッグが進行中の場合は、ドラッグされている列を返します。
 int getDraggedDistance()
          ドラッグが進行中の場合は、元の位置からの列の水平距離を返します。
 Rectangle getHeaderRect(int column)
          column にヘッダタイルがある矩形を返します。
 boolean getReorderingAllowed()
          ユーザがヘッダをドラッグして列の配置のやり直しができる場合に true を返します。
 boolean getResizingAllowed()
          ユーザがヘッダ間をドラッグして列のサイズ変更ができる場合に true を返します。
 TableColumn getResizingColumn()
          サイズ変更されている列を返します。
 JTable getTable()
          このヘッダに関連したテーブルを返します。
 String getToolTipText(MouseEvent event)
          テキストセットがある場合に、レンダリングのヒントとしてそれを使えるようにします。
 TableHeaderUI getUI()
          このコンポーネントを描画する Look & Feel (L&F) オブジェクトを返します。
 String getUIClassID()
          Look & Feel (L&F) クラスの名前の構築に使用された接尾辞を返します。
 boolean getUpdateTableInRealTime()
          Java 2 プラットフォーム v1.3 で廃止されました。
protected  void initializeLocalVars()
          ローカル変数とプロパティをデフォルト値で初期化します。
protected  String paramString()
          この JTableHeader の文字列表現を返します。
 void resizeAndRepaint()
          ヘッダのサイズを指定して、それを要表示としてマークします。
 void setColumnModel(TableColumnModel columnModel)
          このテーブルの列モデルを newModel に設定し、新しい列モデルからのリスナー通知を登録します。
 void setDefaultRenderer(TableCellRenderer defaultRenderer)
          TableColumnheaderRenderer を定義しないときに使われるデフォルトのレンダリングです。
 void setDraggedColumn(TableColumn aColumn)
          ヘッダの draggedColumnaColumn に設定します。
 void setDraggedDistance(int distance)
          ヘッダの draggedDistancedistance に設定します。
 void setReorderingAllowed(boolean reorderingAllowed)
          ユーザが列ヘッダをドラッグして列の順序を変えられるかどうかを設定します。
 void setResizingAllowed(boolean resizingAllowed)
          ユーザがヘッダ間をドラッグして列のサイズを変更できるかどうかを設定します。
 void setResizingColumn(TableColumn aColumn)
          ヘッダの resizingColumnaColumn に設定します。
 void setTable(JTable table)
          このヘッダに関連したテーブルを設定します。
 void setUI(TableHeaderUI ui)
          このコンポーネントを描画する Look & Feel (L&F) オブジェクトを設定します。
 void setUpdateTableInRealTime(boolean flag)
          Java 2 プラットフォーム v1.3 でで廃止されました。
 void updateUI()
          Look &Feel [L&F] が変更されたという UIManager からの通知です。
 
クラス javax.swing.JComponent から継承したメソッド
addAncestorListener, addNotify, addPropertyChangeListener, addPropertyChangeListener, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getVerifyInputWhenFocusTarget, getVisibleRect, getWidth, getX, getY, grabFocus, hasFocus, hide, isDoubleBuffered, isFocusCycleRoot, isFocusTraversable, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processFocusEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDoubleBuffered, setEnabled, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
 
クラス java.awt.Container から継承したメソッド
add, add, add, add, add, addContainerListener, addImpl, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getLayout, insets, invalidate, isAncestorOf, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setLayout, validate, validateTree
 
クラス java.awt.Component から継承したメソッド
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, getBackground, getBounds, getColorModel, getComponentOrientation, getCursor, getDropTarget, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getInputContext, getInputMethodRequests, getLocale, getLocation, getLocationOnScreen, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, imageUpdate, inside, isDisplayable, isEnabled, isLightweight, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus
 
クラス 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 プラットフォーム v1.3 で廃止されました。列のドラッグまたはサイズ変更に応じて、無条件にリアルタイムで再ペイントが行われます。

resizingColumn

protected transient TableColumn resizingColumn
サイズ変更されている列のインデックスです。サイズ変更されていない場合は null です。

draggedColumn

protected transient TableColumn draggedColumn
ドラッグされている列のインデックスです。ドラッグされていない場合は null です。

draggedDistance

protected transient int draggedDistance
列がドラッグされた元の位置からの距離です。
コンストラクタの詳細

JTableHeader

public JTableHeader()
デフォルトの TableColumnModelJTableHeader を構築します。
関連項目:
createDefaultColumnModel()

JTableHeader

public JTableHeader(TableColumnModel cm)
cm を列モデルとして初期化される JTableHeader を構築します。cmnull の場合、このメソッドはデフォルトの 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 を返します。
戻り値:
サイズ変更されている列

setUpdateTableInRealTime

public void setUpdateTableInRealTime(boolean flag)
Java 2 プラットフォーム v1.3 でで廃止されました。列のドラッグまたはサイズ変更に応じて、無条件にリアルタイムで再ペイントが行われます。

getUpdateTableInRealTime

public boolean getUpdateTableInRealTime()
Java 2 プラットフォーム v1.3 で廃止されました。列のドラッグまたはサイズ変更に応じて、無条件にリアルタイムで再ペイントが行われます。

setDefaultRenderer

public void setDefaultRenderer(TableCellRenderer defaultRenderer)
TableColumnheaderRenderer を定義しないときに使われるデフォルトのレンダリングです。
パラメータ:
defaultRenderer - デフォルトのレンダリング

getDefaultRenderer

public TableCellRenderer getDefaultRenderer()
TableColumnheaderRenderer を定義しないときに使われるデフォルトのレンダリングを返します。
戻り値:
デフォルトのレンダリング

columnAtPoint

public int columnAtPoint(Point point)
point のある列のインデックスを返します。それが境界の外側にある場合は -1 を返します。
戻り値:
point のある列のインデックス。それが境界の外側にある場合は -1

getHeaderRect

public Rectangle getHeaderRect(int column)
column にヘッダタイルがある矩形を返します。column パラメータが境界の外側にある場合は、このメソッドは JTable メソッドの getCellRect と同じ変換を使用します。
戻り値:
column にあるヘッダタイルを含む矩形
関連項目:
JTable.getCellRect(int, int, boolean)

getToolTipText

public String getToolTipText(MouseEvent event)
テキストセットがある場合に、レンダリングのヒントとしてそれを使えるようにします。
オーバーライド:
クラス JComponent 内の getToolTipText
パラメータ:
event - イベントの位置が適切なレンダリングを識別する場合、適切なヒント
戻り値:
このコンポーネントのツールヒント

getUI

public TableHeaderUI getUI()
このコンポーネントを描画する Look & Feel (L&F) オブジェクトを返します。
戻り値:
このコンポーネントを描画する TableHeaderUI オブジェクト

setUI

public void setUI(TableHeaderUI ui)
このコンポーネントを描画する Look & Feel (L&F) オブジェクトを設定します。
パラメータ:
ui - TableHeaderUI の L&F オブジェクト
関連項目:
UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()
Look &Feel [L&F] が変更されたという UIManager からの通知です。現在の UI オブジェクトを UIManager の最新バージョンに置き換えます。
オーバーライド:
クラス JComponent 内の updateUI
関連項目:
JComponent.updateUI()

getUIClassID

public String getUIClassID()
Look & Feel (L&F) クラスの名前の構築に使用された接尾辞を返します。このクラスは、このコンポーネントを描画するのに使用されます。
オーバーライド:
クラス JComponent 内の getUIClassID
戻り値:
文字列 TableHeaderUI
関連項目:
JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

setColumnModel

public void setColumnModel(TableColumnModel columnModel)
このテーブルの列モデルを newModel に設定し、新しい列モデルからのリスナー通知を登録します。
パラメータ:
columnModel - このテーブルの新しいデータソース
例外:
IllegalArgumentException - newModelnull の場合
関連項目:
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 がヘッダレンダリングを定義しないときに使われるデフォルトのレンダリングです。
パラメータ:
default - ヘッダレンダリングがないときに使われるレンダリング

initializeLocalVars

protected void initializeLocalVars()
ローカル変数とプロパティをデフォルト値で初期化します。コンストラクタメソッドが使用するメソッドです。

resizeAndRepaint

public void resizeAndRepaint()
ヘッダのサイズを指定して、それを要表示としてマークします。repaint が続く revalidate と同じです。

setDraggedColumn

public void setDraggedColumn(TableColumn aColumn)
ヘッダの draggedColumnaColumn に設定します。
パラメータ:
aColumn - draggedColumn の新規の値

setDraggedDistance

public void setDraggedDistance(int distance)
ヘッダの draggedDistancedistance に設定します。
パラメータ:
distance - ドラッグされた距離

setResizingColumn

public void setResizingColumn(TableColumn aColumn)
ヘッダの resizingColumnaColumn に設定します。
パラメータ:
aColumn - サイズ変更される列

paramString

protected String paramString()
この JTableHeader の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null は返されません。

JFC コンポーネントの特定の新しい側面についての情報を提供するには、paramString をオーバーライドします。

オーバーライド:
クラス JComponent 内の paramString
戻り値:
この JTableHeader の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()
この JTableHeader に関連した AccessibleContext を返します。JtableHeaders の場合、AccessibleContext は AccessibleJTableHeader の形式を取ります。必要に応じて新規の AccessibleJTableHeader インスタンスが作成されます。
定義:
インタフェース Accessible 内の getAccessibleContext
オーバーライド:
クラス JComponent 内の getAccessibleContext
戻り値:
この JTableHeader の AccessibleContext として機能する AccessibleJTableHeader

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.