javax.swing

Класс JToolBar

java.lang. Объект

java.awt. Компонент

java.awt. Контейнер

javax.swing. JComponent

javax.swing. JToolBar

Все Реализованные Интерфейсы:

ImageObserver, MenuContainer, Сериализуемый, Доступный, SwingConstants

public class JToolBar
extends JComponent
implements SwingConstants, Accessible

JToolBar обеспечивает компонент, который полезен для отображения обычно используемый Actions или средства управления. Для примеров и информации об использовании панелей инструментов видят, Как Использовать Панели инструментов, раздел в Учебном руководстве по Java.

С большинством взгляда и чувств, пользователь может вытащить панель инструментов в отдельное окно (если floatable свойство устанавливается в false). Для перетащенного, чтобы работать правильно, рекомендуется, чтобы Вы добавили JToolBar экземпляры одной из четырех "сторон" контейнера, менеджер по расположению которого является a BorderLayout, и не добавляйте дочерние элементы к любой из других четырех "сторон".

Предупреждение: Swing не ориентирован на многопотоковое исполнение. Для получения дополнительной информации см., что Swing Распараллеливает Политику.

Предупреждение: Сериализированные объекты этого class не будут совместимыми с будущими выпусками Swing. Текущая поддержка сериализации является подходящей для краткосрочного хранения или RMI между приложениями, выполняющими ту же самую версию Swing. С 1.4, поддержка длительного хранения всего ^JavaBeansTM была добавлена к java.beans пакет. Пожалуйста, см. XMLEncoder.

См. Также:

Action

Вложенная Сводка Класса

Вложенные Классы

Модификатор и Тип	Класс и Описание
protected class	JToolBar. AccessibleJToolBar Этот class реализует поддержку доступности JToolBar class.
static class	JToolBar. Разделитель Специфичный для панели инструментов разделитель.

Вложенные классы/интерфейсы, наследованные от class javax.swing. JComponent

JComponent. AccessibleJComponent

Вложенные классы/интерфейсы, наследованные от class java.awt. Контейнер

Контейнер. AccessibleAWTContainer

Вложенные классы/интерфейсы, наследованные от class java.awt. Компонент

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Полевая Сводка

Поля, наследованные от class javax.swing. JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Поля, наследованные от class java.awt. Компонент

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, наследованные от интерфейса 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

Поля, наследованные от интерфейса java.awt.image. ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Сводка конструктора

Конструкторы

Конструктор и Описание
JToolBar() Создает новую панель инструментов; значения по умолчанию ориентации к HORIZONTAL.
JToolBar(int orientation) Создает новую панель инструментов с указанным orientation.
JToolBar(String name) Создает новую панель инструментов с указанным name.
JToolBar(String name, int orientation) Создает новую панель инструментов с указанным name и orientation.

Сводка метода

Модификатор и Тип	Метод и Описание
JButton	add(Action a) Добавляет новое JButton который диспетчеризирует действие.
protected void	addImpl(Component comp, Object constraints, int index) Если a JButton добавляется, это первоначально устанавливается быть отключенным.
void	addSeparator() Добавляет разделитель размера значения по умолчанию до конца панели инструментов.
void	addSeparator(Dimension size) Добавляет разделитель указанного размера до конца панели инструментов.
protected PropertyChangeListener	createActionChangeListener(JButton b) Возвращается должным образом сконфигурированный PropertyChangeListener который обновляет управление как изменения к Action происходите, или null если слушатель изменения свойства значения по умолчанию для управления требуется.
protected JButton	createActionComponent(Action a) Метод фабрики, который создает JButton для Actions добавленный к JToolBar.
AccessibleContext	getAccessibleContext() Связали AccessibleContext с этим JToolBar.
Компонент	getComponentAtIndex(int i) Возвращается компонент в указанном индексируют.
int	getComponentIndex(Component c) Возвращает индексирование указанного компонента.
Вставки	getMargin() Возвращает поле между границей панели инструментов и ее кнопками.
int	getOrientation() Возвращает текущую ориентацию панели инструментов.
ToolBarUI	getUI() Возвращает текущий UI панели инструментов.
Строка	getUIClassID() Возвращает имя L&F class, который представляет этот компонент.
boolean	isBorderPainted() Добирается borderPainted свойство.
boolean	isFloatable() Добирается floatable свойство.
boolean	isRollover() Возвращает динамическое состояние.
protected void	paintBorder(Graphics g) Красит границу панели инструментов если borderPainted свойство true.
protected String	paramString() Возвращает строковое представление этого JToolBar.
void	setBorderPainted(boolean b) Наборы borderPainted свойство, которое является true если граница должна быть нарисована.
void	setFloatable(boolean b) Наборы floatable свойство, которое должно быть true для пользователя, чтобы переместить панель инструментов.
void	setLayout(LayoutManager mgr) Устанавливает менеджера по расположению по этому контейнеру.
void	setMargin(Insets m) Устанавливает поле между границей панели инструментов и ее кнопками.
void	setOrientation(int o) Устанавливает ориентацию панели инструментов.
void	setRollover(boolean rollover) Устанавливает динамическое состояние этой панели инструментов.
void	setUI(ToolBarUI ui) Устанавливает L&F объект, который представляет этот компонент.
void	updateUI() Уведомление от UIFactory то, что L&F изменился.

Методы, наследованные от class javax.swing. JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, 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

Методы, наследованные от class java.awt. Контейнер

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, transferFocusDownCycle, validate, validateTree

Методы, наследованные от class java.awt. Компонент

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, 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, getPeer, 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, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Деталь конструктора

JToolBar

public JToolBar()

Создает новую панель инструментов; значения по умолчанию ориентации к HORIZONTAL.

JToolBar

public JToolBar(int orientation)

Создает новую панель инструментов с указанным orientation. orientation должен быть также HORIZONTAL или VERTICAL.

Параметры:

orientation - ориентация требуется

JToolBar

public JToolBar(String name)

Создает новую панель инструментов с указанным name. Имя используется в качестве title расстыкованной панели инструментов. Ориентация значения по умолчанию 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()

Возвращает текущий UI панели инструментов.

См. Также:

setUI(javax.swing.plaf.ToolBarUI)

setUI

public void setUI(ToolBarUI ui)

Устанавливает L&F объект, который представляет этот компонент.

Параметры:

ui - ToolBarUI L&F объект

См. Также:

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

Уведомление от UIFactory то, что L&F изменился. Вызванный, чтобы заменить UI последней версией от UIFactory.

Переопределения:

updateUI в class JComponent

См. Также:

JComponent.updateUI()

getUIClassID

public String getUIClassID()

Возвращает имя L&F class, который представляет этот компонент.

Переопределения:

getUIClassID в class JComponent

Возвраты:

строка "ToolBarUI"

См. Также:

JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

getComponentIndex

public int getComponentIndex(Component c)

Возвращает индексирование указанного компонента. (Отметьте: Разделители занимают, индексируют позиции.)

Параметры:

c - Component найти

Возвраты:

целое число, указывающее на позицию компонента, где 0 является первым

getComponentAtIndex

public Component getComponentAtIndex(int i)

Возвращается компонент в указанном индексируют.

Параметры:

i - позиция компонента, где 0 является первым

Возвраты:

Component в той позиции, или null поскольку недопустимое индексирует

setMargin

public void setMargin(Insets m)

Устанавливает поле между границей панели инструментов и ее кнопками. Установка в null заставляет панель инструментов использовать поля значения по умолчанию. Значение по умолчанию панели инструментов Border возразите использует это значение, чтобы создать надлежащее поле. Однако, если граница не по умолчанию устанавливается на панели инструментов, это - это Border обязанность объекта создать соответствующее граничное пространство (иначе это свойство будет эффективно проигнорировано).

Параметры:

m - Insets объект, который определяет пространство между границей и кнопками

См. Также:

Insets

getMargin

public Insets getMargin()

Возвращает поле между границей панели инструментов и ее кнопками.

Возвраты:

Insets объект, содержащий граничные значения

См. Также:

Insets

isBorderPainted

public boolean isBorderPainted()

Добирается borderPainted свойство.

Возвраты:

значение borderPainted свойство

См. Также:

setBorderPainted(boolean)

setBorderPainted

public void setBorderPainted(boolean b)

Наборы borderPainted свойство, которое является true если граница должна быть нарисована. Значение по умолчанию для этого свойства true. Некоторый взгляд и чувства не могли бы реализовать нарисованные границы; они проигнорируют это свойство.

Параметры:

b - если это правда, граница красится

См. Также:

isBorderPainted()

paintBorder

protected void paintBorder(Graphics g)

Красит границу панели инструментов если borderPainted свойство true.

Переопределения:

paintBorder в class JComponent

Параметры:

g - Graphics контекст, в котором делается рисование

См. Также:

JComponent.paint(java.awt.Graphics), JComponent.setBorder(javax.swing.border.Border)

isFloatable

public boolean isFloatable()

Добирается floatable свойство.

Возвраты:

значение floatable свойство

См. Также:

setFloatable(boolean)

setFloatable

public void setFloatable(boolean b)

Наборы floatable свойство, которое должно быть true для пользователя, чтобы переместить панель инструментов. Как правило, плавучая панель инструментов может быть перетащена в различную позицию в пределах того же самого контейнера или в его собственное окно. Значение по умолчанию этого свойства true. Некоторый взгляд и чувства не могли бы реализовать плавучие панели инструментов; они проигнорируют это свойство.

Параметры:

b - если true, панель инструментов может быть перемещена; false иначе

См. Также:

isFloatable()

getOrientation

public int getOrientation()

Возвращает текущую ориентацию панели инструментов. Значение также HORIZONTAL или VERTICAL.

Возвраты:

целое число, представляющее текущую ориентацию - также HORIZONTAL или VERTICAL

См. Также:

setOrientation(int)

setOrientation

public void setOrientation(int o)

Устанавливает ориентацию панели инструментов. У ориентации должен быть любой значение HORIZONTAL или VERTICAL. Если orientation недопустимое значение, исключение будет выдано.

Параметры:

o - новая ориентация - также HORIZONTAL или VERTICAL

Броски:

IllegalArgumentException - если ориентация ни один не HORIZONTAL ни VERTICAL

См. Также:

getOrientation()

setRollover

public void setRollover(boolean rollover)

Устанавливает динамическое состояние этой панели инструментов. Если динамическое состояние будет истиной тогда, то граница кнопок на панели инструментов будет оттянута только, когда указатель мыши нависнет над ними. Значение по умолчанию этого свойства является ложью.

Реализация стили может хотеть игнорировать это свойство.

Параметры:

rollover - истина для динамических кнопок на панели инструментов; иначе ложь

С тех пор:

1.4

isRollover

public boolean isRollover()

Возвращает динамическое состояние.

Возвраты:

истина, если динамические кнопки на панели инструментов должны быть оттянуты; иначе ложь

С тех пор:

1.4

См. Также:

setRollover(boolean)

addSeparator

public void addSeparator()

Добавляет разделитель размера значения по умолчанию до конца панели инструментов. Размер значения по умолчанию определяется текущим стилем.

addSeparator

public void addSeparator(Dimension size)

Добавляет разделитель указанного размера до конца панели инструментов.

Параметры:

size - Dimension из разделителя

добавить

public JButton add(Action a)

Добавляет новое JButton который диспетчеризирует действие.

Параметры:

a - Action объект добавить как новый пункт меню

Возвраты:

новая кнопка, которая диспетчеризирует действие

createActionComponent

protected JButton createActionComponent(Action a)

Метод фабрики, который создает JButton для Actions добавленный к JToolBar. Имя по умолчанию пусто если a null действие передают.

Параметры:

a - Action для кнопки, которая будет добавлена

Возвраты:

недавно создаваемая кнопка

С тех пор:

1.3

См. Также:

Action

createActionChangeListener

protected PropertyChangeListener createActionChangeListener(JButton b)

Возвращается должным образом сконфигурированный PropertyChangeListener который обновляет управление как изменения к Action происходите, или null если слушатель изменения свойства значения по умолчанию для управления требуется.

Возвраты:

null

addImpl

protected void addImpl(Component comp,
                       Object constraints,
                       int index)

Если a JButton добавляется, это первоначально устанавливается быть отключенным.

Переопределения:

addImpl в class Container

Параметры:

comp - компонент, который будет улучшен

constraints - ограничения, которые будут осуществлены на компоненте

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

См. Также:

Container.add(Component), Container.add(Component, int), Container.add(Component, java.lang.Object), Container.invalidate(), LayoutManager, LayoutManager2

paramString

protected String paramString()

Возвращает строковое представление этого JToolBar. Этот метод предназначается, чтобы использоваться только для того, чтобы отладить цели, и контент и формат возвращенной строки могут измениться между реализациями. Возвращенная строка может быть пустой, но, возможно, не null.

Переопределения:

paramString в class JComponent

Возвраты:

строковое представление этого JToolBar.

setLayout

public void setLayout(LayoutManager mgr)

Описание скопировало с class: Container

Устанавливает менеджера по расположению по этому контейнеру.

Этот метод изменяет связанную с расположением информацию, и поэтому, лишает законной силы иерархию компонентов.

Переопределения:

setLayout в class Container

Параметры:

mgr - указанный менеджер по расположению

См. Также:

Container.doLayout(), Container.getLayout(), Container.invalidate()

getAccessibleContext

public AccessibleContext getAccessibleContext()

Связали AccessibleContext с этим JToolBar. Для панелей инструментов AccessibleContext принимает форму AccessibleJToolBar. Новый экземпляр AccessibleJToolBar создается в случае необходимости.

Определенный:

getAccessibleContext в интерфейсе Accessible

Переопределения:

getAccessibleContext в class Component

Возвраты:

AccessibleJToolBar, который служит AccessibleContext этого JToolBar