Класс ScrollBar
java.lang.Object
javafx.scene.Node
javafx.scene.Parent
javafx.scene.layout.Region
javafx.scene.control.Control
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 |
|
final DoubleProperty |
unitIncrement |
|
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 |
Изменяет свойство 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() |
|
final void |
setBlockIncrement |
Устанавливает значение свойства blockIncrement. |
final void |
setMax |
Устанавливает значение свойства max. |
final void |
setMin |
Устанавливает значение свойства min. |
final void |
setOrientation |
Устанавливает значение свойства orientation. |
final void |
setUnitIncrement |
Устанавливает значение свойства unitIncrement. |
final void |
setValue |
Устанавливает значение свойства value. |
final void |
setVisibleAmount |
Устанавливает значение свойства visibleAmount. |
final DoubleProperty |
unitIncrementProperty() |
|
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, 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
unitIncrement
public final DoubleProperty unitIncrementProperty
blockIncrement
public final DoubleProperty blockIncrementProperty
Величина изменения полосы прокрутки при щелчке по области полосы прокрутки.
visibleAmount
public final DoubleProperty visibleAmountProperty
Видимый диапазон полосы прокрутки, обычно представленный размером ползунка.
Подробности о конструкторах
ScrollBar
public ScrollBar()
Создаёт новую горизонтальную полосу прокрутки (т.е. getOrientation() == Orientation.HORIZONTAL).
Подробности о методах
setMin
public final void setMin(double value)
Устанавливает значение свойства
min.- Описание свойства:
- Минимальное значение, представленное этим
ScrollBar. Это должно быть значение, меньшее или равноеmax. Значение по умолчанию равно 0. - Параметры:
-
value- значение для свойстваmin - См. также:
getMin
public final double getMin()
Получает значение свойства
min.- Описание свойства:
- Минимальное значение, представленное этим
ScrollBar. Это должно быть значение, меньшее или равноеmax. Значение по умолчанию равно 0. - Возвращает:
- значение свойства
min - См. также:
minProperty
public final DoubleProperty minProperty()
Минимальное значение, представленное этим
ScrollBar. Это должно быть значение, меньшее или равное max. Значение по умолчанию равно 0.- Возвращает:
- свойство
min - См. также:
setMax
public final void setMax(double value)
Устанавливает значение свойства
max.- Описание свойства:
- Максимальное значение, представленное этим
ScrollBar. Это должно быть значение, большее или равноеmin. Значение по умолчанию равно 100. - Параметры:
-
value- значение для свойстваmax - См. также:
getMax
public final double getMax()
Получает значение свойства
max.- Описание свойства:
- Максимальное значение, представленное этим
ScrollBar. Это должно быть значение, большее или равноеmin. Значение по умолчанию равно 100. - Возвращает:
- значение свойства
max - См. также:
maxProperty
public final DoubleProperty maxProperty()
Максимальное значение, представленное этим
ScrollBar. Это должно быть значение, большее или равное min. Значение по умолчанию равно 100.- Возвращает:
- свойство
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 - См. также:
setOrientation
public final void setOrientation(Orientation value)
Устанавливает значение свойства
orientation.- Описание свойства:
- Ориентация
ScrollBarможет быть либоHORIZONTAL, либоVERTICAL. - Параметры:
-
value- значение для свойстваorientation - См. также:
getOrientation
public final Orientation getOrientation()
Получает значение свойства
orientation.- Описание свойства:
- Ориентация
ScrollBarможет бытьHORIZONTALилиVERTICAL. - Возвращает:
- значение свойства
orientation - См. также:
orientationProperty
public final ObjectProperty<Orientation> orientationProperty()
- Возвращает:
- свойство
orientation - См. также:
setUnitIncrement
public final void setUnitIncrement(double value)
Устанавливает значение свойства
unitIncrement.- Описание свойства:
- Величина изменения полосы прокрутки при вызове методов
incrementилиdecrement. - Параметры:
-
value- значение для свойстваunitIncrement - См. также:
getUnitIncrement
public final double getUnitIncrement()
Получает значение свойства
unitIncrement.- Описание свойства:
- Величина изменения полосы прокрутки при вызове методов
incrementилиdecrement. - Возвращает:
- значение свойства
unitIncrement - См. также:
unitIncrementProperty
public final DoubleProperty unitIncrementProperty()
- Возвращает:
- свойство
unitIncrement - См. также:
setBlockIncrement
public final void setBlockIncrement(double value)
Устанавливает значение свойства
blockIncrement.- Описание свойства:
- Величина изменения полосы прокрутки при щелчке по области прокрутки.
- Параметры:
-
value- значение для свойстваblockIncrement - См. также:
getBlockIncrement
public final double getBlockIncrement()
Получает значение свойства
blockIncrement.- Описание свойства:
- Величина изменения полосы прокрутки при щелчке по области прокрутки.
- Возвращает:
- значение свойства
blockIncrement - См. также:
blockIncrementProperty
public final DoubleProperty blockIncrementProperty()
Величина изменения полосы прокрутки при щелчке по области прокрутки.
- Возвращает:
- свойство
blockIncrement - См. также:
setVisibleAmount
public final void setVisibleAmount(double value)
Устанавливает значение свойства
visibleAmount.- Описание свойства:
- Видимая часть диапазона полосы прокрутки, обычно представленная размером ползунка.
- Параметры:
-
value- значение для свойстваvisibleAmount - См. также:
getVisibleAmount
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. Примечание: эта функция предназначена для опытных пользователей, в основном для тех, кто реализует новые Skins или Behaviors. Разработчикам и дизайнерам обычно не нужно обращаться к этой функции напрямую.- Параметры:
-
position- позиция
increment
public void increment()
Увеличивает значение
ScrollBar на unitIncrement
decrement
public void decrement()
Уменьшает значение
ScrollBar на unitIncrement
getClassCssMetaData
public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
Получает
CssMetaData, связанное с этим классом, что может включать CssMetaData его суперклассов.- Возвращает:
CssMetaData- Since:
- JavaFX 8.0
getControlCssMetaData
public List<CssMetaData<? extends Styleable,?>> getControlCssMetaData()
Получает неизменяемый список CSS-стилизуемых свойств элемента управления.
- Overrides:
-
getControlCssMetaDataв классеControl - Возвращает:
- неизменяемый список CSS-стилизуемых свойств элемента управления
- Since:
- JavaFX 8.0
getInitialFocusTraversable
protected Boolean getInitialFocusTraversable()
Возвращает начальное состояние фокусируемости для этого элемента управления, для правильной установки его начального значения движком JavaFX CSS. Этот метод переопределяется, так как по умолчанию элементы управления пользовательского интерфейса имеют фокусируемость, установленную в true, но это не подходит для этого элемента управления.
- Overrides:
-
getInitialFocusTraversableв классеControl - Возвращает:
- начальное состояние фокусируемости для этого элемента управления
- Since:
- 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.