Spec-Zone.ru › OpenJDK 25

Класс JSplitPane

java.lang.Object
java.awt.Component
java.awt.Container
javax.swing.JComponent
javax.swing.JSplitPane
Все реализуемые интерфейсы:
ImageObserver, MenuContainer, Serializable, Accessible
@JavaBean(defaultProperty="UI") public class JSplitPane extends JComponent implements Accessible
JSplitPane используется для разделения двух (и только двух) Components. Графическое разделение двух Components зависит от реализации оформления, а размеры двух Components пользователь может изменять интерактивно. Информация об использовании JSplitPane приведена в разделе Использование разделённых панелей учебного пособия Учебное пособие по Java.

Два Components в разделённой панели можно расположить слева направо с помощью JSplitPane.HORIZONTAL_SPLIT или сверху вниз с помощью JSplitPane.VERTICAL_SPLIT. Чтобы изменить размер Components, рекомендуется вызвать setDividerLocation, где location — это новая координата x или y, в зависимости от ориентации JSplitPane.

Чтобы изменить размер Components на их предпочтительные размеры, вызовите resetToPreferredSizes.

Когда пользователь изменяет размер Components, минимальный размер Components используется для определения максимальной/минимальной позиции, на которую можно установить Components. Если минимальный размер двух компонентов больше размера разделённой панели, разделитель не позволит изменить её размер. Чтобы изменить минимальный размер JComponent, см. JComponent.setMinimumSize(Dimension).

Когда пользователь изменяет размер разделённой панели, новое пространство распределяется между двумя компонентами на основе свойства resizeWeight. Значение 0, используемое по умолчанию, означает, что всё пространство получает правый/нижний компонент, а значение 1 означает, что всё пространство получает левый/верхний компонент.

Предупреждение: Swing не является потокобезопасной библиотекой. Дополнительные сведения см. в разделе Политика многопоточности Swing.

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

Начиная с версии:
1.2
См. также:
  • setDividerLocation(double)
  • resetToPreferredSizes()

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

Модификатор и тип Класс Описание
protected class  JSplitPane.AccessibleJSplitPane
Этот класс реализует поддержку специальных возможностей для класса JSplitPane.

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

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

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

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

Модификатор и тип Поле Описание
static final String BOTTOM
Используется для добавления Component под другими Component.
static final String CONTINUOUS_LAYOUT_PROPERTY
Имя связанного свойства continuousLayout.
protected boolean continuousLayout
Определяет, обновляются ли представления непрерывно при изменении размера.
static final String DIVIDER
Используется для добавления Component, обозначающего разделитель.
static final String DIVIDER_LOCATION_PROPERTY
Связанное свойство для dividerLocation.
static final String DIVIDER_SIZE_PROPERTY
Имя связанного свойства для border.
protected int dividerSize
Размер разделителя.
static final int HORIZONTAL_SPLIT
Горизонтальное разделение означает, что Components разделены вдоль оси x.
static final String LAST_DIVIDER_LOCATION_PROPERTY
Связанное свойство для lastLocation.
protected int lastDividerLocation
Предыдущее положение разделённой панели.
static final String LEFT
Используется для добавления Component слева от других Component.
protected Component leftComponent
Левый или верхний компонент.
static final String ONE_TOUCH_EXPANDABLE_PROPERTY
Связанное свойство для oneTouchExpandable.
protected boolean oneTouchExpandable
Предусмотрен ли небольшой элемент управления для быстрого раскрытия/сворачивания разделённой панели?
protected int orientation
Способ разделения представлений.
static final String ORIENTATION_PROPERTY
Имя связанного свойства для ориентации (горизонтальной или вертикальной).
static final String RESIZE_WEIGHT_PROPERTY
Связанное свойство для веса.
static final String RIGHT
Используется для добавления Component справа от других Component.
protected Component rightComponent
Правый или нижний компонент.
static final String TOP
Используется для добавления Component над другими Component.
static final int VERTICAL_SPLIT
Вертикальное разделение означает, что Components разделены вдоль оси y.

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

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

Конструктор Описание
JSplitPane()
Создаёт новый JSplitPane, настроенный для горизонтального расположения дочерних компонентов рядом друг с другом и использующий для компонентов две кнопки.
JSplitPane(int newOrientation)
Создаёт новый JSplitPane с указанной ориентацией.
JSplitPane(int newOrientation, boolean newContinuousLayout)
Создаёт новый JSplitPane с указанными ориентацией и стилем перерисовки.
JSplitPane(int newOrientation, boolean newContinuousLayout, Component newLeftComponent, Component newRightComponent)
Создаёт новый JSplitPane с указанными ориентацией и стилем перерисовки, а также указанными компонентами.
JSplitPane(int newOrientation, Component newLeftComponent, Component newRightComponent)
Создаёт новый JSplitPane с указанными ориентацией и компонентами.

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

Модификатор и тип Метод Описание
protected void addImpl(Component comp, Object constraints, int index)
Добавляет указанный компонент в эту разделённую панель.
AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим JSplitPane.
Component getBottomComponent()
Возвращает компонент, расположенный под разделителем или справа от него.
int getDividerLocation()
Возвращает последнее значение, переданное в setDividerLocation.
int getDividerSize()
Возвращает размер разделителя.
int getLastDividerLocation()
Возвращает последнее положение разделителя.
Component getLeftComponent()
Возвращает компонент слева (или сверху) от разделителя.
int getMaximumDividerLocation()
Возвращает максимальное положение разделителя, определённое реализацией оформления.
int getMinimumDividerLocation()
Возвращает минимальное положение разделителя, определённое реализацией оформления.
int getOrientation()
Возвращает ориентацию.
double getResizeWeight()
Возвращает число, определяющее распределение дополнительного пространства.
Component getRightComponent()
Возвращает компонент справа (или снизу) от разделителя.
Component getTopComponent()
Возвращает компонент над разделителем или слева от него.
SplitPaneUI getUI()
Возвращает SplitPaneUI, обеспечивающий текущее оформление.
String getUIClassID()
Возвращает имя класса оформления (L&F), который отображает этот компонент.
boolean isContinuousLayout()
Возвращает свойство continuousLayout.
boolean isOneTouchExpandable()
Возвращает свойство oneTouchExpandable.
boolean isValidateRoot()
Возвращает true, чтобы вызовы revalidate для любого потомка этого JSplitPane помещали запрос в очередь на проверку JSplitPane и всех его потомков.
protected void paintChildren(Graphics g)
Переопределён для отправки сообщения finishedPaintingChildren в пользовательский интерфейс после вызова метода суперкласса, а также для отрисовки границы.
protected String paramString()
Возвращает строковое представление этого JSplitPane.
void remove(int index)
Удаляет Component с указанным индексом.
void remove(Component component)
Удаляет из панели дочерний компонент component.
void removeAll()
Удаляет все дочерние компоненты из разделённой панели.
void resetToPreferredSizes()
Выполняет компоновку JSplitPane на основе предпочтительных размеров дочерних компонентов.
void setBottomComponent(Component comp)
Задаёт компонент, расположенный под разделителем или справа от него.
void setComponentOrientation(ComponentOrientation orientation)
Задаёт языковую ориентацию, используемую для упорядочения элементов или текста внутри этого компонента.
void setContinuousLayout(boolean newContinuousLayout)
Задаёт значение свойства continuousLayout, которое должно быть равно true, чтобы дочерние компоненты непрерывно обновлялись и компоновались во время действий пользователя.
void setDividerLocation(double proportionalLocation)
Задаёт положение разделителя в процентах от размера JSplitPane.
void setDividerLocation(int location)
Задаёт положение разделителя.
void setDividerSize(int newSize)
Задаёт размер разделителя.
void setEnabled(boolean enabled)
Задаёт, включён ли этот компонент.
void setLastDividerLocation(int newLastLocation)
Устанавливает предыдущее положение разделителя в значение newLastLocation.
void setLeftComponent(Component comp)
Задаёт компонент слева (или сверху) от разделителя.
void setOneTouchExpandable(boolean newValue)
Задаёт значение свойства oneTouchExpandable, которое должно быть равно true, чтобы JSplitPane отображал на разделителе элемент управления для быстрого раскрытия/сворачивания.
void setOrientation(int orientation)
Задаёт ориентацию, то есть способ разделения панели.
void setResizeWeight(double value)
Задаёт способ распределения дополнительного пространства при изменении размера разделённой панели.
void setRightComponent(Component comp)
Задаёт компонент справа (или снизу) от разделителя.
void setTopComponent(Component comp)
Задаёт компонент над разделителем или слева от него.
void setUI(SplitPaneUI ui)
Задаёт объект оформления (L&F), который отображает этот компонент.
void updateUI()
Уведомление от UIManager об изменении оформления (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, paint, paintBorder, 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, 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, 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, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

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

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

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

VERTICAL_SPLIT

public static final int VERTICAL_SPLIT
Вертикальное разделение указывает, что Components разделены вдоль оси y. Например, два Components будут расположены друг над другом.
См. также:
  • Значения констант полей

HORIZONTAL_SPLIT

public static final int HORIZONTAL_SPLIT
Горизонтальное разделение указывает, что Components разделены вдоль оси x. Например, два Components будут расположены рядом друг с другом.
См. также:
  • Значения констант полей

LEFT

public static final String LEFT
Используется для добавления Component слева от другого Component.
См. также:
  • Значения констант полей

RIGHT

public static final String RIGHT
Используется для добавления Component справа от другого Component.
См. также:
  • Значения констант полей

TOP

public static final String TOP
Используется для добавления Component над другим Component.
См. также:
  • Значения констант полей

BOTTOM

public static final String BOTTOM
Используется для добавления Component под другим Component.
См. также:
  • Значения констант полей

DIVIDER

public static final String DIVIDER
Используется для добавления Component, представляющего разделитель.
См. также:
  • Значения констант полей

ORIENTATION_PROPERTY

public static final String ORIENTATION_PROPERTY
Имя ограниченного свойства ориентации (горизонтальной или вертикальной).
См. также:
  • Значения констант полей

CONTINUOUS_LAYOUT_PROPERTY

public static final String CONTINUOUS_LAYOUT_PROPERTY
Имя ограниченного свойства continuousLayout.
См. также:
  • Значения констант полей

DIVIDER_SIZE_PROPERTY

public static final String DIVIDER_SIZE_PROPERTY
Имя ограниченного свойства границы.
См. также:
  • Значения констант полей

ONE_TOUCH_EXPANDABLE_PROPERTY

public static final String ONE_TOUCH_EXPANDABLE_PROPERTY
Ограниченное свойство oneTouchExpandable.
См. также:
  • Значения констант полей

LAST_DIVIDER_LOCATION_PROPERTY

public static final String LAST_DIVIDER_LOCATION_PROPERTY
Ограниченное свойство lastLocation.
См. также:
  • Значения констант полей

DIVIDER_LOCATION_PROPERTY

public static final String DIVIDER_LOCATION_PROPERTY
Ограниченное свойство dividerLocation.
Начиная с версии:
1.3
См. также:
  • Значения констант полей

RESIZE_WEIGHT_PROPERTY

public static final String RESIZE_WEIGHT_PROPERTY
Ограниченное свойство weight.
Начиная с версии:
1.3
См. также:
  • Значения констант полей

orientation

protected int orientation
Способ разделения областей просмотра.

continuousLayout

protected boolean continuousLayout
Перерисовываются ли области просмотра непрерывно во время изменения размера.

leftComponent

protected Component leftComponent
Левый или верхний компонент.

rightComponent

protected Component rightComponent
Правый или нижний компонент.

dividerSize

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

oneTouchExpandable

protected boolean oneTouchExpandable
Предоставляется ли небольшой элемент управления для быстрого разворачивания и сворачивания панели разделения?

lastDividerLocation

protected int lastDividerLocation
Предыдущее положение разделителя панели.

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

JSplitPane

public JSplitPane()
Создает новую JSplitPane, настроенную на горизонтальное расположение дочерних компонентов рядом друг с другом, используя две кнопки для компонентов.

JSplitPane

@ConstructorProperties("orientation") public JSplitPane(int newOrientation)
Создает новую JSplitPane с указанной ориентацией.
Параметры:
newOrientation — JSplitPane.HORIZONTAL_SPLIT или JSplitPane.VERTICAL_SPLIT
Исключения:
IllegalArgumentException — если orientation не является одним из HORIZONTAL_SPLIT или VERTICAL_SPLIT.

JSplitPane

public JSplitPane(int newOrientation, boolean newContinuousLayout)
Создает новую JSplitPane с указанными ориентацией и стилем перерисовки.
Параметры:
newOrientation — JSplitPane.HORIZONTAL_SPLIT или JSplitPane.VERTICAL_SPLIT
newContinuousLayout — логическое значение: true — компоненты перерисовываются непрерывно при изменении положения разделителя, false — перерисовка ожидает прекращения изменения положения разделителя
Исключения:
IllegalArgumentException — если orientation не является одним из HORIZONTAL_SPLIT или VERTICAL_SPLIT

JSplitPane

public JSplitPane(int newOrientation, Component newLeftComponent, Component newRightComponent)
Создает новую JSplitPane с указанными ориентацией и компонентами.
Параметры:
newOrientation — JSplitPane.HORIZONTAL_SPLIT или JSplitPane.VERTICAL_SPLIT
newLeftComponent — Component, который будет отображаться слева в горизонтально разделенной панели или сверху в вертикально разделенной панели
newRightComponent — Component, который будет отображаться справа в горизонтально разделенной панели или снизу в вертикально разделенной панели
Исключения:
IllegalArgumentException — если orientation не является одним из HORIZONTAL_SPLIT или VERTICAL_SPLIT

JSplitPane

public JSplitPane(int newOrientation, boolean newContinuousLayout, Component newLeftComponent, Component newRightComponent)
Создает новую JSplitPane с указанными ориентацией и стилем перерисовки, а также компонентами.
Параметры:
newOrientation — JSplitPane.HORIZONTAL_SPLIT или JSplitPane.VERTICAL_SPLIT
newContinuousLayout — логическое значение: true — компоненты перерисовываются непрерывно при изменении положения разделителя, false — перерисовка ожидает прекращения изменения положения разделителя
newLeftComponent — Component, который будет отображаться слева в горизонтально разделенной панели или сверху в вертикально разделенной панели
newRightComponent — Component, который будет отображаться справа в горизонтально разделенной панели или снизу в вертикально разделенной панели
Исключения:
IllegalArgumentException — если orientation не является одним из HORIZONTAL_SPLIT или VERTICAL_SPLIT

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

setComponentOrientation

public void setComponentOrientation(ComponentOrientation orientation)
Задает зависящую от языка ориентацию, которая будет использоваться для упорядочивания элементов или текста внутри этого компонента. Зависимые от языка подклассы LayoutManager и Component используют это свойство, чтобы определять расположение и отрисовку компонентов.

При создании ориентации компонента присваивается значение ComponentOrientation.UNKNOWN, указывающее, что она не была задана явно. Ориентация UNKNOWN ведет себя так же, как ComponentOrientation.LEFT_TO_RIGHT.

Чтобы задать ориентацию отдельного компонента, используйте этот метод. Чтобы задать ориентацию всей иерархии компонентов, используйте applyComponentOrientation.

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

Переопределяет:
setComponentOrientation в классе Component
Параметры:
orientation — задаваемая ориентация
См. также:
  • ComponentOrientation
  • Component.invalidate()

setEnabled

public void setEnabled(boolean enabled)
Задает, включен ли этот компонент. Включенный компонент может реагировать на ввод пользователя, а отключенный — нет. Некоторые компоненты могут изменять свой внешний вид при отключении, чтобы сообщить пользователю, что они не принимают ввод.

Примечание: отключение компонента не отключает его дочерние компоненты.

Примечание: отключение облегченного компонента не мешает ему получать MouseEvents.

Переопределяет:
setEnabled в классе JComponent
Параметры:
enabled — true, если этот компонент должен быть включен; в противном случае false
См. также:
  • Component.isEnabled()
  • Component.isLightweight()

setUI

public void setUI(SplitPaneUI ui)
Задает объект L&F, который отрисовывает этот компонент.
Параметры:
ui — объект L&F SplitPaneUI
См. также:
  • UIDefaults.getUI(JComponent)

getUI

@BeanProperty(bound=false, expert=true, description="The L&F object that renders this component.") public SplitPaneUI getUI()
Возвращает SplitPaneUI, обеспечивающий текущий внешний вид.
Переопределяет:
getUI в классе JComponent
Возвращает:
объект SplitPaneUI, который отрисовывает этот компонент

updateUI

public void updateUI()
Уведомление от UIManager об изменении L&F. Заменяет текущий объект UI последней версией из UIManager.
Переопределяет:
updateUI в классе JComponent
См. также:
  • JComponent.updateUI()

getUIClassID

@BeanProperty(bound=false, expert=true, description="A string that specifies the name of the L&F class.") public String getUIClassID()
Возвращает имя класса L&F, который отрисовывает этот компонент.
Переопределяет:
getUIClassID в классе JComponent
Возвращает:
строку "SplitPaneUI"
См. также:
  • JComponent.getUIClassID()
  • UIDefaults.getUI(JComponent)

setDividerSize

@BeanProperty(description="The size of the divider.") public void setDividerSize(int newSize)
Задает размер разделителя. Размеры разделителя newSize < 0 игнорируются.
Параметры:
newSize — целое число, задающее размер разделителя в пикселях

getDividerSize

public int getDividerSize()
Возвращает размер разделителя.
Возвращает:
целое число, задающее размер разделителя в пикселях

setLeftComponent

public void setLeftComponent(Component comp)
Задает компонент слева (или сверху) от разделителя.
Параметры:
comp — Component для отображения в этой позиции

getLeftComponent

@BeanProperty(bound=false, preferred=true, description="The component to the left (or above) the divider.") public Component getLeftComponent()
Возвращает компонент слева (или сверху) от разделителя.
Возвращает:
Component, отображаемый в этой позиции

setTopComponent

@BeanProperty(bound=false, description="The component above, or to the left of the divider.") public void setTopComponent(Component comp)
Задает компонент над разделителем или слева от него.
Параметры:
comp — Component для отображения в этой позиции

getTopComponent

public Component getTopComponent()
Возвращает компонент над разделителем или слева от него.
Возвращает:
Component, отображаемый в этой позиции

setRightComponent

@BeanProperty(bound=false, preferred=true, description="The component to the right (or below) the divider.") public void setRightComponent(Component comp)
Задает компонент справа (или снизу) от разделителя.
Параметры:
comp — Component для отображения в этой позиции

getRightComponent

public Component getRightComponent()
Возвращает компонент справа (или снизу) от разделителя.
Возвращает:
Component, отображаемый в этой позиции

setBottomComponent

@BeanProperty(bound=false, description="The component below, or to the right of the divider.") public void setBottomComponent(Component comp)
Задает компонент под разделителем или справа от него.
Параметры:
comp — Component для отображения в этой позиции

getBottomComponent

public Component getBottomComponent()
Возвращает компонент под разделителем или справа от него.
Возвращает:
Component, отображаемый в этой позиции

setOneTouchExpandable

@BeanProperty(description="UI widget on the divider to quickly expand/collapse the divider.") public void setOneTouchExpandable(boolean newValue)
Задает значение свойства oneTouchExpandable, которое должно быть true, чтобы JSplitPane предоставил на разделителе элемент управления для быстрого разворачивания и сворачивания. Значение этого свойства по умолчанию — false. Некоторые реализации внешнего вида могут не поддерживать разворачивание одним касанием и будут игнорировать это свойство.
Параметры:
newValue — true, чтобы указать, что панель разделения должна предоставлять элемент управления сворачиванием и разворачиванием
См. также:
  • isOneTouchExpandable()

isOneTouchExpandable

public boolean isOneTouchExpandable()
Возвращает значение свойства oneTouchExpandable.
Возвращает:
значение свойства oneTouchExpandable
См. также:
  • setOneTouchExpandable(boolean)

setLastDividerLocation

@BeanProperty(description="The last location the divider was at.") public void setLastDividerLocation(int newLastLocation)
Задает последнее положение разделителя равным newLastLocation.
Параметры:
newLastLocation — целое число, задающее последнее положение разделителя в пикселях от левого (или верхнего) края панели до левого (или верхнего) края разделителя

getLastDividerLocation

public int getLastDividerLocation()
Возвращает последнее положение разделителя.
Возвращает:
целое число, задающее последнее положение разделителя в пикселях от левого (или верхнего) края панели до левого (или верхнего) края разделителя

setOrientation

@BeanProperty(enumerationValues={"JSplitPane.HORIZONTAL_SPLIT","JSplitPane.VERTICAL_SPLIT"}, description="The orientation, or how the splitter is divided.") public void setOrientation(int orientation)
Задает ориентацию, то есть способ разделения панели. Возможны следующие варианты:
  • JSplitPane.VERTICAL_SPLIT (компоненты расположены сверху и снизу)
  • JSplitPane.HORIZONTAL_SPLIT (компоненты расположены слева и справа)
Параметры:
orientation — целое число, задающее ориентацию
Исключения:
IllegalArgumentException — если ориентация не является одной из: HORIZONTAL_SPLIT или VERTICAL_SPLIT.

getOrientation

public int getOrientation()
Возвращает ориентацию.
Возвращает:
целое число, задающее ориентацию
См. также:
  • setOrientation(int)

setContinuousLayout

@BeanProperty(description="Whether the child components are continuously redisplayed and laid out during user intervention.") public void setContinuousLayout(boolean newContinuousLayout)
Задает значение свойства continuousLayout, которое должно быть true, чтобы дочерние компоненты непрерывно перерисовывались и размещались во время действий пользователя. Значение этого свойства по умолчанию зависит от внешнего вида. Некоторые реализации внешнего вида могут не поддерживать непрерывную компоновку и будут игнорировать это свойство.
Параметры:
newContinuousLayout — true, если компоненты должны непрерывно перерисовываться при изменении положения разделителя
См. также:
  • isContinuousLayout()

isContinuousLayout

public boolean isContinuousLayout()
Возвращает значение свойства continuousLayout.
Возвращает:
значение свойства continuousLayout
См. также:
  • setContinuousLayout(boolean)

setResizeWeight

@BeanProperty(description="Specifies how to distribute extra space when the split pane resizes.") public void setResizeWeight(double value)
Задает распределение дополнительного пространства при изменении размера панели разделения. Значение 0 (по умолчанию) означает, что все дополнительное пространство достается правому или нижнему компоненту (левый или верхний компонент остается неизменным), а значение 1 означает, что все дополнительное пространство достается левому или верхнему компоненту (правый или нижний компонент остается неизменным). В частности, левый или верхний компонент получает дополнительное пространство в размере (weight * diff), а правый или нижний — (1 - weight) * diff.
Параметры:
value — как описано выше
Исключения:
IllegalArgumentException — если value меньше 0 или больше 1
Начиная с версии:
1.3

getResizeWeight

public double getResizeWeight()
Возвращает значение, определяющее распределение дополнительного пространства.
Возвращает:
способ распределения дополнительного пространства при изменении размера панели разделения
Начиная с версии:
1.3

resetToPreferredSizes

public void resetToPreferredSizes()
Выполняет компоновку JSplitPane на основе предпочтительных размеров дочерних компонентов. Это, скорее всего, приведет к изменению положения разделителя.

setDividerLocation

@BeanProperty(description="The location of the divider.") public void setDividerLocation(double proportionalLocation)
Задает положение разделителя в процентах от размера JSplitPane.

Этот метод реализован на основе setDividerLocation(int). Он немедленно изменяет размер панели разделения с учетом ее текущего размера. Если панель разделения не создана должным образом и не отображается на экране, этот метод не даст эффекта (новое положение разделителя будет равно (текущий размер * пропорциональноеПоложение), то есть 0).

Параметры:
proportionalLocation — число с плавающей точкой двойной точности, задающее процент от 0 (сверху/слева) до 1.0 (снизу/справа)
Исключения:
IllegalArgumentException — если указанное положение меньше 0 или больше 1.0

setDividerLocation

@BeanProperty(description="The location of the divider.") public void setDividerLocation(int location)
Задает положение разделителя. Значение передается реализации внешнего вида, после чего уведомляются прослушиватели. Значение меньше 0 означает, что положение разделителя следует сбросить до значения, которое пытается учитывать предпочтительный размер левого или верхнего компонента. После уведомления прослушивателей последнее положение разделителя обновляется с помощью setLastDividerLocation.
Параметры:
location — целое число, задающее значение, зависящее от реализации пользовательского интерфейса (обычно число пикселей)

getDividerLocation

public int getDividerLocation()
Возвращает последнее значение, переданное в setDividerLocation. Значение, возвращаемое этим методом, может отличаться от фактического положения разделителя (если в setDividerLocation было передано значение, превышающее текущий размер).
Возвращает:
целое число, задающее положение разделителя

getMinimumDividerLocation

@BeanProperty(bound=false, description="The minimum location of the divider from the L&F.") public int getMinimumDividerLocation()
Возвращает минимальное положение разделителя, заданное реализацией внешнего вида.
Возвращает:
целое число, задающее минимальное положение, зависящее от реализации пользовательского интерфейса (обычно число пикселей); или -1, если UI является null

getMaximumDividerLocation

@BeanProperty(bound=false) public int getMaximumDividerLocation()
Возвращает максимальное положение разделителя, заданное реализацией внешнего вида.
Возвращает:
целое число, задающее максимальное положение, зависящее от реализации пользовательского интерфейса (обычно число пикселей); или -1, если UI является null

remove

public void remove(Component component)
Удаляет дочерний компонент component из панели. При необходимости сбрасывает переменную экземпляра leftComponent или rightComponent.
Переопределяет:
remove в классе Container
Параметры:
component — удаляемый Component
См. также:
  • Container.add(Component)
  • Container.invalidate()
  • Container.validate()
  • Container.remove(int)

remove

public void remove(int index)
Удаляет Component с указанным индексом. При необходимости обновляет переменные экземпляра leftComponent и rightComponent, а затем вызывает метод суперкласса.
Переопределяет:
remove в классе Container
Параметры:
index - целое число, указывающее компонент, который нужно удалить; 1 обозначает левый/верхний компонент, а 2 — нижний/правый компонент
См. также:
  • Container.add(Component)
  • Container.invalidate()
  • Container.validate()
  • Container.getComponentCount()

removeAll

public void removeAll()
Удаляет все дочерние компоненты из панели разделения. Сбрасывает переменные экземпляра leftComponent и rightComponent.
Переопределяет:
removeAll в классе Container
См. также:
  • Container.add(Component)
  • Container.remove(int)
  • Container.invalidate()

isValidateRoot

@BeanProperty(hidden=true) public boolean isValidateRoot()
Возвращает true, чтобы вызовы revalidate для любого потомка этого JSplitPane приводили к постановке в очередь запроса на проверку корректности JSplitPane и всех его потомков.
Переопределяет:
isValidateRoot в классе JComponent
Возвращает:
true
См. также:
  • JComponent.revalidate()
  • Container.isValidateRoot()

addImpl

protected void addImpl(Component comp, Object constraints, int index)
Добавляет указанный компонент в эту панель разделения. Если constraints обозначает левый/верхний или правый/нижний дочерний компонент и компонент с таким идентификатором был добавлен ранее, он будет удален, а затем на его место будет добавлен comp. Если constraints не является одним из известных идентификаторов, менеджер компоновки может выбросить IllegalArgumentException.

Возможные объекты-ограничения (строки):

  • JSplitPane.TOP
  • JSplitPane.LEFT
  • JSplitPane.BOTTOM
  • JSplitPane.RIGHT
Если объект constraints равен null, компонент добавляется в первую доступную позицию (слева/сверху, если она свободна, иначе справа/снизу).
Переопределяет:
addImpl в классе Container
Параметры:
comp - добавляемый компонент
constraints - Object, задающий ограничения компоновки (позицию) для этого компонента
index - целое число, указывающее индекс в списке контейнера.
Выбрасывает:
IllegalArgumentException - если объект constraints не соответствует существующему компоненту
См. также:
  • Container.addImpl(Component, Object, int)

paintChildren

protected void paintChildren(Graphics g)
Переопределен для вызова UI с помощью finishedPaintingChildren после вызова метода суперкласса, а также для отрисовки границы.
Переопределяет:
paintChildren в классе JComponent
Параметры:
g - контекст Graphics, в котором выполняется отрисовка
См. также:
  • JComponent.paint(Graphics)
  • Container.paint(Graphics)

paramString

protected String paramString()
Возвращает строковое представление этого JSplitPane. Этот метод предназначен только для отладки; содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть null.
Переопределяет:
paramString в классе JComponent
Возвращает:
строковое представление этого JSplitPane.

getAccessibleContext

@BeanProperty(bound=false, expert=true, description="The AccessibleContext associated with this SplitPane.") public AccessibleContext getAccessibleContext()
Возвращает AccessibleContext, связанный с этим JSplitPane. Для панелей разделения AccessibleContext имеет вид AccessibleJSplitPane. При необходимости создается новый экземпляр AccessibleJSplitPane.
Указан в:
getAccessibleContext в интерфейсе Accessible
Переопределяет:
getAccessibleContext в классе Component
Возвращает:
AccessibleJSplitPane, служащий AccessibleContext для этого JSplitPane

Сообщить об ошибке или предложить улучшение
Дополнительную справочную информацию по API и документацию для разработчиков см. в документации Java SE, содержащей более подробные описания для разработчиков, в том числе обзоры концепций, определения терминов, обходные решения и рабочие примеры кода. Другие версии.
Java является товарным знаком или зарегистрированным товарным знаком Oracle и/или ее аффилированных лиц в США и других странах.
Авторские права © 1993, 2025, Oracle и/или ее аффилированные лица, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
Все права защищены. Использование регулируется условиями лицензии и политикой распространения документации.

© 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/JSplitPane.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API