- 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 в соответствии со спецификацией API UI-элементов JavaFXimport javafx.scene.control.ScrollBar; ScrollBar s1 = new ScrollBar(); s1.setOrientation(Orientation.VERTICAL);- С момента:
- JavaFX 2.0
-
Краткое описание свойств
Свойства Тип Свойство Описание DoublePropertyblockIncrementЗначение, на которое изменяется полоса прокрутки, если кликнуть по области полосы прокрутки.DoublePropertymaxМаксимальное значение, представленное этимScrollBar.DoublePropertyminМинимальное значение, представленное этимScrollBar.ObjectProperty<Orientation>orientationDoublePropertyunitIncrementDoublePropertyvalueТекущее значение, представленное этимScrollBar.DoublePropertyvisibleAmountВидимый диапазон полосы прокрутки, обычно представленный размером ползунка полосы прокрутки.-
Наследуемые свойства от класса 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).
-
Краткое описание методов
Все методыСтатические методыМетоды экземпляраКонкретные методы Модификатор и тип Метод Описание voidadjustValue(double position)Корректирует свойствоvalueна значениеblockIncrement.DoublePropertyblockIncrementProperty()Значение, на которое корректируется полоса прокрутки, если кликнуть по области полосы.protected Skin<?>createDefaultSkin()Создает новый экземпляр стандартной темы для данного элемента управления.voiddecrement()Уменьшает значениеScrollBarна значениеunitIncrementvoidexecuteAccessibleAction(AccessibleAction action, Object... parameters)Этот метод вызывается средствами вспомогательной технологии для выполнения действия, указанного в аргументе.doublegetBlockIncrement()Возвращает значение свойства blockIncrement.static List<CssMetaData<? extends Styleable,?>>getClassCssMetaData()List<CssMetaData<? extends Styleable,?>>getControlCssMetaData()protected BooleangetInitialFocusTraversable()Возвращает начальное состояние фокусируемого элемента управления для корректной установки его начального значения движком JavaFX CSS.doublegetMax()Возвращает значение свойства max.doublegetMin()Возвращает значение свойства min.OrientationgetOrientation()Возвращает значение свойства orientation.doublegetUnitIncrement()Возвращает значение свойства unitIncrement.doublegetValue()Возвращает значение свойства value.doublegetVisibleAmount()Возвращает значение свойства visibleAmount.voidincrement()Увеличивает значениеScrollBarна значениеunitIncrementDoublePropertymaxProperty()Максимальное значение, представляемое этим элементомScrollBar.DoublePropertyminProperty()Минимальное значение, представляемое этим элементомScrollBar.ObjectProperty<Orientation>orientationProperty()ObjectqueryAccessibleAttribute(AccessibleAttribute attribute, Object... parameters)Этот метод вызывается средствами вспомогательной технологии для запроса значения атрибута.voidsetBlockIncrement(double value)Устанавливает значение свойства blockIncrement.voidsetMax(double value)Устанавливает значение свойства max.voidsetMin(double value)Устанавливает значение свойства min.voidsetOrientation(Orientation value)Устанавливает значение свойства orientation.voidsetUnitIncrement(double value)Устанавливает значение свойства unitIncrement.voidsetValue(double value)Устанавливает значение свойства value.voidsetVisibleAmount(double value)Устанавливает значение свойства visibleAmount.DoublePropertyunitIncrementProperty()DoublePropertyvalueProperty()Текущее значение, представляемое этим элементомScrollBar.DoublePropertyvisibleAmountProperty()Видимая часть диапазона полосы прокрутки, обычно представленная размером ползунка полосы прокрутки.-
Наследуемые методы из класса javafx.scene.control.Control
computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, getBaselineOffset, getContextMenu, getCssMetaData, getSkin, getTooltip, isResizable, layoutChildren, setContextMenu, setSkin, setTooltip, skinProperty, tooltipProperty
-
Наследуемые методы из класса javafx.scene.layout.Region
backgroundProperty, borderProperty, cacheShapeProperty, centerShapeProperty, 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
getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, lookup, 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, 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, getStyleClass, 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, 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, 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.- См. также:
-
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
- См. также:
-
getOrientation(),setOrientation(Orientation)
-
unitIncrement
public final DoubleProperty unitIncrementProperty
- См. также:
-
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()
Минимальное значение, представленное этимScrollBar. Оно должно быть меньше или равноmax. Значение по умолчанию 0.- См. также:
-
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()
Максимальное значение, представленное этимScrollBar. Оно должно быть больше или равноmin. Значение по умолчанию 100.- См. также:
-
getMax(),setMax(double)
-
setValue
public final void setValue(double value)
Устанавливает значение свойства value.
-
getValue
public final double getValue()
Получает значение свойства value.
-
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()
- См. также:
-
getOrientation(),setOrientation(Orientation)
-
setUnitIncrement
public final void setUnitIncrement(double value)
Устанавливает значение свойства unitIncrement.
-
getUnitIncrement
public final double getUnitIncrement()
Получает значение свойства unitIncrement.
-
unitIncrementProperty
public final DoubleProperty unitIncrementProperty()
- См. также:
-
getUnitIncrement(),setUnitIncrement(double)
-
setBlockIncrement
public final void setBlockIncrement(double value)
Устанавливает значение свойства blockIncrement.- Описание свойства:
- Величина изменения полосы прокрутки при щелчке по области полосы.
-
getBlockIncrement
public final double getBlockIncrement()
Получает значение свойства blockIncrement.- Описание свойства:
- Величина изменения полосы прокрутки при щелчке по области полосы.
-
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 max100, иvalue25, то позиция .5 означает, что мы должны увеличитьvalueнаblockIncrement. Еслиvalueбыло 75, то позиция .5 означает, что мы должны уменьшитьvalueнаblockIncrement. Примечание: эта функция предназначена для специалистов, в основном для реализации новых скинов или свойств. Разработчикам и дизайнерам обычно не нужно обращаться к этой функции напрямую.- Параметры:
-
position- позиция
-
increment
public void increment()
Увеличивает значениеScrollBarна величинуunitIncrement
-
decrement
public void decrement()
Уменьшает значениеScrollBarна величинуunitIncrement
-
-
createDefaultSkin
protected Skin<?> createDefaultSkin()
Создать новый экземпляр стандартной темы для данного элемента управления. Вызывается для создания темы элемента управления, если тема не задана с помощью CSS-fx-skinили явно не установлена в подклассе с помощьюsetSkin(...).- Overrides:
-
createDefaultSkinв классеControl - Возвращает:
- новый экземпляр стандартной темы для данного элемента управления. Если null, то у элемента управления не будет темы, если её не предоставлена через css.
-
getClassCssMetaData
public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
- Возвращает:
- CssMetaData, связанная с этим классом, которая может включать CssMetaData его суперклассов.
- Since:
- JavaFX 8.0
-
getControlCssMetaData
public List<CssMetaData<? extends Styleable,?>> getControlCssMetaData()
- Overrides:
-
getControlCssMetaDataв классеControl - Возвращает:
- неизменяемый список стилизуемых свойств элемента управления
- Since:
- JavaFX 8.0
-
getInitialFocusTraversable
protected Boolean getInitialFocusTraversable()
Возвращает начальное состояние фокусируемости этого элемента управления, используемое движком JavaFX CSS для корректной установки его начального значения. Этот метод переопределён, так как по умолчанию элементы управления UI имеют фокусируемость, установленную в true, но это не подходит для этого элемента управления.- Overrides:
-
getInitialFocusTraversableв классеControl - Возвращает:
- начальное состояние фокусируемости этого элемента управления
- Since:
- 9
-
queryAccessibleAttribute
public Object queryAccessibleAttribute(AccessibleAttribute attribute, Object... parameters)
Этот метод вызывается технологией вспомогательных средств для запроса значения атрибута.Этот метод обычно переопределяется подклассами для реализации атрибутов, необходимых для определённой роли.
Если конкретный атрибут не обрабатывается, должна быть вызвана реализация суперкласса.- Overrides:
-
queryAccessibleAttributeв классеControl - Параметры:
-
attribute- запрашиваемый атрибут -
parameters- необязательный список параметров - Возвращает:
- значение запрашиваемого атрибута
- См. также:
AccessibleAttribute
-
executeAccessibleAction
public void executeAccessibleAction(AccessibleAction action, Object... parameters)
Этот метод вызывается технологией вспомогательных средств для запроса выполнения действия, указанного в аргументе.Этот метод обычно переопределяется подклассами для реализации действий, необходимых для определённой роли.
Если конкретное действие не обрабатывается, должна быть вызвана реализация суперкласса.- Overrides:
-
executeAccessibleActionв классеControl - Параметры:
-
action- действие для выполнения -
parameters- необязательный список параметров - См. также:
AccessibleAction
-
© 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.