JavaTM 2
Platform
Std. Ed. v1.4.0

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 小さいインデックスになります。

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

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

警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の運用や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。JDK バージョン 1.4 以降、すべての JavaBeansTM の長期間の運用サポートは、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.TOPJTabbedPane.BOTTOMJTabbedPane.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、あるいはその両方によって表された componentindex に挿入します。
 boolean isEnabledAt(int index)
          index のタブが現在使用可能かどうかを返します。
protected  String paramString()
          この JTabbedPane の文字列表現を返します。
 void remove(Component component)
          指定された ComponentJTabbedPane から削除します。
 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.TOPJTabbedPane.BOTTOMJTabbedPane.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.TOPJTabbedPane.BOTTOMJTabbedPane.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)
タブ区画のタブの配置を設定します。次の値を指定できます。 デフォルト値が設定されていない場合は、SwingConstants.TOP

パラメータ:
tabPlacement - コンテンツに対するタブの配置
例外:
IllegalArgumentException - タブ位置の値が上記の有効な値と異なる場合

getTabLayoutPolicy

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

導入されたバージョン:
1.4
関連項目:
setTabLayoutPolicy(int)

setTabLayoutPolicy

public void setTabLayoutPolicy(int tabLayoutPolicy)
すべてのタブが単一のランに収まらない場合に、タブをレイアウトするためにタブ区画が使用するポリシーを設定します。次の値を指定できます。 設定されていない場合、デフォルト値は 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、あるいはその両方によって表された componentindex に挿入します。iconnull 以外の場合で 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 を追加します。iconnull 以外の場合で 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 を追加します。iconnull 以外の場合で 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 を追加します。constraintsString または 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 を追加します。constraintsString または 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)
指定された ComponentJTabbedPane から削除します。

オーバーライド:
クラス 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()
タブを表示するために現在使用されているタブの並びの数を返します。

戻り値:
tabPlacementTOP または BOTTOM の場合は行数、tabPlacementLEFT または 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 - 照会される項目のインデックス
戻り値:
indexComponent
例外:
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

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

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