- 所有已实现的接口:
-
ImageObserver
,MenuContainer
,Serializable
,Accessible
,SwingConstants
选项卡/组件通过使用addTab
和insertTab
方法添加到TabbedPane
对象中。选项卡由与其添加位置对应的索引表示,其中第一个选项卡的索引等于0,最后一个选项卡的索引等于选项卡计数减1。
TabbedPane
使用SingleSelectionModel
来表示选项卡索引集合和当前选定的索引。如果选项卡计数大于0,则始终会有一个选定的索引,默认情况下将初始化为第一个选项卡。如果选项卡计数为0,则选定的索引将为-1。
选项卡标题可以由Component
呈现。例如,以下两种方法会产生类似的结果:
// 在这种情况下,外观和感觉会为选项卡呈现标题。 tabbedPane.addTab("选项卡", myComponent); // 在这种情况下,自定义组件负责呈现选项卡的标题。 tabbedPane.addTab(null, myComponent); tabbedPane.setTabComponentAt(0, new JLabel("选项卡"));后一种方法通常用于需要自定义组件的更复杂用户交互的情况,该情况需要在选项卡上使用自定义组件。例如,您可以提供一个自定义组件,用于动画显示或具有用于关闭选项卡的小部件。
如果为选项卡指定了组件,则JTabbedPane
将不会呈现您为选项卡指定的任何文本或图标。
注意: 不要直接在选项卡组件上使用setVisible
使其可见,而应改用setSelectedComponent
或setSelectedIndex
方法。
警告: Swing不是线程安全的。有关更多信息,请参见Swing的线程策略。
警告: 该类的序列化对象将不兼容未来的Swing版本。当前的序列化支持适用于短期存储或在运行相同版本的Swing应用程序之间进行RMI。从1.4开始,已将所有JavaBeans的长期存储支持添加到java.beans
包中。请参见XMLEncoder
。
- 自从:
- 1.2
- 参见:
-
Nested Class Summary
Modifier and TypeClassDescriptionprotected class
该类为JTabbedPane
类实现了辅助功能支持。protected class
我们将ModelChanged
事件传递给监听器,其中选项卡窗格(而不是模型本身)作为事件源。Nested classes/interfaces declared in class javax.swing.JComponent
JComponent.AccessibleJComponent
Nested classes/interfaces declared in class java.awt.Container
Container.AccessibleAWTContainer
Nested classes/interfaces declared in class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
Field Summary
Modifier and TypeFieldDescriptionprotected ChangeEvent
每个TabPane
实例只需要一个ChangeEvent
,因为事件的唯一(只读)状态是源属性。protected ChangeListener
changeListener
是我们添加到模型的监听器。protected SingleSelectionModel
默认选择模型static final int
为在单个运行中无法容纳所有选项卡时提供一组可用选项卡的选项卡布局策略。protected int
选项卡的放置位置。static final int
当所有选项卡无法在单个运行中容纳时,用于在多个运行中包装选项卡的选项卡布局策略。Fields declared in class javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Fields declared in class java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Fields declared in interface java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Fields declared in interface 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
-
Constructor Summary
ConstructorDescription创建一个具有默认选项卡放置位置JTabbedPane.TOP
的空TabbedPane
。JTabbedPane
(int tabPlacement) 创建一个具有指定选项卡放置位置的空TabbedPane
,可以是:JTabbedPane.TOP
、JTabbedPane.BOTTOM
、JTabbedPane.LEFT
或JTabbedPane.RIGHT
。JTabbedPane
(int tabPlacement, int tabLayoutPolicy) 创建一个具有指定选项卡放置位置和选项卡布局策略的空TabbedPane
。 -
Method Summary
Modifier and TypeMethodDescription添加一个默认为调用component.getName
的组件的选项卡标题。在指定的选项卡索引处添加一个默认为组件名称的选项卡标题。void
向选项卡窗格添加一个组件。void
在指定的选项卡索引处添加一个组件。添加一个具有指定选项卡标题的组件。void
向此选项卡窗格添加一个ChangeListener
。void
添加一个由title
表示且没有图标的component
。void
添加一个由title
和/或icon
表示的component
,其中任一者可以为null
。void
添加一个由title
和/或icon
表示的component
和tip
,其中任一者可以为null
。protected ChangeListener
子类可以重写此方法以返回ModelListener
的子类或另一个ChangeListener
实现,以便以不同方式处理ChangeEvents
。protected void
向每个已注册的监听器发送一个ChangeEvent
,其中此JTabbedPane
作为源。获取与此JTabbedPane关联的AccessibleContext。getBackgroundAt
(int index) 返回index
处的选项卡背景颜色。getBoundsAt
(int index) 返回index
处的选项卡边界。返回添加到此JTabbedPane
的所有ChangeListener
的数组。getComponentAt
(int index) 返回index
处的组件。getDisabledIconAt
(int index) 返回index
处的选项卡禁用图标。int
getDisplayedMnemonicIndexAt
(int tabIndex) 返回字符索引,外观和感觉应为其提供装饰以表示助记符字符。getForegroundAt
(int index) 返回index
处的选项卡前景颜色。getIconAt
(int index) 返回index
处的选项卡图标。int
getMnemonicAt
(int tabIndex) 返回用于访问指定选项卡的键盘助记符。getModel()
返回与此选项卡窗格关联的模型。返回此选项卡窗格的当前选定组件。int
返回此选项卡窗格的当前选定索引。getTabComponentAt
(int index) 返回index
处的选项卡组件。int
返回此tabbedpane
中的选项卡数。int
返回选项卡窗格在所有选项卡无法在单个运行中容纳时用于布局选项卡的策略。int
返回此选项卡窗格的选项卡放置位置。int
返回当前用于显示选项卡的选项卡运行数。getTitleAt
(int index) 返回index
处的选项卡标题。getToolTipText
(MouseEvent event) 返回由鼠标事件位置确定的组件的工具提示文本。getToolTipTextAt
(int index) 返回index
处的选项卡工具提示文本。getUI()
返回实现此组件的L&F的UI对象。返回实现此组件的L&F的UI类的名称。int
indexAtLocation
(int x, int y) 返回与指定位置相交的选项卡的索引。int
indexOfComponent
(Component component) 返回指定组件的选项卡的索引。int
indexOfTab
(String title) 返回具有给定title
的第一个选项卡索引,如果没有选项卡具有此标题,则返回-1。int
indexOfTab
(Icon icon) 返回具有给定icon
的第一个选项卡索引,如果没有选项卡具有此图标,则返回-1。int
indexOfTabComponent
(Component tabComponent) 返回指定选项卡组件的选项卡的索引。void
在给定组件、索引和标题和/或图标的情况下,插入一个新的选项卡。boolean
isEnabledAt
(int index) 返回index
处的选项卡当前是否启用。protected String
返回此JTabbedPane
的字符串表示形式。void
remove
(int index) 删除与指定索引对应的选项卡和组件。void
从JTabbedPane
中删除指定的Component
。void
从tabbedpane
中删除所有选项卡及其对应的组件。void
从此选项卡窗格中删除一个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) 向外观和感觉提供关于应该装饰哪个文本字符以表示助记符的提示。void
setEnabledAt
(int index, boolean enabled) 设置index
处的选项卡当前是否启用。void
setForegroundAt
(int index, Color foreground) 将index
处的前景颜色设置为foreground
,可以为null
,在这种情况下,选项卡的前景颜色将默认为此tabbedpane
的前景颜色。void
将index
处的图标设置为icon
,可以为null
。void
setMnemonicAt
(int tabIndex, int mnemonic) 为访问指定选项卡设置键盘助记符。void
setModel
(SingleSelectionModel model) 设置要与此选项卡窗格一起使用的模型。void
设置此选项卡窗格的当前选定组件。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) 设置实现此组件外观和感觉的UI对象。void
updateUI()
将UI属性重置为当前外观的值。Methods declared in class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, 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
Methods declared in class java.awt.Container
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
Methods declared in class 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, firePropertyChange, 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, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
-
Field Details
-
WRAP_TAB_LAYOUT
public static final int WRAP_TAB_LAYOUT当所有选项卡无法在单个运行中容纳时,用于在多个运行中包装选项卡的选项卡布局策略。- 参见:
-
SCROLL_TAB_LAYOUT
public static final int SCROLL_TAB_LAYOUT提供一组可用选项卡的选项卡布局策略,当所有选项卡无法在单个运行中容纳时。如果所有选项卡无法在单个运行中容纳,外观和感觉将提供一种导航到隐藏选项卡的方式。- 参见:
-
tabPlacement
protected int tabPlacement选项卡的放置位置。- 参见:
-
model
默认选择模型 -
changeListener
changeListener
是我们添加到模型的监听器。 -
changeEvent
每个TabPane
实例只需要一个ChangeEvent
,因为事件的唯一(只读)状态是源属性。这里生成的事件的源始终是"this"。
-
-
Constructor Details
-
JTabbedPane
public JTabbedPane()创建一个带有默认选项卡放置位置JTabbedPane.TOP
的空TabbedPane
。- 参见:
-
JTabbedPane
public JTabbedPane(int tabPlacement) 创建一个带有指定选项卡放置位置的空TabbedPane
,可以是:JTabbedPane.TOP
、JTabbedPane.BOTTOM
、JTabbedPane.LEFT
或JTabbedPane.RIGHT
。- 参数:
-
tabPlacement
- 选项卡相对于内容的放置位置 - 参见:
-
JTabbedPane
public JTabbedPane(int tabPlacement, int tabLayoutPolicy) 创建一个带有指定选项卡放置位置和选项卡布局策略的空TabbedPane
。选项卡放置位置可以是:JTabbedPane.TOP
、JTabbedPane.BOTTOM
、JTabbedPane.LEFT
或JTabbedPane.RIGHT
。选项卡布局策略可以是:JTabbedPane.WRAP_TAB_LAYOUT
或JTabbedPane.SCROLL_TAB_LAYOUT
。- 参数:
-
tabPlacement
- 选项卡相对于内容的放置位置 -
tabLayoutPolicy
- 当所有选项卡无法在一个运行中容纳时的布局策略 - 抛出:
-
IllegalArgumentException
- 如果选项卡放置位置或选项卡布局策略不是上述支持的值之一 - 自:
- 1.4
- 参见:
-
-
Method Details
-
getUI
返回实现此组件外观和感觉的UI对象。- 覆盖:
-
getUI
在类JComponent
- 返回:
-
一个
TabbedPaneUI
对象 - 参见:
-
setUI
@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the tabbedpane\'s LookAndFeel") public void setUI(TabbedPaneUI ui) 设置实现此组件外观和感觉的UI对象。- 参数:
-
ui
- 新的UI对象 - 参见:
-
updateUI
public void updateUI()将UI属性重置为当前外观的值。- 覆盖:
-
updateUI
在类JComponent
- 参见:
-
getUIClassID
返回实现此组件外观和感觉的UI类的名称。- 覆盖:
-
getUIClassID
在类JComponent
- 返回:
- 字符串"TabbedPaneUI"
- 参见:
-
createChangeListener
希望以不同方式处理ChangeEvents
的子类可以重写此方法以返回ModelListener
的子类或另一个ChangeListener
实现。- 返回:
-
一个
ChangeListener
- 参见:
-
addChangeListener
向此选项卡窗格添加一个ChangeListener
。- 参数:
-
l
- 要添加的ChangeListener
- 参见:
-
removeChangeListener
从此选项卡窗格中移除一个ChangeListener
。- 参数:
-
l
- 要移除的ChangeListener
- 参见:
-
getChangeListeners
返回添加到此JTabbedPane
的所有ChangeListener
的数组,使用addChangeListener
。- 返回:
-
所有已添加的
ChangeListener
或如果未添加任何监听器则返回空数组 - 自:
- 1.4
-
fireStateChanged
protected void fireStateChanged()发送一个ChangeEvent
,将此JTabbedPane
作为源发送给每个已注册的监听器。每当JTabbedPane
中的选定索引或选定选项卡发生更改时,都会调用此方法。通常,选定索引和选定选项卡同时更改。但是,有些情况下,例如添加选项卡,选定索引会更改,但相同的选项卡仍保持选定状态。还有其他情况,例如删除选定选项卡,索引保持不变,但新选项卡移动到该索引。对于所有这些情况都会触发事件。- 参见:
-
getModel
返回与此选项卡窗格关联的模型。- 返回:
-
与此选项卡窗格关联的
SingleSelectionModel
- 参见:
-
setModel
@BeanProperty(description="The tabbedpane\'s SingleSelectionModel.") public void setModel(SingleSelectionModel model) 设置要与此选项卡窗格一起使用的模型。- 参数:
-
model
- 要使用的模型 - 参见:
-
getTabPlacement
public int getTabPlacement()返回此选项卡窗格的选项卡放置位置。- 返回:
-
一个指定选项卡放置位置的
int
- 参见:
-
setTabPlacement
@BeanProperty(preferred=true, visualUpdate=true, enumerationValues={"JTabbedPane.TOP","JTabbedPane.LEFT","JTabbedPane.BOTTOM","JTabbedPane.RIGHT"}, description="The tabbedpane\'s tab placement.") public void setTabPlacement(int tabPlacement) 设置此选项卡窗格的选项卡放置位置。可能的值有:JTabbedPane.TOP
JTabbedPane.BOTTOM
JTabbedPane.LEFT
JTabbedPane.RIGHT
SwingConstants.TOP
。- 参数:
-
tabPlacement
- 选项卡相对于内容的放置位置 - 抛出:
-
IllegalArgumentException
- 如果选项卡放置位置值不是上述有效值之一
-
getTabLayoutPolicy
public int getTabLayoutPolicy()返回选项卡窗格在所有选项卡无法在单个运行中容纳时用于布局选项卡的策略。- 返回:
-
一个指定用于布局选项卡的策略的
int
- 自:
- 1.4
- 参见:
-
setTabLayoutPolicy
@BeanProperty(preferred=true, visualUpdate=true, enumerationValues={"JTabbedPane.WRAP_TAB_LAYOUT","JTabbedPane.SCROLL_TAB_LAYOUT"}, description="The tabbedpane\'s policy for laying out the tabs") public void setTabLayoutPolicy(int tabLayoutPolicy) 设置选项卡窗格在所有选项卡无法适应单个运行时将使用的布局策略。可能的值为:JTabbedPane.WRAP_TAB_LAYOUT
JTabbedPane.SCROLL_TAB_LAYOUT
JTabbedPane.WRAP_TAB_LAYOUT
。某些外观可能仅支持可能布局策略的子集,在这种情况下,此属性的值可能会被忽略。
- 参数:
-
tabLayoutPolicy
- 用于布局选项卡的策略 - 抛出:
-
IllegalArgumentException
- 如果布局策略值不是上述有效值之一 - 自:
- 1.4
- 另请参阅:
-
getSelectedIndex
public int getSelectedIndex()返回此选项卡窗格的当前选定索引。如果当前没有选定的选项卡,则返回-1。- 返回:
- 选定选项卡的索引
- 另请参阅:
-
setSelectedIndex
@BeanProperty(bound=false, preferred=true, description="The tabbedpane\'s selected tab index.") public void setSelectedIndex(int index) 设置此选项卡窗格的选定索引。索引必须是有效的选项卡索引或-1,表示不应选择任何选项卡(当选项卡窗格中没有选项卡时也可以使用)。如果在选项卡窗格包含一个或多个选项卡时指定了-1值,则结果将由实现定义。- 参数:
-
index
- 要选择的索引 - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < -1 || index >= tab count)
- 另请参阅:
-
getSelectedComponent
返回此选项卡窗格的当前选定组件。如果当前没有选定的选项卡,则返回null
。- 返回:
- 与选定选项卡对应的组件
- 另请参阅:
-
setSelectedComponent
@BeanProperty(bound=false, preferred=true, description="The tabbedpane\'s selected component.") public void setSelectedComponent(Component c) 设置此选项卡窗格的选定组件。这将自动将selectedIndex
设置为指定组件对应的索引。- 参数:
-
c
- 此TabbedPane
的选定Component
- 抛出:
-
IllegalArgumentException
- 如果选项卡窗格中未找到组件 - 另请参阅:
-
insertTab
在给定索引处为给定组件插入一个新选项卡,由给定标题和/或图标表示,其中任一者可以为null
。- 参数:
-
title
- 在选项卡上显示的标题 -
icon
- 在选项卡上显示的图标 -
component
- 单击此选项卡时要显示的组件 -
tip
- 为此选项卡显示的工具提示 -
index
- 插入此新选项卡的位置(index >= 0 && index <= getTabCount())
- 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index > getTabCount())
- 另请参阅:
-
addTab
添加一个由title
和/或icon
表示的component
和tip
。覆盖方法insertTab
。- 参数:
-
title
- 在此选项卡中显示的标题 -
icon
- 在此选项卡中显示的图标 -
component
- 单击此选项卡时要显示的组件 -
tip
- 为此选项卡显示的工具提示 - 另请参阅:
-
addTab
添加一个由title
和/或icon
表示的component
。覆盖方法insertTab
。- 参数:
-
title
- 在此选项卡中显示的标题 -
icon
- 在此选项卡中显示的图标 -
component
- 单击此选项卡时要显示的组件 - 另请参阅:
-
addTab
添加一个由title
和无图标表示的component
。覆盖方法insertTab
。- 参数:
-
title
- 在此选项卡中显示的标题 -
component
- 单击此选项卡时要显示的组件 - 另请参阅:
-
add
添加一个由选项卡标题默认为调用component.getName
的组件的名称的component
。覆盖方法insertTab
。 -
add
添加一个具有指定选项卡标题的component
。覆盖方法insertTab
。 -
add
在指定的选项卡索引处添加一个具有默认为组件名称的选项卡标题的component
。覆盖方法insertTab
。 -
add
向选项卡窗格添加一个component
。如果constraints
是String
或Icon
,它将用于选项卡标题,否则组件的名称将用作选项卡标题。覆盖方法insertTab
。 -
add
在指定的标签索引处添加一个组件
。如果constraints
是一个String
或一个Icon
,它将用作标签标题,否则将使用组件的名称作为标签标题。是insertTab
的覆盖方法。 -
removeTabAt
public void removeTabAt(int index) 移除index
处的选项卡。在移除与index
关联的组件后,将其可见性重置为true,以确保如果添加到其他容器中,则其将可见。- 参数:
-
index
- 要移除的选项卡的索引 - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= tab count)
- 参见:
-
remove
从JTabbedPane
中移除指定的Component
。如果component
为null,则该方法不执行任何操作。 -
remove
public void remove(int index) 移除与指定索引对应的选项卡和组件。- 覆盖:
-
remove
在类中Container
- 参数:
-
index
- 要从tabbedpane
中移除的组件的索引 - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= tab count)
- 参见:
-
removeAll
public void removeAll()从tabbedpane
中移除所有选项卡及其对应的组件。 -
getTabCount
返回此tabbedpane
中选项卡的数量。- 返回:
- 指定选项卡页数的整数
-
getTabRunCount
返回当前用于显示选项卡的选项卡运行数。- 返回:
-
如果
tabPlacement
为TOP
或BOTTOM
,则返回行数的整数,如果tabPlacement
为LEFT
或RIGHT
,则返回列数的整数,如果此tabbedpane
上没有设置UI,则返回0
-
getTitleAt
返回index
处的选项卡标题。- 参数:
-
index
- 正在查询的项目的索引 - 返回:
-
index
处的标题 - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= tab count)
- 参见:
-
getIconAt
返回index
处的选项卡图标。- 参数:
-
index
- 正在查询的项目的索引 - 返回:
-
index
处的图标 - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= tab count)
- 参见:
-
getDisabledIconAt
返回index
处的禁用选项卡图标。如果在index
处不存在禁用的选项卡图标,则将调用外观和感觉来构造相应启用图标的适当禁用图标。某些外观和感觉可能不会呈现禁用图标,在这种情况下,它将不会被创建。- 参数:
-
index
- 正在查询的项目的索引 - 返回:
-
index
处的图标 - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= tab count)
- 参见:
-
getToolTipTextAt
返回index
处的选项卡工具提示文本。- 参数:
-
index
- 正在查询的项目的索引 - 返回:
-
包含
index
处工具提示文本的字符串 - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= tab count)
- 自:
- 1.3
- 参见:
-
getBackgroundAt
返回index
处的选项卡背景颜色。- 参数:
-
index
- 正在查询的项目的索引 - 返回:
-
index
处选项卡背景的Color
- 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= tab count)
- 参见:
-
getForegroundAt
返回index
处的选项卡前景颜色。- 参数:
-
index
- 正在查询的项目的索引 - 返回:
-
index
处选项卡前景的Color
- 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= tab count)
- 参见:
-
isEnabledAt
public boolean isEnabledAt(int index) 返回index
处的选项卡当前是否启用。- 参数:
-
index
- 正在查询的项目的索引 - 返回:
-
如果
index
处的选项卡已启用,则为true;否则为false - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= tab count)
- 参见:
-
getComponentAt
返回index
处的组件。- 参数:
-
index
- 正在查询的项目的索引 - 返回:
-
index
处的Component
- 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= tab count)
- 参见:
-
getMnemonicAt
public int getMnemonicAt(int tabIndex) 返回指定选项卡访问键盘助记符。助记符是与外观的无鼠标修饰符(通常为Alt键)组合时将激活指定选项卡的键。- 参数:
-
tabIndex
- 助记符所指的选项卡的索引 - 返回:
- 表示助记符的键码;如果未为选项卡指定助记符,则返回-1
- 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(tabIndex
< 0 ||tabIndex
>= 选项卡计数) - 自版本:
- 1.4
- 参见:
-
getDisplayedMnemonicIndexAt
public int getDisplayedMnemonicIndexAt(int tabIndex) 返回作为索引的字符,表示外观应提供装饰以表示助记字符。- 参数:
-
tabIndex
- 助记符所指的选项卡的索引 - 返回:
- 如果存在助记字符,则返回表示助记字符的索引;否则返回-1
- 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(tabIndex
< 0 ||tabIndex
>= 选项卡计数) - 自版本:
- 1.4
- 参见:
-
getBoundsAt
返回index
处的选项卡边界。如果此索引处的选项卡当前在UI中不可见,则返回null
。如果在此tabbedpane
上未设置UI,则返回null
。- 参数:
-
index
- 要查询的索引 - 返回:
-
包含
index
处的选项卡边界的Rectangle
,如果index
处的选项卡当前在UI中不可见,或者在此tabbedpane
上未设置UI,则返回null
- 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= 选项卡计数)
-
setTitleAt
@BeanProperty(preferred=true, visualUpdate=true, description="The title at the specified tab index.") public void setTitleAt(int index, String title) 将index
处的标题设置为title
,可以为null
。如果为此选项卡指定了此选项卡的选项卡组件,则不显示标题。如果该索引处没有选项卡,则会引发内部异常。- 参数:
-
index
- 应设置标题的选项卡索引 -
title
- 要在选项卡中显示的标题 - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= 选项卡计数)
- 参见:
-
setIconAt
@BeanProperty(preferred=true, visualUpdate=true, description="The icon at the specified tab index.") public void setIconAt(int index, Icon icon) 将index
处的图标设置为icon
,可以为null
。这不会设置icon
处的禁用图标。如果新图标与当前图标不同且未明确设置禁用图标,则会要求LookAndFeel生成禁用图标。要明确设置禁用图标,请使用setDisableIconAt()
。如果为该索引处的选项卡指定了此选项卡的选项卡组件,则不显示图标。如果该索引处没有选项卡,则会引发内部异常。- 参数:
-
index
- 应设置图标的选项卡索引 -
icon
- 要在选项卡中显示的图标 - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= 选项卡计数)
- 参见:
-
setDisabledIconAt
@BeanProperty(preferred=true, visualUpdate=true, description="The disabled icon at the specified tab index.") public void setDisabledIconAt(int index, Icon disabledIcon) 将index
处的禁用图标设置为icon
,可以为null
。如果该索引处没有选项卡,则会引发内部异常。- 参数:
-
index
- 应设置禁用图标的选项卡索引 -
disabledIcon
- 当禁用时在选项卡中显示的图标 - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= 选项卡计数)
- 参见:
-
setToolTipTextAt
@BeanProperty(preferred=true, description="The tooltip text at the specified tab index.") public void setToolTipTextAt(int index, String toolTipText) 将index
处的工具提示文本设置为toolTipText
,可以为null
。如果该索引处没有选项卡,则会引发内部异常。- 参数:
-
index
- 应设置工具提示文本的选项卡索引 -
toolTipText
- 要为选项卡显示的工具提示文本 - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= 选项卡计数)
- 自版本:
- 1.3
- 参见:
-
setBackgroundAt
@BeanProperty(preferred=true, visualUpdate=true, description="The background color at the specified tab index.") public void setBackgroundAt(int index, Color background) 将index
处的背景颜色设置为background
,可以为null
,在这种情况下,选项卡的背景颜色将默认为tabbedpane
的背景颜色。如果该索引处没有选项卡,则会引发内部异常。这取决于外观是否遵守此属性,有些可能选择忽略它。
- 参数:
-
index
- 应设置背景的选项卡索引 -
background
- 要在选项卡的背景中显示的颜色 - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= 选项卡计数)
- 参见:
-
setForegroundAt
@BeanProperty(preferred=true, visualUpdate=true, description="The foreground color at the specified tab index.") public void setForegroundAt(int index, Color foreground) 将index
处的前景颜色设置为foreground
,可以为null
,在这种情况下,选项卡的前景颜色将默认为此tabbedpane
的前景颜色。如果该索引处没有选项卡,则会引发内部异常。这取决于外观是否遵守此属性,有些可能选择忽略它。
- 参数:
-
index
- 应设置前景的选项卡索引 -
foreground
- 要作为选项卡前景显示的颜色 - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= 选项卡计数)
- 参见:
-
setEnabledAt
public void setEnabledAt(int index, boolean enabled) 设置index
处的选项卡是否启用。如果该索引处没有选项卡,则会引发内部异常。- 参数:
-
index
- 应启用/禁用的选项卡索引 -
enabled
- 选项卡是否应启用 - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= 选项卡计数)
- 参见:
-
setComponentAt
@BeanProperty(visualUpdate=true, description="The component at the specified tab index.") public void setComponentAt(int index, Component component) 将index
处的组件设置为component
。如果该索引处没有选项卡,则会引发内部异常。- 参数:
-
index
- 正在放置此组件的选项卡索引 -
component
- 选项卡的组件 - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= 选项卡计数)
- 参见:
-
setDisplayedMnemonicIndexAt
@BeanProperty(visualUpdate=true, description="the index into the String to draw the keyboard character mnemonic at") public void setDisplayedMnemonicIndexAt(int tabIndex, int mnemonicIndex) 向外观提供关于文本中哪个字符应该被装饰以表示助记的提示。并非所有外观都支持此功能。值为-1表示此选项卡没有助记,或者您不希望为此选项卡显示助记。此值随着与助记相关的属性更改(如助记本身、文本等)而更新。只有在不希望默认字符被下划线标记时才需要调用此方法。例如,如果索引为3的选项卡文本为'Apple Price',助记为'p',您希望将'P'装饰为'Apple Price',则需要在调用
setMnemonicAt(3, KeyEvent.VK_P)
后调用setDisplayedMnemonicIndex(3, 6)
。请注意,程序员有责任确保每个选项卡具有唯一的助记,否则可能会导致不可预测的结果。
- 参数:
-
tabIndex
- 指定助记键所指向的选项卡的索引 -
mnemonicIndex
- 下划线所在字符串中的索引 - 抛出:
-
IndexOutOfBoundsException
- 如果tabIndex
超出范围(tabIndex < 0 || tabIndex >= 选项卡数量
) -
IllegalArgumentException
- 如果mnemonicIndex
>= 选项卡标题长度,或者 < -1 时抛出 - 自从:
- 1.4
- 参见:
-
setMnemonicAt
@BeanProperty(visualUpdate=true, description="The keyboard mnenmonic, as a KeyEvent VK constant, for the specified tab") public void setMnemonicAt(int tabIndex, int mnemonic) 设置访问指定选项卡的键盘助记键。助记键是与外观的无鼠标操作修饰符(通常为Alt键)组合时将激活指定选项卡的键。助记键必须对应于键盘上的单个键,并应使用
java.awt.event.KeyEvent
中定义的VK_XXX
键码之一或通过java.awt.event.KeyEvent.getExtendedKeyCodeForChar
获得的扩展键码之一来指定。助记键不区分大小写,因此具有相应键码的键事件将导致按钮被激活,无论是否按下Shift修饰键。这将更新指定选项卡的显示助记键属性。
- 参数:
-
tabIndex
- 指定助记键所指向的选项卡的索引 -
mnemonic
- 表示助记键的键码 - 抛出:
-
IndexOutOfBoundsException
- 如果tabIndex
超出范围(tabIndex < 0 || tabIndex >= 选项卡数量
) - 自从:
- 1.4
- 参见:
-
indexOfTab
返回具有给定title
的第一个选项卡索引,如果没有选项卡具有此标题,则返回-1。- 参数:
-
title
- 选项卡的标题 - 返回:
-
匹配
title
的第一个选项卡索引,如果没有选项卡具有此标题,则返回-1
-
indexOfTab
返回具有给定icon
的第一个选项卡索引,如果没有选项卡具有此图标,则返回-1。- 参数:
-
icon
- 选项卡的图标 - 返回:
-
匹配
icon
的第一个选项卡索引,如果没有选项卡具有此图标,则返回-1
-
indexOfComponent
返回指定组件的选项卡索引。如果没有此组件的选项卡,则返回-1。- 参数:
-
component
- 选项卡的组件 - 返回:
- 匹配此组件的第一个选项卡,如果没有此组件的选项卡,则返回-1
-
indexAtLocation
public int indexAtLocation(int x, int y) 返回与与指定位置相交的选项卡边界相交的选项卡索引。如果没有选项卡与该位置相交,则返回-1。- 参数:
-
x
- 相对于此选项卡窗格的x位置 -
y
- 相对于此选项卡窗格的y位置 - 返回:
- 与该位置相交的选项卡索引,如果没有选项卡与该位置相交,则返回-1
- 自从:
- 1.4
-
getToolTipText
返回由鼠标事件位置确定的组件的工具提示文本。- 覆盖:
-
getToolTipText
在类JComponent
- 参数:
-
event
- 告诉光标所在位置的MouseEvent
- 返回:
-
包含工具提示文本的
String
-
paramString
返回此JTabbedPane
的字符串表示形式。此方法仅用于调试目的,返回的字符串的内容和格式可能因实现而异。返回的字符串可能为空,但不会是null
。- 覆盖:
-
paramString
在类JComponent
- 返回:
- 此JTabbedPane的字符串表示形式。
-
getAccessibleContext
获取与此JTabbedPane关联的AccessibleContext。对于选项卡窗格,AccessibleContext采用AccessibleJTabbedPane的形式。如果需要,将创建一个新的AccessibleJTabbedPane实例。- 指定者:
-
getAccessibleContext
在接口Accessible
- 覆盖:
-
getAccessibleContext
在类Component
- 返回:
- 作为此JTabbedPane的AccessibleContext的AccessibleJTabbedPane
-
setTabComponentAt
@BeanProperty(preferred=true, visualUpdate=true, description="The tab component at the specified tab index.") public void setTabComponentAt(int index, Component component) 设置负责为指定选项卡渲染标题的组件。空值表示JTabbedPane
将为指定选项卡渲染标题和/或图标。非空值表示组件将渲染标题,JTabbedPane
将不会渲染标题和/或图标。注意:组件不能是开发人员已经添加到选项卡窗格中的组件。
- 参数:
-
index
- 应设置组件的选项卡索引 -
component
- 为指定选项卡渲染标题的组件 - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= 选项卡数量)
-
IllegalArgumentException
- 如果组件已经添加到此JTabbedPane
中,则抛出 - 自从:
- 1.6
- 参见:
-
getTabComponentAt
返回index
处的选项卡组件。- 参数:
-
index
- 正在查询的项目的索引 - 返回:
-
index
处的选项卡组件 - 抛出:
-
IndexOutOfBoundsException
- 如果索引超出范围(index < 0 || index >= 选项卡数量)
- 自从:
- 1.6
- 参见:
-
indexOfTabComponent
返回指定选项卡组件的选项卡索引。如果没有此选项卡组件的选项卡,则返回-1。- 参数:
-
tabComponent
- 选项卡组件 - 返回:
- 匹配此选项卡组件的第一个选项卡,如果没有此选项卡组件的选项卡,则返回-1
- 自从:
- 1.6
- 参见:
-