Spec-Zone.ru › OpenJDK 24

Класс 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 используется для разделения двух (и только двух) Component. Два Component графически разделены в соответствии с реализацией визуального оформления, и два Component могут быть перетаскиваемыми пользователем. Информация по использованию JSplitPane находится в Руководстве по использованию разделительных панелей в Руководстве по Java.

Два Component в разделительной панели могут быть выстроены слева направо, используя JSplitPane.HORIZONTAL_SPLIT, или сверху вниз, используя JSplitPane.VERTICAL_SPLIT. Предпочтительный способ изменения размера Component — вызов setDividerLocation, где location — это новое значение x или y в зависимости от ориентации JSplitPane.

Для изменения размера Component до их предпочтительных размеров вызовите resetToPreferredSizes.

При изменении пользователем размера Component используется минимальный размер Components для определения максимального/минимального положения, до которого можно установить Component. Если минимальный размер двух компонентов больше размера разделительной панели, разделитель не позволит изменить его размер. Для изменения минимального размера JComponent, см. JComponent.setMinimumSize(java.awt.Dimension).

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

Предупреждение: Swing не потокобезопасен. Дополнительную информацию см. в Политике потоков Swing.

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

С момента:
1.2
См. также:
  • setDividerLocation(double)
  • resetToPreferredSizes()

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

Модификатор и тип Класс Описание
protected class  JSplitPane.AccessibleJSplitPane
Этот класс реализует поддержку доступности для класса JSplitPane.

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

Вложенные классы/интерфейсы, объявленные в классе java.awt.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
Горизонтальное разделение указывает, что Component разделены по оси 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
Связанное свойство для weight.
static final String RIGHT
Используется для добавления Component справа от другого Component.
protected Component rightComponent
Компонент справа или снизу.
static final String TOP
Используется для добавления Component над другим Component.
static final int VERTICAL_SPLIT
Вертикальное разделение указывает, что Component разделены по оси y.

Поля, объявленные в классе javax.swing.JComponent

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

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

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

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

Конструктор Описание
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)
Переопределён для отправки сообщения UI с 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 предоставлял UI-виджет на разделителе для быстрого разворачивания/сворачивания разделителя.
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 о том, что визуальное оформление изменилось.

Методы, объявленные в классе javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, 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

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

add, add, add, add, add, addContainerListener, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

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

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

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

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

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

VERTICAL_SPLIT

public static final int VERTICAL_SPLIT
Вертикальное разделение указывает, что Component разделены по оси Y. Например, два Component будут разделены один над другим.
См. также:
  • Constant Field Values

HORIZONTAL_SPLIT

public static final int HORIZONTAL_SPLIT
Горизонтальное разделение указывает, что Component разделены по оси X. Например, два Component будут разделены один слева от другого.
См. также:
  • Constant Field Values

LEFT

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

RIGHT

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

TOP

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

BOTTOM

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

DIVIDER

public static final String DIVIDER
Используется для добавления Component, который будет представлять разделитель.
См. также:
  • Constant Field Values

ORIENTATION_PROPERTY

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

CONTINUOUS_LAYOUT_PROPERTY

public static final String CONTINUOUS_LAYOUT_PROPERTY
Имя связанного свойства для continuousLayout.
См. также:
  • Constant Field Values

DIVIDER_SIZE_PROPERTY

public static final String DIVIDER_SIZE_PROPERTY
Имя связанного свойства для границы.
См. также:
  • Constant Field Values

ONE_TOUCH_EXPANDABLE_PROPERTY

public static final String ONE_TOUCH_EXPANDABLE_PROPERTY
Связанное свойство для oneTouchExpandable.
См. также:
  • Constant Field Values

LAST_DIVIDER_LOCATION_PROPERTY

public static final String LAST_DIVIDER_LOCATION_PROPERTY
Связанное свойство для lastLocation.
См. также:
  • Constant Field Values

DIVIDER_LOCATION_PROPERTY

public static final String DIVIDER_LOCATION_PROPERTY
Связанное свойство для dividerLocation.
С версии:
1.3
См. также:
  • Constant Field Values

RESIZE_WEIGHT_PROPERTY

public static final String RESIZE_WEIGHT_PROPERTY
Связанное свойство для weight.
С версии:
1.3
См. также:
  • Constant Field Values

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(javax.swing.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 о том, что внешний вид изменился. Заменяет текущий объект 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(javax.swing.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()
Компонует разделитель на основе предпочтительных размеров дочерних компонентов. Это может привести к изменению положения разделителя.

setDividerLocation

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

Этот метод реализован через setDividerLocation(int). Этот метод немедленно изменяет размер разделителя, основываясь на текущем размере. Если разделитель не отображается корректно, этот метод не будет иметь эффекта (новое положение разделителя станет (текущий размер * proportionalLocation), что равно 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(java.awt.Component)
  • Container.invalidate()
  • Container.validate()
  • Container.remove(int)

remove

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

removeAll

public void removeAll()
Удаляет все дочерние компоненты из разделителя. Сбрасывает переменные leftComponent и rightComponent.
Переопределяет:
removeAll в классе Container
См. также:
  • Container.add(java.awt.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, компонент добавляется в первую доступную позицию (слева/сверху, если открыто, в противном случае справа/снизу).
Overrides:
addImpl в классе Container
Parameters:
comp - компонент для добавления
constraints - Object, определяющий ограничения макета (позицию) для этого компонента
index - целое число, определяющее индекс в списке контейнера.
Throws:
IllegalArgumentException - если объект constraints не соответствует существующему компоненту
See Also:
  • Container.addImpl(Component, Object, int)

paintChildren

protected void paintChildren(Graphics g)
Переопределён для отправки сообщения UI с finishedPaintingChildren после сообщения суперклассу, а также для отрисовки рамки.
Overrides:
paintChildren в классе JComponent
Parameters:
g - контекст Graphics для отрисовки
See Also:
  • JComponent.paint(java.awt.Graphics)
  • Container.paint(java.awt.Graphics)

paramString

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

getAccessibleContext

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

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

Spec-Zone.ru

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