Класс JToolBar
- Все реализованные интерфейсы:
ImageObserver, MenuContainer, Serializable, Accessible, SwingConstants
@JavaBean(defaultProperty="UI", description="A component which displays commonly used controls or Actions.") public class JToolBar extends JComponent implements SwingConstants, Accessible
JToolBar предоставляет компонент, удобный для отображения часто используемых Actionов или элементов управления. Примеры и сведения об использовании панелей инструментов см. в разделе Как использовать панели инструментов руководства Учебник по Java. В большинстве тем оформления пользователь может перетащить панель инструментов в отдельное окно (если только свойство floatable не имеет значения false). Для корректной работы перетаскивания рекомендуется добавлять экземпляры JToolBar к одной из четырёх «сторон» контейнера, менеджером компоновки которого является BorderLayout, и не добавлять дочерние компоненты к остальным четырём «сторонам».
Предупреждение: Swing не является потокобезопасной библиотекой. Дополнительные сведения см. в разделе Политика Swing в отношении потоков.
Предупреждение: Сериализованные объекты этого класса будут несовместимы с будущими выпусками Swing. Текущая поддержка сериализации предназначена для кратковременного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4, в пакет java.beans добавлена поддержка долговременного хранения всех JavaBeans. См. XMLEncoder.
- Начиная с:
- 1.2
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
protected class |
JToolBar.AccessibleJToolBar |
Этот класс реализует поддержку доступности для класса JToolBar. |
static class |
JToolBar.Separator |
Разделитель, предназначенный для панели инструментов. |
Вложенные классы/интерфейсы, объявленные в классе JComponent
JComponent.AccessibleJComponent
Вложенные классы/интерфейсы, объявленные в классе Container
Container.AccessibleAWTContainer
Вложенные классы/интерфейсы, объявленные в классе Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Краткое описание полей
Поля, объявленные в классе JComponent
listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW
Поля, объявленные в классе Component
accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
Поля, объявленные в интерфейсе ImageObserver
ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH
Поля, объявленные в интерфейсе SwingConstants
BOTTOM, CENTER, EAST, HORIZONTAL, LEADING, LEFT, NEXT, NORTH, NORTH_EAST, NORTH_WEST, PREVIOUS, RIGHT, SOUTH, SOUTH_EAST, SOUTH_WEST, TOP, TRAILING, VERTICAL, WEST
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
JToolBar() |
Создаёт новую панель инструментов; ориентация по умолчанию — HORIZONTAL. |
JToolBar |
Создаёт новую панель инструментов с указанным orientation. |
JToolBar |
Создаёт новую панель инструментов с указанным name. |
JToolBar |
Создаёт новую панель инструментов с указанными name и orientation. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
JButton |
add |
Добавляет новый JButton, который выполняет действие. |
protected void |
addImpl |
Если добавляется JButton, он изначально отключается. |
void |
addSeparator() |
Добавляет в конец панели инструментов разделитель размера по умолчанию. |
void |
addSeparator |
Добавляет в конец панели инструментов разделитель указанного размера. |
protected PropertyChangeListener |
createActionChangeListener |
Возвращает правильно настроенный PropertyChangeListener, который обновляет элемент управления при изменениях Action, или null, если требуется используемый по умолчанию слушатель изменений свойств элемента управления. |
protected JButton |
createActionComponent |
Фабричный метод, создающий JButton для Actionов, добавленных в JToolBar. |
AccessibleContext |
getAccessibleContext() |
Получает AccessibleContext, связанный с этим JToolBar. |
Component |
getComponentAtIndex |
Возвращает компонент с указанным индексом. |
int |
getComponentIndex |
Возвращает индекс указанного компонента. |
Insets |
getMargin() |
Возвращает отступ между границей панели инструментов и её кнопками. |
int |
getOrientation() |
Возвращает текущую ориентацию панели инструментов. |
ToolBarUI |
getUI() |
Возвращает текущий пользовательский интерфейс панели инструментов. |
String |
getUIClassID() |
Возвращает имя класса L&F, который отображает этот компонент. |
boolean |
isBorderPainted() |
Получает свойство borderPainted. |
boolean |
isFloatable() |
Получает свойство floatable. |
boolean |
isRollover() |
Возвращает состояние rollover. |
protected void |
paintBorder |
Отображает границу панели инструментов, если свойство borderPainted имеет значение true. |
protected String |
paramString() |
Возвращает строковое представление этого JToolBar. |
void |
setBorderPainted |
Задаёт свойство borderPainted, которое принимает значение true, если границу нужно отображать. |
void |
setFloatable |
Задаёт свойство floatable, которое должно иметь значение true, чтобы пользователь мог перемещать панель инструментов. |
void |
setMargin |
Задаёт отступ между границей панели инструментов и её кнопками. |
void |
setOrientation |
Задаёт ориентацию панели инструментов. |
void |
setRollover |
Задаёт состояние rollover этой панели инструментов. |
void |
setUI |
Задаёт объект L&F, который отображает этот компонент. |
void |
updateUI() |
Уведомление от UIFactory об изменении L&F. |
Методы, объявленные в классе 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, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update
Методы, объявленные в классе Container
add, add, add, add, add, addContainerListener, 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, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree
Методы, объявленные в классе Component
action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle
Подробное описание конструкторов
JToolBar
public JToolBar()
HORIZONTAL.JToolBar
public JToolBar(int orientation)
orientation. Значение orientation должно быть либо HORIZONTAL, либо VERTICAL.- Параметры:
-
orientation— требуемая ориентация
JToolBar
public JToolBar(String name)
name. Имя используется в качестве заголовка откреплённой панели инструментов. Ориентация по умолчанию — HORIZONTAL.- Параметры:
-
name— имя панели инструментов - Начиная с:
- 1.3
JToolBar
public JToolBar(String name, int orientation)
name и orientation. Все остальные конструкторы вызывают этот конструктор. Если orientation имеет недопустимое значение, будет выброшено исключение.- Параметры:
-
name— имя панели инструментов -
orientation— исходная ориентация; она должна быть либоHORIZONTAL, либоVERTICAL - Вызывает исключение:
-
IllegalArgumentException— если ориентация не равна ниHORIZONTAL, ниVERTICAL - Начиная с:
- 1.3
Подробное описание методов
getUI
public ToolBarUI getUI()
- Переопределяет:
-
getUIв классеJComponent - Возвращает:
- текущий пользовательский интерфейс панели инструментов.
- См. также:
setUI
@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component's LookAndFeel.") public void setUI(ToolBarUI ui)
- Параметры:
-
ui— объект L&F дляToolBarUI - См. также:
updateUI
public void updateUI()
UIFactory об изменении L&F. Вызывается для замены пользовательского интерфейса последней версией из UIFactory.- Переопределяет:
-
updateUIв классеJComponent - См. также:
getUIClassID
@BeanProperty(bound=false) public String getUIClassID()
- Переопределяет:
-
getUIClassIDв классеJComponent - Возвращает:
- строка "ToolBarUI"
- См. также:
getComponentIndex
public int getComponentIndex(Component c)
- Параметры:
-
c—Componentдля поиска - Возвращает:
- целое число, указывающее позицию компонента, где 0 — первая позиция
getComponentAtIndex
public Component getComponentAtIndex(int i)
- Параметры:
-
i— позиция компонента, где 0 — первая позиция - Возвращает:
Componentв этой позиции илиnull, если индекс недопустим
setMargin
@BeanProperty(expert=true, description="The margin between the tool bar's border and contents") public void setMargin(Insets m)
null приводит к использованию панелью инструментов отступов по умолчанию. Объект Border панели инструментов использует это значение для создания нужного отступа. Однако если для панели инструментов задана нестандартная граница, создание подходящего пространства отступа становится обязанностью соответствующего объекта Border (в противном случае это свойство фактически будет проигнорировано).- Параметры:
-
m— объектInsets, определяющий расстояние между границей и кнопками - См. также:
getMargin
public Insets getMargin()
- Возвращает:
- объект
Insets, содержащий значения отступов - См. также:
isBorderPainted
public boolean isBorderPainted()
borderPainted.- Возвращает:
- значение свойства
borderPainted - См. также:
setBorderPainted
@BeanProperty(expert=true, description="Does the tool bar paint its borders?") public void setBorderPainted(boolean b)
borderPainted, которое указывает, true ли отображать границу. Значение этого свойства по умолчанию — true. Некоторые темы оформления могут не поддерживать отображение границ и будут игнорировать это свойство.- Параметры:
-
b— если значение true, граница отображается - См. также:
paintBorder
protected void paintBorder(Graphics g)
borderPainted имеет значение true.- Переопределяет:
-
paintBorderв классеJComponent - Параметры:
-
g— контекстGraphics, в котором выполняется рисование - См. также:
isFloatable
public boolean isFloatable()
floatable.- Возвращает:
- значение свойства
floatable - См. также:
setFloatable
@BeanProperty(preferred=true, description="Can the tool bar be made to float by the user?") public void setFloatable(boolean b)
floatable, которое должно иметь значение true, чтобы пользователь мог перемещать панель инструментов. Обычно плавающую панель инструментов можно перетащить в другое место того же контейнера или в отдельное окно. Значение этого свойства по умолчанию — true. Некоторые темы оформления могут не поддерживать плавающие панели инструментов и будут игнорировать это свойство.- Параметры:
-
b— еслиtrue, панель инструментов можно перемещать; в противном случае —false - См. также:
getOrientation
public int getOrientation()
HORIZONTAL, либо VERTICAL.- Возвращает:
- целое число, представляющее текущую ориентацию:
HORIZONTALилиVERTICAL - См. также:
setOrientation
@BeanProperty(preferred=true, enumerationValues={"SwingConstants.HORIZONTAL","SwingConstants.VERTICAL"}, description="The current orientation of the tool bar") public void setOrientation(int o) HORIZONTAL или VERTICAL. Если orientation имеет недопустимое значение, будет выброшено исключение.- Параметры:
-
o— новая ориентация:HORIZONTALилиVERTICAL - Вызывает исключение:
-
IllegalArgumentException— если ориентация не равна ниHORIZONTAL, ниVERTICAL - См. также:
setRollover
@BeanProperty(preferred=true, visualUpdate=true, description="Will draw rollover button borders in the toolbar.") public void setRollover(boolean rollover)
Реализация темы оформления может игнорировать это свойство.
- Параметры:
-
rollover— true для кнопок панели инструментов с rollover; иначе false - Начиная с:
- 1.4
isRollover
public boolean isRollover()
- Возвращает:
- true, если следует отображать кнопки панели инструментов с rollover; иначе false
- Начиная с:
- 1.4
- См. также:
addSeparator
public void addSeparator()
addSeparator
public void addSeparator(Dimension size)
- Параметры:
-
size—Dimensionразделителя
add
public JButton add(Action a)
JButton, который выполняет действие.- Параметры:
-
a— объектAction, который нужно добавить как новый элемент меню - Возвращает:
- новую кнопку, выполняющую действие
createActionComponent
protected JButton createActionComponent(Action a)
JButton для Actionов, добавляемых в JToolBar. Если передано действие null, имя по умолчанию — пустая строка.- Параметры:
-
a—Actionдля добавляемой кнопки - Возвращает:
- созданную кнопку
- Начиная с:
- 1.3
- См. также:
createActionChangeListener
protected PropertyChangeListener createActionChangeListener(JButton b)
PropertyChangeListener, который обновляет элемент управления при изменениях Action, или null, если требуется используемый по умолчанию слушатель изменений свойств элемента управления.- Параметры:
-
b—JButton - Возвращает:
null
addImpl
protected void addImpl(Component comp, Object constraints, int index)
JButton, он изначально отключается.paramString
protected String paramString()
JToolBar. Этот метод предназначен только для отладки; содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть null.- Переопределяет:
-
paramStringв классеJComponent - Возвращает:
- строковое представление этого
JToolBar.
getAccessibleContext
@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
- Определён в:
-
getAccessibleContextв интерфейсеAccessible - Переопределяет:
-
getAccessibleContextв классеComponent - Возвращает:
- AccessibleJToolBar, выполняющий роль AccessibleContext этого JToolBar
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/JToolBar.html