Класс 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, добавлена поддержка долгосрочного хранения всех JavaBeans в пакете java.beans. См. XMLEncoder.

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

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

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

Container.AccessibleAWTContainer

Вложенные классы/интерфейсы, объявленные в классе java.awt.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, из которого был создан экземпляр.

Поля, объявленные в классе 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

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

Конструктор	Описание
`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()`	Возвращает, находится ли курсор мыши над разделителем.
`protected void`	`oneTouchExpandableChanged()`	Получает сообщение при изменении значения oneTouchExpandable JSplitPane, в котором находится разделитель. Если необходимо, вызовет updateOrientation.
`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)`	Устанавливает, находится ли курсор мыши над разделителем.

Методы, объявленные в классе java.awt.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

Методы, объявленные в классе java.awt.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

Методы, объявленные в классе java.lang.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

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

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()

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

Возвращает:: находится ли мышь над разделителем
С:: 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. Включенный компонент может реагировать на ввод пользователя и генерировать события. Компоненты по умолчанию включаются изначально.

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

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

Overrides:

setEnabled в классе Component

Параметры:

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

См. также:

paint

public void paint(Graphics g)

Рисует разделитель.

Overrides:

paint в классе Container

Параметры:

g - указанное графическое окно

См. также:

oneTouchExpandableChanged

protected void oneTouchExpandableChanged()

Сообщение при изменении значения oneTouchExpandable JSplitPane, в котором содержится разделитель. Если конкретный L&F поддерживает свойство 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/plaf/basic/BasicSplitPaneDivider.html