Класс ScrollBar

javafx.scene.control.ScrollBar

Все реализованные интерфейсы:: Styleable, EventTarget, Skinnable

public class ScrollBar
extends Control

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

ScrollBar устанавливает focusTraversable в false.

Этот пример создаёт вертикальную ScrollBar:

 ScrollBar s1 = new ScrollBar();
 s1.setOrientation(Orientation.VERTICAL);

С тех пор как:: JavaFX 2.0

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

Свойства
Тип	Свойство	Описание
`DoubleProperty`	`blockIncrement`	Значение, на которое будет сдвинута полоса прокрутки при нажатии на полосу.
`DoubleProperty`	`max`	Максимальное значение, представляемое этим элементом `ScrollBar`.
`DoubleProperty`	`min`	Минимальное значение, представляемое этим элементом `ScrollBar`.
`ObjectProperty<Orientation>`	`orientation`	Ориентация `ScrollBar` может быть `HORIZONTAL` или `VERTICAL`.
`DoubleProperty`	`unitIncrement`	Значение, на которое будет сдвинута полоса прокрутки при вызове методов `increment` или `decrement`.
`DoubleProperty`	`value`	Текущее значение, представляемое этим элементом `ScrollBar`.
`DoubleProperty`	`visibleAmount`	Видимая часть диапазона полосы прокрутки, обычно отображаемая размером ползунка полосы прокрутки.

Свойства, объявленные в классе javafx.scene.control.Control

contextMenu, skin, tooltip

Свойства, объявленные в классе javafx.scene.layout.Region

background, border, cacheShape, centerShape, height, insets, maxHeight, maxWidth, minHeight, minWidth, opaqueInsets, padding, prefHeight, prefWidth, scaleShape, shape, snapToPixel, width

Свойства, объявленные в классе javafx.scene.Parent

needsLayout

Свойства, объявленные в классе javafx.scene.Node

accessibleHelp, accessibleRoleDescription, accessibleRole, accessibleText, blendMode, boundsInLocal, boundsInParent, cacheHint, cache, clip, cursor, depthTest, disabled, disable, effectiveNodeOrientation, effect, eventDispatcher, focused, focusTraversable, hover, id, inputMethodRequests, layoutBounds, layoutX, layoutY, localToParentTransform, localToSceneTransform, managed, mouseTransparent, nodeOrientation, onContextMenuRequested, onDragDetected, onDragDone, onDragDropped, onDragEntered, onDragExited, onDragOver, onInputMethodTextChanged, onKeyPressed, onKeyReleased, onKeyTyped, onMouseClicked, onMouseDragEntered, onMouseDragExited, onMouseDragged, onMouseDragOver, onMouseDragReleased, onMouseEntered, onMouseExited, onMouseMoved, onMousePressed, onMouseReleased, onRotate, onRotationFinished, onRotationStarted, onScrollFinished, onScroll, onScrollStarted, onSwipeDown, onSwipeLeft, onSwipeRight, onSwipeUp, onTouchMoved, onTouchPressed, onTouchReleased, onTouchStationary, onZoomFinished, onZoom, onZoomStarted, opacity, parent, pickOnBounds, pressed, rotate, rotationAxis, scaleX, scaleY, scaleZ, scene, style, translateX, translateY, translateZ, viewOrder, visible

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

Поля, объявленные в классе javafx.scene.layout.Region

USE_COMPUTED_SIZE, USE_PREF_SIZE

Поля, объявленные в классе javafx.scene.Node

BASELINE_OFFSET_SAME_AS_HEIGHT

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

Конструкторы
Конструктор	Описание
`ScrollBar()`	Создаёт новую горизонтальную полосу прокрутки (т.е. getOrientation() == Orientation.HORIZONTAL).

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

Модификатор и тип	Метод	Описание
`void`	`adjustValue(double position)`	Корректирует свойство `value` на `blockIncrement`.
`DoubleProperty`	`blockIncrementProperty()`	Значение, на которое нужно скорректировать полосу прокрутки, если щелкнуть по области перемещения.
`void`	`decrement()`	Уменьшает значение `ScrollBar` на `unitIncrement`
`double`	`getBlockIncrement()`	Возвращает значение свойства blockIncrement.
`static List<CssMetaData<? extends Styleable,?>>`	`getClassCssMetaData()`
`List<CssMetaData<? extends Styleable,?>>`	`getControlCssMetaData()`
`protected Boolean`	`getInitialFocusTraversable()`	Возвращает начальное состояние перехода фокуса для этого элемента управления, для корректной установки начального значения движком JavaFX CSS.
`double`	`getMax()`	Возвращает значение свойства max.
`double`	`getMin()`	Возвращает значение свойства min.
`Orientation`	`getOrientation()`	Возвращает значение свойства orientation.
`double`	`getUnitIncrement()`	Возвращает значение свойства unitIncrement.
`double`	`getValue()`	Возвращает значение свойства value.
`double`	`getVisibleAmount()`	Возвращает значение свойства visibleAmount.
`void`	`increment()`	Увеличивает значение `ScrollBar` на `unitIncrement`
`DoubleProperty`	`maxProperty()`	Максимальное значение, представленное этим `ScrollBar`.
`DoubleProperty`	`minProperty()`	Минимальное значение, представленное этим `ScrollBar`.
`ObjectProperty<Orientation>`	`orientationProperty()`	Направление `ScrollBar` может быть `HORIZONTAL` или `VERTICAL`.
`void`	`setBlockIncrement(double value)`	Устанавливает значение свойства blockIncrement.
`void`	`setMax(double value)`	Устанавливает значение свойства max.
`void`	`setMin(double value)`	Устанавливает значение свойства min.
`void`	`setOrientation(Orientation value)`	Устанавливает значение свойства orientation.
`void`	`setUnitIncrement(double value)`	Устанавливает значение свойства unitIncrement.
`void`	`setValue(double value)`	Устанавливает значение свойства value.
`void`	`setVisibleAmount(double value)`	Устанавливает значение свойства visibleAmount.
`DoubleProperty`	`unitIncrementProperty()`	Значение, на которое будет скорректирована полоса прокрутки при вызове методов `increment` или `decrement`.
`DoubleProperty`	`valueProperty()`	Текущее значение, представленное этим `ScrollBar`.
`DoubleProperty`	`visibleAmountProperty()`	Видимая часть диапазона полосы прокрутки, обычно представленная размером ползунка полосы прокрутки.

Методы, объявленные в классе javafx.scene.control.Control

computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, contextMenuProperty, createDefaultSkin, getContextMenu, getCssMetaData, getTooltip, isResizable, setContextMenu, setTooltip, skinProperty, tooltipProperty

Методы, объявленные в классе javafx.scene.layout.Region

backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, computePrefHeight, computePrefWidth, getBackground, getBorder, getHeight, getInsets, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getOpaqueInsets, getPadding, getPrefHeight, getPrefWidth, getShape, getUserAgentStylesheet, getWidth, heightProperty, insetsProperty, isCacheShape, isCenterShape, isScaleShape, isSnapToPixel, layoutInArea, layoutInArea, layoutInArea, layoutInArea, maxHeight, maxHeightProperty, maxWidth, maxWidthProperty, minHeight, minHeightProperty, minWidth, minWidthProperty, opaqueInsetsProperty, paddingProperty, positionInArea, positionInArea, prefHeight, prefHeightProperty, prefWidth, prefWidthProperty, resize, scaleShapeProperty, setBackground, setBorder, setCacheShape, setCenterShape, setHeight, setMaxHeight, setMaxSize, setMaxWidth, setMinHeight, setMinSize, setMinWidth, setOpaqueInsets, setPadding, setPrefHeight, setPrefSize, setPrefWidth, setScaleShape, setShape, setSnapToPixel, setWidth, shapeProperty, snappedBottomInset, snappedLeftInset, snappedRightInset, snappedTopInset, snapPosition, snapPositionX, snapPositionY, snapSize, snapSizeX, snapSizeY, snapSpace, snapSpaceX, snapSpaceY, snapToPixelProperty, widthProperty

Методы, объявленные в классе javafx.scene.Parent

getBaselineOffset, getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, layoutChildren, needsLayoutProperty, requestLayout, requestParentLayout, setNeedsLayout, updateBounds

Методы, объявленные в классе javafx.scene.Node

accessibleHelpProperty, accessibleRoleDescriptionProperty, accessibleRoleProperty, accessibleTextProperty, addEventFilter, addEventHandler, applyCss, autosize, blendModeProperty, boundsInLocalProperty, boundsInParentProperty, buildEventDispatchChain, cacheHintProperty, cacheProperty, clipProperty, computeAreaInScreen, contains, contains, cursorProperty, depthTestProperty, disabledProperty, disableProperty, effectiveNodeOrientationProperty, effectProperty, eventDispatcherProperty, executeAccessibleAction, fireEvent, focusedProperty, focusTraversableProperty, getAccessibleHelp, getAccessibleRole, getAccessibleRoleDescription, getAccessibleText, getBlendMode, getBoundsInLocal, getBoundsInParent, getCacheHint, getClip, getContentBias, getCursor, getDepthTest, getEffect, getEffectiveNodeOrientation, getEventDispatcher, getId, getInitialCursor, getInputMethodRequests, getLayoutBounds, getLayoutX, getLayoutY, getLocalToParentTransform, getLocalToSceneTransform, getNodeOrientation, getOnContextMenuRequested, getOnDragDetected, getOnDragDone, getOnDragDropped, getOnDragEntered, getOnDragExited, getOnDragOver, getOnInputMethodTextChanged, getOnKeyPressed, getOnKeyReleased, getOnKeyTyped, getOnMouseClicked, getOnMouseDragEntered, getOnMouseDragExited, getOnMouseDragged, getOnMouseDragOver, getOnMouseDragReleased, getOnMouseEntered, getOnMouseExited, getOnMouseMoved, getOnMousePressed, getOnMouseReleased, getOnRotate, getOnRotationFinished, getOnRotationStarted, getOnScroll, getOnScrollFinished, getOnScrollStarted, getOnSwipeDown, getOnSwipeLeft, getOnSwipeRight, getOnSwipeUp, getOnTouchMoved, getOnTouchPressed, getOnTouchReleased, getOnTouchStationary, getOnZoom, getOnZoomFinished, getOnZoomStarted, getOpacity, getParent, getProperties, getPseudoClassStates, getRotate, getRotationAxis, getScaleX, getScaleY, getScaleZ, getScene, getStyle, getStyleableParent, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isHover, isManaged, isMouseTransparent, isPickOnBounds, isPressed, isVisible, layoutBoundsProperty, layoutXProperty, layoutYProperty, localToParent, localToParent, localToParent, localToParent, localToParent, localToParentTransformProperty, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToScene, localToSceneTransformProperty, localToScreen, localToScreen, localToScreen, localToScreen, localToScreen, lookup, lookupAll, managedProperty, mouseTransparentProperty, nodeOrientationProperty, notifyAccessibleAttributeChanged, onContextMenuRequestedProperty, onDragDetectedProperty, onDragDoneProperty, onDragDroppedProperty, onDragEnteredProperty, onDragExitedProperty, onDragOverProperty, onInputMethodTextChangedProperty, onKeyPressedProperty, onKeyReleasedProperty, onKeyTypedProperty, onMouseClickedProperty, onMouseDragEnteredProperty, onMouseDragExitedProperty, onMouseDraggedProperty, onMouseDragOverProperty, onMouseDragReleasedProperty, onMouseEnteredProperty, onMouseExitedProperty, onMouseMovedProperty, onMousePressedProperty, onMouseReleasedProperty, onRotateProperty, onRotationFinishedProperty, onRotationStartedProperty, onScrollFinishedProperty, onScrollProperty, onScrollStartedProperty, onSwipeDownProperty, onSwipeLeftProperty, onSwipeRightProperty, onSwipeUpProperty, onTouchMovedProperty, onTouchPressedProperty, onTouchReleasedProperty, onTouchStationaryProperty, onZoomFinishedProperty, onZoomProperty, onZoomStartedProperty, opacityProperty, parentProperty, parentToLocal, parentToLocal, parentToLocal, parentToLocal, parentToLocal, pickOnBoundsProperty, pressedProperty, pseudoClassStateChanged, queryAccessibleAttribute, relocate, removeEventFilter, removeEventHandler, requestFocus, resizeRelocate, rotateProperty, rotationAxisProperty, scaleXProperty, scaleYProperty, scaleZProperty, sceneProperty, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, sceneToLocal, screenToLocal, screenToLocal, screenToLocal, setAccessibleHelp, setAccessibleRole, setAccessibleRoleDescription, setAccessibleText, setBlendMode, setCache, setCacheHint, setClip, setCursor, setDepthTest, setDisable, setDisabled, setEffect, setEventDispatcher, setEventHandler, setFocused, setFocusTraversable, setHover, setId, setInputMethodRequests, setLayoutX, setLayoutY, setManaged, setMouseTransparent, setNodeOrientation, setOnContextMenuRequested, setOnDragDetected, setOnDragDone, setOnDragDropped, setOnDragEntered, setOnDragExited, setOnDragOver, setOnInputMethodTextChanged, setOnKeyPressed, setOnKeyReleased, setOnKeyTyped, setOnMouseClicked, setOnMouseDragEntered, setOnMouseDragExited, setOnMouseDragged, setOnMouseDragOver, setOnMouseDragReleased, setOnMouseEntered, setOnMouseExited, setOnMouseMoved, setOnMousePressed, setOnMouseReleased, setOnRotate, setOnRotationFinished, setOnRotationStarted, setOnScroll, setOnScrollFinished, setOnScrollStarted, setOnSwipeDown, setOnSwipeLeft, setOnSwipeRight, setOnSwipeUp, setOnTouchMoved, setOnTouchPressed, setOnTouchReleased, setOnTouchStationary, setOnZoom, setOnZoomFinished, setOnZoomStarted, setOpacity, setPickOnBounds, setPressed, setRotate, setRotationAxis, setScaleX, setScaleY, setScaleZ, setStyle, setTranslateX, setTranslateY, setTranslateZ, setUserData, setViewOrder, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, viewOrderProperty, visibleProperty

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

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

Методы, объявленные в интерфейсе javafx.scene.control.Skinnable

getSkin, setSkin

Методы, объявленные в интерфейсе javafx.css.Styleable

getStyleableNode, getStyleClass

Подробности свойств

min

public final DoubleProperty minProperty

Минимальное значение, представляемое этим ScrollBar. Это значение должно быть меньше или равно max. Значение по умолчанию 0.

См. также:: getMin(), setMin(double)

max

public final DoubleProperty maxProperty

Максимальное значение, представляемое этим ScrollBar. Это значение должно быть больше или равно min. Значение по умолчанию 100.

См. также:: getMax(), setMax(double)

value

public final DoubleProperty valueProperty

Текущее значение, представляемое этим ScrollBar. Это значение должно быть между min и max включительно.

См. также:: getValue(), setValue(double)

orientation

public final ObjectProperty<Orientation> orientationProperty

Направление ScrollBar может быть HORIZONTAL или VERTICAL.

См. также:: getOrientation(), setOrientation(Orientation)

unitIncrement

public final DoubleProperty unitIncrementProperty

Значение, на которое изменяется полоса прокрутки при вызове методов increment или decrement.

См. также:: getUnitIncrement(), setUnitIncrement(double)

blockIncrement

public final DoubleProperty blockIncrementProperty

Значение, на которое изменяется полоса прокрутки при щелчке по области полосы прокрутки.

См. также:: getBlockIncrement(), setBlockIncrement(double)

visibleAmount

public final DoubleProperty visibleAmountProperty

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

См. также:: getVisibleAmount(), setVisibleAmount(double)

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

ScrollBar

public ScrollBar()

Создает новую горизонтальную полосу прокрутки (т.е. getOrientation() == Orientation.HORIZONTAL).

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

setMin

public final void setMin(double value)

Устанавливает значение свойства min.

Описание свойства:: Минимальное значение, представляемое этим ScrollBar. Это значение должно быть меньше или равно max. Значение по умолчанию 0.

getMin

public final double getMin()

Получает значение свойства min.

Описание свойства:: Минимальное значение, представляемое этим ScrollBar. Это значение должно быть меньше или равно max. Значение по умолчанию 0.

minProperty

public final DoubleProperty minProperty()

См. также:: getMin(), setMin(double)

setMax

public final void setMax(double value)

Устанавливает значение свойства max.

Описание свойства:: Максимальное значение, представляемое этим ScrollBar. Это значение должно быть больше или равно min. Значение по умолчанию 100.

getMax

public final double getMax()

Получает значение свойства max.

Описание свойства:: Максимальное значение, представляемое этим ScrollBar. Это значение должно быть больше или равно min. Значение по умолчанию 100.

maxProperty

public final DoubleProperty maxProperty()

См. также:: getMax(), setMax(double)

setValue

public final void setValue(double value)

Устанавливает значение свойства value.

Описание свойства:: Текущее значение, представляемое этим ScrollBar. Это значение должно быть между min и max включительно.

getValue

public final double getValue()

Получает значение свойства value.

Описание свойства:: Текущее значение, представляемое этим ScrollBar. Это значение должно быть между min и max включительно.

valueProperty

public final DoubleProperty valueProperty()

Текущее значение, представляемое этим ScrollBar. Это значение должно быть между min и max включительно.

См. также:: getValue(), setValue(double)

setOrientation

public final void setOrientation(Orientation value)

Устанавливает значение свойства orientation.

Описание свойства:: Направление ScrollBar может быть HORIZONTAL или VERTICAL.

getOrientation

public final Orientation getOrientation()

Получает значение свойства orientation.

Описание свойства:: Направление ScrollBar может быть HORIZONTAL или VERTICAL.

orientationProperty

public final ObjectProperty<Orientation> orientationProperty()

Направление ScrollBar может быть HORIZONTAL или VERTICAL.

См. также:: getOrientation(), setOrientation(Orientation)

setUnitIncrement

public final void setUnitIncrement(double value)

Устанавливает значение свойства unitIncrement.

Описание свойства:: Значение, на которое изменяется полоса прокрутки при вызове методов increment или decrement.

getUnitIncrement

public final double getUnitIncrement()

Получает значение свойства unitIncrement.

Описание свойства:: Значение, на которое изменяется полоса прокрутки при вызове методов increment или decrement.

unitIncrementProperty

public final DoubleProperty unitIncrementProperty()

Значение, на которое изменяется полоса прокрутки при вызове методов increment или decrement.

См. также:: getUnitIncrement(), setUnitIncrement(double)

setBlockIncrement

public final void setBlockIncrement(double value)

Устанавливает значение свойства blockIncrement.

Описание свойства:: Значение, на которое изменяется полоса прокрутки при щелчке по области полосы прокрутки.

getBlockIncrement

public final double getBlockIncrement()

Получает значение свойства blockIncrement.

Описание свойства:: Значение, на которое изменяется полоса прокрутки при щелчке по области полосы прокрутки.

END_OF_DOCUMENT_MARKER

blockIncrementProperty

public final DoubleProperty blockIncrementProperty()

Величина изменения полосы прокрутки при нажатии на область трека.

См. также:: getBlockIncrement(), setBlockIncrement(double)

setVisibleAmount

public final void setVisibleAmount(double value)

Устанавливает значение свойства visibleAmount.

Описание свойства:: Видимая часть диапазона полосы прокрутки, обычно представляющая размер ползунка.

getVisibleAmount

public final double getVisibleAmount()

Возвращает значение свойства visibleAmount.

Описание свойства:: Видимая часть диапазона полосы прокрутки, обычно представляющая размер ползунка.

visibleAmountProperty

public final DoubleProperty visibleAmountProperty()

Видимая часть диапазона полосы прокрутки, обычно представляющая размер ползунка.

См. также:: getVisibleAmount(), setVisibleAmount(double)

adjustValue

public void adjustValue(double position)

Изменяет свойство value на величину blockIncrement. Значение position — дробная часть между min и max. Например, это может быть 50%. Если #minProperty min равно 0, а #maxProperty max равно 100, и value равно 25, то позиция .5 указывает на то, что value нужно увеличить на blockIncrement. Если value равно 75, то позиция .5 указывает на то, что value нужно уменьшить на blockIncrement. Примечание: Эта функция предназначена для использования экспертами, в основном теми, кто реализует новые скины или поведение. Разработчикам и дизайнерам обычно не нужно напрямую обращаться к этой функции.

Параметры:: position — позиция

increment

public void increment()

Увеличивает значение ScrollBar на величину unitIncrement

decrement

public void decrement()

Уменьшает значение ScrollBar на величину unitIncrement

getClassCssMetaData

public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()

Возвращает:: CssMetaData, связанная с этим классом, которая может включать CssMetaData его суперклассов.
С:: JavaFX 8.0

getControlCssMetaData

public List<CssMetaData<? extends Styleable,?>> getControlCssMetaData()

Переопределяет:: getControlCssMetaData в классе Control
Возвращает:: неизменяемый список стилизуемых свойств элементов управления.
С:: JavaFX 8.0

getInitialFocusTraversable

protected Boolean getInitialFocusTraversable()

Возвращает начальное состояние фокусировки для этого элемента управления, которое используется движком JavaFX CSS для правильной установки начального значения. Этот метод переопределен, так как по умолчанию элементы управления UI имеют фокусировку, установленную в true, но это неприменимо к данному элементу управления.

Переопределяет:: getInitialFocusTraversable в классе Control
Возвращает:: начальное состояние фокусировки для этого элемента управления
С:: 9

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.