Spec-Zone.ru › OpenJDK 24

Класс JTabbedPane

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.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
Компонент, позволяющий пользователю переключаться между группой компонентов, щелкнув по вкладке с заданным названием и/или иконкой. Примеры и информация по использованию вкладок см. в Как использовать вкладки — разделе учебника Java.

Вкладки/компоненты добавляются в объект 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
См. также:
  • SingleSelectionModel

Краткое описание вложенных классов

Модификатор и тип Класс Описание
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(int tabPlacement)
Создаёт пустой TabbedPane с указанным размещением вкладок: JTabbedPane.TOP, JTabbedPane.BOTTOM, JTabbedPane.LEFT или JTabbedPane.RIGHT.
JTabbedPane(int tabPlacement, int tabLayoutPolicy)
Создаёт пустой TabbedPane с указанным размещением вкладок и политикой выравнивания.

Краткое описание методов

Модификатор и тип Метод Описание
Component add(Component component)
Добавляет component с заголовком вкладки, по умолчанию равным имени компонента, полученного в результате вызова component.getName.
Component add(Component component, int index)
Добавляет component по указанному индексу вкладки с заголовком вкладки, по умолчанию равным имени компонента.
void add(Component component, Object constraints)
Добавляет component к панели вкладок.
void add(Component component, Object constraints, int index)
Добавляет component по указанному индексу вкладки.
Component add(String title, Component component)
Добавляет component с указанным заголовком вкладки.
void addChangeListener(ChangeListener l)
Добавляет ChangeListener в эту панель вкладок.
void addTab(String title, Component component)
Добавляет component, представленный title и без значка.
void addTab(String title, Icon icon, Component component)
Добавляет component, представленный title и/или icon, любой из которых может быть null.
void addTab(String title, Icon icon, Component component, String tip)
Добавляет component и tip, представленные title и/или icon, любой из которых может быть null.
protected ChangeListener createChangeListener()
Подклассы, которые хотят обработать ChangeEvents по-другому, могут переопределить этот метод, чтобы вернуть подкласс ModelListener или другую реализацию ChangeListener.
protected void fireStateChanged()
Отправляет ChangeEvent, с этой JTabbedPane в качестве источника, каждому зарегистрированному слушателю.
AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этой JTabbedPane.
Color getBackgroundAt(int index)
Возвращает цвет фона вкладки в позиции index.
Rectangle getBoundsAt(int index)
Возвращает область вкладки в позиции index.
ChangeListener[] getChangeListeners()
Возвращает массив всех ChangeListener, добавленных в эту JTabbedPane с помощью addChangeListener.
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 для этого компонента.
String getUIClassID()
Возвращает имя класса пользовательского интерфейса, реализующего L&F для этого компонента.
int indexAtLocation(int x, int y)
Возвращает индекс вкладки, соответствующей вкладке, чья область пересекается с заданным местоположением.
int indexOfComponent(Component component)
Возвращает индекс вкладки для указанного компонента.
int indexOfTab(String title)
Возвращает первый индекс вкладки с заданным title, или -1, если нет вкладки с таким заголовком.
int indexOfTab(Icon icon)
Возвращает первый индекс вкладки с заданным icon, или -1, если нет вкладки с таким значком.
int indexOfTabComponent(Component tabComponent)
Возвращает индекс вкладки для указанного компонента вкладки.
void insertTab(String title, Icon icon, Component component, String tip, int index)
Вставляет новую вкладку для данного компонента по данному индексу, представленную данным заголовком и/или значком, любой из которых может быть null.
boolean isEnabledAt(int index)
Возвращает, включена ли вкладка в позиции index в данный момент.
protected String paramString()
Возвращает строковое представление этой JTabbedPane.
void remove(int index)
Удаляет вкладку и компонент, соответствующие указанному индексу.
void remove(Component component)
Удаляет указанную Component из JTabbedPane.
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)
Устанавливает объект 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

Methods declared in class 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
Политика размещения вкладок для отображения подмножества доступных вкладок, когда все вкладки не помещаются в одну строку. Если все вкладки не помещаются в одну строку, виджет предоставит способ перехода к скрытым вкладкам.
См. также:
  • Значения константных полей

tabPlacement

protected int tabPlacement
Расположение вкладок.
См. также:
  • setTabPlacement(int)

model

protected SingleSelectionModel model
Модель выбора по умолчанию

changeListener

protected ChangeListener changeListener
Прослушиватель, который мы добавляем к модели.

changeEvent

protected transient ChangeEvent changeEvent
Необходим только один экземпляр события на каждый экземпляр компонента, так как состояние события (только для чтения) — это свойство источника. Источником событий, генерируемых здесь, всегда является «this».

Подробное описание конструкторов

JTabbedPane

public JTabbedPane()
Создаёт пустой компонент TabbedPane с размещением вкладок по умолчанию JTabbedPane.TOP.
См. также:
  • addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)

JTabbedPane

public JTabbedPane(int tabPlacement)
Создаёт пустой компонент TabbedPane с указанным размещением вкладок: JTabbedPane.TOP, JTabbedPane.BOTTOM, JTabbedPane.LEFT или JTabbedPane.RIGHT.
Параметры:
tabPlacement - расположение вкладок относительно содержимого
См. также:
  • addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)

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
См. также:
  • addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)

Подробное описание методов

getUI

public TabbedPaneUI getUI()
Возвращает объект UI, который реализует L&F для данного компонента.
Переопределяет:
getUI в классе JComponent
Возвращает:
объект TabbedPaneUI
См. также:
  • setUI(javax.swing.plaf.TabbedPaneUI)

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the tabbedpane's LookAndFeel") public void setUI(TabbedPaneUI ui)
Устанавливает объект UI, который реализует L&F для данного компонента.
Параметры:
ui - новый объект UI
См. также:
  • UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()
Сбрасывает свойство UI на значение из текущей темы оформления.
Переопределяет:
updateUI в классе JComponent
См. также:
  • JComponent.updateUI()

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()
Возвращает имя класса UI, реализующего L&F для данного компонента.
Переопределяет:
getUIClassID в классе JComponent
Возвращает:
строку "TabbedPaneUI"
См. также:
  • JComponent.getUIClassID()
  • UIDefaults.getUI(javax.swing.JComponent)

createChangeListener

protected ChangeListener createChangeListener()
Подклассы, которые хотят обработать ChangeEvents по-разному, могут переопределить этот метод, чтобы вернуть подкласс ModelListener или другую реализацию ChangeListener.
Возвращает:
объект ChangeListener
См. также:
  • fireStateChanged()

addChangeListener

public void addChangeListener(ChangeListener l)
Добавляет прослушитель ChangeListener к этому компоненту tabbedpane.
Параметры:
l - добавляемый прослушитель ChangeListener
См. также:
  • fireStateChanged()
  • removeChangeListener(javax.swing.event.ChangeListener)

removeChangeListener

public void removeChangeListener(ChangeListener l)
Удаляет прослушитель ChangeListener из этого компонента tabbedpane.
Параметры:
l - удаляемый прослушитель ChangeListener
См. также:
  • fireStateChanged()
  • addChangeListener(javax.swing.event.ChangeListener)

getChangeListeners

@BeanProperty(bound=false) public ChangeListener[] getChangeListeners()
Возвращает массив всех прослушителей ChangeListener, добавленных к этому компоненту JTabbedPane с помощью метода addChangeListener.
Возвращает:
все добавленные прослушители ChangeListener или пустой массив, если прослушители не добавлены
С:
1.4

fireStateChanged

protected void fireStateChanged()
Отправляет событие ChangeEvent, с этим компонентом JTabbedPane в качестве источника, каждому зарегистрированному прослушивателю. Этот метод вызывается каждый раз, когда изменяется либо выбранный индекс, либо выбранная вкладка в компоненте JTabbedPane. Обычно выбранный индекс и выбранная вкладка изменяются вместе. Однако есть некоторые случаи, такие как добавление вкладок, когда выбранный индекс изменяется, но выбранная вкладка остаётся той же. Есть другие случаи, такие как удаление выбранной вкладки, когда индекс остаётся прежним, но новая вкладка перемещается на этот индекс. События генерируются во всех этих случаях.
См. также:
  • addChangeListener(javax.swing.event.ChangeListener)
  • EventListenerList

getModel

public SingleSelectionModel getModel()
Возвращает модель, связанную с этим компонентом tabbedpane.
Возвращает:
модель SingleSelectionModel, связанную с этим компонентом tabbedpane
См. также:
  • setModel(javax.swing.SingleSelectionModel)

setModel

@BeanProperty(description="The tabbedpane's SingleSelectionModel.") public void setModel(SingleSelectionModel model)
Устанавливает модель, которая будет использоваться с этим компонентом tabbedpane.
Параметры:
model - используемая модель
См. также:
  • getModel()

getTabPlacement

public int getTabPlacement()
Возвращает расположение вкладок для этого компонента tabbedpane.
Возвращает:
перечисление int, определяющее расположение вкладок
См. также:
  • setTabPlacement(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
См. также:
  • setTabLayoutPolicy(int)

Установка политики выравнивания вкладок

@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
См. также:
  • getTabLayoutPolicy()

Возвращение индекса выбранной вкладки

public int getSelectedIndex()
Возвращает текущий выбранный индекс для этой панели вкладок. Возвращает -1, если нет текущей выбранной вкладки.
Возвращает:
индекс выбранной вкладки
См. также:
  • setSelectedIndex(int)

Установка индекса выбранной вкладки

@BeanProperty(bound=false, preferred=true, description="The tabbedpane's selected tab index.") public void setSelectedIndex(int index)
Устанавливает выбранный индекс для этой панели вкладок. Индекс должен быть допустимым индексом вкладки или -1, что указывает на то, что ни одна вкладка не должна быть выбрана (также может использоваться, когда на панели вкладок нет вкладок). Если значение -1 задано, когда на панели вкладок есть одна или несколько вкладок, результаты зависят от реализации.
Параметры:
index - индекс для выбора
Исключения:
IndexOutOfBoundsException - если индекс находится за пределами допустимого диапазона (index < -1 || index >= tab count)
См. также:
  • getSelectedIndex()
  • SingleSelectionModel.setSelectedIndex(int)

Возвращение выбранного компонента

public Component getSelectedComponent()
Возвращает текущий выбранный компонент для этой панели вкладок. Возвращает null, если нет текущей выбранной вкладки.
Возвращает:
компонент, соответствующий выбранной вкладке
См. также:
  • setSelectedComponent(java.awt.Component)

Установка выбранного компонента

@BeanProperty(bound=false, preferred=true, description="The tabbedpane's selected component.") public void setSelectedComponent(Component c)
Устанавливает выбранный компонент для этой панели вкладок. Это автоматически установит selectedIndex в индекс, соответствующий указанному компоненту.
Параметры:
c - выбранный Component для этой TabbedPane
Исключения:
IllegalArgumentException - если компонент не найден на панели вкладок
См. также:
  • getSelectedComponent()

Вставка вкладки

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(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)
  • removeTabAt(int)

Добавление вкладки

public void addTab(String title, Icon icon, Component component, String tip)
Добавляет component и tip, представленные title и/или icon, любой из которых может быть null. Метод-обёртка для insertTab.
Параметры:
title - заголовок, отображаемый на вкладке
icon - значок, отображаемый на вкладке
component - компонент, отображаемый при нажатии на эту вкладку
tip - всплывающая подсказка для этой вкладки
См. также:
  • insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int)
  • removeTabAt(int)

Добавление вкладки

public void addTab(String title, Icon icon, Component component)
Добавляет component, представленную title и/или icon, любой из которых может быть null. Метод-обёртка для insertTab.
Параметры:
title - заголовок, отображаемый на вкладке
icon - значок, отображаемый на вкладке
component - компонент, отображаемый при нажатии на эту вкладку
См. также:
  • insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int)
  • removeTabAt(int)

Добавление вкладки

public void addTab(String title, Component component)
Добавляет component, представленную title и без значка. Метод-обёртка для insertTab.
Параметры:
title - заголовок, отображаемый на вкладке
component - компонент, отображаемый при нажатии на эту вкладку
См. также:
  • insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int)
  • removeTabAt(int)

Добавление компонента

public Component add(Component component)
Добавляет component с заголовком вкладки по умолчанию, равным имени компонента, полученного вызовом component.getName. Метод-обёртка для insertTab.
Переопределяет:
add в классе Container
Параметры:
component - компонент, отображаемый при нажатии на эту вкладку
Возвращает:
компонент
См. также:
  • insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int)
  • removeTabAt(int)

Добавление компонента

public Component add(String title, Component component)
Добавляет component со строковым заголовком вкладки. Метод-обёртка для insertTab.
Переопределяет:
add в классе Container
Параметры:
title - заголовок, отображаемый на вкладке
component - компонент, отображаемый при нажатии на эту вкладку
Возвращает:
компонент
См. также:
  • insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int)
  • removeTabAt(int)

добавить

public Component add(Component component, int index)
Добавляет вкладку с указанным индексом вкладки, при этом заголовок вкладки по умолчанию устанавливается равным имени компонента. Метод-обёртка для insertTab.
Overrides:
add в классе Container
Параметры:
component - компонент, отображаемый при нажатии на эту вкладку
index - позиция вставки новой вкладки
Возвращает:
компонент
См. также:
  • insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int)
  • removeTabAt(int)

добавить

public void add(Component component, Object constraints)
Добавляет вкладку в панель вкладок. Если constraints является String или Icon, оно будет использовано в качестве заголовка вкладки; в противном случае будет использовано имя компонента. Метод-обёртка для insertTab.
Overrides:
add в классе Container
Параметры:
component - компонент, отображаемый при нажатии на эту вкладку
constraints - объект, отображаемый на вкладке
См. также:
  • insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int)
  • removeTabAt(int)

добавить

public void add(Component component, Object constraints, int index)
Добавляет вкладку с указанным индексом вкладки. Если constraints является String или Icon, оно будет использовано в качестве заголовка вкладки; в противном случае будет использовано имя компонента. Метод-обёртка для insertTab.
Overrides:
add в классе Container
Параметры:
component - компонент, отображаемый при нажатии на эту вкладку
constraints - объект, отображаемый на вкладке
index - позиция вставки новой вкладки
См. также:
  • insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int)
  • removeTabAt(int)

удалитьВкладкуПоИндексу

public void removeTabAt(int index)
Удаляет вкладку по указанному index. После удаления компонента, связанного с index, его видимость сбрасывается в true, чтобы обеспечить его видимость, если он будет добавлен в другие контейнеры.
Параметры:
index - индекс вкладки, подлежащей удалению
Исключения:
IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)
См. также:
  • addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)
  • insertTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String, int)

удалить

public void remove(Component component)
Удаляет указанный Component из JTabbedPane. Метод ничего не делает, если component равен null.
Overrides:
remove в классе Container
Параметры:
component - компонент для удаления из вкладки
См. также:
  • addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)
  • removeTabAt(int)

удалить

public void remove(int index)
Удаляет вкладку и соответствующий компонент, соответствующий указанному индексу.
Overrides:
remove в классе Container
Параметры:
index - индекс компонента для удаления из tabbedpane
Исключения:
IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)
См. также:
  • addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)
  • removeTabAt(int)

удалитьВсе

public void removeAll()
Удаляет все вкладки и соответствующие компоненты из tabbedpane.
Overrides:
removeAll в классе Container
См. также:
  • addTab(java.lang.String, javax.swing.Icon, java.awt.Component, java.lang.String)
  • removeTabAt(int)

количествоВкладок

@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)
См. также:
  • setTitleAt(int, java.lang.String)

получитьИконкуВкладки

public Icon getIconAt(int index)
Возвращает иконку вкладки по указанному index.
Параметры:
index - индекс запрашиваемого элемента
Возвращает:
иконку по указанному index
Исключения:
IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)
См. также:
  • setIconAt(int, javax.swing.Icon)

получитьИконкуВкладкиОтключена

public Icon getDisabledIconAt(int index)
Возвращает иконку вкладки в состоянии отключения по указанному index. Если иконка вкладки в состоянии отключения не существует по указанному index, вызов перенаправляется в обработчик внешнего вида, чтобы создать соответствующую иконку в состоянии отключения из соответствующей иконки в состоянии включения. Некоторые внешние виды могут не отображать иконку в состоянии отключения, в этом случае она не будет создана.
Параметры:
index - индекс запрашиваемого элемента
Возвращает:
иконку по указанному index
Исключения:
IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)
См. также:
  • setDisabledIconAt(int, javax.swing.Icon)

получитьПодсказкуВкладки

public String getToolTipTextAt(int index)
Возвращает текст всплывающей подсказки вкладки по указанному index.
Параметры:
index - индекс запрашиваемого элемента
Возвращает:
строка, содержащая текст всплывающей подсказки по указанному index
Исключения:
IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)
Since:
1.3
См. также:
  • setToolTipTextAt(int, java.lang.String)

получитьЦветФонаВкладки

public Color getBackgroundAt(int index)
Возвращает цвет фона вкладки по указанному index.
Параметры:
index - индекс запрашиваемого элемента
Возвращает:
цвет фона вкладки по указанному index
Исключения:
IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)
См. также:
  • setBackgroundAt(int, java.awt.Color)

получитьЦветТекстаВкладки

public Color getForegroundAt(int index)
Возвращает цвет текста вкладки по указанному index.
Параметры:
index - индекс запрашиваемого элемента
Возвращает:
цвет текста вкладки по указанному index
Исключения:
IndexOutOfBoundsException - если индекс вне диапазона (index < 0 || index >= tab count)
См. также:
  • setForegroundAt(int, java.awt.Color)

isEnabledAt

public boolean isEnabledAt(int index)
Возвращает, включена ли вкладка по индексу index.
Параметры:
index - индекс запрашиваемого элемента
Возвращает:
true, если вкладка по индексу index включена; иначе false
Исключения:
IndexOutOfBoundsException - если индекс находится вне допустимого диапазона (index < 0 || index >= tab count)
См. также:
  • setEnabledAt(int, boolean)

getComponentAt

public Component getComponentAt(int index)
Возвращает компонент по индексу index.
Параметры:
index - индекс запрашиваемого элемента
Возвращает:
компонент по индексу index
Исключения:
IndexOutOfBoundsException - если индекс находится вне допустимого диапазона (index < 0 || index >= tab count)
См. также:
  • setComponentAt(int, java.awt.Component)

getMnemonicAt

public int getMnemonicAt(int tabIndex)
Возвращает мнемонический код клавиатуры для доступа к указанной вкладке. Мнемонический код — это ключ, который в сочетании с модификатором без мыши (обычно Alt) активирует указанную вкладку.
Параметры:
tabIndex - индекс вкладки, к которой относится мнемонический код
Возвращает:
код ключа, представляющий мнемонический код; -1, если для вкладки мнемонический код не указан
Исключения:
IndexOutOfBoundsException - если индекс находится вне допустимого диапазона (tabIndex < 0 || tabIndex >= количество вкладок)
С тех пор как:
1.4
См. также:
  • setDisplayedMnemonicIndexAt(int,int)
  • setMnemonicAt(int,int)

getDisplayedMnemonicIndexAt

public int getDisplayedMnemonicIndexAt(int tabIndex)
Возвращает символ, как индекс, для которого вид должен предоставить декорацию, представляющую мнемонический символ.
Параметры:
tabIndex - индекс вкладки, к которой относится мнемонический код
Возвращает:
индекс, представляющий мнемонический символ, если он существует; в противном случае возвращает -1
Исключения:
IndexOutOfBoundsException - если индекс находится вне допустимого диапазона (tabIndex < 0 || tabIndex >= количество вкладок)
С тех пор как:
1.4
См. также:
  • setDisplayedMnemonicIndexAt(int,int)
  • setMnemonicAt(int,int)

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)
См. также:
  • getTitleAt(int)
  • setTabComponentAt(int, java.awt.Component)

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(int, javax.swing.Icon)
  • getIconAt(int)
  • getDisabledIconAt(int)
  • setTabComponentAt(int, java.awt.Component)

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)
См. также:
  • getDisabledIconAt(int)

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
См. также:
  • getToolTipTextAt(int)

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)
См. также:
  • getBackgroundAt(int)

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)
См. также:
  • getForegroundAt(int)

setEnabledAt

public void setEnabledAt(int index, boolean enabled)
Устанавливает, включена ли вкладка по индексу index. Внутренняя ошибка возникает, если вкладки с указанным индексом нет.
Параметры:
index - индекс вкладки, которая должна быть включена/выключена
enabled - нужно ли включить вкладку
Исключения:
IndexOutOfBoundsException - если индекс находится вне допустимого диапазона (index < 0 || index >= tab count)
См. также:
  • isEnabledAt(int)

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:
  • getComponentAt(int)

setDisplayedMnemonicIndexAt

@BeanProperty(visualUpdate=true, description="the index into the String to draw the keyboard character mnemonic at") public void setDisplayedMnemonicIndexAt(int tabIndex, int mnemonicIndex)
Предоставляет подсказку для отображения и ощущения, какой символ в тексте должен быть выделен для обозначения мнемоники. Не все визуальные стили могут поддерживать это. Значение -1 указывает, что для этой вкладки нет мнемоники или вы не хотите отображать мнемонику для этой вкладки.

Значение обновляется при изменении свойств, относящихся к мнемонике (например, самой мнемонике, тексту...). Вам нужно вызывать этот метод только если вы не хотите, чтобы по умолчанию символ был подчеркнут. Например, если текст вкладки с индексом 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(int,int)
  • getDisplayedMnemonicIndexAt(int)

setMnemonicAt

@BeanProperty(visualUpdate=true, description="The keyboard mnenmonic, as a KeyEvent VK constant, for the specified tab") public void setMnemonicAt(int tabIndex, int mnemonic)
Устанавливает мнемонику клавиатуры для доступа к указанной вкладке. Мнемоника — это ключ, который в сочетании с модификатором без использования мыши (обычно Alt) активирует указанную вкладку.

Мнемоника должна соответствовать одному ключу на клавиатуре и должна быть указана с использованием одного из 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:
  • getMnemonicAt(int)
  • setDisplayedMnemonicIndexAt(int,int)

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)
Возвращает индекс вкладки для указанного компонента. Возвращает -1, если для этого компонента нет вкладки.
Parameters:
component - компонент для вкладки
Returns:
первая вкладка, соответствующая этому компоненту, или -1, если для этого компонента нет вкладки

indexAtLocation

public int indexAtLocation(int x, int y)
Возвращает индекс вкладки, соответствующей вкладке, границы которой пересекают указанную локацию. Возвращает -1, если ни одна вкладка не пересекает локацию.
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()
Получает AccessibleContext, связанный с этим JTabbedPane. Для панелей вкладок AccessibleContext представлен в виде AccessibleJTabbedPane. Новый экземпляр AccessibleJTabbedPane создается при необходимости.
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)
Устанавливает компонент, ответственный за отображение заголовка для указанной вкладки. Значение null означает, что JTabbedPane будет отображать заголовок и/или иконку для указанной вкладки. Не-null значение означает, что компонент будет отображать заголовок, и JTabbedPane не будет отображать заголовок и/или иконку.

Примечание: компонент не должен быть тем, который разработчик уже добавил на панель вкладок.

Parameters:
index - индекс вкладки, где должен быть установлен компонент
component - компонент для отображения заголовка указанной вкладки
Throws:
IndexOutOfBoundsException - если индекс находится вне допустимого диапазона (index < 0 || index >= tab count)
IllegalArgumentException - если компонент уже добавлен в эту JTabbedPane
Since:
1.6
See Also:
  • getTabComponentAt(int)

getTabComponentAt

public Component getTabComponentAt(int index)
Возвращает компонент вкладки в index.
Parameters:
index - индекс запрашиваемого элемента
Returns:
компонент вкладки в index
Throws:
IndexOutOfBoundsException - если индекс находится вне допустимого диапазона (index < 0 || index >= tab count)
Since:
1.6
See Also:
  • setTabComponentAt(int, java.awt.Component)

indexOfTabComponent

public int indexOfTabComponent(Component tabComponent)
Возвращает индекс вкладки для указанного компонента вкладки. Возвращает -1, если для этого компонента вкладки нет вкладки.
Parameters:
tabComponent - компонент вкладки для вкладки
Returns:
первая вкладка, соответствующая этому компоненту вкладки, или -1, если для этого компонента вкладки нет вкладки
Since:
1.6
See Also:
  • setTabComponentAt(int, java.awt.Component)
  • getTabComponentAt(int)

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API