javax.swing
クラス JTabbedPane

java.lang.Object
  |
  +--java.awt.Component
        |
        +--java.awt.Container
              |
              +--javax.swing.JComponent
                    |
                    +--javax.swing.JTabbedPane

すべての実装インタフェース:

Accessible, ImageObserver, MenuContainer, Serializable, SwingConstants

public class JTabbedPane

extends JComponent

implements Serializable, Accessible, SwingConstants

指定されたタイトルやアイコンを持つタブをクリックすることにより、ユーザがコンポーネントのグループを切り替えられるようにするコンポーネントです。タブ区画の例および情報については、「The Java Tutorial」のセクション「How to Use Tabbed Panes」を参照してください。

タブまたはコンポーネントは、addTab および insertTab メソッドを使用して TabbedPane オブジェクトに追加されます。タブは、追加された位置に対応するインデックスで表され、1 番目のタブがインデックス 0 となり、最後のタブがタブの総数より 1 小さいインデックスになります。

TabbedPane は SingleSelectionModel を使用してタブインデックスのセットと現在選択されているインデックスを表します。タブの総数が 0 より大きい場合、選択されているインデックスが常にあり、デフォルトでは、1 番目のタブが選択されるように初期化されます。タブの総数が 0 の場合、選択されるインデックスは -1 になります。

標準の Look & Feel (L&F) 表現でこのコンポーネントが使用するキーボードのキーについては、「JTabbedPane のキーの割り当て」を参照してください。

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK バージョン 1.4 以降、すべての JavaBeans^TM の長期間の運用サポートは、java.beans パッケージに追加されています。詳細は、XMLEncoder を参照してください。

関連項目:

SingleSelectionModel

入れ子クラスの概要

protected class	JTabbedPane.AccessibleJTabbedPane このクラスは JTabbedPane クラス用のユーザ補助機能のサポートを実装しています。
protected class	JTabbedPane.ModelListener イベントソースとして、モデル自身ではなくタブ区画を持つリスナーに ModelChanged イベントを渡します。

クラス javax.swing.JComponent から継承した入れ子クラス

クラス java.awt.Container から継承した入れ子クラス

クラス java.awt.Component から継承した入れ子クラス

Component.BltBufferStrategy, Component.FlipBufferStrategy

フィールドの概要

protected ChangeEvent	changeEvent 読み取り専用である ChangeEvent の状態は常にソースプロパティであるため、TabPane の各インスタンスに必要なイベントは 1 つだけです。
protected ChangeListener	changeListener changeListener は、モデルに追加するリスナーです。
protected SingleSelectionModel	model デフォルトの選択モードです。
static int	SCROLL_TAB_LAYOUT すべてのタブが単一のランに収まらない場合、スクロール可能なタブの領域を提供するタブレイアウトポリシーです。
protected int	tabPlacement タブが配置される位置です。
static int	WRAP_TAB_LAYOUT すべてのタブが単一のランに収まらない場合、複数のランにタブをラップするタブレイアウトポリシーです。

クラス 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

インタフェース javax.swing.SwingConstants から継承したフィールド

BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST

インタフェース java.awt.image.ImageObserver から継承したフィールド

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

コンストラクタの概要

JTabbedPane()
JTabbedPane.TOP のデフォルトのタブ配置および JTabbedPane.WRAP_TAB_LAYOUT のデフォルトのタブレイアウトポリシーを使用して、空の TabbedPane を作成します。

JTabbedPane(int tabPlacement)
JTabbedPane.TOP、JTabbedPane.BOTTOM、JTabbedPane.LEFT、または JTabbedPane.RIGHT のどれかの指定されたタブ配置および JTabbedPane.WRAP_TAB_LAYOUT のデフォルトのタブレイアウトポリシーを使用して、空の TabbedPane を作成します。

JTabbedPane(int tabPlacement, int tabLayoutPolicy)
指定されたタブ配置およびタブレイアウトポリシーを使用して、空の TabbedPane を作成します。

メソッドの概要

Component	add(Component component) タブタイトルをデフォルトでコンポーネントの名前に設定して component を追加します。
Component	add(Component component, int index) タブタイトルをデフォルトでコンポーネントの名前に設定して、指定したタブインデックスに component を追加します。
void	add(Component component, Object constraints) タブ区画に component を追加します。
void	add(Component component, Object constraints, int index) 指定したタブのインデックスに component を追加します。
Component	add(String title, Component component) タブタイトルを指定して component を追加します。
void	addChangeListener(ChangeListener l) このタブ区画に ChangeListener を追加します。
void	addTab(String title, Component component) title で表される (アイコンなし) component を追加します。
void	addTab(String title, Icon icon, Component component) どちらかが null でもかまわない title または icon、あるいはその両方によって表された component を追加します。
void	addTab(String title, Icon icon, Component component, String tip) どちらかが null でもかまわない title または icon、あるいはその両方によって表された component および tip を追加します。
protected ChangeListener	createChangeListener() サブクラスでモデルの ChangeEvents を別の方法で処理したい場合は、このメソッドをオーバーライドして ModelListener のサブクラスまたは別の ChangeListener の実装を返すように設定できます。
protected void	fireStateChanged() ソースがこのタブ区画である ChangeEvent を各リスナーに送信します。
AccessibleContext	getAccessibleContext() この JTabbedPane に関連した AccessibleContext を返します。
Color	getBackgroundAt(int index) index のタブのバックグラウンドカラーを返します。
Rectangle	getBoundsAt(int index) index のタブの境界を返します。
ChangeListener[]	getChangeListeners() addChangeListener を使用して、この JTabbedPane に追加されたすべての ChangeListener の配列を返します。
Component	getComponentAt(int index) index のコンポーネントを返します。
Icon	getDisabledIconAt(int index) index のタブの使用不可のアイコンを返します。
int	getDisplayedMnemonicIndexAt(int tabIndex) Look & Feel が、ニーモニック文字を表すための装飾を提供するインデックスとしての文字を返します。
Color	getForegroundAt(int index) index のタブのフォアグラウンドカラーを返します。
Icon	getIconAt(int index) index のタブのアイコンを返します。
int	getMnemonicAt(int tabIndex) 指定されたタブにアクセスするキーボードニーモニックを返します。
SingleSelectionModel	getModel() タブ区画に関連したモデルを返します。
Component	getSelectedComponent() タブ区画で現在選択されているコンポーネントを返します。
int	getSelectedIndex() タブ区画で現在選択されているインデックスを返します。
int	getTabCount() この tabbedpane のタブの数を返します。
int	getTabLayoutPolicy() すべてのタブが単一のランに収まらない場合に、タブをレイアウトするためにタブ区画が使用するポリシーを返します。
int	getTabPlacement() タブ区画のタブの配置を返します。
int	getTabRunCount() タブを表示するために現在使用されているタブの並びの数を返します。
String	getTitleAt(int index) index のタブのタイトルを返します。
String	getToolTipText(MouseEvent event) マウスイベントの位置によって決められるコンポーネントのツールヒントテキストを返します。
String	getToolTipTextAt(int index) index のタブのツールヒントのテキストを返します。
TabbedPaneUI	getUI() コンポーネントの L&F を実装する UI オブジェクトを返します。
String	getUIClassID() コンポーネントの L&F を実装する UI クラスの名前を返します。
int	indexAtLocation(int x, int y) 境界が指定された位置と交差するタブに対応するタブインデックスを返します。
int	indexOfComponent(Component component) 指定されたコンポーネントのタブのインデックスを返します。
int	indexOfTab(Icon icon) 指定された icon を持つ最初のタブインデックスを返します。
int	indexOfTab(String title) 指定された title を持つ最初のタブインデックスを返します。
void	insertTab(String title, Icon icon, Component component, String tip, int index) どちらかが null でもかまわない title または icon、あるいはその両方によって表された component を index に挿入します。
boolean	isEnabledAt(int index) index のタブが現在使用可能かどうかを返します。
protected String	paramString() この JTabbedPane の文字列表現を返します。
void	remove(Component component) 指定された Component を JTabbedPane から削除します。
void	remove(int index) 指定されたインデックスに対応するタブとコンポーネントを削除します。
void	removeAll() tabbedpane からすべてのタブおよび対応するコンポーネントを削除します。
void	removeChangeListener(ChangeListener l) このタブ区画から ChangeListener を削除します。
void	removeTabAt(int index) index のタブを削除します。
void	setBackgroundAt(int index, Color background) index のバックグラウンドカラーを background に設定します。
void	setComponentAt(int index, Component component) index のコンポーネントを component に設定します。
void	setDisabledIconAt(int index, Icon disabledIcon) index の無効なアイコンを icon に設定します。
void	setDisplayedMnemonicIndexAt(int tabIndex, int mnemonicIndex) ニーモニックを表すためにテキストのどの文字を装飾するかについてのヒントを、Look & Feel に提供します。
void	setEnabledAt(int index, boolean enabled) index のタブが使用可能であるかどうかを設定します。
void	setForegroundAt(int index, Color foreground) index のフォアグラウンドカラーを foreground に設定します。
void	setIconAt(int index, Icon icon) index のアイコンを icon に設定します。
void	setMnemonicAt(int tabIndex, int mnemonic) 指定されたタブにアクセスするキーボードニーモニックを設定します。
void	setModel(SingleSelectionModel model) タブ区画とともに使用するモデルを設定します。
void	setSelectedComponent(Component c) タブ区画の選択コンポーネントを設定します。
void	setSelectedIndex(int index) タブ区画の選択されたインデックスを設定します。
void	setTabLayoutPolicy(int tabLayoutPolicy) すべてのタブが単一のランに収まらない場合に、タブをレイアウトするためにタブ区画が使用するポリシーを設定します。
void	setTabPlacement(int tabPlacement) タブ区画のタブの配置を設定します。
void	setTitleAt(int index, String title) index のタイトルを title に設定します。
void	setToolTipTextAt(int index, String toolTipText) index のツールヒントのテキストを toolTipText に設定します。
void	setUI(TabbedPaneUI ui) コンポーネントの L&F を実装する UI オブジェクトを設定します。
void	updateUI() 現在の Look & Feel からの値に UI プロパティをリセットします。

クラス 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, getAncestorListeners, getAutoscrolls, getBorder, getBounds, getClientProperty, getComponentGraphics, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getGraphics, getHeight, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPreferredSize, getPropertyChangeListeners, getPropertyChangeListeners, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, isDoubleBuffered, isLightweightComponent, isManagingFocus, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isOptimizedDrawingEnabled, isPaintingTile, isPreferredSizeSet, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removePropertyChangeListener, removePropertyChangeListener, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFont, setForeground, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

クラス java.awt.Container から継承したメソッド

addContainerListener, addImpl, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, removeContainerListener, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, 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, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMouseWheelListeners, getName, getParent, getPeer, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, 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, processMouseEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, 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

フィールドの詳細

WRAP_TAB_LAYOUT

public static final int WRAP_TAB_LAYOUT

すべてのタブが単一のランに収まらない場合、複数のランにタブをラップするタブレイアウトポリシーです。

関連項目:

定数フィールド値

SCROLL_TAB_LAYOUT

public static final int SCROLL_TAB_LAYOUT

すべてのタブが単一のランに収まらない場合、スクロール可能なタブの領域を提供するタブレイアウトポリシーです。ユーザがスクロールを制御するために、スクロールボタンのペアが提供されます。スクロールボタンの配置は Look & Feel によって決まります。

関連項目:

定数フィールド値

tabPlacement

protected int tabPlacement

タブが配置される位置です。

関連項目:

setTabPlacement(int)

model

protected SingleSelectionModel model

デフォルトの選択モードです。

changeListener

protected ChangeListener changeListener

changeListener は、モデルに追加するリスナーです。

changeEvent

protected transient ChangeEvent changeEvent

読み取り専用である ChangeEvent の状態は常にソースプロパティであるため、TabPane の各インスタンスに必要なイベントは 1 つだけです。生成されるイベントのソースは、常に this です。

コンストラクタの詳細

JTabbedPane

public JTabbedPane()

JTabbedPane.TOP のデフォルトのタブ配置および JTabbedPane.WRAP_TAB_LAYOUT のデフォルトのタブレイアウトポリシーを使用して、空の TabbedPane を作成します。

関連項目:

addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)

JTabbedPane

public JTabbedPane(int tabPlacement)

JTabbedPane.TOP、JTabbedPane.BOTTOM、JTabbedPane.LEFT、または JTabbedPane.RIGHT のどれかの指定されたタブ配置および JTabbedPane.WRAP_TAB_LAYOUT のデフォルトのタブレイアウトポリシーを使用して、空の TabbedPane を作成します。

パラメータ:

tabPlacement - コンテンツに対するタブの配置

関連項目:

addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)

JTabbedPane

public JTabbedPane(int tabPlacement,
                   int tabLayoutPolicy)

指定されたタブ配置およびタブレイアウトポリシーを使用して、空の TabbedPane を作成します。タブ配置は、JTabbedPane.TOP、JTabbedPane.BOTTOM、JTabbedPane.LEFT、または JTabbedPane.RIGHT のどれかを指定します。タブレイアウトポリシーは、JTabbedPane.WRAP_TAB_LAYOUT または JTabbedPane.SCROLL_TAB_LAYOUT のどれかです。

パラメータ:

tabPlacement - コンテンツに対するタブの配置

tabLayoutPolicy - すべてのタブが単一のランに収まらない場合にタブをレイアウトするポリシー

例外:

IllegalArgumentException - タブ配置またはタブレイアウトポリシーが上記のサポートされた値のどれかでない場合

導入されたバージョン:

1.4

関連項目:

addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)

メソッドの詳細

getUI

public TabbedPaneUI getUI()

コンポーネントの L&F を実装する UI オブジェクトを返します。

戻り値:

TabbedPaneUI オブジェクト

関連項目:

setUI(javax.swing.plaf.TabbedPaneUI)

setUI

public void setUI(TabbedPaneUI ui)

コンポーネントの L&F を実装する UI オブジェクトを設定します。

パラメータ:

ui - 新規の UI オブジェクト

関連項目:

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

現在の Look & Feel からの値に UI プロパティをリセットします。

オーバーライド:

クラス JComponent 内の updateUI

関連項目:

JComponent.updateUI()

getUIClassID

public String getUIClassID()

コンポーネントの L&F を実装する UI クラスの名前を返します。

オーバーライド:

クラス JComponent 内の getUIClassID

戻り値:

TabbedPaneUI の文字列

関連項目:

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

createChangeListener

protected ChangeListener createChangeListener()

サブクラスでモデルの ChangeEvents を別の方法で処理したい場合は、このメソッドをオーバーライドして ModelListener のサブクラスまたは別の ChangeListener の実装を返すように設定できます。

関連項目:

fireStateChanged()

addChangeListener

public void addChangeListener(ChangeListener l)

このタブ区画に ChangeListener を追加します。

パラメータ:

l - 追加する ChangeListener

関連項目:

fireStateChanged(), removeChangeListener(javax.swing.event.ChangeListener)

removeChangeListener

public void removeChangeListener(ChangeListener l)

このタブ区画から ChangeListener を削除します。

パラメータ:

l - 削除する ChangeListener

関連項目:

fireStateChanged(), addChangeListener(javax.swing.event.ChangeListener)

getChangeListeners

public ChangeListener[] getChangeListeners()

addChangeListener を使用して、この JTabbedPane に追加されたすべての ChangeListener の配列を返します。

戻り値:

追加されたすべての ChangeListener、またはリスナーが追加されていない場合は空の配列

導入されたバージョン:

1.4

fireStateChanged

protected void fireStateChanged()

ソースがこのタブ区画である ChangeEvent を各リスナーに送信します。このメソッドはモデルから ChangeEvent を受け取るたびに呼び出されます。

関連項目:

addChangeListener(javax.swing.event.ChangeListener), EventListenerList

getModel

public SingleSelectionModel getModel()

タブ区画に関連したモデルを返します。

関連項目:

setModel(javax.swing.SingleSelectionModel)

setModel

public void setModel(SingleSelectionModel model)

タブ区画とともに使用するモデルを設定します。

パラメータ:

model - 使用されるモデル

関連項目:

getModel()

getTabPlacement

public int getTabPlacement()

タブ区画のタブの配置を返します。

関連項目:

setTabPlacement(int)

setTabPlacement

public void setTabPlacement(int tabPlacement)

タブ区画のタブの配置を設定します。次の値を指定できます。

• JTabbedPane.TOP
• JTabbedPane.BOTTOM
• JTabbedPane.LEFT
• JTabbedPane.RIGHT

デフォルト値が設定されていない場合は、SwingConstants.TOP

パラメータ:

tabPlacement - コンテンツに対するタブの配置

例外:

IllegalArgumentException - タブ位置の値が上記の有効な値と異なる場合

getTabLayoutPolicy

public int getTabLayoutPolicy()

すべてのタブが単一のランに収まらない場合に、タブをレイアウトするためにタブ区画が使用するポリシーを返します。

導入されたバージョン:

1.4

関連項目:

setTabLayoutPolicy(int)

setTabLayoutPolicy

public void setTabLayoutPolicy(int tabLayoutPolicy)

すべてのタブが単一のランに収まらない場合に、タブをレイアウトするためにタブ区画が使用するポリシーを設定します。次の値を指定できます。

• JTabbedPane.WRAP_TAB_LAYOUT
• JTabbedPane.SCROLL_TAB_LAYOUT

設定されていない場合、デフォルト値は JTabbedPane.WRAP_TAB_LAYOUT になります。

例外:

IllegalArgumentException - layoutPolicy の値が上記の有効な値と異なる場合

導入されたバージョン:

1.4

関連項目:

getTabLayoutPolicy()

getSelectedIndex

public int getSelectedIndex()

タブ区画で現在選択されているインデックスを返します。現在選択されているタブがない場合は -1 を返します。

戻り値:

選択されているタブのインデックス

関連項目:

setSelectedIndex(int)

setSelectedIndex

public void setSelectedIndex(int index)

タブ区画の選択されたインデックスを設定します。インデックスは、有効なタブインデックスまたは -1 を設定する必要があります。-1 を設定すると、タブが選択されていないこと示します。また、インデックスは、タブ区画にタブがない場合にも使用できます。タブ区画が 1 つ以上のタブを保持するときに値 -1 が指定される場合は、その結果は実装の定義によって決まります。

パラメータ:

index - 選択されるインデックス

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < -1 || index >= tab count)

関連項目:

getSelectedIndex(), SingleSelectionModel.setSelectedIndex(int)

getSelectedComponent

public Component getSelectedComponent()

タブ区画で現在選択されているコンポーネントを返します。現在選択されているタブがない場合は null を返します。

戻り値:

選択されているタブに対応するコンポーネント

関連項目:

setSelectedComponent(java.awt.Component)

setSelectedComponent

public void setSelectedComponent(Component c)

タブ区画の選択コンポーネントを設定します。selectedIndex は自動的に、指定されたコンポーネントに対応するインデックスに設定されます。

例外:

IllegalArgumentException - タブ区画にコンポーネントがない場合

関連項目:

getSelectedComponent()

insertTab

public void insertTab(String title,
                      Icon icon,
                      Component component,
                      String tip,
                      int index)

どちらかが null でもかまわない title または icon、あるいはその両方によって表された component を index に挿入します。icon が null 以外の場合で ImageIcon を実装する場合、対応する無効な状態のアイコンがタブ区画に自動的に作成、設定されます。内部的には java.util.Vector を使用します。挿入規則の詳細は、insertElementAt を参照してください。

パラメータ:

title - このタブで表示されるタイトル

icon - このタブで表示されるアイコン

component - このタブをクリックしたときに表示されるコンポーネント

tip - このタブで表示されるツールヒント

index - この新しいタブを挿入する位置

関連項目:

addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String), removeTabAt(int)

addTab

public void addTab(String title,
                   Icon icon,
                   Component component,
                   String tip)

どちらかが null でもかまわない title または icon、あるいはその両方によって表された component および tip を追加します。icon が null 以外の場合で ImageIcon を実装する場合、対応する無効な状態のアイコンがタブ区画に自動的に作成、設定されます。insertTab のカバーメソッドです。

パラメータ:

title - このタブで表示されるタイトル

icon - このタブで表示されるアイコン

component - このタブをクリックしたときに表示されるコンポーネント

tip - このタブで表示されるツールヒント

関連項目:

insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int), removeTabAt(int)

addTab

public void addTab(String title,
                   Icon icon,
                   Component component)

どちらかが null でもかまわない title または icon、あるいはその両方によって表された component を追加します。icon が null 以外の場合で ImageIcon を実装する場合、対応する無効な状態のアイコンがタブ区画に自動的に作成、設定されます。insertTab のカバーメソッドです。

パラメータ:

title - このタブで表示されるタイトル

icon - このタブで表示されるアイコン

component - このタブをクリックしたときに表示されるコンポーネント

関連項目:

insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int), removeTabAt(int)

addTab

public void addTab(String title,
                   Component component)

title で表される (アイコンなし) component を追加します。insertTab のカバーメソッドです。

パラメータ:

title - このタブで表示されるタイトル

component - このタブをクリックしたときに表示されるコンポーネント

関連項目:

insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int), removeTabAt(int)

add

public Component add(Component component)

タブタイトルをデフォルトでコンポーネントの名前に設定して component を追加します。この名前は component.getName の呼び出しによって取得されます。insertTab のカバーメソッドです。

オーバーライド:

クラス Container 内の add

パラメータ:

component - このタブをクリックしたときに表示されるコンポーネント

戻り値:

コンポーネント

関連項目:

insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int), removeTabAt(int)

add

public Component add(String title,
                     Component component)

タブタイトルを指定して component を追加します。insertTab のカバーメソッドです。

オーバーライド:

クラス Container 内の add

パラメータ:

title - このタブで表示されるタイトル

component - このタブをクリックしたときに表示されるコンポーネント

戻り値:

コンポーネント

関連項目:

insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int), removeTabAt(int)

add

public Component add(Component component,
                     int index)

タブタイトルをデフォルトでコンポーネントの名前に設定して、指定したタブインデックスに component を追加します。insertTab のカバーメソッドです。

オーバーライド:

クラス Container 内の add

パラメータ:

component - このタブをクリックしたときに表示されるコンポーネント

index - この新しいタブを挿入する位置

戻り値:

コンポーネント

関連項目:

insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int), removeTabAt(int)

add

public void add(Component component,
                Object constraints)

タブ区画に component を追加します。constraints が String または Icon の場合は、タブタイトルで使用されます。そうでない場合は、コンポーネントの名前がタブタイトルとして使用されます。insertTab のカバーメソッドです。

オーバーライド:

クラス Container 内の add

パラメータ:

component - このタブをクリックしたときに表示されるコンポーネント

constraints - タブで表示されるオブジェクト

関連項目:

insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int), removeTabAt(int)

add

public void add(Component component,
                Object constraints,
                int index)

指定したタブのインデックスに component を追加します。constraints が String または Icon の場合は、タブタイトルで使用されます。そうでない場合は、コンポーネントの名前がタブタイトルとして使用されます。insertTab のカバーメソッドです。

オーバーライド:

クラス Container 内の add

パラメータ:

component - このタブをクリックしたときに表示されるコンポーネント

index - この新しいタブを挿入する位置

constraints - このコンポーネントの配置条件を表現するオブジェクト

関連項目:

insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int), removeTabAt(int)

removeTabAt

public void removeTabAt(int index)

index のタブを削除します。index に関連したコンポーネントが削除されたあとで、可視性を true にリセットし、ほかのコンテナに追加された場合に可視になることが保証されるようにします。

パラメータ:

index - 削除されるタブのインデックス

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String), insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int)

remove

public void remove(Component component)

指定された Component を JTabbedPane から削除します。

オーバーライド:

クラス Container 内の remove

パラメータ:

component - タブ区画から削除するコンポーネント

例外:

NullPointerException - component が null の場合

関連項目:

addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String), removeTabAt(int)

remove

public void remove(int index)

指定されたインデックスに対応するタブとコンポーネントを削除します。

オーバーライド:

クラス Container 内の remove

パラメータ:

index - tabbedpane から削除するコンポーネントのインデックス

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String), removeTabAt(int)

removeAll

public void removeAll()

tabbedpane からすべてのタブおよび対応するコンポーネントを削除します。

オーバーライド:

クラス Container 内の removeAll

関連項目:

addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String), removeTabAt(int)

getTabCount

public int getTabCount()

この tabbedpane のタブの数を返します。

戻り値:

タブページの数を指定する int 値

getTabRunCount

public int getTabRunCount()

タブを表示するために現在使用されているタブの並びの数を返します。

戻り値:

tabPlacement が TOP または BOTTOM の場合は行数、tabPlacement が LEFT または RIGHT の場合は列数を指定する int 値。この tabbedpane に UI が設定されていない場合は 0

getTitleAt

public String getTitleAt(int index)

index のタブのタイトルを返します。

パラメータ:

index - 照会される項目のインデックス

戻り値:

index のタイトル

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

setTitleAt(int, java.lang.String)

getIconAt

public Icon getIconAt(int index)

index のタブのアイコンを返します。

パラメータ:

index - 照会される項目のインデックス

戻り値:

index のアイコン

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

* icon が null 以外で ImageIcon を実装する場合、対応する使用不可のアイコンが自動的に作成されてタブ区画に設定される

getDisabledIconAt

public Icon getDisabledIconAt(int index)

index のタブの使用不可のアイコンを返します。

パラメータ:

index - 照会される項目のインデックス

戻り値:

index のアイコン

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

setDisabledIconAt(int, javax.swing.Icon)

getToolTipTextAt

public String getToolTipTextAt(int index)

index のタブのツールヒントのテキストを返します。

パラメータ:

index - 照会される項目のインデックス

戻り値:

index のツールヒントのテキストを格納する文字列

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

setToolTipTextAt(int, java.lang.String)

getBackgroundAt

public Color getBackgroundAt(int index)

index のタブのバックグラウンドカラーを返します。

パラメータ:

index - 照会される項目のインデックス

戻り値:

index のタブのバックグラウンドの Color

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

setBackgroundAt(int, java.awt.Color)

getForegroundAt

public Color getForegroundAt(int index)

index のタブのフォアグラウンドカラーを返します。

パラメータ:

index - 照会される項目のインデックス

戻り値:

index のタブのフォアグラウンドの Color

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

setForegroundAt(int, java.awt.Color)

isEnabledAt

public boolean isEnabledAt(int index)

index のタブが現在使用可能かどうかを返します。

パラメータ:

index - 照会される項目のインデックス

戻り値:

index のタブが使用可能な場合は true、そうでない場合は false

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

setEnabledAt(int, boolean)

getComponentAt

public Component getComponentAt(int index)

index のコンポーネントを返します。

パラメータ:

index - 照会される項目のインデックス

戻り値:

index の Component

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

setComponentAt(int, java.awt.Component)

getMnemonicAt

public int getMnemonicAt(int tabIndex)

指定されたタブにアクセスするキーボードニーモニックを返します。ニーモニックは、Look & Feel のマウスを使用しない修飾子 (通常は Alt) と組み合わせたときに、指定されたタブをアクティブにするキーです。

パラメータ:

tabIndex - ニーモニックが参照するタブのインデックス

戻り値:

ニーモニックを表すキーコード。ニーモニックがタブを指定していない場合は -1

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (tabIndex < 0 || tabIndex >= tab count)

導入されたバージョン:

1.4

関連項目:

setDisplayedMnemonicIndexAt(int,int), setMnemonicAt(int,int)

getDisplayedMnemonicIndexAt

public int getDisplayedMnemonicIndexAt(int tabIndex)

Look & Feel が、ニーモニック文字を表すための装飾を提供するインデックスとしての文字を返します。

パラメータ:

tabIndex - ニーモニックが参照するタブのインデックス

戻り値:

ニーモニック文字を表すインデックスがある場合はそのインデックス。そうでない場合は -1

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (tabIndex < 0 || tabIndex >= tab count)

導入されたバージョン:

1.4

関連項目:

setDisplayedMnemonicIndexAt(int,int), setMnemonicAt(int,int)

getBoundsAt

public Rectangle getBoundsAt(int index)

index のタブの境界を返します。このインデックスのタブが現在 UI で可視でない場合は null を返します。この tabbedpane で設定されている UI がない場合は null を返します。

パラメータ:

index - 照会されるインデックス

戻り値:

index のタブの境界が格納された Rectangle。この index のタブが現在 UI で可視でない場合、またはこの tabbedpane で設定されている UI がない場合は null

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

setTitleAt

public void setTitleAt(int index,
                       String title)

index のタイトルを title に設定します。null にすることもできます。そのインデックスにタブがない場合は内部例外がスローされます。

パラメータ:

index - タイトルを設定するタブのインデックス

title - タブに表示されるタイトル

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

getTitleAt(int)

setIconAt

public void setIconAt(int index,
                      Icon icon)

index のアイコンを icon に設定します。null にすることもできます。icon の無効なアイコンを設定しないでください。無効なアイコンを設定するには、setDisableIconAt() を使用します。そのインデックスにタブがない場合は内部例外がスローされます。

パラメータ:

index - アイコンを設定するタブのインデックス

icon - タブに表示されるアイコン

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

setDisabledIconAt(int, javax.swing.Icon), getIconAt(int)

setDisabledIconAt

public void setDisabledIconAt(int index,
                              Icon disabledIcon)

index の無効なアイコンを icon に設定します。null にすることもできます。そのインデックスにタブがない場合は内部例外がスローされます。

パラメータ:

index - 使用不可のアイコンを設定するタブのインデックス

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

getDisabledIconAt(int)

setToolTipTextAt

public void setToolTipTextAt(int index,
                             String toolTipText)

index のツールヒントのテキストを toolTipText に設定します。null にすることもできます。そのインデックスにタブがない場合は内部例外がスローされます。

パラメータ:

index - ツールヒントのテキストを設定するタブのインデックス

toolTipText - タブに表示されるツールヒントのテキスト

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

getToolTipTextAt(int)

setBackgroundAt

public void setBackgroundAt(int index,
                            Color background)

index のバックグラウンドカラーを background に設定します。null にすることもできますが、その場合、タブのバックグラウンドカラーは tabbedpane のデフォルトのバックグラウンドカラーに設定されます。そのインデックスにタブがない場合は内部例外がスローされます。

パラメータ:

index - バックグラウンドを設定するタブのインデックス

background - タブのバックグラウンドに表示される色

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

getBackgroundAt(int)

setForegroundAt

public void setForegroundAt(int index,
                            Color foreground)

index のフォアグラウンドカラーを foreground に設定します。null にすることもできますが、その場合、タブのフォアグラウンドカラーは tabbedpane のデフォルトのフォアグラウンドカラーに設定されます。そのインデックスにタブがない場合は内部例外がスローされます。

パラメータ:

index - フォアグラウンドを設定するタブのインデックス

foreground - タブのフォアグラウンドとして表示される色

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

getForegroundAt(int)

setEnabledAt

public void setEnabledAt(int index,
                         boolean enabled)

index のタブが使用可能であるかどうかを設定します。そのインデックスにタブがない場合は内部例外がスローされます。

パラメータ:

index - 使用可能または不可能にするタブのインデックス

enabled - タブを使用可能にするかどうか

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

isEnabledAt(int)

setComponentAt

public void setComponentAt(int index,
                           Component component)

index のコンポーネントを component に設定します。そのインデックスにタブがない場合は内部例外がスローされます。

パラメータ:

index - このコンポーネントが配置される位置のタブインデックス

component - タブのコンポーネント

例外:

IndexOutOfBoundsException - インデックスが範囲外の場合 (index < 0 || index >= tab count)

関連項目:

getComponentAt(int)

setDisplayedMnemonicIndexAt

public void setDisplayedMnemonicIndexAt(int tabIndex,
                                        int mnemonicIndex)

ニーモニックを表すためにテキストのどの文字を装飾するかについてのヒントを、Look & Feel に提供します。すべての Look & Feel がこれをサポートしているわけではありません。値 -1 は、このタブのニーモニックが存在しないか、またはこのタブにニーモニックを表示しないことを示します。

この値は、ニーモニックの変更 (ニーモニック自身またはテキストの変更など) に関連するプロパティとして更新されます。デフォルトの文字を下線付きでないようにする場合、これだけを呼び出す必要があります。たとえば、タブインデックス 3 のテキストがニーモニック「p」を持つ「Apple Price」の場合で、「Apple Price」のように「P」を装飾しようとする場合は、setMnemonicAt(3, KeyEvent.VK_P) を呼び出してから setDisplayedMnemonicIndex(3, 6) を呼び出す必要があります。

各タブが固有のニーモニックを保持したり、あるいは予想外の結果が生じたりする場合があることをプログラマは確認してください。

パラメータ:

tabIndex - ニーモニックが参照するタブのインデックス

mnemonicIndex - 下線を引く String の中のインデックス

例外:

IndexOutOfBoundsException - tabIndex が範囲外の場合 (tabIndex < 0 || tabIndex >= tab count)

IllegalArgumentException - mnemonicIndex が >= タブタイトルの長さ、または < -1 の場合、スローされる

導入されたバージョン:

1.4

関連項目:

setMnemonicAt(int,int), getDisplayedMnemonicIndexAt(int)

setMnemonicAt

public void setMnemonicAt(int tabIndex,
                          int mnemonic)

指定されたタブにアクセスするキーボードニーモニックを設定します。ニーモニックは、Look & Feel のマウスを使用しない修飾子 (通常は Alt) と組み合わせたときに、指定されたタブをアクティブにするキーです。

ニーモニックはキーボードの 1 つのキーに対応し、java.awt.event.KeyEvent で定義される VK_XXX キーコードの 1 つを使って指定する必要があります。ニーモニックは大文字と小文字を区別しないので、対応するキーコードによるキーイベントは、Shift 修飾子が押されている、いないにかかわらずボタンをアクティブにします。

これは、指定されたタブの表示されたニーモニックのプロパティを更新します。

パラメータ:

tabIndex - ニーモニックが参照するタブのインデックス

mnemonic - ニーモニックを表すキーコード

例外:

IndexOutOfBoundsException - tabIndex が範囲外の場合 (tabIndex < 0 || tabIndex >= tab count)

導入されたバージョン:

1.4

関連項目:

getMnemonicAt(int), setDisplayedMnemonicIndexAt(int,int)

indexOfTab

public int indexOfTab(String title)

指定された title を持つ最初のタブインデックスを返します。そのタイトルを持つタブがない場合は -1 を返します。

パラメータ:

title - タブのタイトル

戻り値:

title と一致する最初のタブインデックス。そのタイトルを持つタブがない場合は -1

indexOfTab

public int indexOfTab(Icon icon)

指定された icon を持つ最初のタブインデックスを返します。そのアイコンを持つタブがない場合は -1 を返します。

パラメータ:

icon - タブのアイコン

戻り値:

icon と一致する最初のタブインデックス。そのアイコンを持つタブがない場合は -1

indexOfComponent

public int indexOfComponent(Component component)

指定されたコンポーネントのタブのインデックスを返します。指定されたコンポーネントのタブがない場合は -1 を返します。

パラメータ:

component - タブのコンポーネント

戻り値:

このコンポーネントと一致する最初のタブ。そのコンポーネントを持つタブがない場合は -1

indexAtLocation

public int indexAtLocation(int x,
                           int y)

境界が指定された位置と交差するタブに対応するタブインデックスを返します。タブがその位置と交差しない場合は -1 を返します。

パラメータ:

x - このタブ区画に対する x 位置

y - このタブ区画に対する y 位置

戻り値:

その位置と交差するタブインデックス。タブがその位置と交差しない場合 -1

導入されたバージョン:

1.4

getToolTipText

public String getToolTipText(MouseEvent event)

マウスイベントの位置によって決められるコンポーネントのツールヒントテキストを返します。

オーバーライド:

クラス JComponent 内の getToolTipText

パラメータ:

event - カーソルの位置を知らせる MouseEvent

戻り値:

ツールヒントのテキストを格納する String

paramString

protected String paramString()

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

オーバーライド:

クラス JComponent 内の paramString

戻り値:

この JTabbedPane の文字列表現

getAccessibleContext

public AccessibleContext getAccessibleContext()

この JTabbedPane に関連した AccessibleContext を返します。タブ区画の場合、AccessibleContext は AccessibleJTabbedPane の形式を取ります。必要に応じて新規の AccessibleJTabbedPane インスタンスが作成されます。

定義:

インタフェース Accessible 内の getAccessibleContext

オーバーライド:

クラス JComponent 内の getAccessibleContext

戻り値:

この JTabbedPane の AccessibleContext として機能する AccessibleJTabbedPane