Класс JTabbedPane
- Все реализованные интерфейсы:
ImageObserver, MenuContainer, Serializable, Accessible, SwingConstants
@JavaBean(defaultProperty="UI", description="A component which provides a tab folder metaphor for displaying one component from a set of components.") public class JTabbedPane extends JComponent implements Serializable, Accessible, SwingConstants
Вкладки/компоненты добавляются в объект TabbedPane с помощью методов addTab и insertTab. Вкладка представлена индексом, соответствующим позиции, в которой она была добавлена: индекс первой вкладки равен 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 с потоками.
Предупреждение: Сериализованные объекты этого класса будут несовместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для краткосрочного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4 в пакете java.beans добавлена поддержка долгосрочного хранения всех JavaBeans. См. XMLEncoder.
- Начиная с версии:
- 1.2
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
protected class |
JTabbedPane.AccessibleJTabbedPane |
Этот класс реализует поддержку специальных возможностей для класса JTabbedPane. |
protected class |
JTabbedPane.ModelListener |
Мы передаём события ModelChanged слушателям, связанным с панелью вкладок (а не самой модели), в качестве источника событий. |
Вложенные классы/интерфейсы, объявленные в классе JComponent
JComponent.AccessibleJComponent
Вложенные классы/интерфейсы, объявленные в классе Container
Container.AccessibleAWTContainer
Вложенные классы/интерфейсы, объявленные в классе Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
protected ChangeEvent |
changeEvent |
Для каждого экземпляра TabPane достаточно только одного ChangeEvent, поскольку единственное (доступное только для чтения) состояние события — это свойство источника. |
protected ChangeListener |
changeListener |
changeListener — это слушатель, которого мы добавляем к модели. |
protected SingleSelectionModel |
model |
Модель выбора по умолчанию |
static final int |
SCROLL_TAB_LAYOUT |
Политика компоновки вкладок для отображения части доступных вкладок, если все вкладки не помещаются в один ряд. |
protected int |
tabPlacement |
Расположение вкладок. |
static final int |
WRAP_TAB_LAYOUT |
Политика компоновки вкладок, определяющая их перенос на несколько рядов, если все вкладки не помещаются в один ряд. |
Поля, объявленные в классе JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Поля, объявленные в классе Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Поля, объявленные в интерфейсе ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Поля, объявленные в интерфейсе SwingConstants
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
JTabbedPane() |
Создаёт пустой TabbedPane с расположением вкладок по умолчанию JTabbedPane.TOP. |
JTabbedPane |
Создаёт пустой TabbedPane с указанным расположением вкладок: JTabbedPane.TOP, JTabbedPane.BOTTOM, JTabbedPane.LEFT или JTabbedPane.RIGHT. |
JTabbedPane |
Создаёт пустой TabbedPane с указанным расположением вкладок и политикой их компоновки. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
Component |
add |
Добавляет component с заголовком вкладки, по умолчанию совпадающим с именем компонента, которое возвращает вызов component.getName. |
Component |
add |
Добавляет component с указанным индексом вкладки; заголовок вкладки по умолчанию совпадает с именем компонента. |
void |
add |
Добавляет component на панель вкладок. |
void |
add |
Добавляет component с указанным индексом вкладки. |
Component |
add |
Добавляет component с указанным заголовком вкладки. |
void |
addChangeListener |
Добавляет ChangeListener на эту панель вкладок. |
void |
addTab |
Добавляет component, представленную title без значка. |
void |
addTab |
Добавляет component, представленную title и/или icon; любой из них может быть null. |
void |
addTab |
Добавляет component и tip, представленные title и/или icon; любой из них может быть null. |
protected ChangeListener |
createChangeListener() |
Подклассы, которым требуется другая обработка ChangeEvents, могут переопределить этот метод так, чтобы он возвращал подкласс ModelListener или другую реализацию ChangeListener. |
protected void |
fireStateChanged() |
Отправляет ChangeEvent с этим JTabbedPane в качестве источника каждому зарегистрированному слушателю. |
AccessibleContext |
getAccessibleContext() |
Возвращает AccessibleContext, связанный с этим JTabbedPane. |
Color |
getBackgroundAt |
Возвращает цвет фона вкладки с индексом index. |
Rectangle |
getBoundsAt |
Возвращает границы вкладки с индексом index. |
ChangeListener[] |
getChangeListeners() |
Возвращает массив всех ChangeListeners, добавленных в этот JTabbedPane с помощью addChangeListener. |
Component |
getComponentAt |
Возвращает компонент с индексом index. |
Icon |
getDisabledIconAt |
Возвращает значок отключённой вкладки с индексом index. |
int |
getDisplayedMnemonicIndexAt |
Возвращает символ в виде индекса, для которого внешний вид и стиль должны обеспечить оформление, обозначающее мнемонический символ. |
Color |
getForegroundAt |
Возвращает цвет текста вкладки с индексом index. |
Icon |
getIconAt |
Возвращает значок вкладки с индексом index. |
int |
getMnemonicAt |
Возвращает мнемоническую клавишу для доступа к указанной вкладке. |
SingleSelectionModel |
getModel() |
Возвращает модель, связанную с этой панелью вкладок. |
Component |
getSelectedComponent() |
Возвращает текущий выбранный компонент этой панели вкладок. |
int |
getSelectedIndex() |
Возвращает текущий выбранный индекс этой панели вкладок. |
Component |
getTabComponentAt |
Возвращает компонент вкладки с индексом index. |
int |
getTabCount() |
Возвращает количество вкладок в этом tabbedpane. |
int |
getTabLayoutPolicy() |
Возвращает политику, используемую панелью вкладок для компоновки вкладок, когда они не помещаются в один ряд. |
int |
getTabPlacement() |
Возвращает расположение вкладок этой панели вкладок. |
int |
getTabRunCount() |
Возвращает количество рядов вкладок, используемых в данный момент для их отображения. |
String |
getTitleAt |
Возвращает заголовок вкладки с индексом index. |
String |
getToolTipText |
Возвращает текст всплывающей подсказки для компонента, определённого по расположению события мыши. |
String |
getToolTipTextAt |
Возвращает текст всплывающей подсказки вкладки с индексом index. |
TabbedPaneUI |
getUI() |
Возвращает объект пользовательского интерфейса, реализующий внешний вид и стиль этого компонента. |
String |
getUIClassID() |
Возвращает имя класса пользовательского интерфейса, реализующего внешний вид и стиль этого компонента. |
int |
indexAtLocation |
Возвращает индекс вкладки, границы которой пересекаются с указанным расположением. |
int |
indexOfComponent |
Возвращает индекс вкладки для указанного компонента. |
int |
indexOfTab |
Возвращает индекс первой вкладки с заданным title или -1, если вкладки с таким заголовком нет. |
int |
indexOfTab |
Возвращает индекс первой вкладки с заданным icon или -1, если вкладки с таким значком нет. |
int |
indexOfTabComponent |
Возвращает индекс вкладки для указанного компонента вкладки. |
void |
insertTab |
Вставляет новую вкладку для указанного компонента с заданным индексом, представленную заданным заголовком и/или значком; любой из них может быть null. |
boolean |
isEnabledAt |
Возвращает значение, указывающее, включена ли в данный момент вкладка с индексом index. |
protected String |
paramString() |
Возвращает строковое представление этого JTabbedPane. |
void |
remove |
Удаляет вкладку и компонент, соответствующие указанному индексу. |
void |
remove |
Удаляет указанный Component из JTabbedPane. |
void |
removeAll() |
Удаляет все вкладки и соответствующие им компоненты из tabbedpane. |
void |
removeChangeListener |
Удаляет ChangeListener из этой панели вкладок. |
void |
removeTabAt |
Удаляет вкладку с индексом index. |
void |
setBackgroundAt |
Устанавливает цвет фона вкладки с индексом index в background, который может быть null; в этом случае цвет фона вкладки будет совпадать с цветом фона tabbedpane. |
void |
setComponentAt |
Устанавливает для компонента с индексом index значение component. |
void |
setDisabledIconAt |
Устанавливает для отключённого значка с индексом index значение icon, которое может быть null. |
void |
setDisplayedMnemonicIndexAt |
Сообщает внешнему виду и стилю, какой символ в тексте следует оформить как мнемонический. |
void |
setEnabledAt |
Устанавливает, включена ли вкладка с индексом index. |
void |
setForegroundAt |
Устанавливает цвет текста вкладки с индексом index в foreground, который может быть null; в этом случае цвет текста вкладки будет совпадать с цветом текста этого tabbedpane. |
void |
setIconAt |
Устанавливает значок вкладки с индексом index в icon, который может быть null. |
void |
setMnemonicAt |
Устанавливает мнемоническую клавишу для доступа к указанной вкладке. |
void |
setModel |
Устанавливает модель, используемую этой панелью вкладок. |
void |
setSelectedComponent |
Устанавливает выбранный компонент этой панели вкладок. |
void |
setSelectedIndex |
Устанавливает выбранный индекс этой панели вкладок. |
void |
setTabComponentAt |
Устанавливает компонент, отвечающий за отображение заголовка указанной вкладки. |
void |
setTabLayoutPolicy |
Устанавливает политику компоновки вкладок, которую панель будет использовать, если все вкладки не помещаются в один ряд. |
void |
setTabPlacement |
Устанавливает расположение вкладок этой панели вкладок. |
void |
setTitleAt |
Устанавливает заголовок вкладки с индексом index в title, которое может быть null. |
void |
setToolTipTextAt |
Устанавливает текст всплывающей подсказки вкладки с индексом index в toolTipText, который может быть null. |
void |
setUI |
Устанавливает объект пользовательского интерфейса, реализующий внешний вид и стиль этого компонента. |
void |
updateUI() |
Сбрасывает свойство пользовательского интерфейса, устанавливая его в значение из текущего внешнего вида и стиля. |
Методы, объявленные в классе 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
Методы, объявленные в классе 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
Методы, объявленные в классе 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
Подробное описание полей
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
protected SingleSelectionModel model
changeListener
protected ChangeListener changeListener
changeListener — это слушатель, добавляемый нами к модели.changeEvent
protected transient ChangeEvent changeEvent
TabPane нужен только один ChangeEvent, поскольку единственное его (доступное только для чтения) состояние — это свойство источника. Источником событий, генерируемых здесь, всегда является «this».Подробное описание конструкторов
JTabbedPane
public JTabbedPane()
TabbedPane с расположением вкладок по умолчанию JTabbedPane.TOP.- См. также:
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
- См. также:
Подробное описание методов
getUI
public TabbedPaneUI getUI()
- Переопределяет:
-
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 - См. также:
updateUI
public void updateUI()
- Переопределяет:
-
updateUIв классеJComponent - См. также:
getUIClassID
@BeanProperty(bound=false) public String getUIClassID()
- Переопределяет:
-
getUIClassIDв классеJComponent - Возвращает:
- строку "TabbedPaneUI"
- См. также:
createChangeListener
protected ChangeListener createChangeListener()
ChangeEvents иначе, могут переопределить этот метод, чтобы вернуть подкласс ModelListener или другую реализацию ChangeListener.- Возвращает:
- объект
ChangeListener - См. также:
addChangeListener
public void addChangeListener(ChangeListener l)
ChangeListener в эту панель вкладок.- Параметры:
-
l— добавляемыйChangeListener - См. также:
removeChangeListener
public void removeChangeListener(ChangeListener l)
ChangeListener из этой панели вкладок.- Параметры:
-
l— удаляемыйChangeListener - См. также:
getChangeListeners
@BeanProperty(bound=false) public ChangeListener[] getChangeListeners()
ChangeListener, добавленных в этот JTabbedPane с помощью addChangeListener.- Возвращает:
- всех добавленных слушателей
ChangeListenerили пустой массив, если слушатели не добавлялись - С версии:
- 1.4
fireStateChanged
protected void fireStateChanged()
ChangeEvent с этим JTabbedPane в качестве источника каждому зарегистрированному слушателю. Этот метод вызывается при каждом изменении выбранного индекса или выбранной вкладки в JTabbedPane. Обычно выбранный индекс и выбранная вкладка меняются одновременно. Однако в некоторых случаях, например при добавлении вкладки, выбранный индекс меняется, а выбранной остается та же вкладка. В других случаях, например при удалении выбранной вкладки, индекс остается прежним, но на это место перемещается новая вкладка. События генерируются во всех этих случаях.- См. также:
getModel
public SingleSelectionModel 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— если значение layoutPolicy не входит в число допустимых значений, перечисленных выше - С версии:
- 1.4
- См. также:
getSelectedIndex
public int getSelectedIndex()
- Возвращает:
- индекс выбранной вкладки
- См. также:
setSelectedIndex
@BeanProperty(bound=false, preferred=true, description="The tabbedpane's selected tab index.") public void setSelectedIndex(int index)
- Параметры:
-
index— индекс выбираемой вкладки - Исключения:
-
IndexOutOfBoundsException— если индекс выходит за допустимый диапазон(index < -1 || index >= tab count) - См. также:
getSelectedComponent
public Component getSelectedComponent()
null.- Возвращает:
- компонент, соответствующий выбранной вкладке
- См. также:
setSelectedComponent
@BeanProperty(bound=false, preferred=true, description="The tabbedpane's selected component.") public void setSelectedComponent(Component c)
selectedIndex автоматически устанавливается в индекс, соответствующий указанному компоненту.- Параметры:
-
c— выбранныйComponentдля этойTabbedPane - Исключения:
-
IllegalArgumentException— если компонент не найден в панели вкладок - См. также:
insertTab
public void insertTab(String title, Icon icon, Component component, String tip, int index)
null.- Параметры:
-
title— заголовок, отображаемый на вкладке -
icon— значок, отображаемый на вкладке -
component— компонент, отображаемый при нажатии на эту вкладку. -
tip— всплывающая подсказка для этой вкладки -
index— позиция для вставки новой вкладки(index >= 0 && index <= getTabCount()) - Исключения:
-
IndexOutOfBoundsException— если индекс выходит за допустимый диапазон(index < 0 || index > getTabCount()) - См. также:
addTab
public void addTab(String title, Icon icon, Component component, String tip)
component и tip, представленные title и/или icon, любое из которых может быть null. Вспомогательный метод для insertTab.- Параметры:
-
title— заголовок, отображаемый на этой вкладке -
icon— значок, отображаемый на этой вкладке -
component— компонент, отображаемый при нажатии на эту вкладку -
tip— всплывающая подсказка для этой вкладки - См. также:
addTab
public void addTab(String title, Icon icon, Component component)
component, представленный title и/или icon, любое из которых может быть null. Вспомогательный метод для insertTab.- Параметры:
-
title— заголовок, отображаемый на этой вкладке -
icon— значок, отображаемый на этой вкладке -
component— компонент, отображаемый при нажатии на эту вкладку - См. также:
addTab
public void addTab(String title, Component component)
component, представленный title без значка. Вспомогательный метод для insertTab.- Параметры:
-
title— заголовок, отображаемый на этой вкладке -
component— компонент, отображаемый при нажатии на эту вкладку - См. также:
add
public Component add(Component component)
component, заголовком вкладки по умолчанию становится имя компонента, полученное в результате вызова component.getName. Вспомогательный метод для insertTab.add
public Component add(String title, Component component)
component с указанным заголовком вкладки. Вспомогательный метод для insertTab.add
public Component add(Component component, int index)
component с указанным индексом вкладки; заголовком вкладки по умолчанию становится имя компонента. Вспомогательный метод для insertTab.add
public void add(Component component, Object constraints)
component на панель вкладок. Если constraints является String или Icon, он будет использоваться в качестве заголовка вкладки; в противном случае заголовком станет имя компонента. Вспомогательный метод для insertTab.add
public void add(Component component, Object constraints, int index)
component с указанным индексом вкладки. Если constraints является String или Icon, он будет использоваться в качестве заголовка вкладки; в противном случае заголовком станет имя компонента. Вспомогательный метод для insertTab.removeTabAt
public void removeTabAt(int index)
index. После удаления компонента, связанного с index, его видимость снова устанавливается в true, чтобы он оставался видимым при добавлении в другие контейнеры.- Параметры:
-
index— индекс удаляемой вкладки - Исключения:
-
IndexOutOfBoundsException— если индекс выходит за допустимый диапазон(index < 0 || index >= tab count) - См. также:
remove
remove
public void remove(int index)
- Переопределяет:
-
removeв классеContainer - Параметры:
-
index— индекс компонента, удаляемого изtabbedpane - Исключения:
-
IndexOutOfBoundsException— если индекс выходит за допустимый диапазон(index < 0 || index >= tab count) - См. также:
removeAll
getTabCount
@BeanProperty(bound=false) public int getTabCount()
tabbedpane.- Возвращает:
- целое число, задающее количество страниц с вкладками
getTabRunCount
@BeanProperty(bound=false) public int getTabRunCount()
- Возвращает:
- целое число, задающее количество строк, если
tabPlacementравноTOPилиBOTTOM, и количество столбцов, еслиtabPlacementравноLEFTилиRIGHT; если для этогоtabbedpaneне задан интерфейс UI, возвращается 0
getTitleAt
public String getTitleAt(int index)
index.- Параметры:
-
index— индекс запрашиваемого элемента - Возвращает:
- заголовок с индексом
index - Исключения:
-
IndexOutOfBoundsException— если индекс выходит за допустимый диапазон(index < 0 || index >= tab count) - См. также:
getIconAt
public Icon getIconAt(int index)
index.- Параметры:
-
index— индекс запрашиваемого элемента - Возвращает:
- значок с индексом
index - Исключения:
-
IndexOutOfBoundsException— если индекс выходит за допустимый диапазон(index < 0 || index >= tab count) - См. также:
getDisabledIconAt
public Icon getDisabledIconAt(int index)
index. Если отключённый значок вкладки отсутствует в index, вызов будет перенаправлен в механизм оформления для создания подходящего отключённого значка на основе соответствующего включённого значка. Некоторые механизмы оформления могут не отображать отключённый значок, и в этом случае он не будет создан.- Параметры:
-
index— индекс запрашиваемого элемента - Возвращает:
- значок в
index - Выбрасывает:
-
IndexOutOfBoundsException— если индекс выходит за допустимые пределы(index < 0 || index >= tab count) - См. также:
getToolTipTextAt
public String getToolTipTextAt(int index)
index.- Параметры:
-
index— индекс запрашиваемого элемента - Возвращает:
- строку с текстом всплывающей подсказки в
index - Выбрасывает:
-
IndexOutOfBoundsException— если индекс выходит за допустимые пределы(index < 0 || index >= tab count) - С версии:
- 1.3
- См. также:
getBackgroundAt
public Color getBackgroundAt(int index)
index.- Параметры:
-
index— индекс запрашиваемого элемента - Возвращает:
Colorфона вкладки вindex- Выбрасывает:
-
IndexOutOfBoundsException— если индекс выходит за допустимые пределы(index < 0 || index >= tab count) - См. также:
getForegroundAt
public Color getForegroundAt(int index)
index.- Параметры:
-
index— индекс запрашиваемого элемента - Возвращает:
Colorпереднего плана вкладки вindex- Выбрасывает:
-
IndexOutOfBoundsException— если индекс выходит за допустимые пределы(index < 0 || index >= tab count) - См. также:
isEnabledAt
public boolean isEnabledAt(int index)
index.- Параметры:
-
index— индекс запрашиваемого элемента - Возвращает:
- true, если вкладка в
indexвключена; в противном случае false - Выбрасывает:
-
IndexOutOfBoundsException— если индекс выходит за допустимые пределы(index < 0 || index >= tab count) - См. также:
getComponentAt
public Component getComponentAt(int index)
index.- Параметры:
-
index— индекс запрашиваемого элемента - Возвращает:
Componentвindex- Выбрасывает:
-
IndexOutOfBoundsException— если индекс выходит за допустимые пределы(index < 0 || index >= tab count) - См. также:
getMnemonicAt
public int getMnemonicAt(int tabIndex)
- Параметры:
-
tabIndex— индекс вкладки, к которой относится мнемоническая клавиша - Возвращает:
- код клавиши, представляющий мнемоническую клавишу; -1, если мнемоническая клавиша для вкладки не задана
- Выбрасывает:
-
IndexOutOfBoundsException— если индекс выходит за допустимые пределы (tabIndex< 0 ||tabIndex>= количество вкладок) - С версии:
- 1.4
- См. также:
getDisplayedMnemonicIndexAt
public int getDisplayedMnemonicIndexAt(int tabIndex)
- Параметры:
-
tabIndex— индекс вкладки, к которой относится мнемоническая клавиша - Возвращает:
- индекс символа мнемонической клавиши, если он существует; в противном случае возвращает -1
- Выбрасывает:
-
IndexOutOfBoundsException— если индекс выходит за допустимые пределы (tabIndex< 0 ||tabIndex>= количество вкладок) - С версии:
- 1.4
- См. также:
getBoundsAt
public Rectangle getBoundsAt(int index)
index. Если вкладка с этим индексом в данный момент не видна в пользовательском интерфейсе, возвращает null. Если для этого tabbedpane не задан пользовательский интерфейс, возвращает null.- Параметры:
-
index— индекс для запроса - Возвращает:
Rectangle, содержащий границы вкладки вindex, либоnull, если вкладка вindexв данный момент не видна в пользовательском интерфейсе или для этогоtabbedpaneне задан пользовательский интерфейс- Выбрасывает:
-
IndexOutOfBoundsException— если индекс выходит за допустимые пределы(index < 0 || index >= tab count)
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 >= tab count) - См. также:
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 >= tab count) - См. также:
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 >= tab count) - См. также:
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 >= tab count) - С версии:
- 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 >= tab count) - См. также:
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 >= tab count) - См. также:
setEnabledAt
public void setEnabledAt(int index, boolean enabled)
index. Если вкладки с таким индексом нет, возникает внутреннее исключение.- Параметры:
-
index— индекс вкладки, которую нужно включить или отключить -
enabled— следует ли включить вкладку - Выбрасывает:
-
IndexOutOfBoundsException— если индекс выходит за допустимые пределы(index < 0 || index >= tab count) - См. также:
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 >= tab count) - См. также:
setDisplayedMnemonicIndexAt
@BeanProperty(visualUpdate=true, description="the index into the String to draw the keyboard character mnemonic at") public void setDisplayedMnemonicIndexAt(int tabIndex, int mnemonicIndex)
Значение обновляется при изменении свойств, связанных с мнемонической клавишей (например, самой клавиши, текста и т. д.). Вызывать этот метод нужно только в том случае, если вы не хотите подчёркивать символ по умолчанию. Например, если текст вкладки с индексом 3 — «Apple Price», мнемоническая клавиша — «p», и вы хотите выделить символ «P» так, чтобы получилось «Apple Price», необходимо вызвать setDisplayedMnemonicIndex(3, 6) после вызова setMnemonicAt(3, KeyEvent.VK_P).
Обратите внимание: программист отвечает за то, чтобы у каждой вкладки была уникальная мнемоническая клавиша; в противном случае возможны непредсказуемые результаты.
- Параметры:
-
tabIndex— индекс вкладки, к которой относится мнемоническая клавиша -
mnemonicIndex— индекс символа вString, который нужно подчеркнуть - Выбрасывает:
-
IndexOutOfBoundsException— еслиtabIndexвыходит за допустимые пределы (tabIndex < 0 || tabIndex >= tab count) -
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)
Мнемоническая клавиша должна соответствовать одной клавише на клавиатуре и задаваться с помощью одного из VK_XXX кодов клавиш, определённых в java.awt.event.KeyEvent, или одного из расширенных кодов клавиш, полученных с помощью java.awt.event.KeyEvent.getExtendedKeyCodeForChar. Мнемонические клавиши нечувствительны к регистру, поэтому событие клавиши с соответствующим кодом активирует кнопку независимо от того, была ли нажата клавиша Shift.
Этот метод обновит свойство отображаемой мнемонической клавиши для указанной вкладки.
- Параметры:
-
tabIndex— индекс вкладки, к которой относится мнемоническая клавиша -
mnemonic— код клавиши, представляющий мнемоническую клавишу - Выбрасывает:
-
IndexOutOfBoundsException— еслиtabIndexвыходит за допустимые пределы (tabIndex < 0 || tabIndex >= tab count) - С версии:
- 1.4
- См. также:
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)
- Параметры:
-
component— компонент вкладки - Возвращает:
- первая вкладка, соответствующая этому компоненту, или -1, если вкладки для этого компонента нет
indexAtLocation
public int indexAtLocation(int x, int y)
- Параметры:
-
x— координата x относительно этой панели вкладок -
y— координата y относительно этой панели вкладок - Возвращает:
- индекс вкладки, пересекающейся с указанной точкой, или -1, если ни одна вкладка не пересекается с этой точкой
- С версии:
- 1.4
getToolTipText
public String getToolTipText(MouseEvent event)
- Переопределяет:
-
getToolTipTextв классеJComponent - Параметры:
-
event—MouseEvent, указывающее, где находится курсор - Возвращает:
String, содержащий текст всплывающей подсказки
paramString
protected String paramString()
JTabbedPane. Этот метод предназначен только для отладки, а содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть null.- Переопределяет:
-
paramStringв классеJComponent - Возвращает:
- строковое представление этого JTabbedPane.
getAccessibleContext
@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
- Определён в:
-
getAccessibleContextв интерфейсеAccessible - Переопределяет:
-
getAccessibleContextв классеComponent - Возвращает:
- AccessibleJTabbedPane, служащий AccessibleContext этого JTabbedPane
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 >= tab count) -
IllegalArgumentException— если компонент уже добавлен в этотJTabbedPane - С версии:
- 1.6
- См. также:
getTabComponentAt
public Component getTabComponentAt(int index)
index.- Параметры:
-
index— индекс запрашиваемого элемента - Возвращает:
- компонент вкладки в
index - Выбрасывает:
-
IndexOutOfBoundsException— если индекс выходит за допустимые пределы(index < 0 || index >= tab count) - С версии:
- 1.6
- См. также:
indexOfTabComponent
public int indexOfTabComponent(Component tabComponent)
- Параметры:
-
tabComponent— компонент вкладки - Возвращает:
- первая вкладка, соответствующая этому компоненту вкладки, или -1, если вкладки для этого компонента нет
- С версии:
- 1.6
- См. также:
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/JTabbedPane.html