JavaTM 2 Platform
Standard Ed. 6

javax.swing
類別 JTabbedPane

java.lang.Object
  繼承者 java.awt.Component
      繼承者 java.awt.Container
          繼承者 javax.swing.JComponent
              繼承者 javax.swing.JTabbedPane
所有已實作的介面:
ImageObserver, MenuContainer, Serializable, Accessible, SwingConstants

public class JTabbedPane
extends JComponent
implements Serializable, Accessible, SwingConstants

一個元件,它允許使用者通過單擊具有給定標題和/或圖標的選項卡,在一組元件之間進行切換。有關使用選項卡窗格的例子和資訊,請參閱 The Java Tutorial 中的 How to Use Tabbed Panes 一節。

通過使用 addTabinsertTab 方法將選項卡/元件添加到 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 以使其可見,使用 setSelectedComponentsetSelectedIndex 方法來替代。

警告: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.TOPJTabbedPane.BOTTOMJTabbedPane.LEFTJTabbedPane.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 表示的 componenttip,其中任意一個都可以為 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 屬性的值。
 
從類別 javax.swing.JComponent 繼承的方法
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, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, 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
 
從類別 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, transferFocusBackward, transferFocusDownCycle, validate, validateTree
 
從類別 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, 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, hide, 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, transferFocusUpCycle
 
從類別 java.lang.Object 繼承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

欄位詳細資訊

WRAP_TAB_LAYOUT

public static final int WRAP_TAB_LAYOUT
當在一次運行中不能放入所有的選項卡時,在多次運行中包裹選項卡的選項卡佈局策略。

另請參見:
常數欄位值

SCROLL_TAB_LAYOUT

public static final int SCROLL_TAB_LAYOUT
當在一次運行中不能放入所有的選項卡時,用於提供可用選項卡子集的選項卡佈局策略。如果在一次運行中不能放入所有的選項卡,則外觀(look and feel)將提供一種導航到隱藏的選項卡的方法。

另請參見:
常數欄位值

tabPlacement

protected int tabPlacement
選項卡的放置位置。

另請參見:
setTabPlacement(int)

model

protected SingleSelectionModel model
預設的選擇模型。


changeListener

protected ChangeListener changeListener
changeListener 是添加到模型中的偵聽器。


changeEvent

protected transient ChangeEvent changeEvent
由於事件僅有的(只讀)狀態是源屬性,因此每個 TabPane 實例只需要一個 ChangeEvent。此處產生的事件源總是 "this"。

建構子詳細資訊

JTabbedPane

public JTabbedPane()
創建一個具有預設的 JTabbedPane.TOP 選項卡佈局的空 TabbedPane

另請參見:
addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)

JTabbedPane

public JTabbedPane(int tabPlacement)
創建一個空的 TabbedPane,使其具有以下指定選項卡佈局中的一種:JTabbedPane.TOPJTabbedPane.BOTTOMJTabbedPane.LEFTJTabbedPane.RIGHT

參數:
tabPlacement - 關於內容的選項卡佈局
另請參見:
addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)

JTabbedPane

public JTabbedPane(int tabPlacement,
                   int tabLayoutPolicy)
創建一個空的 TabbedPane,使其具有指定的選項卡佈局和選項卡佈局策略。佈局可以是以下幾種之一:JTabbedPane.TOPJTabbedPane.BOTTOMJTabbedPane.LEFTJTabbedPane.RIGHT。佈局策略可以是以下兩種之一:JTabbedPane.WRAP_TAB_LAYOUTJTabbedPane.SCROLL_TAB_LAYOUT

參數:
tabPlacement - 關於內容的選項卡佈局
tabLayoutPolicy - 當在一次運行中不能放入所有的選項卡時,放置選項卡的策略
拋出:
IllegalArgumentException - 如果選項卡佈局或選項卡佈局策略不是以上受支持的值中的一個
從以下版本開始:
1.4
另請參見:
addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)
方法詳細資訊

getUI

public TabbedPaneUI getUI()
返回實作此元件的 L&F 的 UI 物件。

返回:
TabbedPaneUI 物件
另請參見:
setUI(javax.swing.plaf.TabbedPaneUI)

setUI

public void setUI(TabbedPaneUI ui)
設置實作此元件的 L&F 的 UI 物件。

參數:
ui - 新的 UI 物件
另請參見:
UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()
從當前外觀更新 UI 屬性的值。

覆寫:
類別 JComponent 中的 updateUI
另請參見:
JComponent.updateUI()

getUIClassID

public String getUIClassID()
返回實作此元件的 L&F 的 UI 類別的名稱。

覆寫:
類別 JComponent 中的 getUIClassID
返回:
字元串 "TabbedPaneUI"
另請參見:
JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

createChangeListener

protected ChangeListener createChangeListener()
要對 ChangeEvents 進行不同處理的子類別可以覆寫它,從而返回 ModelListener 的一個子類別,或者返回另一個 ChangeListener 實作。

另請參見:
fireStateChanged()

addChangeListener

public void addChangeListener(ChangeListener l)
將一個 ChangeListener 添加到此選項卡窗格中。

參數:
l - 要添加的 ChangeListener
另請參見:
fireStateChanged(), removeChangeListener(javax.swing.event.ChangeListener)

removeChangeListener

public void removeChangeListener(ChangeListener l)
從此選項卡窗格中移除一個 ChangeListener

參數:
l - 要移除的 ChangeListener
另請參見:
fireStateChanged(), addChangeListener(javax.swing.event.ChangeListener)

getChangeListeners

public ChangeListener[] getChangeListeners()
返回通過 addChangeListener 方法添加到此 JTabbedPane 中的所有 ChangeListener 的陣列。

返回:
所有添加的 ChangeListener,或者在沒有添加偵聽器時返回一個空陣列
從以下版本開始:
1.4

fireStateChanged

protected void fireStateChanged()
將一個 ChangeEvent(以此 JTabbedPane 作為源)發送到每個已註冊的偵聽器。每次選定的索引或 JTabbedPane 中選定的製表符發生了更改時調用此方法。通常,選定的索引和選定的製表符同時更改。但是,在某些情況下(如選項卡增加),選定的索引發生了更改而選定的選項卡卻保持不變。還有一些情況下(如刪除選定的選項卡),索引保持不變,但一個新的選項卡移動到該索引。對於所有這些情況都將觸發事件。

另請參見:
addChangeListener(javax.swing.event.ChangeListener), EventListenerList

getModel

public SingleSelectionModel getModel()
返回與此選項卡窗格關聯的模型。

另請參見:
setModel(javax.swing.SingleSelectionModel)

setModel

public void setModel(SingleSelectionModel model)
設置要用於此選項卡窗格的模型。

參數:
model - 要使用的模型
另請參見:
getModel()

getTabPlacement

public int getTabPlacement()
返回此選項卡窗格的選項卡佈局。

另請參見:
setTabPlacement(int)

setTabPlacement

public void setTabPlacement(int tabPlacement)
設置此選項卡窗格的選項卡佈局。可能的值為: 如果未設置,則預設值為 SwingConstants.TOP

參數:
tabPlacement - 關於內容的選項卡佈局
拋出:
IllegalArgumentException - 如果選項卡佈局的值不是以上的有效值之一

getTabLayoutPolicy

public int getTabLayoutPolicy()
返回在一次運行中不能放入所有的選項卡時,選項卡窗格使用的對選項卡進行佈局安排的策略。

從以下版本開始:
1.4
另請參見:
setTabLayoutPolicy(int)

setTabLayoutPolicy

public void setTabLayoutPolicy(int tabLayoutPolicy)
設置在一次運行中不能放入所有的選項卡時,選項卡窗格使用的對選項卡進行佈局安排的策略。可能的值為: 如果未通過 UI 進行設置,則預設值為 JTabbedPane.WRAP_TAB_LAYOUT

一些外觀可能只支持可能的佈局策略的一個子集,在這種情況下可以忽略此屬性的值。

參數:
tabLayoutPolicy - 用於安排選項卡的策略
拋出:
IllegalArgumentException - 如果 layoutPolicy 的值不是以上有效值之一
從以下版本開始:
1.4
另請參見:
getTabLayoutPolicy()

getSelectedIndex

public int getSelectedIndex()
返回當前選擇的此選項卡窗格的索引。如果當前沒有選擇選項卡,則返回 -1。

返回:
所選擇的選項卡的索引
另請參見:
setSelectedIndex(int)

setSelectedIndex

public void setSelectedIndex(int index)
設置所選擇的此選項卡窗格的索引。索引必須為有效的選項卡索引或為 -1,-1 指示不應該選擇選項卡(也可以用於選項卡窗格中沒有選項卡的情況)。如果在選項卡窗格中包含一個或多個選項卡時指定了 -1,則結果將是已定義的實作。

參數:
index - 要選擇的索引
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍(index < -1 || index >= tab count)
另請參見:
getSelectedIndex(), SingleSelectionModel.setSelectedIndex(int)

getSelectedComponent

public Component getSelectedComponent()
返回此選項卡窗格當前選擇的元件。如果當前沒有選擇選項卡,則返回 null

返回:
與選擇的選項卡對應的元件
另請參見:
setSelectedComponent(java.awt.Component)

setSelectedComponent

public void setSelectedComponent(Component c)
設置此選項卡窗格的已選元件。這將自動將 selectedIndex 設置為對應於指定元件的索引。

拋出:
IllegalArgumentException - 如果選項卡窗格中沒有元件
另請參見:
getSelectedComponent()

insertTab

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)

addTab

public void addTab(String title,
                   Icon icon,
                   Component component,
                   String tip)
添加由 title 和/或 icon 表示的 componenttip,其中任意一個都可以為 nullinsertTab 的覆寫方法。

參數:
title - 此選項卡中要顯示的標題
icon - 此選項卡中要顯示的圖標
component - 單擊此選項卡時要顯示的元件
tip - 此選項卡要顯示的工具提示
另請參見:
insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int), removeTabAt(int)

addTab

public void addTab(String title,
                   Icon icon,
                   Component component)
添加一個由 title 和/或 icon 表示的 component,其任意一個都可以為 nullinsertTab 的覆寫方法。

參數:
title - 此選項卡中要顯示的標題
icon - 此選項卡中要顯示的圖標
component - 單擊此選項卡時要顯示的元件
另請參見:
insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int), removeTabAt(int)

addTab

public void addTab(String title,
                   Component component)
添加一個由 title 表示,且沒有圖標的 componentinsertTab 的覆寫方法。

參數:
title - 此選項卡要顯示的標題
component - 單擊此選項卡時要顯示的元件
另請參見:
insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int), removeTabAt(int)

add

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)

add

public Component add(String title,
                     Component component)
添加具有指定選項卡標題的 componentinsertTab 的覆寫方法。

覆寫:
類別 Container 中的 add
參數:
title - 此選項卡要顯示的標題
component - 單擊此選項卡時要顯示的元件
返回:
此元件
另請參見:
insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int), removeTabAt(int)

add

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)

add

public void add(Component component,
                Object constraints)
將一個 component 添加到選項卡窗格中。如果 constraintsStringIcon,則它將用於選項卡標題,否則元件名稱將用作選項卡標題。insertTab 的覆寫方法。

覆寫:
類別 Container 中的 add
參數:
component - 單擊此選項卡時要顯示的元件
constraints - 選項卡中要顯示的物件
另請參見:
insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int), removeTabAt(int)

add

public void add(Component component,
                Object constraints,
                int index)
在指定的選項卡索引位置添加一個 component。如果 constraintsStringIcon,則它將用於選項卡標題,否則元件名稱將用作選項卡標題。insertTab 的覆寫方法。

覆寫:
類別 Container 中的 add
參數:
component - 單擊此選項卡時要顯示的元件
constraints - 選項卡中要顯示的物件
index - 插入新選項卡的位置
另請參見:
insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int), removeTabAt(int)

removeTabAt

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)

remove

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)

remove

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)

removeAll

public void removeAll()
tabbedpane 中移除所有選項卡及其相應元件。

覆寫:
類別 Container 中的 removeAll
另請參見:
addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String), removeTabAt(int)

getTabCount

public int getTabCount()
返回此 tabbedpane 的選項卡數。

返回:
指定了選項卡頁數的整數

getTabRunCount

public int getTabRunCount()
返回當前運行的用於顯示選項卡的選項卡數。

返回:
一個整數,如果 tabPlacementTOPBOTTOM,則此數給出了行數,如果 tabPlacementLEFTRIGHT,則此數給出了列數,如果此 tabbedpane 沒有設置 UI,則此數為 0

getTitleAt

public String getTitleAt(int index)
返回 index 位置的選項卡標題。

參數:
index - 正在被查詢的項的索引
返回:
index 位置的標題
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍(index < 0 || index >= tab count)
另請參見:
setTitleAt(int, java.lang.String)

getIconAt

public Icon getIconAt(int index)
返回 index 位置的選項卡圖標。

參數:
index - 正在被查詢的項的索引
返回:
index 位置的圖標
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍(index < 0 || index >= tab count)
另請參見:
setIconAt(int, javax.swing.Icon)

getDisabledIconAt

public Icon getDisabledIconAt(int index)
返回 index 位置的選項卡禁用圖標。如果在 index 位置不存在選項卡禁用圖標,則將該調用轉發到外觀,以從對應的啟用的 Icon 建構合適的禁用 Icon。一些外觀可能不呈現禁用的 Icon,在這種情況下將不創建禁用的 Icon。

參數:
index - 正在被查詢的項的索引
返回:
index 位置的圖標
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍(index < 0 || index >= tab count)
另請參見:
setDisabledIconAt(int, javax.swing.Icon)

getToolTipTextAt

public String getToolTipTextAt(int index)
返回 index 位置的選項卡工具提示文本。

參數:
index - 正在被查詢的項的索引
返回:
包含 index 位置的工具提示文本的字元串
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍(index < 0 || index >= tab count)
從以下版本開始:
1.3
另請參見:
setToolTipTextAt(int, java.lang.String)

getBackgroundAt

public Color getBackgroundAt(int index)
返回 index 位置的選項卡背景色。

參數:
index - 正在被查詢的項的索引
返回:
index 位置的選項卡背景色的 Color
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍(index < 0 || index >= tab count)
另請參見:
setBackgroundAt(int, java.awt.Color)

getForegroundAt

public Color getForegroundAt(int index)
返回 index 位置的選項卡背景色。

參數:
index - 正在被查詢的項的索引
返回:
index 位置的選項卡的前景 Color
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍(index < 0 || index >= tab count)
另請參見:
setForegroundAt(int, java.awt.Color)

isEnabledAt

public boolean isEnabledAt(int index)
返回當前是否啟用了 index 位置的選項卡。

參數:
index - 正在被查詢的項的索引
返回:
如果啟用了 index 位置的選項卡,則返回 true;否則返回 false
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍(index < 0 || index >= tab count)
另請參見:
setEnabledAt(int, boolean)

getComponentAt

public Component getComponentAt(int index)
返回 index 位置的元件。

參數:
index - 正在被查詢的項的索引
返回:
index 位置的 Component
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍(index < 0 || index >= tab count)
另請參見:
setComponentAt(int, java.awt.Component)

getMnemonicAt

public int getMnemonicAt(int tabIndex)
返回用於存取指定選項卡的鍵盤助記符。助記符是一個鍵,在與外觀的無鼠標修改鍵(通常為 Alt)一起使用時,它將啟動指定的選項卡。

參數:
tabIndex - 助記符參考的選項卡的索引
返回:
表示助記符的鍵程式碼;如果選項卡沒有指定助記符,則返回 -1
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍(tabIndex < 0 || tabIndex >= tab count)
從以下版本開始:
1.4
另請參見:
setDisplayedMnemonicIndexAt(int,int), setMnemonicAt(int,int)

getDisplayedMnemonicIndexAt

public int getDisplayedMnemonicIndexAt(int tabIndex)
返回作為索引的字元,外觀必須提供它來表示助記符字元。

參數:
tabIndex - 助記符要參考的選項卡索引
返回:
表示助記符字元(如果存在)的索引;否則返回 -1
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍(tabIndex < 0 || tabIndex >= tab count)
從以下版本開始:
1.4
另請參見:
setDisplayedMnemonicIndexAt(int,int), setMnemonicAt(int,int)

getBoundsAt

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)

setTitleAt

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)

setIconAt

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)

setDisabledIconAt

public void setDisabledIconAt(int index,
                              Icon disabledIcon)
index 位置的禁用圖標設置為 icon,它可以為 null。如果在該索引位置沒有選項卡,則會引發一個內部異常。

參數:
index - 圖標要被設置的位置的選項卡索引
disabledIcon - 當禁用時要在選項卡中顯示的圖標
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍(index < 0 || index >= tab count)
另請參見:
getDisabledIconAt(int)

setToolTipTextAt

public void setToolTipTextAt(int index,
                             String toolTipText)
index 位置的工具提示文本設置為 toolTipText,它可以為 null。如果在該索引位置沒有選項卡,則會引發一個內部異常。

參數:
index - 工具提示文本要被設置的位置選項卡索引
toolTipText - 選項卡中要顯示的工具提示文本
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍(index < 0 || index >= tab count)
從以下版本開始:
1.3
另請參見:
getToolTipTextAt(int)

setBackgroundAt

public void setBackgroundAt(int index,
                            Color background)
index 位置的背景色設置為 background,它可以為 null,在這種情況下選項卡的背景色預設為 tabbedpane 的背景色。如果在該索引位置沒有選項卡,則會引發一個內部異常。

參數:
index - 要設置背景色的位置的選項卡索引
background - 要在選項卡背景中顯示的顏色
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍(index < 0 || index >= tab count)
另請參見:
getBackgroundAt(int)

setForegroundAt

public void setForegroundAt(int index,
                            Color foreground)
index 位置的前景色設置為 foreground,它可以為 null,在這種情況下選項卡的前景色預設為此 tabbedpane 的前景色。如果在該索引位置沒有選項卡,則會引發一個內部異常。

參數:
index - 要設置前景色的位置的選項卡索引
foreground - 要作為選項卡前景色顯示的顏色
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍(index < 0 || index >= tab count)
另請參見:
getForegroundAt(int)

setEnabledAt

public void setEnabledAt(int index,
                         boolean enabled)
設置是否啟用 index 位置的選項卡。如果在該索引位置沒有選項卡,則會引發一個內部異常。

參數:
index - 要啟用/禁用的選項卡索引
enabled - 選項卡是否啟用
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍(index < 0 || index >= tab count)
另請參見:
isEnabledAt(int)

setComponentAt

public void setComponentAt(int index,
                           Component component)
index 位置的元件設置為 component。如果在該索引位置沒有選項卡,則會引發一個內部異常。

參數:
index - 此元件放置位置的選項卡索引
component - 選項卡的元件
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍(index < 0 || index >= tab count)
另請參見:
getComponentAt(int)

setDisplayedMnemonicIndexAt

public void setDisplayedMnemonicIndexAt(int tabIndex,
                                        int mnemonicIndex)
提供一個外觀的提示,此提示是關於文本中哪此字元必須被裝飾用來表示助記符。不是所有的外觀都支持此功能。-1 指示兩種情況,或者此選項卡沒有助記符,或者使用者不希望此選項卡顯示助記符。

此值隨著助記符相關屬性的改變(例如助記符本身、文本等等)而更新。如果不需要預設字元帶有下劃線,則不必調用此方法。例如,如果索引為 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 >= 選項卡標題的長度或 < -1
從以下版本開始:
1.4
另請參見:
setMnemonicAt(int,int), getDisplayedMnemonicIndexAt(int)

setMnemonicAt

public void setMnemonicAt(int tabIndex,
                          int mnemonic)
設置用於存取指定選項卡的鍵盤助記符。助記符是一個鍵,在與外觀的無鼠標修改鍵(通常為 Alt)一起使用時,它將啟動指定的選項卡。

助記符必須對應於鍵盤上的單個鍵,且必須使用 java.awt.event.KeyEvent 中定義的 VK_XXX 鍵程式碼之一來指定。助記符是不區分大小寫的,因此具有對應鍵程式碼的鍵事件將導致銨鈕被啟動,而不管 Shift 鍵是否按下。

這將更新指定選項卡所顯示的助記符屬性。

參數:
tabIndex - 助記符參考的選項卡的索引
mnemonic - 表示助記符的鍵程式碼
拋出:
IndexOutOfBoundsException - 如果 tabIndex 超出了範圍(tabIndex < 0 || tabIndex >= tab count
從以下版本開始:
1.4
另請參見:
getMnemonicAt(int), setDisplayedMnemonicIndexAt(int,int)

indexOfTab

public int indexOfTab(String title)
返回具有給定 title 的第一個選項卡索引,如果沒有具有此標題的選項卡,則返回 -1。

參數:
title - 選項卡的標題
返回:
title 比對的第一個選項卡索引,如果沒有具有此標題的選項卡,則返回 -1

indexOfTab

public int indexOfTab(Icon icon)
返回具有給定的 icon 的第一個選項卡索引,如果沒有具有此圖標的選項卡,則返回 -1。

參數:
icon - 選項卡的圖標
返回:
icon 比對的第一個選項卡索引,如果沒有具有此圖標的選項卡,則返回 -1

indexOfComponent

public int indexOfComponent(Component component)
返回指定元件的選項卡索引。如果此元件沒有選項卡,則返回 -1。

參數:
component - 選項卡的元件
返回:
與此元件比對的第一個選項卡,如果此元件沒有選項卡,則返回 -1

indexAtLocation

public int indexAtLocation(int x,
                           int y)
返回選項卡邊界與指定區域相交的選項卡索引。如果沒有與此區域相交的選項卡,則返回 -1。

參數:
x - 相對於此選項卡窗格的 x 位置
y - 相對於此選項卡窗格的 y 位置
返回:
與此位置相交的選項卡索引,如果沒有與此位置相交的選項卡,則返回 -1
從以下版本開始:
1.4

getToolTipText

public String getToolTipText(MouseEvent event)
返回由鼠標事件位置確定的元件的工具提示文本。

覆寫:
類別 JComponent 中的 getToolTipText
參數:
event - MouseEvent,它告知鼠標的當前位置
返回:
包含工具提示文本的 String

paramString

protected String paramString()
返回此 JTabbedPane 的字元串表示。此方法僅用於除錯目的,對於各個實作,所返回字元串的內容和格式可能有所不同。返回的字元串可能為空,但不可能為 null

覆寫:
類別 JComponent 中的 paramString
返回:
此 JTabbedPane 的字元串表示形式。

getAccessibleContext

public AccessibleContext getAccessibleContext()
獲取與此 JTabbedPane 關聯的 AccessibleContext。對於選項卡窗格,AccessibleContext 採用 AccessibleJTabbedPane 的形式。必要時創建新的 AccessibleJTabbedPane 實例。

指定者:
介面 Accessible 中的 getAccessibleContext
覆寫:
類別 JComponent 中的 getAccessibleContext
返回:
一個 AccessibleJTabbedPane,它充當此 JTabbedPane 的 AccessibleContext

setTabComponentAt

public void setTabComponentAt(int index,
                              Component component)
設置負責呈現指定選項卡標題的元件。null 值意味著 JTabbedPane 將呈現指定選項卡的標題和/或圖標。非 null 值意味著該元件將呈現標題,並且 JTabbedPane 將不呈現標題和/或圖標。

註:該元件不得是開發人員已添加到選項卡面板中的元件之一。

參數:
index - 應該在其中設置元件的選項卡索引
component - 要呈現指定選項卡標題的元件
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍 (index < 0 || index >= tab count)
IllegalArgumentException - 如果元件已添加到此 JTabbedPane
從以下版本開始:
1.6
另請參見:
getTabComponentAt(int)

getTabComponentAt

public Component getTabComponentAt(int index)
返回 index 位置上的選項卡元件。

參數:
index - 被查詢的項的索引
返回:
index 位置上的選項卡元件
拋出:
IndexOutOfBoundsException - 如果索引超出了範圍 (index < 0 || index >= tab count)
從以下版本開始:
1.6
另請參見:
setTabComponentAt(int, java.awt.Component)

indexOfTabComponent

public int indexOfTabComponent(Component tabComponent)
返回指定選項卡元件的選項卡索引。如果此選項卡元件沒有選項卡,則返回 -1。

參數:
tabComponent - 該選項卡的選項卡元件
返回:
比對此選項卡元件的第一個選項卡;如果此選項卡元件沒有選項卡,則返回 -1
從以下版本開始:
1.6
另請參見:
setTabComponentAt(int, java.awt.Component), getTabComponentAt(int)

JavaTM 2 Platform
Standard Ed. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only