Класс 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 слушателям, используя tabbedpane (вместо модели) в качестве источника события. |
Вложенные классы/интерфейсы, объявленные в классе javax.swing.JComponent
JComponent.AccessibleJComponent
Вложенные классы/интерфейсы, объявленные в классе java.awt.Container
Container.AccessibleAWTContainer
Вложенные классы/интерфейсы, объявленные в классе java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
protected ChangeEvent |
changeEvent |
Для каждого экземпляра TabPane требуется только один ChangeEvent, так как состояние события (только для чтения) — это свойство source. |
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 с указанным размещением вкладок и политикой макета вкладок. |
Краткое описание методов
| Modifier and Type | Method | Description |
|---|---|---|
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() |
Возвращает модель, связанную с этим 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() |
Возвращает объект UI, который реализует L&F для этого компонента. |
String |
getUIClassID() |
Возвращает имя класса UI, который реализует 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 до значения из текущей темы. |
Методы, объявленные в классе 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
Методы, объявленные в классе 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
Методы, объявленные в классе 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
TabPane требуется только один ChangeEvent, так как единственное состояние события (только для чтения) — свойство источника. Источником событий, генерируемых здесь, всегда является «this».Подробное описание конструкторов
JTabbedPane
public JTabbedPane()
JTabbedPane.TOP.JTabbedPane
public JTabbedPane(int tabPlacement)
JTabbedPane.TOP, JTabbedPane.BOTTOM, JTabbedPane.LEFT, или JTabbedPane.RIGHT.- Параметры:
-
tabPlacement- расположение вкладок относительно содержимого - См. также:
JTabbedPane
public JTabbedPane(int tabPlacement, int tabLayoutPolicy)
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)
- Параметры:
-
l- слушатель изменений - См. также:
removeChangeListener
public void removeChangeListener(ChangeListener l)
- Параметры:
-
l- слушатель изменений для удаления - См. также:
getChangeListeners
@BeanProperty(bound=false) public ChangeListener[] getChangeListeners()
addChangeListener.- Возвращает:
- все добавленные слушатели изменений или пустой массив, если слушатели не добавлены
- С:
- 1.4
fireStateChanged
protected void fireStateChanged()
getModel
public SingleSelectionModel getModel()
- Возвращает:
- модель, связанную с этой панелью вкладок
- См. также:
setModel
@BeanProperty(description="The tabbedpane\'s SingleSelectionModel.") public void setModel(SingleSelectionModel model)
- Параметры:
-
model- модель для использования - См. также:
getTabPlacement
public int getTabPlacement()
- Возвращает:
- значение, определяющее расположение вкладок
- См. также:
setTabPlacement
@BeanProperty(preferred=true, visualUpdate=true, enumerationValues={"JTabbedPane.TOP","JTabbedPane.LEFT","JTabbedPane.BOTTOM","JTabbedPane.RIGHT"}, description="The tabbedpane\'s tab placement.") public void setTabPlacement(int tabPlacement) -
JTabbedPane.TOP -
JTabbedPane.BOTTOM -
JTabbedPane.LEFT -
JTabbedPane.RIGHT
SwingConstants.TOP.- Параметры:
-
tabPlacement- расположение вкладок относительно содержимого - Исключения:
-
IllegalArgumentException- если значение расположения вкладок не соответствует допустимым значениям
getTabLayoutPolicy
public int getTabLayoutPolicy()
- Returns:
- a
intописывающую политику вывода вкладок - Since:
- 1.4
- See Also:
setTabLayoutPolicy
@BeanProperty(preferred=true, visualUpdate=true, enumerationValues={"JTabbedPane.WRAP_TAB_LAYOUT","JTabbedPane.SCROLL_TAB_LAYOUT"}, description="The tabbedpane\'s policy for laying out the tabs") public void setTabLayoutPolicy(int tabLayoutPolicy) -
JTabbedPane.WRAP_TAB_LAYOUT -
JTabbedPane.SCROLL_TAB_LAYOUT
JTabbedPane.WRAP_TAB_LAYOUT. Некоторые стили отображения могут поддерживать только подмножество возможных политик вывода, в этом случае значение этого свойства может быть проигнорировано.
- Parameters:
-
tabLayoutPolicy- политика вывода вкладок - Throws:
-
IllegalArgumentException- если значение layoutPolicy не является одним из вышеперечисленных допустимых значений - Since:
- 1.4
- See Also:
getSelectedIndex
public int getSelectedIndex()
- Returns:
- индекс выбранной вкладки
- See Also:
setSelectedIndex
@BeanProperty(bound=false, preferred=true, description="The tabbedpane\'s selected tab index.") public void setSelectedIndex(int index)
- Parameters:
-
index- индекс для выбора - Throws:
-
IndexOutOfBoundsException- если индекс находится вне диапазона(index < -1 || index >= tab count) - See Also:
getSelectedComponent
public Component getSelectedComponent()
null если нет текущей выбранной вкладки.- Returns:
- компонент, соответствующий выбранной вкладке
- See Also:
setSelectedComponent
@BeanProperty(bound=false, preferred=true, description="The tabbedpane\'s selected component.") public void setSelectedComponent(Component c)
selectedIndex на индекс, соответствующий указанному компоненту.- Parameters:
-
c- выбранныйComponentдля этойTabbedPane - Throws:
-
IllegalArgumentException- если компонент не найден в табпанели - See Also:
insertTab
public void insertTab(String title, Icon icon, Component component, String tip, int index)
null.- Parameters:
-
title- заголовок, отображаемый на вкладке -
icon- значок, отображаемый на вкладке -
component- компонент, отображаемый при нажатии на эту вкладку. -
tip- всплывающая подсказка для этой вкладки -
index- позиция для вставки этой новой вкладки (> 0 and <= getTabCount()) - Throws:
-
IndexOutOfBoundsException- если индекс находится вне диапазона (< 0 or > getTabCount()) - See Also:
addTab
public void addTab(String title, Icon icon, Component component, String tip)
component и tip, представленные title и/или icon, любой из которых может быть null. Метод для insertTab.- Parameters:
-
title- заголовок, отображаемый на вкладке -
icon- значок, отображаемый на вкладке -
component- компонент, отображаемый при нажатии на эту вкладку -
tip- всплывающая подсказка для этой вкладки - See Also:
addTab
public void addTab(String title, Icon icon, Component component)
component представленную title и/или icon, любой из которых может быть null. Метод для insertTab.- Parameters:
-
title- заголовок, отображаемый на вкладке -
icon- значок, отображаемый на вкладке -
component- компонент, отображаемый при нажатии на эту вкладку - See Also:
addTab
public void addTab(String title, Component component)
component представленную title и без значка. Метод для insertTab.- Parameters:
-
title- заголовок, отображаемый на вкладке -
component- компонент, отображаемый при нажатии на эту вкладку - See Also:
add
public Component add(Component component)
component с заголовком вкладки по умолчанию, равным имени компонента, которое получено вызовом component.getName. Метод для insertTab.- Overrides:
-
addв классеContainer - Parameters:
-
component- компонент, отображаемый при нажатии на эту вкладку - Returns:
- компонент
- See Also:
add
public Component add(String title, Component component)
component со специфицированным заголовком вкладки. Метод для insertTab.- Overrides:
-
addв классеContainer - Parameters:
-
title- заголовок, отображаемый на вкладке -
component- компонент, отображаемый при нажатии на эту вкладку - Returns:
- компонент
- See Also:
add
public Component add(Component component, int index)
component в указанный индекс вкладки с заголовком вкладки по умолчанию, равным имени компонента. Метод для insertTab.- Overrides:
-
addв классеContainer - Parameters:
-
component- компонент, отображаемый при нажатии на эту вкладку -
index- позиция для вставки этой новой вкладки - Returns:
- компонент
- See Also:
add
public void add(Component component, Object constraints)
component в табпанель. Если constraints является String или Icon, оно будет использоваться в качестве заголовка вкладки, в противном случае имя компонента будет использовано в качестве заголовка вкладки. Метод для insertTab.- Overrides:
-
addв классеContainer - Parameters:
-
component- компонент, отображаемый при нажатии на эту вкладку -
constraints- объект, отображаемый на вкладке - See Also:
добавить
public void add(Component component, Object constraints, int index)
component в указанном индексе вкладки. Если constraints является String или Icon, оно будет использовано в качестве заголовка вкладки, в противном случае имя компонента будет использовано в качестве заголовка. Метод-обёртка для insertTab.- Overrides:
-
addв классеContainer - Параметры:
-
component- компонент, который будет отображаться при нажатии на эту вкладку -
constraints- объект, который будет отображаться на вкладке -
index- позиция для вставки новой вкладки - См. также:
удалитьВкладкуВ
public void removeTabAt(int index)
index. После удаления компонента, связанного с index, его видимость сбрасывается в true, чтобы гарантировать, что он будет виден, если он будет добавлен в другие контейнеры.- Параметры:
-
index- индекс вкладки, которую нужно удалить - Исключения:
-
IndexOutOfBoundsException- если индекс выходит за пределы допустимого диапазона(index < 0 || index >= tab count) - См. также:
удалить
public void remove(Component component)
Component из JTabbedPane. Метод ничего не делает, если component равно null.- Overrides:
-
removeв классеContainer - Параметры:
-
component- компонент, который нужно удалить из вкладки - См. также:
удалить
public void remove(int index)
- Overrides:
-
removeв классеContainer - Параметры:
-
index- индекс компонента, который нужно удалить изtabbedpane - Исключения:
-
IndexOutOfBoundsException- если индекс выходит за пределы допустимого диапазона(index < 0 || index >= tab count) - См. также:
удалитьВсе
public void removeAll()
tabbedpane.- Overrides:
-
removeAllв классеContainer - См. также:
получитьКоличествоВкладок
@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 нет, вызов передаётся в Look and Feel, чтобы сконструировать соответствующую иконку отключённого состояния из соответствующей иконки включённого состояния. Некоторые стили визуализации могут не отображать иконку отключённого состояния, в этом случае она не будет создана.- Параметры:
-
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) - См. также:
включеноВ
public boolean isEnabledAt(int index)
index.- Параметры:
-
index- индекс запрашиваемого элемента - Возвращает:
- true, если вкладка в
indexвключена; в противном случае false - Исключения:
-
IndexOutOfBoundsException- если индекс выходит за пределы допустимого диапазона(index < 0 || index >= tab count) - См. также:
получитьКомпонентВ
public Component getComponentAt(int index)
index.- Параметры:
-
index- индекс запрашиваемого элемента - Возвращает:
- компонент в
index - Исключения:
-
IndexOutOfBoundsException- если индекс выходит за пределы допустимого диапазона(index < 0 || index >= tab count) - См. также:
получитьМенюВ
public int getMnemonicAt(int tabIndex)
- Параметры:
-
tabIndex- индекс вкладки, к которой относится клавиша быстрого вызова - Возвращает:
- код клавиши, представляющий клавишу быстрого вызова; -1, если для вкладки не указана клавиша быстрого вызова
- Исключения:
-
IndexOutOfBoundsException- если индекс выходит за пределы допустимого диапазона (tabIndex< 0 ||tabIndex>= количество вкладок) - Since:
- 1.4
- См. также:
getDisplayedMnemonicIndexAt
public int getDisplayedMnemonicIndexAt(int tabIndex)
- Параметры:
-
tabIndex- индекс вкладки, к которой относится мнемоника - Возвращает:
- индекс, представляющий символ мнемоники, если он существует; в противном случае возвращает -1
- Исключение:
-
IndexOutOfBoundsException- если индекс выходит за пределы диапазона (tabIndex< 0 ||tabIndex>= количество вкладок) - С:
- 1.4
- См. также:
getBoundsAt
public Rectangle getBoundsAt(int index)
index. Если вкладка по этому индексу в данный момент не отображается в пользовательском интерфейсе, возвращается null. Если для этой tabbedpane нет установленного пользовательского интерфейса, возвращается null.- Параметры:
-
index- индекс, который нужно запросить - Возвращает:
- объект
Rectangle, содержащий границы вкладки по индексуindex, илиnull, если вкладка по индексуindexв данный момент не отображается в пользовательском интерфейсе или если для этойtabbedpaneнет установленного пользовательского интерфейса. - Исключение:
-
IndexOutOfBoundsException- если индекс выходит за пределы диапазона(index < 0 || index >= tab count)
setTitleAt
@BeanProperty(preferred=true, visualUpdate=true, description="The title at the specified tab index.") public void setTitleAt(int index, String title)
index на значение title, которое может быть null. Заголовок не отображается, если для этой вкладки был указан компонент вкладки. Внутреннее исключение возникает, если вкладки с указанным индексом нет.- Параметры:
-
index- индекс вкладки, где должен быть установлен заголовок -
title- заголовок, который должен отображаться в вкладке - Исключение:
-
IndexOutOfBoundsException- если индекс выходит за пределы диапазона(index < 0 || index >= tab count) - См. также:
setIconAt
@BeanProperty(preferred=true, visualUpdate=true, description="The icon at the specified tab index.") public void setIconAt(int index, Icon icon)
index на значение icon, которое может быть null. Это не устанавливает значок в неактивном состоянии по индексу icon. Если новый значок отличается от текущего значка и значок в неактивном состоянии не установлен явно, будет запрошено у LookAndFeel создание значка в неактивном состоянии. Для явного задания значка в неактивном состоянии используйте setDisableIconAt(). Значок не отображается, если для этой вкладки был указан компонент вкладки. Внутреннее исключение возникает, если вкладки с указанным индексом нет.- Параметры:
-
index- индекс вкладки, где должен быть установлен значок -
icon- значок, который должен отображаться во вкладке - Исключение:
-
IndexOutOfBoundsException- если индекс выходит за пределы диапазона(index < 0 || index >= tab count) - См. также:
setDisabledIconAt
@BeanProperty(preferred=true, visualUpdate=true, description="The disabled icon at the specified tab index.") public void setDisabledIconAt(int index, Icon disabledIcon)
index на значение icon, которое может быть null. Внутреннее исключение возникает, если вкладки с указанным индексом нет.- Параметры:
-
index- индекс вкладки, где должен быть установлен значок в неактивном состоянии -
disabledIcon- значок, который должен отображаться во вкладке в неактивном состоянии - Исключение:
-
IndexOutOfBoundsException- если индекс выходит за пределы диапазона(index < 0 || index >= tab count) - См. также:
setToolTipTextAt
@BeanProperty(preferred=true, description="The tooltip text at the specified tab index.") public void setToolTipTextAt(int index, String toolTipText)
index на значение toolTipText, которое может быть null. Внутреннее исключение возникает, если вкладки с указанным индексом нет.- Параметры:
-
index- индекс вкладки, где должна быть установлена подсказка -
toolTipText- текст подсказки, который должен отображаться для вкладки - Исключение:
-
IndexOutOfBoundsException- если индекс выходит за пределы диапазона(index < 0 || index >= tab count) - С:
- 1.3
- См. также:
setBackgroundAt
@BeanProperty(preferred=true, visualUpdate=true, description="The background color at the specified tab index.") public void setBackgroundAt(int index, Color background)
index на значение background, которое может быть null, в этом случае цвет фона вкладки будет по умолчанию соответствовать цвету фона tabbedpane. Внутреннее исключение возникает, если вкладки с указанным индексом нет. Внешний вид должен учитывать это свойство, некоторые могут его игнорировать.
- Параметры:
-
index- индекс вкладки, где должен быть установлен цвет фона -
background- цвет, который должен отображаться в фоне вкладки - Исключение:
-
IndexOutOfBoundsException- если индекс выходит за пределы диапазона(index < 0 || index >= tab count) - См. также:
setForegroundAt
@BeanProperty(preferred=true, visualUpdate=true, description="The foreground color at the specified tab index.") public void setForegroundAt(int index, Color foreground)
index на значение foreground, которое может быть null, в этом случае цвет переднего плана вкладки будет по умолчанию соответствовать цвету переднего плана данной tabbedpane. Внутреннее исключение возникает, если вкладки с указанным индексом нет. Внешний вид должен учитывать это свойство, некоторые могут его игнорировать.
- Параметры:
-
index- индекс вкладки, где должен быть установлен цвет переднего плана -
foreground- цвет, который должен отображаться как цвет переднего плана вкладки - Исключение:
-
IndexOutOfBoundsException- если индекс выходит за пределы диапазона(index < 0 || index >= tab count) - См. также:
setEnabledAt
public void setEnabledAt(int index, boolean enabled)
index. Внутреннее исключение возникает, если вкладки с указанным индексом нет.- Параметры:
-
index- индекс вкладки, которая должна быть активирована/деактивирована -
enabled- активна ли вкладка - Исключение:
-
IndexOutOfBoundsException- если индекс выходит за пределы диапазона(index < 0 || index >= tab count) - См. также:
setComponentAt
@BeanProperty(visualUpdate=true, description="The component at the specified tab index.") public void setComponentAt(int index, Component component)
index на component. Внутреннее исключение возникает, если вкладки с указанным индексом нет.- Параметры:
-
index- индекс вкладки, куда помещается компонент -
component- компонент для вкладки - Исключение:
-
IndexOutOfBoundsException- если индекс выходит за пределы диапазона(index < 0 || index >= tab count) - См. также:
setDisplayedMnemonicIndexAt
@BeanProperty(visualUpdate=true, description="the index into the String to draw the keyboard character mnemonic at") public void setDisplayedMnemonicIndexAt(int tabIndex, int mnemonicIndex)
Значение обновляется при изменении свойств, относящихся к мнемонике (например, сама мнемоника, текст...). Вы должны вызывать это только в том случае, если вы не хотите, чтобы подчёркивался символ по умолчанию. Например, если текст вкладки с индексом 3 был «Apple Price», с мнемоникой «p», и вы хотели, чтобы «P» был выделен как «Apple Price», вам нужно было бы вызвать setDisplayedMnemonicIndex(3, 6) после вызова setMnemonicAt(3, KeyEvent.VK_P).
Обратите внимание, что программист несет ответственность за обеспечение уникальной мнемоники для каждой вкладки, в противном случае могут возникнуть непредсказуемые результаты.
- Параметры:
-
tabIndex- индекс вкладки, к которой относится мнемоника -
mnemonicIndex- индекс вStringдля подчёркивания - Исключение:
-
IndexOutOfBoundsException- еслиtabIndexвыходит за пределы диапазона (tabIndex < 0 || tabIndex >= tab count) -
IllegalArgumentException- будет выброшено, еслиmnemonicIndex≥ длины заголовка вкладки, или < -1 - С:
- 1.4
- См. также:
setMnemonicAt
@BeanProperty(visualUpdate=true, description="The keyboard mnenmonic, as a KeyEvent VK constant, for the specified tab") public void setMnemonicAt(int tabIndex, int mnemonic)
Мнемонический символ должен соответствовать одной клавише на клавиатуре и должен быть указан с помощью одного из VK_XXX кодов клавиш, определённых в java.awt.event.KeyEvent, или одного из расширенных кодов клавиш, полученных через java.awt.event.KeyEvent.getExtendedKeyCodeForChar. Мнемонические символы регистронезависимы, поэтому событие нажатия клавиши с соответствующим кодом активирует кнопку независимо от того, была ли нажата клавиша Shift.
Это обновит отображаемый мнемонический символ для указанной вкладки.
- 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- событие мыши, указывающее, где находится курсор - Returns:
- текст всплывающей подсказки
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, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/javax/swing/JTabbedPane.html