Spec-Zone.ru › OpenJavaFX 8
javafx.scene.control

Class ScrollBar

java.lang.Object
  • javafx.scene.Node
    • javafx.scene.Parent
      • javafx.scene.layout.Region
        • javafx.scene.control.Control
          • javafx.scene.control.ScrollBar

All Implemented Interfaces:

Styleable, EventTarget, Skinnable



public class ScrollBar
extends Control
Either a horizontal or vertical bar with increment and decrement buttons and a "thumb" with which the user can interact. Typically not used alone but used for building up more complicated controls such as the ScrollPane and ListView.

ScrollBar sets focusTraversable to false.

This example creates a vertical ScrollBar :

import javafx.scene.control.ScrollBar;

 ScrollBar s1 = new ScrollBar();
 s1.setOrientation(Orientation.VERTICAL);
Implementation of ScrollBar According to JavaFX UI Control API Specification

Since:

JavaFX 2.0

  • Property Summary

    All MethodsInstance MethodsConcrete Methods
    Type Property and Description
    DoubleProperty blockIncrement
    The amount by which to adjust the scrollbar if the track of the bar is clicked.
    DoubleProperty max
    The maximum value represented by this ScrollBar.
    DoubleProperty min
    The minimum value represented by this ScrollBar.
    ObjectProperty<Orientation> orientation
    The orientation of the ScrollBar can either be HORIZONTAL or VERTICAL.
    DoubleProperty unitIncrement
    The amount by which to adjust the ScrollBar when the increment or decrement methods are called.
    DoubleProperty value
    The current value represented by this ScrollBar.
    DoubleProperty visibleAmount
    Visible amount of the scrollbar's range, typically represented by the size of the scroll bar's thumb.
    • Properties inherited from class javafx.scene.control.Control

      contextMenu, skin, tooltip
    • Properties inherited from class javafx.scene.layout.Region

      background, border, cacheShape, centerShape, height, insets, maxHeight, maxWidth, minHeight, minWidth, opaqueInsets, padding, prefHeight, prefWidth, scaleShape, shape, snapToPixel, width
    • Properties inherited from class javafx.scene.Parent

      needsLayout
    • Properties inherited from class 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, visible
  • Field Summary

    • Fields inherited from class javafx.scene.layout.Region

      USE_COMPUTED_SIZE, USE_PREF_SIZE
    • Fields inherited from class javafx.scene.Node

      BASELINE_OFFSET_SAME_AS_HEIGHT
  • Constructor Summary

    Constructors
    Constructor and Description
    ScrollBar()
    Creates a new horizontal ScrollBar (ie getOrientation() == Orientation.HORIZONTAL).
  • Method Summary

    All MethodsStatic MethodsInstance MethodsConcrete Methods
    Modifier and Type Method and Description
    void adjustValue(double position)
    Adjusts the value property by blockIncrement.
    DoubleProperty blockIncrementProperty()
    The amount by which to adjust the scrollbar if the track of the bar is clicked.
    protected Skin<?> createDefaultSkin()
    Create a new instance of the default skin for this control.
    void decrement()
    Decrements the value of the ScrollBar by the unitIncrement
    void executeAccessibleAction(AccessibleAction action, Object... parameters)
    This method is called by the assistive technology to request the action indicated by the argument should be executed.
    double getBlockIncrement()
    Gets the value of the property blockIncrement.
    static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
    List<CssMetaData<? extends Styleable,?>> getControlCssMetaData()
    double getMax()
    Gets the value of the property max.
    double getMin()
    Gets the value of the property min.
    Orientation getOrientation()
    Gets the value of the property orientation.
    double getUnitIncrement()
    Gets the value of the property unitIncrement.
    double getValue()
    Gets the value of the property value.
    double getVisibleAmount()
    Gets the value of the property visibleAmount.
    void increment()
    Increments the value of the ScrollBar by the unitIncrement
    DoubleProperty maxProperty()
    The maximum value represented by this ScrollBar.
    DoubleProperty minProperty()
    The minimum value represented by this ScrollBar.
    ObjectProperty<Orientation> orientationProperty()
    The orientation of the ScrollBar can either be HORIZONTAL or VERTICAL.
    Object queryAccessibleAttribute(AccessibleAttribute attribute, Object... parameters)
    * Accessibility handling * *
    void setBlockIncrement(double value)
    Sets the value of the property blockIncrement.
    void setMax(double value)
    Sets the value of the property max.
    void setMin(double value)
    Sets the value of the property min.
    void setOrientation(Orientation value)
    Sets the value of the property orientation.
    void setUnitIncrement(double value)
    Sets the value of the property unitIncrement.
    void setValue(double value)
    Sets the value of the property value.
    void setVisibleAmount(double value)
    Sets the value of the property visibleAmount.
    DoubleProperty unitIncrementProperty()
    The amount by which to adjust the ScrollBar when the increment or decrement methods are called.
    DoubleProperty valueProperty()
    The current value represented by this ScrollBar.
    DoubleProperty visibleAmountProperty()
    Visible amount of the scrollbar's range, typically represented by the size of the scroll bar's thumb.
    • Methods inherited from class javafx.scene.control.Control

      computeMaxHeight, computeMaxWidth, computeMinHeight, computeMinWidth, computePrefHeight, computePrefWidth, contextMenuProperty, getBaselineOffset, getContextMenu, getCssMetaData, getSkin, getTooltip, isResizable, layoutChildren, setContextMenu, setSkin, setTooltip, skinProperty, tooltipProperty
    • Methods inherited from class 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, snapSize, snapSpace, snapToPixelProperty, widthProperty
    • Methods inherited from class javafx.scene.Parent

      getChildren, getChildrenUnmodifiable, getManagedChildren, getStylesheets, isNeedsLayout, layout, lookup, needsLayoutProperty, requestLayout, requestParentLayout, setNeedsLayout, updateBounds
    • Methods inherited from class 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, 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, 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, setVisible, snapshot, snapshot, startDragAndDrop, startFullDrag, styleProperty, toBack, toFront, toString, translateXProperty, translateYProperty, translateZProperty, usesMirroring, visibleProperty
    • Methods inherited from class java.lang.Object

      clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
  • Property Detail

    • min

      public final DoubleProperty minProperty
      The minimum value represented by this ScrollBar. This should be a value less than or equal to max. Default value is 0.

      See Also:

      getMin(), setMin(double)

    • max

      public final DoubleProperty maxProperty
      The maximum value represented by this ScrollBar. This should be a value greater than or equal to min. Default value is 100.

      See Also:

      getMax(), setMax(double)

    • value

      public final DoubleProperty valueProperty
      The current value represented by this ScrollBar. This value should be between min and max, inclusive.

      See Also:

      getValue(), setValue(double)

    • orientation

      public final ObjectProperty<Orientation> orientationProperty
      The orientation of the ScrollBar can either be HORIZONTAL or VERTICAL.

      See Also:

      getOrientation(), setOrientation(Orientation)

    • unitIncrement

      public final DoubleProperty unitIncrementProperty
      The amount by which to adjust the ScrollBar when the increment or decrement methods are called.

      See Also:

      getUnitIncrement(), setUnitIncrement(double)

    • blockIncrement

      public final DoubleProperty blockIncrementProperty
      The amount by which to adjust the scrollbar if the track of the bar is clicked.

      See Also:

      getBlockIncrement(), setBlockIncrement(double)

    • visibleAmount

      public final DoubleProperty visibleAmountProperty
      Visible amount of the scrollbar's range, typically represented by the size of the scroll bar's thumb.

      See Also:

      getVisibleAmount(), setVisibleAmount(double)

  • Constructor Detail

    • ScrollBar

      public ScrollBar()
      Creates a new horizontal ScrollBar (ie getOrientation() == Orientation.HORIZONTAL).
  • Method Detail

    • setMin

      public final void setMin(double value)
      Sets the value of the property min.

      Property description:

      The minimum value represented by this ScrollBar. This should be a value less than or equal to max. Default value is 0.

    • getMin

      public final double getMin()
      Gets the value of the property min.

      Property description:

      The minimum value represented by this ScrollBar. This should be a value less than or equal to max. Default value is 0.

    • minProperty

      public final DoubleProperty minProperty()
      The minimum value represented by this ScrollBar. This should be a value less than or equal to max. Default value is 0.

      See Also:

      getMin(), setMin(double)

    • setMax

      public final void setMax(double value)
      Sets the value of the property max.

      Property description:

      The maximum value represented by this ScrollBar. This should be a value greater than or equal to min. Default value is 100.

    • getMax

      public final double getMax()
      Gets the value of the property max.

      Property description:

      The maximum value represented by this ScrollBar. This should be a value greater than or equal to min. Default value is 100.

    • maxProperty

      public final DoubleProperty maxProperty()
      The maximum value represented by this ScrollBar. This should be a value greater than or equal to min. Default value is 100.

      See Also:

      getMax(), setMax(double)

    • setValue

      public final void setValue(double value)
      Sets the value of the property value.

      Property description:

      The current value represented by this ScrollBar. This value should be between min and max, inclusive.

    • getValue

      public final double getValue()
      Gets the value of the property value.

      Property description:

      The current value represented by this ScrollBar. This value should be between min and max, inclusive.

    • valueProperty

      public final DoubleProperty valueProperty()
      The current value represented by this ScrollBar. This value should be between min and max, inclusive.

      See Also:

      getValue(), setValue(double)

    • setOrientation

      public final void setOrientation(Orientation value)
      Sets the value of the property orientation.

      Property description:

      The orientation of the ScrollBar can either be HORIZONTAL or VERTICAL.

    • getOrientation

      public final Orientation getOrientation()
      Gets the value of the property orientation.

      Property description:

      The orientation of the ScrollBar can either be HORIZONTAL or VERTICAL.

    • orientationProperty

      public final ObjectProperty<Orientation> orientationProperty()
      The orientation of the ScrollBar can either be HORIZONTAL or VERTICAL.

      See Also:

      getOrientation(), setOrientation(Orientation)

    • setUnitIncrement

      public final void setUnitIncrement(double value)
      Sets the value of the property unitIncrement.

      Property description:

      The amount by which to adjust the ScrollBar when the increment or decrement methods are called.

    • getUnitIncrement

      public final double getUnitIncrement()
      Gets the value of the property unitIncrement.

      Property description:

      The amount by which to adjust the ScrollBar when the increment or decrement methods are called.

    • unitIncrementProperty

      public final DoubleProperty unitIncrementProperty()
      The amount by which to adjust the ScrollBar when the increment or decrement methods are called.

      See Also:

      getUnitIncrement(), setUnitIncrement(double)

    • setBlockIncrement

      public final void setBlockIncrement(double value)
      Sets the value of the property blockIncrement.

      Property description:

      The amount by which to adjust the scrollbar if the track of the bar is clicked.

    • getBlockIncrement

      public final double getBlockIncrement()
      Gets the value of the property blockIncrement.

      Property description:

      The amount by which to adjust the scrollbar if the track of the bar is clicked.

    • blockIncrementProperty

      public final DoubleProperty blockIncrementProperty()
      The amount by which to adjust the scrollbar if the track of the bar is clicked.

      See Also:

      getBlockIncrement(), setBlockIncrement(double)

    • setVisibleAmount

      public final void setVisibleAmount(double value)
      Sets the value of the property visibleAmount.

      Property description:

      Visible amount of the scrollbar's range, typically represented by the size of the scroll bar's thumb.

    • getVisibleAmount

      public final double getVisibleAmount()
      Gets the value of the property visibleAmount.

      Property description:

      Visible amount of the scrollbar's range, typically represented by the size of the scroll bar's thumb.

    • visibleAmountProperty

      public final DoubleProperty visibleAmountProperty()
      Visible amount of the scrollbar's range, typically represented by the size of the scroll bar's thumb.

      See Also:

      getVisibleAmount(), setVisibleAmount(double)

    • adjustValue

      public void adjustValue(double position)
      Adjusts the value property by blockIncrement. The position is the fractional amount between the min and max. For example, it might be 50%. If #minProperty min were 0 and #maxProperty max were 100 and value were 25, then a position of .5 would indicate that we should increment value by blockIncrement. If value were 75, then a position of .5 would indicate that we should decrement value by blockIncrement.
    • increment

      public void increment()
      Increments the value of the ScrollBar by the unitIncrement
    • decrement

      public void decrement()
      Decrements the value of the ScrollBar by the unitIncrement
    • createDefaultSkin

      protected Skin<?> createDefaultSkin()
      Create a new instance of the default skin for this control. This is called to create a skin for the control if no skin is provided via CSS -fx-skin or set explicitly in a sub-class with setSkin(...).

      Overrides:

      createDefaultSkin in class Control

      Returns:

      new instance of default skin for this control. If null then the control will have no skin unless one is provided by css.

    • getClassCssMetaData

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

      Returns:

      The CssMetaData associated with this class, which may include the CssMetaData of its super classes.

      Since:

      JavaFX 8.0

    • getControlCssMetaData

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

      Overrides:

      getControlCssMetaData in class Control

      Returns:

      unmodifiable list of the controls css styleable properties

      Since:

      JavaFX 8.0

    • queryAccessibleAttribute

      public Object queryAccessibleAttribute(AccessibleAttribute attribute,
                                             Object... parameters)
      * Accessibility handling * *

      Overrides:

      queryAccessibleAttribute in class Control

      Parameters:

      attribute - the requested attribute

      Returns:

      the value for the requested attribute

      See Also:

      AccessibleAttribute

    • executeAccessibleAction

      public void executeAccessibleAction(AccessibleAction action,
                                          Object... parameters)
      Description copied from class: Node
      This method is called by the assistive technology to request the action indicated by the argument should be executed.

      This method is commonly overridden by subclasses to implement action that are required for a specific role.
      If a particular action is not handled, the super class implementation must be called.

      Overrides:

      executeAccessibleAction in class Control

      Parameters:

      action - the action to execute

      See Also:

      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.

Spec-Zone.ru

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