|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object java.awt.Component java.awt.Container javax.swing.JComponent javax.swing.JTabbedPane
public class JTabbedPane
一个组件,它允许用户通过单击具有给定标题和/或图标的选项卡,在一组组件之间进行切换。有关使用选项卡窗格的例子和信息,请参阅《The Java Tutorial》 中的 How to Use Tabbed Panes 一节。
通过使用 addTab
和 insertTab
方法将选项卡/组件添加到 TabbedPane
对象中。选项卡通过对应于添加位置的索引来表示,其中第一个选项卡的索引为 0,最后一个选项卡的索引为选项卡数减 1。
TabbedPane
使用 SingleSelectionModel
来表示选项卡索引集和当前所选择的索引。如果选项卡数大于 0,则总会有一个被选定的索引,此索引默认被初始化为第一个选项卡。如果选项卡数为 0,则所选择的索引为 -1。
警告:此类的已序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储,或适用于在运行相同 Swing 版本的应用程序之间进行 RMI(Remote Method Invocation,远程方法调用)。从 1.4 版本开始,已在 java.beans
包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 XMLEncoder
。
SingleSelectionModel
嵌套类摘要 | |
---|---|
protected class |
JTabbedPane.AccessibleJTabbedPane
此类实现对 JTabbedPane 类的可访问性支持。 |
protected class |
JTabbedPane.ModelListener
将 ModelChanged 事件传递给侦听器,其中选项卡窗格(而不是模型本身)作为侦听器的事件源。 |
从类 javax.swing.JComponent 继承的嵌套类/接口 |
---|
JComponent.AccessibleJComponent |
从类 java.awt.Container 继承的嵌套类/接口 |
---|
Container.AccessibleAWTContainer |
从类 java.awt.Component 继承的嵌套类/接口 |
---|
Component.AccessibleAWTComponent, Component.BltBufferStrategy, Component.FlipBufferStrategy |
字段摘要 | |
---|---|
protected ChangeEvent |
changeEvent
由于事件仅有的(只读)状态是源属性,因此每个 TabPane 实例只需要一个 ChangeEvent 。 |
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 选项卡布局的空 TabbedPane 。 |
|
JTabbedPane(int tabPlacement)
创建一个空的 TabbedPane ,使其具有以下指定选项卡布局中的一种:JTabbedPane.TOP 、JTabbedPane.BOTTOM 、JTabbedPane.LEFT 或 JTabbedPane.RIGHT 。 |
|
JTabbedPane(int tabPlacement,
int tabLayoutPolicy)
创建一个空的 TabbedPane ,使其具有指定的选项卡布局和选项卡布局策略。 |
方法摘要 | |
---|---|
Component |
add(Component component)
添加一个 component ,其选项卡的默认值为调用 component.getName 返回的组件的名称。 |
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 表示的 component ,其任意一个都可以为 null 。 |
void |
addTab(String title,
Icon icon,
Component component,
String tip)
添加由 title 和/或 icon 表示的 component 和 tip ,其中任意一个都可以为 null 。 |
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)
返回作为索引的字符,外观必须提供它来表示助记符字符。 |
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 的第一个选项卡索引,如果没有具有此图标的选项卡,则返回 -1。 |
int |
indexOfTab(String title)
返回具有给定 title 的第一个选项卡索引,如果没有具有此标题的选项卡,则返回 -1。 |
void |
insertTab(String title,
Icon icon,
Component component,
String tip,
int index)
在 index 位置插入一个 component ,该组件通过 title 和/或 icon (任意一个都可以为 null )来表示。 |
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)
提供一个外观的提示,此提示是关于文本中哪此字符必须被装饰用来表示助记符。 |
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 |
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()
从当前外观更新 UI 属性的值。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
字段详细信息 |
---|
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
TabPane
实例只需要一个 ChangeEvent
。此处生成的事件源总是 "this"。
构造方法详细信息 |
---|
public JTabbedPane()
JTabbedPane.TOP
选项卡布局的空 TabbedPane
。
public JTabbedPane(int tabPlacement)
TabbedPane
,使其具有以下指定选项卡布局中的一种:JTabbedPane.TOP
、JTabbedPane.BOTTOM
、JTabbedPane.LEFT
或 JTabbedPane.RIGHT
。
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()
JComponent
中的 updateUI
public String getUIClassID()
JComponent
中的 getUIClassID
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()
ChangeEvent
发送到每个侦听器。当每次从模型中接收 ChangeEvent
时,调用此方法。
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
。
一些外观可能只支持可能的布局策略的一个子集,在这种情况下可以忽略此属性的值。
tabLayoutPolicy
- 用于安排选项卡的策略
IllegalArgumentException
- 如果 layoutPolicy 的值不是以上有效值之一getTabLayoutPolicy()
public int getSelectedIndex()
setSelectedIndex(int)
public void setSelectedIndex(int index)
index
- 要选择的索引
IndexOutOfBoundsException
- 如果索引超出了范围(index < -1 || index >= tab count)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)
index
位置插入一个 component
,该组件通过 title
和/或 icon
(任意一个都可以为 null
)来表示。在内部使用 java.util.Vector,有关插入约定的详细信息请参阅 insertElementAt
。
title
- 要在此选项卡中显示的标题icon
- 要在此选项卡中显示的图标component
- 单击此选项卡时要显示的组件。tip
- 此选项卡要显示的工具提示index
- 要插入此新选项卡的位置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
表示的 component
和 tip
,其中任意一个都可以为 null
。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
表示的 component
,其任意一个都可以为 null
。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
,其选项卡的默认值为调用 component.getName
返回的组件的名称。insertTab
的覆盖方法。
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
的覆盖方法。
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
的覆盖方法。
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
的覆盖方法。
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
的覆盖方法。
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
- 如果索引超出了范围(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)
public void remove(Component component)
JTabbedPane
中移除指定 Component
。如果 component
为 null,则此方法不执行任何操作。
component
- 要从选项卡窗格中移除的组件addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)
,
removeTabAt(int)
public void remove(int index)
index
- 要从 tabbedpane
中移除的组件的索引
IndexOutOfBoundsException
- 如果索引超出了范围(index < 0 || index >= tab count)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
- 如果索引超出了范围(index < 0 || index >= tab count)setTitleAt(int, java.lang.String)
public Icon getIconAt(int index)
index
位置的选项卡图标。
index
- 正在被查询的项的索引
index
位置的图标
IndexOutOfBoundsException
- 如果索引超出了范围(index < 0 || index >= tab count)setIconAt(int, javax.swing.Icon)
public Icon getDisabledIconAt(int index)
index
位置的选项卡禁用图标。如果在 index
位置不存在选项卡禁用图标,则将该调用转发到外观,以从对应的启用的 Icon 构造合适的禁用 Icon。一些外观可能不呈现禁用的 Icon,在这种情况下将不创建禁用的 Icon。
index
- 正在被查询的项的索引
index
位置的图标
IndexOutOfBoundsException
- 如果索引超出了范围(index < 0 || index >= tab count)setDisabledIconAt(int, javax.swing.Icon)
public String getToolTipTextAt(int index)
index
位置的选项卡工具提示文本。
index
- 正在被查询的项的索引
index
位置的工具提示文本的字符串
IndexOutOfBoundsException
- 如果索引超出了范围(index < 0 || index >= tab count)setToolTipTextAt(int, java.lang.String)
public Color getBackgroundAt(int index)
index
位置的选项卡背景色。
index
- 正在被查询的项的索引
index
位置的选项卡背景色的 Color
IndexOutOfBoundsException
- 如果索引超出了范围(index < 0 || index >= tab count)setBackgroundAt(int, java.awt.Color)
public Color getForegroundAt(int index)
index
位置的选项卡背景色。
index
- 正在被查询的项的索引
index
位置的选项卡的前景 Color
IndexOutOfBoundsException
- 如果索引超出了范围(index < 0 || index >= tab count)setForegroundAt(int, java.awt.Color)
public boolean isEnabledAt(int index)
index
位置的选项卡。
index
- 正在被查询的项的索引
index
位置的选项卡,则返回 true;否则返回 false
IndexOutOfBoundsException
- 如果索引超出了范围(index < 0 || index >= tab count)setEnabledAt(int, boolean)
public Component getComponentAt(int index)
index
位置的组件。
index
- 正在被查询的项的索引
index
位置的 Component
IndexOutOfBoundsException
- 如果索引超出了范围(index < 0 || index >= tab count)setComponentAt(int, java.awt.Component)
public int getMnemonicAt(int tabIndex)
tabIndex
- 助记符引用的选项卡的索引
IndexOutOfBoundsException
- 如果索引超出了范围(tabIndex
< 0 || tabIndex
>= tab count)setDisplayedMnemonicIndexAt(int,int)
,
setMnemonicAt(int,int)
public int getDisplayedMnemonicIndexAt(int tabIndex)
tabIndex
- 助记符要引用的选项卡索引
IndexOutOfBoundsException
- 如果索引超出了范围(tabIndex
< 0 || tabIndex
>= tab count)setDisplayedMnemonicIndexAt(int,int)
,
setMnemonicAt(int,int)
public Rectangle getBoundsAt(int index)
index
位置的选项卡边界。如果当前此索引位置的选项卡在 UI 中不可见,则返回 null
。如果在此 tabbedpane
上没有设置 UI,则返回 null
。
index
- 要查询的索引
index
位置的选项卡边界的 Rectangle
,如果当前 index
位置的选项卡在 UI 中不可见,则返回 null
,如果在此 tabbedpane
上没有设置 UI,也将返回 null
IndexOutOfBoundsException
- 如果索引超出了范围(index < 0 || index >= tab count)public void setTitleAt(int index, String title)
index
位置的标题设置为 title
,它可以为 null
。如果在该索引位置没有选项卡,则将引发一个内部异常。
index
- 标题要被设置的位置的选项卡索引title
- 选项卡上要显示的标题
IndexOutOfBoundsException
- 如果索引超出了范围(index < 0 || index >= tab count)getTitleAt(int)
public void setIconAt(int index, Icon icon)
index
位置的图标设置为 icon
,它可以为 null
。此方法不能设置 icon
位置的禁用图标。如果新的 Icon 不同于当前的 Icon,且禁用的图标不是显式设置的,那么 LookAndFeel 会被要求生成一个禁用的 Icon。要显式设置禁用的图标,请使用 setDisableIconAt()
。如果在该索引位置没有选项卡,则会引发一个内部异常。
index
- 图标要被设置的位置的选项卡索引icon
- 要在选项卡中显示的图标
IndexOutOfBoundsException
- 如果索引超出了范围(index < 0 || index >= tab count)setDisabledIconAt(int, javax.swing.Icon)
,
getIconAt(int)
,
getDisabledIconAt(int)
public void setDisabledIconAt(int index, Icon disabledIcon)
index
位置的禁用图标设置为 icon
,它可以为 null
。如果在该索引位置没有选项卡,则会引发一个内部异常。
index
- 图标要被设置的位置的选项卡索引disabledIcon
- 当禁用时要在选项卡中显示的图标
IndexOutOfBoundsException
- 如果索引超出了范围(index < 0 || index >= tab count)getDisabledIconAt(int)
public void setToolTipTextAt(int index, String toolTipText)
index
位置的工具提示文本设置为 toolTipText
,它可以为 null
。如果在该索引位置没有选项卡,则会引发一个内部异常。
index
- 工具提示文本要被设置的位置选项卡索引toolTipText
- 选项卡中要显示的工具提示文本
IndexOutOfBoundsException
- 如果索引超出了范围(index < 0 || index >= tab count)getToolTipTextAt(int)
public void setBackgroundAt(int index, Color background)
index
位置的背景色设置为 background
,它可以为 null
,在这种情况下选项卡的背景色默认为 tabbedpane
的背景色。如果在该索引位置没有选项卡,则会引发一个内部异常。
index
- 要设置背景色的位置的选项卡索引background
- 要在选项卡背景中显示的颜色
IndexOutOfBoundsException
- 如果索引超出了范围(index < 0 || index >= tab count)getBackgroundAt(int)
public void setForegroundAt(int index, Color foreground)
index
位置的前景色设置为 foreground
,它可以为 null
,在这种情况下选项卡的前景色默认为此 tabbedpane
的前景色。如果在该索引位置没有选项卡,则会引发一个内部异常。
index
- 要设置前景色的位置的选项卡索引foreground
- 要作为选项卡前景色显示的颜色
IndexOutOfBoundsException
- 如果索引超出了范围(index < 0 || index >= tab count)getForegroundAt(int)
public void setEnabledAt(int index, boolean enabled)
index
位置的选项卡。如果在该索引位置没有选项卡,则会引发一个内部异常。
index
- 要启用/禁用的选项卡索引enabled
- 选项卡是否启用
IndexOutOfBoundsException
- 如果索引超出了范围(index < 0 || index >= tab count)isEnabledAt(int)
public void setComponentAt(int index, Component component)
index
位置的组件设置为 component
。如果在该索引位置没有选项卡,则会引发一个内部异常。
index
- 此组件放置位置的选项卡索引component
- 选项卡的组件
IndexOutOfBoundsException
- 如果索引超出了范围(index < 0 || index >= tab count)getComponentAt(int)
public void setDisplayedMnemonicIndexAt(int tabIndex, int mnemonicIndex)
此值随着助记符相关属性的改变(例如助记符本身、文本等等)而更新。如果不需要默认字符带有下划线,则不必调用此方法。例如,如果索引为 3 的选项卡的文本为 'Apple Price',助记符为 'p',并且要将其装饰为 'Apple Price',那么必须在调用 setMnemonicAt(3, KeyEvent.VK_P)
之后调用 setDisplayedMnemonicIndex(3, 6)
。
注意,程序员要负责确保每个选项卡具有惟一的助记符,否则将发生不可预计的结果。
tabIndex
- 助记符引用的选项卡索引mnemonicIndex
- 要加下划线的 String
的索引
IndexOutOfBoundsException
- 如果 tabIndex
超出了范围(tabIndex < 0 || tabIndex >= tab count
)
IllegalArgumentException
- 将被抛出,如果 mnemonicIndex
>= 选项卡标题的长度或 < -1setMnemonicAt(int,int)
,
getDisplayedMnemonicIndexAt(int)
public void setMnemonicAt(int tabIndex, int mnemonic)
助记符必须对应于键盘上的单个键,且必须使用 java.awt.event.KeyEvent
中定义的 VK_XXX
键代码之一来指定。助记符是不区分大小写的,因此具有对应键代码的键事件将导致铵钮被激活,而不管 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)
JComponent
中的 getToolTipText
event
- MouseEvent
,它告知光标的当前位置
String
protected String paramString()
JTabbedPane
的字符串表示。此方法仅用于调试目的,对于各个实现,所返回字符串的内容和格式可能有所不同。返回的字符串可能为空,但不可能为 null
。
JComponent
中的 paramString
public AccessibleContext getAccessibleContext()
Accessible
中的 getAccessibleContext
JComponent
中的 getAccessibleContext
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。