Класс BasicSplitPaneDivider

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.plaf.basic.BasicSplitPaneDivider

Все реализованные интерфейсы:: ImageObserver, MenuContainer, PropertyChangeListener, Serializable, EventListener

public class BasicSplitPaneDivider extends Container implements PropertyChangeListener

Разделитель, используемый BasicSplitPaneUI. При необходимости в подклассах можно переопределить paint, чтобы реализовать более интересную отрисовку. Эффект границы отрисовывается в BasicSplitPaneUI, поэтому, если эта граница вам не нравится, сбросьте её там. Чтобы разрешить перетаскивание только из определённых областей, переопределите mousePressed и вызовите super, когда нужно начать перетаскивание.

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

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`protected class`	`BasicSplitPaneDivider.DividerLayout`	Используется для размещения `BasicSplitPaneDivider`.
`protected class`	`BasicSplitPaneDivider.DragController`	Обрабатывает события во время перетаскивания для разделённой панели с ориентацией HORIZONTAL_SPLIT.
`protected class`	`BasicSplitPaneDivider.MouseHandler`	MouseHandler отвечает за преобразование событий мыши (отпускание, перетаскивание и т. д.) в соответствующие вызовы методов DragController.
`protected class`	`BasicSplitPaneDivider.VerticalDragController`	Обрабатывает события во время перетаскивания для разделённой панели с ориентацией VERTICAL_SPLIT.

Вложенные классы/интерфейсы, объявленные в классе Container

Container.AccessibleAWTContainer

Вложенные классы/интерфейсы, объявленные в классе Component

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

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected int`	`dividerSize`	Размер разделителя.
`protected BasicSplitPaneDivider.DragController`	`dragger`	Обрабатывает сообщения о перетаскивании мышью и выполняет само перетаскивание.
`protected Component`	`hiddenDivider`	Разделитель, используемый в режиме непостоянного размещения.
`protected JButton`	`leftButton`	Кнопка для быстрого переключения левого компонента.
`protected BasicSplitPaneDivider.MouseHandler`	`mouseHandler`	Обрабатывает события мыши как от этого класса, так и от разделённой панели.
`protected static final int`	`ONE_TOUCH_OFFSET`	Смещение разделителя.
`protected static final int`	`ONE_TOUCH_SIZE`	Ширина или высота разделителя в зависимости от ориентации `BasicSplitPaneUI` увеличивает это значение на два.
`protected int`	`orientation`	Ориентация JSplitPane.
`protected JButton`	`rightButton`	Кнопка для быстрого переключения правого компонента.
`protected JSplitPane`	`splitPane`	Экземпляр JSplitPane, содержащий данный объект.
`protected BasicSplitPaneUI`	`splitPaneUI`	UI, на основе которого был создан этот экземпляр.

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе ImageObserver

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

Краткое описание конструкторов

Конструктор	Описание
`BasicSplitPaneDivider(BasicSplitPaneUI ui)`	Создаёт экземпляр `BasicSplitPaneDivider`.

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

Модификатор и тип	Метод	Описание
`protected JButton`	`createLeftOneTouchButton()`	Создаёт и возвращает экземпляр `JButton`, который можно использовать для сворачивания левого компонента разделённой панели.
`protected JButton`	`createRightOneTouchButton()`	Создаёт и возвращает экземпляр `JButton`, который можно использовать для сворачивания правого компонента разделённой панели.
`protected void`	`dragDividerTo(int location)`	Передаёт BasicSplitPaneUI, содержащему этот экземпляр, сообщение dragDividerTo.
`protected void`	`finishDraggingTo(int location)`	Передаёт BasicSplitPaneUI, содержащему этот экземпляр, сообщение finishDraggingTo.
`BasicSplitPaneUI`	`getBasicSplitPaneUI()`	Возвращает `SplitPaneUI`, в котором в данный момент находится данный объект.
`Border`	`getBorder()`	Возвращает границу этого компонента или null, если граница не задана.
`int`	`getDividerSize()`	Возвращает размер разделителя: ширину, если splitpane имеет значение HORIZONTAL_SPLIT, или высоту, если он имеет значение VERTICAL_SPLIT.
`Insets`	`getInsets()`	Если для этого компонента задана граница, возвращает её внутренние отступы; в противном случае вызывает super.getInsets.
`Dimension`	`getMinimumSize()`	Возвращает минимальный размер разделителя.
`Dimension`	`getPreferredSize()`	Возвращает предпочтительный размер разделителя.
`boolean`	`isMouseOver()`	Возвращает true, если указатель мыши в данный момент находится над разделителем.
`protected void`	`oneTouchExpandableChanged()`	Вызывается при изменении значения oneTouchExpandable у JSplitPane, содержащего разделитель.
`void`	`paint(Graphics g)`	Отрисовывает разделитель.
`protected void`	`prepareForDragging()`	Подготавливает объект к перетаскиванию.
`void`	`propertyChange(PropertyChangeEvent e)`	При событии изменения свойства, предположительно исходящем от JSplitPane, при необходимости вызывается updateOrientation.
`void`	`setBasicSplitPaneUI(BasicSplitPaneUI newUI)`	Задаёт `SplitPaneUI`, использующий данный объект.
`void`	`setBorder(Border border)`	Задаёт границу этого компонента.
`void`	`setDividerSize(int newSize)`	Задаёт размер разделителя: `newSize`.
`void`	`setEnabled(boolean enabled)`	Включает или отключает этот компонент в зависимости от значения параметра `b`.
`protected void`	`setMouseOver(boolean mouseOver)`	Задаёт, находится ли указатель мыши в данный момент над разделителем.

Методы, объявленные в классе Container

add, add, add, add, add, addContainerListener, addImpl, addNotify, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getAlignmentX, getAlignmentY, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getListeners, getMaximumSize, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, isValidateRoot, layout, list, list, locate, minimumSize, paintComponents, paramString, preferredSize, print, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, removeNotify, setComponentZOrder, setFocusCycleRoot, setFocusTraversalKeys, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setFont, setLayout, transferFocusDownCycle, update, validate, validateTree

Методы, объявленные в классе Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, contains, createImage, createImage, createVolatileImage, createVolatileImage, disable, disableEvents, dispatchEvent, enable, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getAccessibleContext, getBackground, getBaseline, getBaselineResizeBehavior, getBounds, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getFontMetrics, getForeground, getGraphics, getGraphicsConfiguration, getHeight, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getSize, getToolkit, getTreeLock, getWidth, getX, getY, gotFocus, handleEvent, hasFocus, hide, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isDoubleBuffered, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isOpaque, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, printAll, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processKeyEvent, processMouseEvent, processMouseMotionEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, repaint, requestFocus, requestFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, requestFocusInWindow, reshape, resize, resize, revalidate, setBackground, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setForeground, setIgnoreRepaint, setLocale, setLocation, setLocation, setMaximumSize, setMinimumSize, setMixingCutoutShape, setName, setPreferredSize, setSize, setSize, setVisible, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Методы, объявленные в классе Object

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

Подробное описание полей

ONE_TOUCH_SIZE

protected static final int ONE_TOUCH_SIZE

Ширина или высота разделителя в зависимости от ориентации BasicSplitPaneUI увеличивает это значение на два.

См. также:

ONE_TOUCH_OFFSET

protected static final int ONE_TOUCH_OFFSET

Смещение разделителя.

См. также:

dragger

protected BasicSplitPaneDivider.DragController dragger

Обрабатывает сообщения о перетаскивании мышью и выполняет само перетаскивание.

splitPaneUI

protected BasicSplitPaneUI splitPaneUI

UI, на основе которого был создан этот экземпляр.

dividerSize

protected int dividerSize

Размер разделителя.

hiddenDivider

protected Component hiddenDivider

Разделитель, используемый в режиме непостоянного размещения.

splitPane

protected JSplitPane splitPane

Экземпляр JSplitPane, содержащий данный объект.

mouseHandler

protected BasicSplitPaneDivider.MouseHandler mouseHandler

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

orientation

protected int orientation

Ориентация JSplitPane.

leftButton

protected JButton leftButton

Кнопка для быстрого переключения левого компонента.

rightButton

protected JButton rightButton

Кнопка для быстрого переключения правого компонента.

Подробное описание конструкторов

BasicSplitPaneDivider

public BasicSplitPaneDivider(BasicSplitPaneUI ui)

Создаёт экземпляр BasicSplitPaneDivider. Регистрирует этот экземпляр для обработки событий мыши и событий перетаскивания мышью.

Параметры:: ui — экземпляр BasicSplitPaneUI

Подробное описание методов

setBasicSplitPaneUI

public void setBasicSplitPaneUI(BasicSplitPaneUI newUI)

Задаёт SplitPaneUI, использующий данный объект.

Параметры:: newUI — новый SplitPaneUI

getBasicSplitPaneUI

public BasicSplitPaneUI getBasicSplitPaneUI()

Возвращает SplitPaneUI, в котором в данный момент находится данный объект.

Возвращает:: SplitPaneUI, в котором в данный момент находится данный объект

setDividerSize

public void setDividerSize(int newSize)

Задаёт размер разделителя равным newSize. Это ширина, если splitpane имеет значение HORIZONTAL_SPLIT, или высота, если он имеет значение VERTICAL_SPLIT. Размеры разделителя newSize < 0 игнорируются.

Параметры:: newSize — новый размер

getDividerSize

public int getDividerSize()

Возвращает размер разделителя: ширину, если splitpane имеет значение HORIZONTAL_SPLIT, или высоту, если он имеет значение VERTICAL_SPLIT.

Возвращает:: размер разделителя

setBorder

public void setBorder(Border border)

Задаёт границу этого компонента.

Параметры:: border — новая граница
Начиная с версии:: 1.3

getBorder

public Border getBorder()

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

Возвращает:

объект границы этого компонента

Начиная с версии:

1.3

См. также:

getInsets

public Insets getInsets()

Если для этого компонента задана граница, возвращает её внутренние отступы; в противном случае вызывает super.getInsets.

Переопределяет:

getInsets в классе Container

Возвращает:

значение свойства внутренних отступов.

См. также:

setMouseOver

protected void setMouseOver(boolean mouseOver)

Задаёт, находится ли указатель мыши в данный момент над разделителем.

Параметры:: mouseOver — находится ли указатель мыши в данный момент над разделителем
Начиная с версии:: 1.5

isMouseOver

public boolean isMouseOver()

Возвращает true, если указатель мыши в данный момент находится над разделителем.

Возвращает:: true, если указатель мыши в данный момент находится над разделителем
Начиная с версии:: 1.5

getPreferredSize

public Dimension getPreferredSize()

Возвращает предпочтительный размер разделителя.

Переопределяет:

getPreferredSize в классе Container

Примечание по реализации:

В текущей реализации, если splitpane имеет значение HORIZONTAL_SPLIT, предпочтительный размер определяется шириной getDividerSize пикселей и высотой 1 пиксель. Если splitpane имеет значение VERTICAL_SPLIT, предпочтительный размер определяется высотой getDividerSize пикселей и шириной 1 пиксель.

Возвращает:

объект Dimension, содержащий предпочтительный размер BasicSplitPaneDivider

См. также:

getMinimumSize

public Dimension getMinimumSize()

Возвращает минимальный размер разделителя.

Переопределяет:

getMinimumSize в классе Container

Примечание по реализации:

В текущей реализации, если splitpane имеет значение HORIZONTAL_SPLIT, минимальный размер определяется шириной getDividerSize пикселей и высотой 1 пиксель. Если splitpane имеет значение VERTICAL_SPLIT, минимальный размер определяется высотой getDividerSize пикселей и шириной 1 пиксель.

Возвращает:

объект Dimension, содержащий минимальный размер BasicSplitPaneDivider

См. также:

propertyChange

public void propertyChange(PropertyChangeEvent e)

Событие изменения свойства, предположительно исходящее от JSplitPane, при необходимости вызывает updateOrientation.

Определено в:: propertyChange в интерфейсе PropertyChangeListener
Параметры:: e — объект PropertyChangeEvent, описывающий источник события и изменившееся свойство.

setEnabled

public void setEnabled(boolean enabled)

Включает или отключает этот компонент в зависимости от значения параметра b. Включённый компонент может реагировать на ввод пользователя и генерировать события. По умолчанию компоненты изначально включены.

Примечание: отключение облегчённого компонента не препятствует получению им событий MouseEvent.

Примечание: отключение тяжеловесного контейнера препятствует получению любых событий ввода всеми компонентами этого контейнера. Отключение облегчённого контейнера влияет только на сам этот контейнер.

Переопределяет:

setEnabled в классе Component

Параметры:

enabled — если true, этот компонент включён; в противном случае он отключён

См. также:

paint

public void paint(Graphics g)

Отрисовывает разделитель.

Переопределяет:

paint в классе Container

Параметры:

g — указанное окно Graphics

См. также:

oneTouchExpandableChanged

protected void oneTouchExpandableChanged()

Вызывается при изменении значения oneTouchExpandable у JSplitPane, содержащего разделитель. Если конкретный стиль оформления поддерживает это свойство Swing "SplitPane.supportsOneTouchButtons", он создаёт leftButton и rightButton, если они равны null и соответствующий JSplitPane поддерживает свойство oneTouchExpandable. Также выполняется инвалидация соответствующего JSplitPane.

createLeftOneTouchButton

protected JButton createLeftOneTouchButton()

Создаёт и возвращает экземпляр JButton, который можно использовать для сворачивания левого компонента разделённой панели.

Возвращает:: экземпляр JButton

createRightOneTouchButton

protected JButton createRightOneTouchButton()

Создаёт и возвращает экземпляр JButton, который можно использовать для сворачивания правого компонента разделённой панели.

Возвращает:: экземпляр JButton

prepareForDragging

protected void prepareForDragging()

Подготавливает объект к перетаскиванию. Передаёт BasicSplitPaneUI сообщение startDragging.

dragDividerTo

protected void dragDividerTo(int location)

Передаёт BasicSplitPaneUI, содержащему этот экземпляр, сообщение dragDividerTo.

Параметры:: location — местоположение

finishDraggingTo

protected void finishDraggingTo(int location)

Передаёт BasicSplitPaneUI, содержащему этот экземпляр, сообщение finishDraggingTo.

Параметры:: location — местоположение

© 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/plaf/basic/BasicSplitPaneDivider.html