Класс 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()
TabbedPane с расположением вкладок по умолчанию JTabbedPane.TOP. - См. также:
JTabbedPane
public JTabbedPane(int tabPlacement)
TabbedPane со указанным расположением вкладок: JTabbedPane.TOP, JTabbedPane.BOTTOM, JTabbedPane.LEFT, или JTabbedPane.RIGHT.- Параметры:
-
tabPlacement- расположение вкладок относительно содержимого - См. также:
JTabbedPane
public JTabbedPane(int tabPlacement, int tabLayoutPolicy)
TabbedPane с указанным расположением вкладок и политикой расположения вкладок. Расположение вкладок может быть: JTabbedPane.TOP, JTabbedPane.BOTTOM, JTabbedPane.LEFT, или JTabbedPane.RIGHT. Политика расположения вкладок может быть: JTabbedPane.WRAP_TAB_LAYOUT или JTabbedPane.SCROLL_TAB_LAYOUT.- Параметры:
-
tabPlacement- расположение вкладок относительно содержимого -
tabLayoutPolicy- политика расположения вкладок, когда все вкладки не помещаются в одну строку - Исключения:
-
IllegalArgumentException- если расположение вкладок или политика расположения вкладок не соответствуют одному из поддерживаемых значений - С:
- 1.4
- См. также:
Подробное описание методов
getUI
public TabbedPaneUI getUI()
- Переопределяет:
-
getUIв классеJComponent - Возвращает:
- объект
TabbedPaneUI - См. также:
setUI
@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the tabbedpane\'s LookAndFeel") public void setUI(TabbedPaneUI ui)
- Параметры:
-
ui- новый объект UI - См. также:
updateUI
public void updateUI()
- Переопределяет:
-
updateUIв классеJComponent - См. также:
getUIClassID
@BeanProperty(bound=false) public String getUIClassID()
- Переопределяет:
-
getUIClassIDв классеJComponent - Возвращает:
- строку "TabbedPaneUI"
- См. также:
createChangeListener
protected ChangeListener createChangeListener()
ChangeEvents по-другому, могут переопределить этот метод, чтобы вернуть подкласс ModelListener или другую реализацию ChangeListener. - Возвращает:
ChangeListener- См. также:
addChangeListener
public void addChangeListener(ChangeListener l)
ChangeListener в этот компонент JTabbedPane.- Параметры:
-
l- добавляемыйChangeListener - См. также:
removeChangeListener
public void removeChangeListener(ChangeListener l)
ChangeListener из этого компонента JTabbedPane.- Параметры:
-
l- удаляемыйChangeListener - См. также:
getChangeListeners
@BeanProperty(bound=false) public ChangeListener[] getChangeListeners()
ChangeListener , добавленных в этот JTabbedPane с addChangeListener. - Возвращает:
- все добавленные
ChangeListenerили пустой массив, если слушатели не добавлены - С:
- 1.4
fireStateChanged
protected void fireStateChanged()
ChangeEvent, с этим JTabbedPane в качестве источника, каждому зарегистрированному слушателю. Этот метод вызывается каждый раз, когда изменяется либо выбранный индекс, либо выбранная вкладка в JTabbedPane. Обычно выбранный индекс и выбранная вкладка изменяются вместе. Однако существуют некоторые случаи, такие как добавление вкладки, когда выбранный индекс изменяется, а та же вкладка остается выбранной. Есть и другие случаи, например, удаление выбранной вкладки, когда индекс остается неизменным, но новая вкладка перемещается на этот индекс. События генерируются для всех этих случаев.- См. также:
getModel
public SingleSelectionModel getModel()
- Возвращает:
- модель
SingleSelectionModel, связанную с этим компонентом JTabbedPane - См. также:
setModel
@BeanProperty(description="The tabbedpane\'s SingleSelectionModel.") public void setModel(SingleSelectionModel model)
- Параметры:
-
model- модель для использования - См. также:
getTabPlacement
public int getTabPlacement()
- Возвращает:
- значение
int, определяющее расположение вкладок - См. также:
setTabPlacement
@BeanProperty(preferred=true, visualUpdate=true, enumerationValues={"JTabbedPane.TOP","JTabbedPane.LEFT","JTabbedPane.BOTTOM","JTabbedPane.RIGHT"}, description="The tabbedpane\'s tab placement.") public void setTabPlacement(int tabPlacement) -
JTabbedPane.TOP -
JTabbedPane.BOTTOM -
JTabbedPane.LEFT -
JTabbedPane.RIGHT
SwingConstants.TOP.- Параметры:
-
tabPlacement- расположение вкладок относительно содержимого - Исключения:
-
IllegalArgumentException- если значение расположения вкладок не соответствует ни одному из указанных значений
getTabLayoutPolicy
public int getTabLayoutPolicy()
- Возвращает:
- объект
int, определяющий политику выравнивания вкладок - С:
- 1.4
- См. также:
setTabLayoutPolicy
@BeanProperty(preferred=true, visualUpdate=true, enumerationValues={"JTabbedPane.WRAP_TAB_LAYOUT","JTabbedPane.SCROLL_TAB_LAYOUT"}, description="The tabbedpane\'s policy for laying out the tabs") public void setTabLayoutPolicy(int tabLayoutPolicy) -
JTabbedPane.WRAP_TAB_LAYOUT -
JTabbedPane.SCROLL_TAB_LAYOUT
JTabbedPane.WRAP_TAB_LAYOUT. Некоторые стили отображения могут поддерживать только подмножество возможных политик выравнивания, в таком случае значение этого свойства может быть проигнорировано.
- Параметры:
-
tabLayoutPolicy- политика выравнивания вкладок - Исключения:
-
IllegalArgumentException- если значение layoutPolicy не является одним из вышеперечисленных допустимых значений - С:
- 1.4
- См. также:
getSelectedIndex
public int getSelectedIndex()
- Возвращает:
- индекс выбранной вкладки
- См. также:
setSelectedIndex
@BeanProperty(bound=false, preferred=true, description="The tabbedpane\'s selected tab index.") public void setSelectedIndex(int index)
- Параметры:
-
index- индекс, который должен быть выбран - Исключения:
-
IndexOutOfBoundsException- если индекс выходит за пределы диапазона(index < -1 || index >= tab count) - См. также:
getSelectedComponent
public Component getSelectedComponent()
null , если нет текущей выбранной вкладки.- Возвращает:
- компонент, соответствующий выбранной вкладке
- См. также:
setSelectedComponent
@BeanProperty(bound=false, preferred=true, description="The tabbedpane\'s selected component.") public void setSelectedComponent(Component c)
selectedIndex на индекс, соответствующий указанному компоненту.- Параметры:
-
c- выбранныйComponentдля этойTabbedPane - Исключения:
-
IllegalArgumentException- если компонент не найден во вкладке - См. также:
insertTab
public void insertTab(String title, Icon icon, Component component, String tip, int index)
null.- Параметры:
-
title- название, отображаемое на вкладке -
icon- значок, отображаемый на вкладке -
component- компонент, отображаемый при нажатии на эту вкладку. -
tip- всплывающая подсказка, отображаемая для этой вкладки -
index- позиция для вставки новой вкладки(index >= 0 && index <= getTabCount()) - Исключения:
-
IndexOutOfBoundsException- если индекс выходит за пределы диапазона(index < 0 || index > getTabCount()) - См. также:
addTab
public void addTab(String title, Icon icon, Component component, String tip)
component и tip , представленные title и/или icon, любой из которых может быть null . Метод-обёртка для insertTab.- Параметры:
-
title- название, отображаемое на вкладке -
icon- значок, отображаемый на вкладке -
component- компонент, отображаемый при нажатии на эту вкладку -
tip- всплывающая подсказка для этой вкладки - См. также:
addTab
public void addTab(String title, Icon icon, Component component)
component , представленную title и/или icon, любой из которых может быть null . Метод-обёртка для insertTab.- Параметры:
-
title- название, отображаемое на вкладке -
icon- значок, отображаемый на вкладке -
component- компонент, отображаемый при нажатии на эту вкладку - См. также:
addTab
public void addTab(String title, Component component)
component , представленную title и без значка. Метод-обёртка для insertTab.- Параметры:
-
title- название, отображаемое на вкладке -
component- компонент, отображаемый при нажатии на эту вкладку - См. также:
add
public Component add(Component component)
component с названием вкладки по умолчанию, равным имени компонента, полученного в результате вызова component.getName . Метод-обёртка для insertTab.- Переопределяет:
-
addв классеContainer - Параметры:
-
component- компонент, отображаемый при нажатии на вкладку - Возвращает:
- компонент
- См. также:
add
public Component add(String title, Component component)
component с указанным заголовком вкладки. Метод-обёртка для insertTab.- Переопределяет:
-
addв классеContainer - Параметры:
-
title- название, отображаемое на вкладке -
component- компонент, отображаемый при нажатии на вкладку - Возвращает:
- компонент
- См. также:
add
public Component add(Component component, int index)
component в указанный индекс вкладки с названием вкладки по умолчанию, равным имени компонента. Метод-обёртка для insertTab.- Переопределяет:
-
addв классеContainer - Параметры:
-
component- компонент, отображаемый при нажатии на вкладку -
index- позиция вставки новой вкладки - Возвращает:
- компонент
- См. также:
add
public void add(Component component, Object constraints)
component на вкладку. Если constraints является String или Icon, оно будет использоваться в качестве названия вкладки, иначе имя компонента будет использоваться в качестве названия вкладки. Метод-обёртка для insertTab.- Переопределяет:
-
addв классеContainer - Параметры:
-
component- компонент, отображаемый при нажатии на вкладку -
constraints- объект, отображаемый на вкладке - См. также:
добавить
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нет UI.
получитьЗаголовокВкладки
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 для построения соответствующей иконки в отключенном состоянии из соответствующей иконки в включенном состоянии. Некоторые look and feels могут не отображать иконку в отключенном состоянии, в таком случае она не будет создана.- Параметры:
-
index- индекс запрашиваемого элемента - Возвращает:
- иконку по указанному
index - Исключения:
-
IndexOutOfBoundsException- если индекс вне допустимого диапазона(index < 0 || index >= tab count) - См. также:
получитьТекстПодсказкиВкладки
public String getToolTipTextAt(int index)
index.- Параметры:
-
index- индекс запрашиваемого элемента - Возвращает:
- строку, содержащую текст подсказки по указанному
index - Исключения:
-
IndexOutOfBoundsException- если индекс вне допустимого диапазона(index < 0 || index >= tab count) - С:
- 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>= количество вкладок) - С:
- 1.4
- См. также:
getDisplayedMnemonicIndexAt
public int getDisplayedMnemonicIndexAt(int tabIndex)
- Параметры:
-
tabIndex- индекс вкладки, к которой относится мнемоника - Возвращает:
- индекс, представляющий символ мнемоники, если он существует; в противном случае возвращает -1
- Исключения:
-
IndexOutOfBoundsException- если индекс выходит за пределы диапазона (tabIndex< 0 ||tabIndex>= количество вкладок) - С тех пор:
- 1.4
- См. также:
getBoundsAt
public Rectangle getBoundsAt(int index)
null. Если для этой вкладки не задан интерфейс пользователя, возвращает null.- Параметры:
-
index- индекс для запроса - Возвращает:
- объект
Rectangle, содержащий границы вкладки по указанному индексу, илиnull, если вкладка по указанному индексу не отображается в интерфейсе пользователя, или если для этой вкладки не задан интерфейс пользователя. - Исключения:
-
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)
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)
icon, который может быть null. Это не устанавливает значок для состояния отключения по указанному индексу. Если новый значок отличается от текущего значка, и значок для состояния отключения не установлен явно, 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)
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)
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)
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)
foreground, который может быть null, в этом случае цвет переднего плана вкладки будет по умолчанию соответствовать цвету переднего плана tabbedpane. Внутреннее исключение генерируется, если вкладка с указанным индексом не найдена. Виджет может игнорировать это свойство.
- Параметры:
-
index- индекс вкладки, для которой нужно установить цвет переднего плана -
foreground- цвет переднего плана вкладки - Исключения:
-
IndexOutOfBoundsException- если индекс выходит за пределы диапазона(index < 0 || index >= tab count) - См. также:
setEnabledAt
public void setEnabledAt(int index, boolean enabled)
- Параметры:
-
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)
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, 2023, 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/21/docs/api/java.desktop/javax/swing/JTabbedPane.html