Класс 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, добавлена поддержка долгосрочного хранения всех JavaBeans в пакете java.beans. Подробнее см. XMLEncoder.
- С:
- 1.2
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
protected class |
JTabbedPane.AccessibleJTabbedPane |
Этот класс реализует поддержку доступности для класса JTabbedPane. |
protected class |
JTabbedPane.ModelListener |
Мы передаём события ModelChanged слушателям, используя JTabbedPane в качестве источника событий (вместо модели). |
Вложенные классы/интерфейсы, объявленные в классе javax.swing.JComponent
JComponent.AccessibleJComponent
Вложенные классы/интерфейсы, объявленные в классе java.awt.Container
Container.AccessibleAWTContainer
Вложенные классы/интерфейсы, объявленные в классе java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
protected ChangeEvent |
changeEvent |
Только один ChangeEvent необходим на экземпляр TabPane, поскольку единственное состояние события (только для чтения) — свойство источника. |
protected ChangeListener |
changeListener |
changeListener — это слушатель, который мы добавляем к модели. |
protected SingleSelectionModel |
model |
Модель выбора по умолчанию |
static final int |
SCROLL_TAB_LAYOUT |
Политика выравнивания вкладок для предоставления подмножества доступных вкладок, когда все вкладки не помещаются в один ряд. |
protected int |
tabPlacement |
Место расположения вкладок. |
static final int |
WRAP_TAB_LAYOUT |
Политика выравнивания вкладок для перехода на несколько строк, когда все вкладки не помещаются в один ряд. |
Поля, объявленные в классе javax.swing.JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Поля, объявленные в классе java.awt.Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Поля, объявленные в интерфейсе java.awt.image.ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Поля, объявленные в интерфейсе 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
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
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() |
Возвращает массив всех ChangeListener, добавленных в эту 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() |
Возвращает объект пользовательского интерфейса, реализующий L&F для этого компонента. |
String |
getUIClassID() |
Возвращает имя класса пользовательского интерфейса, реализующего L&F для этого компонента. |
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 |
Устанавливает объект UI, реализующий L&F для этого компонента. |
void |
updateUI() |
Сбрасывает свойство UI до значения из текущей темы оформления. |
Methods declared in class javax.swing.JComponent
addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
Methods declared in class java.awt.Container
addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
Methods declared in class java.awt.Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
Подробное описание полей
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
changeEvent
protected transient ChangeEvent changeEvent
Подробное описание конструкторов
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 к этому компоненту tabbedpane.- Параметры:
-
l- добавляемый прослушительChangeListener - См. также:
removeChangeListener
public void removeChangeListener(ChangeListener l)
ChangeListener из этого компонента tabbedpane.- Параметры:
-
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, связанную с этим компонентом tabbedpane - См. также:
setModel
@BeanProperty(description="The tabbedpane's SingleSelectionModel.") public void setModel(SingleSelectionModel model)
- Параметры:
-
model- используемая модель - См. также:
getTabPlacement
public int getTabPlacement()
- Возвращает:
- перечисление
int, определяющее расположение вкладок - См. также:
Установка расположения вкладок
@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
- См. также:
Установка политики выравнивания вкладок
@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
- См. также:
Возвращение индекса выбранной вкладки
public int getSelectedIndex()
- Возвращает:
- индекс выбранной вкладки
- См. также:
Установка индекса выбранной вкладки
@BeanProperty(bound=false, preferred=true, description="The tabbedpane's selected tab index.") public void setSelectedIndex(int index)
- Параметры:
-
index- индекс для выбора - Исключения:
-
IndexOutOfBoundsException- если индекс находится за пределами допустимого диапазона(index < -1 || index >= tab count) - См. также:
Возвращение выбранного компонента
public Component getSelectedComponent()
null, если нет текущей выбранной вкладки.- Возвращает:
- компонент, соответствующий выбранной вкладке
- См. также:
Установка выбранного компонента
@BeanProperty(bound=false, preferred=true, description="The tabbedpane's selected component.") public void setSelectedComponent(Component c)
selectedIndex в индекс, соответствующий указанному компоненту.- Параметры:
-
c- выбранныйComponentдля этойTabbedPane - Исключения:
-
IllegalArgumentException- если компонент не найден на панели вкладок - См. также:
Вставка вкладки
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()) - См. также:
Добавление вкладки
public void addTab(String title, Icon icon, Component component, String tip)
component и tip, представленные title и/или icon, любой из которых может быть null. Метод-обёртка для insertTab.- Параметры:
-
title- заголовок, отображаемый на вкладке -
icon- значок, отображаемый на вкладке -
component- компонент, отображаемый при нажатии на эту вкладку -
tip- всплывающая подсказка для этой вкладки - См. также:
Добавление вкладки
public void addTab(String title, Icon icon, Component component)
component, представленную title и/или icon, любой из которых может быть null. Метод-обёртка для insertTab.- Параметры:
-
title- заголовок, отображаемый на вкладке -
icon- значок, отображаемый на вкладке -
component- компонент, отображаемый при нажатии на эту вкладку - См. также:
Добавление вкладки
public void addTab(String title, Component component)
component, представленную title и без значка. Метод-обёртка для insertTab.- Параметры:
-
title- заголовок, отображаемый на вкладке -
component- компонент, отображаемый при нажатии на эту вкладку - См. также:
Добавление компонента
public Component add(Component component)
component с заголовком вкладки по умолчанию, равным имени компонента, полученного вызовом component.getName. Метод-обёртка для insertTab.Добавление компонента
public Component add(String title, Component component)
component со строковым заголовком вкладки. Метод-обёртка для insertTab.добавить
public Component add(Component component, int index)
insertTab.добавить
public void add(Component component, Object constraints)
constraints является String или Icon, оно будет использовано в качестве заголовка вкладки; в противном случае будет использовано имя компонента. Метод-обёртка для insertTab.добавить
public void add(Component component, Object constraints, int index)
constraints является String или Icon, оно будет использовано в качестве заголовка вкладки; в противном случае будет использовано имя компонента. Метод-обёртка для insertTab.удалитьВкладкуПоИндексу
public void removeTabAt(int index)
index. После удаления компонента, связанного с index, его видимость сбрасывается в true, чтобы обеспечить его видимость, если он будет добавлен в другие контейнеры.- Параметры:
-
index- индекс вкладки, подлежащей удалению - Исключения:
-
IndexOutOfBoundsException- если индекс вне диапазона(index < 0 || index >= tab count) - См. также:
удалить
удалить
public void remove(int index)
- Overrides:
-
removeв классеContainer - Параметры:
-
index- индекс компонента для удаления изtabbedpane - Исключения:
-
IndexOutOfBoundsException- если индекс вне диапазона(index < 0 || index >= tab count) - См. также:
удалитьВсе
количествоВкладок
@BeanProperty(bound=false) public int getTabCount()
tabbedpane.- Возвращает:
- целое число, определяющее количество страниц вкладок
количествоРазворотовВкладок
@BeanProperty(bound=false) public int getTabRunCount()
- Возвращает:
- целое число, представляющее количество строк, если
tabPlacementявляетсяTOPилиBOTTOM, и количество столбцов, еслиtabPlacementявляетсяLEFTилиRIGHT, или 0, если для этогоtabbedpaneнет пользовательского интерфейса
получитьЗаголовокВкладки
public String getTitleAt(int index)
index.- Параметры:
-
index- индекс запрашиваемого элемента - Возвращает:
- заголовок по указанному
index - Исключения:
-
IndexOutOfBoundsException- если индекс вне диапазона(index < 0 || index >= tab count) - См. также:
получитьИконкуВкладки
public Icon getIconAt(int index)
index.- Параметры:
-
index- индекс запрашиваемого элемента - Возвращает:
- иконку по указанному
index - Исключения:
-
IndexOutOfBoundsException- если индекс вне диапазона(index < 0 || index >= tab count) - См. также:
получитьИконкуВкладкиОтключена
public Icon getDisabledIconAt(int index)
index. Если иконка вкладки в состоянии отключения не существует по указанному index, вызов перенаправляется в обработчик внешнего вида, чтобы создать соответствующую иконку в состоянии отключения из соответствующей иконки в состоянии включения. Некоторые внешние виды могут не отображать иконку в состоянии отключения, в этом случае она не будет создана.- Параметры:
-
index- индекс запрашиваемого элемента - Возвращает:
- иконку по указанному
index - Исключения:
-
IndexOutOfBoundsException- если индекс вне диапазона(index < 0 || index >= tab count) - См. также:
получитьПодсказкуВкладки
public String getToolTipTextAt(int index)
index.- Параметры:
-
index- индекс запрашиваемого элемента - Возвращает:
- строка, содержащая текст всплывающей подсказки по указанному
index - Исключения:
-
IndexOutOfBoundsException- если индекс вне диапазона(index < 0 || index >= tab count) - Since:
- 1.3
- См. также:
получитьЦветФонаВкладки
public Color getBackgroundAt(int index)
index.- Параметры:
-
index- индекс запрашиваемого элемента - Возвращает:
- цвет фона вкладки по указанному
index - Исключения:
-
IndexOutOfBoundsException- если индекс вне диапазона(index < 0 || index >= tab count) - См. также:
получитьЦветТекстаВкладки
public Color getForegroundAt(int index)
index.- Параметры:
-
index- индекс запрашиваемого элемента - Возвращает:
- цвет текста вкладки по указанному
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- индекс запрашиваемого элемента - Возвращает:
- компонент по индексу
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. Внутреннее исключение генерируется, если нет вкладки в этом индексе.- Parameters:
-
index- индекс вкладки, где размещается этот компонент -
component- компонент для вкладки - Throws:
-
IndexOutOfBoundsException- если индекс находится вне допустимого диапазона(index < 0 || index >= tab count) - See Also:
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).
Обратите внимание, что программист несет ответственность за обеспечение уникальности мнемоники каждой вкладки, иначе могут возникнуть непредсказуемые результаты.
- Parameters:
-
tabIndex- индекс вкладки, к которой относится мнемоника -
mnemonicIndex- индекс вStringдля подчеркивания - Throws:
-
IndexOutOfBoundsException- еслиtabIndexнаходится вне допустимого диапазона (tabIndex < 0 || tabIndex >= tab count) -
IllegalArgumentException- будет выброшено, еслиmnemonicIndexбольше или равен длине заголовка вкладки, или меньше -1 - Since:
- 1.4
- See Also:
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.
Это обновит свойство отображаемой мнемоники для указанной вкладки.
- Parameters:
-
tabIndex- индекс вкладки, к которой относится мнемоника -
mnemonic- код клавиши, представляющий мнемонику - Throws:
-
IndexOutOfBoundsException- еслиtabIndexнаходится вне допустимого диапазона (tabIndex < 0 || tabIndex >= tab count) - Since:
- 1.4
- See Also:
indexOfTab
public int indexOfTab(String title)
title или -1, если нет вкладки с таким заголовком.- Parameters:
-
title- заголовок вкладки - Returns:
- индекс первой вкладки, соответствующей
title, или -1, если нет вкладки с таким заголовком
indexOfTab
public int indexOfTab(Icon icon)
icon, или -1, если нет вкладки с таким изображением.- Parameters:
-
icon- иконка для вкладки - Returns:
- индекс первой вкладки, соответствующей
icon, или -1, если нет вкладки с такой иконкой
indexOfComponent
public int indexOfComponent(Component component)
- Parameters:
-
component- компонент для вкладки - Returns:
- первая вкладка, соответствующая этому компоненту, или -1, если для этого компонента нет вкладки
indexAtLocation
public int indexAtLocation(int x, int y)
- Parameters:
-
x- координата x относительно этой вкладки -
y- координата y относительно этой вкладки - Returns:
- индекс вкладки, которая пересекает локацию, или -1, если ни одна вкладка не пересекает локацию
- Since:
- 1.4
getToolTipText
public String getToolTipText(MouseEvent event)
- Overrides:
-
getToolTipTextв классеJComponent - Parameters:
-
event- событиеMouseEvent, указывающее, где находится курсор - Returns:
- текст
String, содержащий текст всплывающей подсказки
paramString
protected String paramString()
JTabbedPane. Этот метод предназначен только для отладки, и содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не null.- Overrides:
-
paramStringв классеJComponent - Returns:
- строковое представление этой JTabbedPane.
getAccessibleContext
@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
- Specified by:
-
getAccessibleContextв интерфейсеAccessible - Overrides:
-
getAccessibleContextв классеComponent - Returns:
- 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 будет отображать заголовок и/или иконку для указанной вкладки. Не-null значение означает, что компонент будет отображать заголовок, и JTabbedPane не будет отображать заголовок и/или иконку. Примечание: компонент не должен быть тем, который разработчик уже добавил на панель вкладок.
- Parameters:
-
index- индекс вкладки, где должен быть установлен компонент -
component- компонент для отображения заголовка указанной вкладки - Throws:
-
IndexOutOfBoundsException- если индекс находится вне допустимого диапазона(index < 0 || index >= tab count) -
IllegalArgumentException- если компонент уже добавлен в этуJTabbedPane - Since:
- 1.6
- See Also:
getTabComponentAt
public Component getTabComponentAt(int index)
index.- Parameters:
-
index- индекс запрашиваемого элемента - Returns:
- компонент вкладки в
index - Throws:
-
IndexOutOfBoundsException- если индекс находится вне допустимого диапазона(index < 0 || index >= tab count) - Since:
- 1.6
- See Also:
indexOfTabComponent
public int indexOfTabComponent(Component tabComponent)
- Parameters:
-
tabComponent- компонент вкладки для вкладки - Returns:
- первая вкладка, соответствующая этому компоненту вкладки, или -1, если для этого компонента вкладки нет вкладки
- Since:
- 1.6
- See Also:
© 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/JTabbedPane.html