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以降、すべてのJavaBeans(tm)用の長期間の格納サポートが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
すべてのタブが単一のランに収まらない場合、複数のランにタブをラップするタブ・レイアウト・ポリシーです。
|
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
accessibleContext, 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 >= タブの総数
)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 >= タブの総数
)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
、クラス: Component
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, 2014, Oracle and/or its affiliates. All rights reserved.