|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一個類別 下一個類別 | 框架 無框架 | |||||||||
摘要: 巢狀 | 欄位 | 建構子 | 方法 | 詳細資訊: 欄位 | 建構子 | 方法 |
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。
製表符標題可由 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(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.BaselineResizeBehavior, 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 (以此 JTabbedPane 作為源)發送到每個已註冊的偵聽器。 |
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()
返回當前選擇的此選項卡窗格的索引。 |
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)
在 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 |
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()
從當前外觀更新 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
。
addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)
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
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
(以此 JTabbedPane
作為源)發送到每個已註冊的偵聽器。每次選定的索引或 JTabbedPane
中選定的製表符發生了更改時調用此方法。通常,選定的索引和選定的製表符同時更改。但是,在某些情況下(如選項卡增加),選定的索引發生了更改而選定的選項卡卻保持不變。還有一些情況下(如刪除選定的選項卡),索引保持不變,但一個新的選項卡移動到該索引。對於所有這些情況都將觸發事件。
addChangeListener(javax.swing.event.ChangeListener)
,
EventListenerList
public SingleSelectionModel getModel()
setModel(javax.swing.SingleSelectionModel)
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
的覆寫方法。
Container
中的 add
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
的覆寫方法。
Container
中的 add
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
的覆寫方法。
Container
中的 add
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
的覆寫方法。
Container
中的 add
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
的覆寫方法。
Container
中的 add
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,則此方法不執行任何操作。
Container
中的 remove
component
- 要從選項卡窗格中移除的元件addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)
,
removeTabAt(int)
public void remove(int index)
Container
中的 remove
index
- 要從 tabbedpane
中移除的元件的索引
IndexOutOfBoundsException
- 如果索引超出了範圍(index < 0 || index >= tab count)addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)
,
removeTabAt(int)
public void removeAll()
tabbedpane
中移除所有選項卡及其相應元件。
Container
中的 removeAll
addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)
,
removeTabAt(int)
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)
,
setTabComponentAt(int, java.awt.Component)
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)
,
setTabComponentAt(int, java.awt.Component)
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
public void setTabComponentAt(int index, Component component)
JTabbedPane
將呈現指定選項卡的標題和/或圖標。非 null 值意味著該元件將呈現標題,並且 JTabbedPane
將不呈現標題和/或圖標。
註:該元件不得是開發人員已添加到選項卡面板中的元件之一。
index
- 應該在其中設置元件的選項卡索引component
- 要呈現指定選項卡標題的元件
IndexOutOfBoundsException
- 如果索引超出了範圍 (index < 0 || index >= tab count)
IllegalArgumentException
- 如果元件已添加到此 JTabbedPane
中getTabComponentAt(int)
public Component getTabComponentAt(int index)
index
位置上的選項卡元件。
index
- 被查詢的項的索引
index
位置上的選項卡元件
IndexOutOfBoundsException
- 如果索引超出了範圍 (index < 0 || index >= tab count)setTabComponentAt(int, java.awt.Component)
public int indexOfTabComponent(Component tabComponent)
tabComponent
- 該選項卡的選項卡元件
setTabComponentAt(int, java.awt.Component)
,
getTabComponentAt(int)
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一個類別 下一個類別 | 框架 無框架 | |||||||||
摘要: 巢狀 | 欄位 | 建構子 | 方法 | 詳細資訊: 欄位 | 建構子 | 方法 |
版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only。