Класс 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

Сводка свойств

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

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

computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, contextMenuProperty, createDefaultSkin, getContextMenu, getCssMetaData, getSkin, getTooltip, isResizable, setContextMenu, setSkin, 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, focusVisibleProperty, focusWithinProperty, 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, getStyleClass, getTransforms, getTranslateX, getTranslateY, getTranslateZ, getTypeSelector, getUserData, getViewOrder, hasProperties, hoverProperty, idProperty, inputMethodRequestsProperty, intersects, intersects, isCache, isDisable, isDisabled, isFocused, isFocusTraversable, isFocusVisible, isFocusWithin, 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, requestFocusTraversal, 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.css.Styleable

getStyleableNode

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

min

public final DoubleProperty minProperty

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

См. также:

max

public final DoubleProperty maxProperty

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

См. также:

value

public final DoubleProperty valueProperty

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

См. также:

orientation

public final ObjectProperty<Orientation> orientationProperty

Ориентация ScrollBar может быть HORIZONTAL или VERTICAL.

См. также:

unitIncrement

public final DoubleProperty unitIncrementProperty

Величина, на которую изменяется ScrollBar, когда вызываются методы increment или decrement.

См. также:

blockIncrement

public final DoubleProperty blockIncrementProperty

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

См. также:

visibleAmount

public final DoubleProperty visibleAmountProperty

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

См. также:

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

ScrollBar

public ScrollBar()

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

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

setMin

public final void setMin(double value)

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

Описание свойства:

Параметры:

value - значение для свойства min

См. также:

getMin

public final double getMin()

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

Описание свойства:

Возвращает:

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

См. также:

minProperty

public final DoubleProperty minProperty()

Возвращает:

свойство min

См. также:

setMax

public final void setMax(double value)

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

Описание свойства:

Параметры:

value - значение для свойства max

См. также:

getMax

public final double getMax()

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

Описание свойства:

Возвращает:

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

См. также:

maxProperty

public final DoubleProperty maxProperty()

Возвращает:

свойство max

См. также:

setValue

public final void setValue(double value)

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

Описание свойства:

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

Параметры:

value - значение для свойства value

См. также:

getValue

public final double getValue()

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

Описание свойства:

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

Возвращает:

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

См. также:

valueProperty

public final DoubleProperty valueProperty()

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

Возвращает:

свойство value

См. также:

Установить ориентацию

public final void setOrientation(Orientation value)

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

Описание свойства:

Ориентация ScrollBar может быть HORIZONTAL или VERTICAL.

Параметры:

value - значение свойства orientation

См. также:

Получить ориентацию

public final Orientation getOrientation()

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

Описание свойства:

Ориентация ScrollBar может быть HORIZONTAL или VERTICAL.

Возвращает:

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

См. также:

orientationProperty

public final ObjectProperty<Orientation> orientationProperty()

Ориентация ScrollBar может быть HORIZONTAL или VERTICAL.

Возвращает:

свойство orientation

См. также:

Установить шаг

public final void setUnitIncrement(double value)

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

Описание свойства:

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

Параметры:

value - значение свойства unitIncrement

См. также:

Получить шаг

public final double getUnitIncrement()

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

Описание свойства:

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

Возвращает:

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

См. также:

unitIncrementProperty

public final DoubleProperty unitIncrementProperty()

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

Возвращает:

свойство unitIncrement

См. также:

Установить шаг блока

public final void setBlockIncrement(double value)

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

Описание свойства:

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

Параметры:

value - значение свойства blockIncrement

См. также:

Получить шаг блока

public final double getBlockIncrement()

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

Описание свойства:

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

Возвращает:

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

См. также:

blockIncrementProperty

public final DoubleProperty blockIncrementProperty()

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

Возвращает:

свойство blockIncrement

См. также:

Установить видимую область

public final void setVisibleAmount(double value)

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

Описание свойства:

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

Параметры:

value - значение свойства visibleAmount

См. также:

Получить видимую область

public final double getVisibleAmount()

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

Описание свойства:

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

Возвращает:

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

См. также:

visibleAmountProperty

public final DoubleProperty visibleAmountProperty()

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

Возвращает:

свойство visibleAmount

См. также:

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 - позиция

инкремент

public void increment()

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

декремент

public void decrement()

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

getClassCssMetaData

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

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

Возвращает:: CssMetaData
С тех пор:: JavaFX 8.0

getControlCssMetaData

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

Возвращает неизменяемый список стилизуемых свойств элемента управления.

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

getInitialFocusTraversable

protected Boolean getInitialFocusTraversable()

Возвращает начальное состояние доступности для перехода по фокусу этого элемента управления, для использования движком JavaFX CSS для корректной установки его начального значения. Этот метод переопределён, так как по умолчанию элементы управления пользовательского интерфейса имеют доступность для перехода по фокусу, установленную в значение 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.