Класс 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, добавлена поддержка долгосрочного хранения всех JavaBeans в пакете java.beans. См. XMLEncoder.
- С момента:
- 1.2
- См. также:
Краткое описание вложенных классов
| Модификатор и тип | Класс | Описание |
|---|---|---|
protected class |
JToolBar.AccessibleJToolBar |
Этот класс реализует поддержку доступности для класса JToolBar. |
static class |
JToolBar.Separator |
Разделитель, специфичный для панели инструментов. |
Вложенные классы/интерфейсы, объявленные в классе javax.swing.JComponent
JComponent.AccessibleJComponent
Вложенные классы/интерфейсы, объявленные в классе java.awt.Container
Container.AccessibleAWTContainer
Вложенные классы/интерфейсы, объявленные в классе java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
Краткое описание полей
Поля, объявленные в классе 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
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
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() |
Возвращает текущий UI панели инструментов. |
String |
getUIClassID() |
Возвращает имя класса L&F, который отображает этот компонент. |
boolean |
isBorderPainted() |
Получает свойство borderPainted. |
boolean |
isFloatable() |
Получает свойство floatable. |
boolean |
isRollover() |
Возвращает состояние наведения. |
protected void |
paintBorder |
Рисует границу панели инструментов, если свойство borderPainted равно true. |
protected String |
paramString() |
Возвращает строковое представление этого JToolBar. |
void |
setBorderPainted |
Устанавливает свойство borderPainted, которое равно true если граница должна быть нарисована. |
void |
setFloatable |
Устанавливает свойство floatable, которое должно быть true для того, чтобы пользователь мог перемещать панель инструментов. |
void |
setMargin |
Устанавливает отступ между границей панели инструментов и её кнопками. |
void |
setOrientation |
Устанавливает ориентацию панели инструментов. |
void |
setRollover |
Устанавливает состояние наведения для этой панели инструментов. |
void |
setUI |
Устанавливает объект L&F, который отображает этот компонент. |
void |
updateUI() |
Уведомление от UIFactory о том, что L&F изменился. |
Методы, объявленные в классе 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, 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
Методы, объявленные в классе java.awt.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
Методы, объявленные в классе 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
Подробное описание конструкторов
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 - Возвращает:
- текущий UI панели инструментов.
- См. также:
setUI
@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component\'s LookAndFeel.") public void setUI(ToolBarUI ui)
- Параметры:
-
ui— объект L&FToolBarUI - См. также:
updateUI
public void updateUI()
UIFactory о том, что изменился L&F. Вызывается для замены UI на последнюю версию из 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 для кнопок панели инструментов с "переходом мыши"; в противном случае false - С:
- 1.4
isRollover
public boolean isRollover()
- Возвращает:
- true, если кнопки панели инструментов с "переходом мыши" должны быть отрисованы; в противном случае false
- С:
- 1.4
- См. также:
addSeparator
public void addSeparator()
addSeparator
public void addSeparator(Dimension size)
- Parameters:
-
size- размер разделителя
add
public JButton add(Action a)
- Parameters:
-
a- объект команды, добавляемый как новая кнопка меню - Returns:
- новая кнопка, вызывающая действие
createActionComponent
protected JButton createActionComponent(Action a)
- Parameters:
-
a- команда для кнопки - Returns:
- созданная кнопка
- Since:
- 1.3
- See Also:
createActionChangeListener
protected PropertyChangeListener createActionChangeListener(JButton b)
- Parameters:
-
b- кнопка - Returns:
null
addImpl
protected void addImpl(Component comp, Object constraints, int index)
- Overrides:
-
addImplв классеContainer - Parameters:
-
comp- компонент для улучшения -
constraints- ограничения, применяемые к компоненту -
index- индекс компонента - See Also:
paramString
protected String paramString()
null.- Overrides:
-
paramStringв классеJComponent - Returns:
- строковое представление этого объекта.
getAccessibleContext
@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()
- Specified by:
-
getAccessibleContextв интерфейсеAccessible - Overrides:
-
getAccessibleContextв классеComponent - Returns:
- AccessibleJToolBar, служащий AccessibleContext для этого объекта JToolBar
© 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/JToolBar.html