public class JTabbedPane extends JComponent implements Serializable, Accessible, SwingConstants
タブまたはコンポーネントは、addTab
および insertTab
メソッドを使用して TabbedPane
オブジェクトに追加されます。タブは、追加された位置に対応するインデックスで表され、1 番目のタブがインデックス 0 となり、最後のタブがタブの総数より 1 小さいインデックスになります。
TabbedPane
は SingleSelectionModel
を使用してタブインデックスのセットと現在選択されているインデックスを表します。タブの総数が 0 より大きい場合、選択されているインデックスが常にあり、デフォルトでは、1 番目のタブが選択されるように初期化されます。タブの総数が 0 の場合、選択されるインデックスは -1 になります。
タブのタイトルは Component
を使ってレンダリングできます。たとえば、次のコードを使用しても同じ結果になります。
// In this case the look and feel renders the title for the tab. tabbedPane.addTab("Tab", myComponent); // In this case the custom component is responsible for rendering the // title of the tab. tabbedPane.addTab(null, myComponent); tabbedPane.setTabComponentAt(0, new JLabel("Tab"));後者は、通常、タブ上でカスタムコンポーネントを使用する、より複雑なユーザー操作が必要な場合に使用します。たとえば、アニメーション効果を提供するカスタムコンポーネントや、タブを閉じるためのウィジェットを持つカスタムコンポーネントを提供できます。
タブのコンポーネントを指定した場合、JTabbedPane
は、ユーザーがタブに指定したテキストやアイコンをレンダリングしません。
注: タブコンポーネントを可視化する場合は、タブコンポーネント上で直接 setVisible
を使用するのではなく、setSelectedComponent
メソッドまたは setSelectedIndex
メソッドを使用してください。
警告: Swing はスレッドに対して安全ではありません。詳細は、「Swing's Threading Policy」を参照してください。
警告: このクラスの直列化されたオブジェクトは、今後の Swing リリースと互換ではなくなる予定です。現在の直列化のサポートは、短期間の格納や、同じバージョンの Swing を実行するアプリケーション間の RMI に適しています。1.4 以降、すべての JavaBeansTM 用の長期間の格納サポートが java.beans
パッケージに追加されています。XMLEncoder
を参照してください。
SingleSelectionModel
修飾子と型 | クラスと説明 |
---|---|
protected class |
JTabbedPane.AccessibleJTabbedPane
このクラスは
JTabbedPane クラスのアクセシビリティーサポートを実装しています。 |
protected class |
JTabbedPane.ModelListener
イベントソースとして、モデル自身ではなくタブペインを持つリスナーに
ModelChanged イベントを渡します。 |
JComponent.AccessibleJComponent
Container.AccessibleAWTContainer
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, 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
すべてのタブが単一のランに収まらない場合、複数のランにタブをラップするタブレイアウトポリシーです。
|
accessibleContext, listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
コンストラクタと説明 |
---|
JTabbedPane()
デフォルトのタブ位置
JTabbedPane.TOP を使用して、空の TabbedPane を作成します。 |
JTabbedPane(int tabPlacement)
JTabbedPane.TOP 、JTabbedPane.BOTTOM 、JTabbedPane.LEFT 、JTabbedPane.RIGHT のいずれかを指定したタブ配置を使用して、空の TabbedPane を作成します。 |
JTabbedPane(int tabPlacement, int tabLayoutPolicy)
指定されたタブ配置およびタブレイアウトポリシーを使用して、空の
TabbedPane を作成します。 |
修飾子と型 | メソッドと説明 |
---|---|
Component |
add(Component component)
component.getName の呼び出しの結果であるコンポーネントの名前がデフォルトで設定されたタブタイトルを持つ 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)
title または icon 、あるいはその両方 (どちらかは null でもかまわない) で表される component を追加します。 |
void |
addTab(String title, Icon icon, Component component, String tip)
title または icon 、あるいはその両方 (どちらかは null でもかまわない) で表される component および tip を追加します。 |
protected ChangeListener |
createChangeListener()
サブクラスで
ChangeEvents を別の方法で処理する場合は、このメソッドをオーバーライドして ModelListener のサブクラスまたは別の ChangeListener の実装を返すことができます。 |
protected void |
fireStateChanged()
この
JTabbedPane をソースとして、登録されている各リスナーに 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()
タブペインで現在選択されているインデックスを返します。
|
Component |
getTabComponentAt(int index)
index のタブコンポーネントを返します。 |
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 を持つ最初のタブインデックスを返します。そのアイコンを持つタブがない場合は -1 を返します。 |
int |
indexOfTab(String title)
指定された
title を持つ最初のタブインデックスを返します。そのタイトルを持つタブがない場合は -1 を返します。 |
int |
indexOfTabComponent(Component tabComponent)
指定されたタブコンポーネントのタブのインデックスを返します。
|
void |
insertTab(String title, Icon icon, Component component, String tip, int index)
指定された title または icon、あるいはその両方 (どちらかは
null でもかまわない) で表される、指定された component の新しいタブを、指定された index の位置に挿入します。 |
boolean |
isEnabledAt(int index)
index のタブが現在使用可能かどうかを返します。 |
protected String |
paramString()
この
JTabbedPane の文字列表現を返します。 |
void |
remove(Component component)
JTabbedPane から指定された Component を削除します。 |
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 に設定します。null にすることもできますが、その場合、タブのバックグラウンドカラーは tabbedpane のデフォルトのバックグラウンドカラーに設定されます。 |
void |
setComponentAt(int index, Component component)
index のコンポーネントを component に設定します。 |
void |
setDisabledIconAt(int index, Icon disabledIcon)
index の無効なアイコンを icon に設定します。null にすることもできます。 |
void |
setDisplayedMnemonicIndexAt(int tabIndex, int mnemonicIndex)
ニーモニックを表すためにテキストのどの文字を装飾するかについてのヒントを、Look & Feel に提供します。
|
void |
setEnabledAt(int index, boolean enabled)
index のタブが使用可能であるかどうかを設定します。 |
void |
setForegroundAt(int index, Color foreground)
index のフォアグラウンドカラーを foreground に設定します。null にすることもできますが、その場合、タブのフォアグラウンドカラーはこの tabbedpane のデフォルトのフォアグラウンドカラーに設定されます。 |
void |
setIconAt(int index, Icon icon)
index のアイコンを icon に設定します。null にすることもできます。 |
void |
setMnemonicAt(int tabIndex, int mnemonic)
指定されたタブにアクセスするキーボードニーモニックを設定します。
|
void |
setModel(SingleSelectionModel model)
タブペインとともに使用するモデルを設定します。
|
void |
setSelectedComponent(Component c)
タブペインの選択コンポーネントを設定します。
|
void |
setSelectedIndex(int index)
タブペインの選択インデックスを設定します。
|
void |
setTabComponentAt(int index, Component component)
指定されたタブのタイトルをレンダリングするコンポーネントを設定します。
|
void |
setTabLayoutPolicy(int tabLayoutPolicy)
すべてのタブが単一のランに収まらない場合に、タブをレイアウトするためにタブペインが使用するポリシーを設定します。
|
void |
setTabPlacement(int tabPlacement)
タブペインのタブの配置を設定します。
|
void |
setTitleAt(int index, String title)
index のタイトルを title に設定します。null にすることもできます。 |
void |
setToolTipTextAt(int index, String toolTipText)
index のツールヒントのテキストを toolTipText に設定します。null にすることもできます。 |
void |
setUI(TabbedPaneUI ui)
コンポーネントの L&F を実装する UI オブジェクトを設定します。
|
void |
updateUI()
現在の Look & Feel からの値に UI プロパティーをリセットします。
|
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, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, 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
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, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
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, 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, transferFocusBackward, transferFocusUpCycle
public static final int WRAP_TAB_LAYOUT
public static final int SCROLL_TAB_LAYOUT
protected int tabPlacement
setTabPlacement(int)
protected SingleSelectionModel model
protected ChangeListener changeListener
changeListener
は、モデルに追加するリスナーです。protected transient ChangeEvent changeEvent
ChangeEvent
が示す唯一の状態 (読み取り専用) はソースプロパティーであるため、TabPane
の各インスタンスに必要なのはこのイベント 1 つだけです。ここで生成されたイベントのソースは、常に「this」です。public JTabbedPane()
JTabbedPane.TOP
を使用して、空の TabbedPane
を作成します。public JTabbedPane(int tabPlacement)
JTabbedPane.TOP
、JTabbedPane.BOTTOM
、JTabbedPane.LEFT
、JTabbedPane.RIGHT
のいずれかを指定したタブ配置を使用して、空の TabbedPane
を作成します。tabPlacement
- コンテンツに対するタブの配置addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)
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
- タブ配置またはタブレイアウトポリシーが前述のサポートされている値のいずれでもない場合addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)
public TabbedPaneUI getUI()
TabbedPaneUI
オブジェクトsetUI(javax.swing.plaf.TabbedPaneUI)
public void setUI(TabbedPaneUI ui)
ui
- 新規の UI オブジェクトUIDefaults.getUI(javax.swing.JComponent)
public void updateUI()
updateUI
、クラス: JComponent
JComponent.updateUI()
public String getUIClassID()
getUIClassID
、クラス: JComponent
JComponent.getUIClassID()
, UIDefaults.getUI(javax.swing.JComponent)
protected ChangeListener createChangeListener()
ChangeEvents
を別の方法で処理する場合は、このメソッドをオーバーライドして ModelListener
のサブクラスまたは別の ChangeListener
の実装を返すことができます。fireStateChanged()
public void addChangeListener(ChangeListener l)
ChangeListener
を追加します。l
- 追加する ChangeListener
fireStateChanged()
, removeChangeListener(javax.swing.event.ChangeListener)
public void removeChangeListener(ChangeListener l)
ChangeListener
を削除します。l
- 削除する ChangeListener
fireStateChanged()
, addChangeListener(javax.swing.event.ChangeListener)
public ChangeListener[] getChangeListeners()
addChangeListener
を使用して、この JTabbedPane
に追加されたすべての ChangeListener
の配列を返します。ChangeListener
。リスナーが追加されていない場合は空の配列protected void fireStateChanged()
JTabbedPane
をソースとして、登録されている各リスナーに ChangeEvent
を送信します。このメソッドは、JTabbedPane
内の選択されたインデックスまたは選択されたタブに変更があるたびに呼び出されます。通常、選択されたインデックスと選択されたタブは同時に変更されます。ただし、タブの追加時など、選択されたインデックスだけが変更され、選択されたタブはそのままの場合もあります。また、選択されたタブの削除時には、インデックスはそのままで、新しいタブがそのインデックス位置に移動してきます。どの場合も、イベントがトリガーされます。public SingleSelectionModel getModel()
public void setModel(SingleSelectionModel model)
model
- 使用されるモデルgetModel()
public int getTabPlacement()
setTabPlacement(int)
public void setTabPlacement(int tabPlacement)
JTabbedPane.TOP
JTabbedPane.BOTTOM
JTabbedPane.LEFT
JTabbedPane.RIGHT
SwingConstants.TOP
。tabPlacement
- コンテンツに対するタブの配置IllegalArgumentException
- タブの配置が前述の正当な値のいずれでもない場合public int getTabLayoutPolicy()
setTabLayoutPolicy(int)
public void setTabLayoutPolicy(int tabLayoutPolicy)
JTabbedPane.WRAP_TAB_LAYOUT
JTabbedPane.SCROLL_TAB_LAYOUT
JTabbedPane.WRAP_TAB_LAYOUT
になります。
Look & Feel によっては利用できるレイアウトポリシーの一部しかサポートしていないことがあります。その場合は、このプロパティーの値が無視されることがあります。
tabLayoutPolicy
- タブのレイアウトに使用するポリシーIllegalArgumentException
- layoutPolicy の値が前述の正当な値のいずれでもない場合getTabLayoutPolicy()
public int getSelectedIndex()
setSelectedIndex(int)
public void setSelectedIndex(int index)
index
- 選択されるインデックスIndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < -1 || インデックス >= タブの総数)getSelectedIndex()
, SingleSelectionModel.setSelectedIndex(int)
public Component getSelectedComponent()
null
を返します。setSelectedComponent(java.awt.Component)
public void setSelectedComponent(Component c)
selectedIndex
は自動的に、指定されたコンポーネントに対応するインデックスに設定されます。IllegalArgumentException
- タブペインにコンポーネントがない場合getSelectedComponent()
public void insertTab(String title, Icon icon, Component component, String tip, int index)
null
でもかまわない) で表される、指定された component の新しいタブを、指定された index の位置に挿入します。title
- タブに表示されるタイトルicon
- タブに表示されるアイコンcomponent
- このタブをクリックしたときに表示されるコンポーネント。tip
- このタブで表示されるツールヒントindex
- この新しいタブを挿入する位置 (> 0 and <= getTabCount()
)IndexOutOfBoundsException
- インデックスが範囲外の場合 (< 0 or > getTabCount()
)addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)
, removeTabAt(int)
public void addTab(String title, Icon icon, Component component, String tip)
title
または icon
、あるいはその両方 (どちらかは null
でもかまわない) で表される component
および tip
を追加します。insertTab
のカバーメソッドです。title
- このタブに表示されるタイトルicon
- このタブに表示されるアイコンcomponent
- このタブをクリックしたときに表示されるコンポーネントtip
- このタブで表示されるツールヒントinsertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int)
, removeTabAt(int)
public void addTab(String title, Icon icon, Component component)
title
または icon
、あるいはその両方 (どちらかは null
でもかまわない) で表される component
を追加します。insertTab
のカバーメソッドです。title
- このタブに表示されるタイトルicon
- このタブに表示されるアイコンcomponent
- このタブをクリックしたときに表示されるコンポーネントinsertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int)
, removeTabAt(int)
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)
public Component add(Component component)
component.getName
の呼び出しの結果であるコンポーネントの名前がデフォルトで設定されたタブタイトルを持つ component
を追加します。insertTab
のカバーメソッドです。add
、クラス: Container
component
- このタブをクリックしたときに表示されるコンポーネントinsertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int)
, removeTabAt(int)
public Component add(String title, Component component)
component
を追加します。insertTab
のカバーメソッドです。add
、クラス: Container
title
- このタブに表示されるタイトルcomponent
- このタブをクリックしたときに表示されるコンポーネントinsertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int)
, removeTabAt(int)
public Component add(Component component, int index)
component
を、指定されたタブインデックス位置に追加します。insertTab
のカバーメソッドです。add
、クラス: Container
component
- このタブをクリックしたときに表示されるコンポーネントindex
- この新しいタブを挿入する位置insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int)
, removeTabAt(int)
public void add(Component component, Object constraints)
component
を追加します。constraints
が String
または Icon
の場合は、タブタイトルに使用されます。それ以外の場合は、コンポーネントの名前がタブタイトルとして使用されます。insertTab
のカバーメソッドです。add
、クラス: Container
component
- このタブをクリックしたときに表示されるコンポーネントconstraints
- タブに表示されるオブジェクトinsertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int)
, removeTabAt(int)
public void add(Component component, Object constraints, int index)
component
を追加します。constraints
が String
または Icon
の場合は、タブタイトルに使用されます。それ以外の場合は、コンポーネントの名前がタブタイトルとして使用されます。insertTab
のカバーメソッドです。add
、クラス: Container
component
- このタブをクリックしたときに表示されるコンポーネントconstraints
- タブに表示されるオブジェクトindex
- この新しいタブを挿入する位置insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int)
, removeTabAt(int)
public void removeTabAt(int index)
index
のタブを削除します。index
に関連したコンポーネントが削除されたあとで、可視性を true にリセットし、ほかのコンテナに追加された場合に可視になることが保証されるようにします。index
- 削除されるタブのインデックスIndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)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)
public void remove(Component component)
JTabbedPane
から指定された Component
を削除します。component
が null の場合は何も行いません。remove
、クラス: Container
component
- タブペインから削除するコンポーネントaddTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)
, removeTabAt(int)
public void remove(int index)
remove
、クラス: Container
index
- tabbedpane
から削除するコンポーネントのインデックスIndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)
, removeTabAt(int)
public void removeAll()
tabbedpane
からすべてのタブおよび対応するコンポーネントを削除します。public int getTabCount()
tabbedpane
のタブの数を返します。public int getTabRunCount()
tabPlacement
が TOP
または BOTTOM
の場合は行数を指定する整数値、tabPlacement
が LEFT
または RIGHT
の場合は列数を指定する整数値、この tabbedpane
に UI が設定されていない場合は 0public String getTitleAt(int index)
index
のタブのタイトルを返します。index
- 照会される項目のインデックスindex
のタイトルIndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)setTitleAt(int, java.lang.String)
public Icon getIconAt(int index)
index
のタブのアイコンを返します。index
- 照会される項目のインデックスindex
のアイコンIndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)setIconAt(int, javax.swing.Icon)
public Icon getDisabledIconAt(int index)
index
のタブの使用不可のアイコンを返します。index
にタブの無効な状態のアイコンが存在しない場合は、呼び出しが Look & Feel に転送されて、対応する有効な状態のアイコンから、適切な無効な状態のアイコンが構築されます。Look & Feel によっては無効な状態のアイコンがレンダリングされないことがあり、その場合、無効な状態のアイコンは作成されません。index
- 照会される項目のインデックスindex
のアイコンIndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)setDisabledIconAt(int, javax.swing.Icon)
public String getToolTipTextAt(int index)
index
のタブのツールヒントのテキストを返します。index
- 照会される項目のインデックスindex
のツールヒントのテキストを格納する文字列IndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)setToolTipTextAt(int, java.lang.String)
public Color getBackgroundAt(int index)
index
のタブのバックグラウンドカラーを返します。index
- 照会される項目のインデックスindex
のタブのバックグラウンドの Color
IndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)setBackgroundAt(int, java.awt.Color)
public Color getForegroundAt(int index)
index
のタブのフォアグラウンドカラーを返します。index
- 照会される項目のインデックスindex
のタブのフォアグラウンドの Color
IndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)setForegroundAt(int, java.awt.Color)
public boolean isEnabledAt(int index)
index
のタブが現在使用可能かどうかを返します。index
- 照会される項目のインデックスindex
のタブが使用可能な場合は true、そうでない場合は falseIndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)setEnabledAt(int, boolean)
public Component getComponentAt(int index)
index
のコンポーネントを返します。index
- 照会される項目のインデックスindex
の Component
IndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)setComponentAt(int, java.awt.Component)
public int getMnemonicAt(int tabIndex)
tabIndex
- ニーモニックが参照するタブのインデックスIndexOutOfBoundsException
- インデックスが範囲外の場合 (tabIndex
< 0 || tabIndex
> = タブの総数)setDisplayedMnemonicIndexAt(int,int)
, setMnemonicAt(int,int)
public int getDisplayedMnemonicIndexAt(int tabIndex)
tabIndex
- ニーモニックが参照するタブのインデックスIndexOutOfBoundsException
- インデックスが範囲外の場合 (tabIndex
< 0 || tabIndex
> = タブの総数)setDisplayedMnemonicIndexAt(int,int)
, setMnemonicAt(int,int)
public Rectangle getBoundsAt(int index)
index
のタブの境界を返します。このインデックスのタブが現在 UI で可視でない場合は null
を返します。この tabbedpane
で設定されている UI がない場合は null
を返します。index
- 照会されるインデックスindex
のタブの境界が格納された Rectangle
。この index
のタブが現在 UI で可視でない場合、またはこの tabbedpane
で設定されている UI がない場合は null
IndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)public void setTitleAt(int index, String title)
index
のタイトルを title
に設定します。null
にすることもできます。このタブのタブコンポーネントが指定されなかった場合、タイトルは表示されません。そのインデックスにタブがない場合は内部例外がスローされます。index
- タイトルを設定するタブのインデックスtitle
- タブに表示されるタイトルIndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)getTitleAt(int)
, setTabComponentAt(int, java.awt.Component)
public void setIconAt(int index, Icon icon)
index
のアイコンを icon
に設定します。null
にすることもできます。これにより、icon
に無効なアイコンが設定されません。新しいアイコンが現在のアイコンと異なり、無効なアイコンが明示的に設定されていない場合、Look & Feel に無効なアイコンを作成するように要求されます。無効な状態のアイコンを明示的に設定する場合は、setDisableIconAt()
を使用します。このアイコンのタブコンポーネントが指定されなかった場合、アイコンは表示されません。そのインデックスにタブがない場合は内部例外がスローされます。index
- アイコンを設定するタブのインデックスicon
- タブに表示されるアイコンIndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)setDisabledIconAt(int, javax.swing.Icon)
, getIconAt(int)
, getDisabledIconAt(int)
, setTabComponentAt(int, java.awt.Component)
public void setDisabledIconAt(int index, Icon disabledIcon)
index
の無効なアイコンを icon
に設定します。null
にすることもできます。そのインデックスにタブがない場合は内部例外がスローされます。index
- 使用不可のアイコンを設定するタブのインデックスdisabledIcon
- 使用不可の場合にタブに表示されるアイコンIndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)getDisabledIconAt(int)
public void setToolTipTextAt(int index, String toolTipText)
index
のツールヒントのテキストを toolTipText
に設定します。null
にすることもできます。そのインデックスにタブがない場合は内部例外がスローされます。index
- ツールヒントのテキストを設定するタブのインデックスtoolTipText
- タブに表示されるツールヒントのテキストIndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)getToolTipTextAt(int)
public void setBackgroundAt(int index, Color background)
index
のバックグラウンドカラーを background
に設定します。null
にすることもできますが、その場合、タブのバックグラウンドカラーは tabbedpane
のデフォルトのバックグラウンドカラーに設定されます。そのインデックスにタブがない場合は内部例外がスローされます。
このプロパティーが受け付けられるかどうかは Look & Feel しだいであり、無視されることもあります。index
- バックグラウンドを設定するタブのインデックスbackground
- タブのバックグラウンドに表示される色IndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)getBackgroundAt(int)
public void setForegroundAt(int index, Color foreground)
index
のフォアグラウンドカラーを foreground
に設定します。null
にすることもできますが、その場合、タブのフォアグラウンドカラーはこの tabbedpane
のデフォルトのフォアグラウンドカラーに設定されます。そのインデックスにタブがない場合は内部例外がスローされます。
このプロパティーが受け付けられるかどうかは Look & Feel しだいであり、無視されることもあります。index
- フォアグラウンドを設定するタブのインデックスforeground
- タブのフォアグラウンドとして表示される色IndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)getForegroundAt(int)
public void setEnabledAt(int index, boolean enabled)
index
のタブが使用可能であるかどうかを設定します。そのインデックスにタブがない場合は内部例外がスローされます。index
- 使用可能または不可能にするタブのインデックスenabled
- タブを使用可能にするかどうかIndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)isEnabledAt(int)
public void setComponentAt(int index, Component component)
index
のコンポーネントを component
に設定します。そのインデックスにタブがない場合は内部例外がスローされます。index
- このコンポーネントが配置される位置のタブインデックスcomponent
- タブのコンポーネントIndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)getComponentAt(int)
public void setDisplayedMnemonicIndexAt(int tabIndex, int mnemonicIndex)
この値は、ニーモニックの変更 (ニーモニック自身またはテキストの変更など) に関連するプロパティーとして更新されます。デフォルトの文字を下線付きでないようにする場合、これだけを呼び出す必要があります。たとえば、タブインデックス 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 より小さい場合にスローされるsetMnemonicAt(int,int)
, getDisplayedMnemonicIndexAt(int)
public void setMnemonicAt(int tabIndex, int mnemonic)
ニーモニックはキーボード上の 1 つのキーに対応している必要があり、java.awt.event.KeyEvent
で定義される VK_XXX
キーコードまたは java.awt.event.KeyEvent.getExtendedKeyCodeForChar
によって取得される拡張キーコードのいずれかを使用して指定します。大文字、小文字は区別されないため、対応するキーコードのキーイベントは、Shift キーが押されているかどうかにかかわらず、ボタンを有効化します。
これは、指定されたタブの表示されたニーモニックのプロパティーを更新します。
tabIndex
- ニーモニックが参照するタブのインデックスmnemonic
- ニーモニックを表すキーコードIndexOutOfBoundsException
- tabIndex
が範囲外の場合 (tabIndex < 0 || tabIndex >= tab count
)getMnemonicAt(int)
, setDisplayedMnemonicIndexAt(int,int)
public int indexOfTab(String title)
title
を持つ最初のタブインデックスを返します。そのタイトルを持つタブがない場合は -1 を返します。title
- タブのタイトルtitle
と一致する最初のタブインデックス。そのタイトルを持つタブがない場合は -1public int indexOfTab(Icon icon)
icon
を持つ最初のタブインデックスを返します。そのアイコンを持つタブがない場合は -1 を返します。icon
- タブのアイコンicon
と一致する最初のタブインデックス。そのアイコンを持つタブがない場合は -1public int indexOfComponent(Component component)
component
- タブのコンポーネントpublic int indexAtLocation(int x, int y)
x
- このタブペインに対する x 位置y
- このタブペインに対する y 位置public String getToolTipText(MouseEvent event)
getToolTipText
、クラス: JComponent
event
- カーソルの位置を知らせる MouseEvent
String
protected String paramString()
JTabbedPane
の文字列表現を返します。このメソッドはデバッグ専用であり、返される文字列の内容および形式は実装によって異なります。返される文字列は空の場合がありますが、null
にはなりません。paramString
、クラス: JComponent
public AccessibleContext getAccessibleContext()
getAccessibleContext
、インタフェース: Accessible
getAccessibleContext
、クラス: JComponent
public void setTabComponentAt(int index, Component component)
JTabbedPane
が指定されたタブのタイトルやアイコンをレンダリングすることを意味します。null 以外の値は、コンポーネントがタイトルをレンダリングし、JTabbedPane
がタイトルやアイコンをレンダリングしないことを意味します。
注:開発者が以前にタブペインに追加したコンポーネントは使用できません。
index
- コンポーネントを設定するタブのインデックスcomponent
- 指定されたタブのタイトルをレンダリングするコンポーネントIndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)IllegalArgumentException
- この JTabbedPane
にコンポーネントがすでに追加されている場合getTabComponentAt(int)
public Component getTabComponentAt(int index)
index
のタブコンポーネントを返します。index
- 照会される項目のインデックスindex
のタブコンポーネントIndexOutOfBoundsException
- インデックスが範囲外の場合 (インデックス < 0 || インデックス >= タブの総数)setTabComponentAt(int, java.awt.Component)
public int indexOfTabComponent(Component tabComponent)
tabComponent
- タブのタブコンポーネントsetTabComponentAt(int, java.awt.Component)
, getTabComponentAt(int)
バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.