javaFX学习之ScrollBar的使用

原文：DOC-03-10 滚动条(Scroll Bar) | JavaFX中文资料

通过使用ScrollBar组件来创建可以滚动的面板。

ScrollBar 类可以让你在应用程序中创建可滚动的面板和视图。图显示了ScrollBar的三个区域：滑块(Thumb)，左右(或上下)按钮和滚动槽(Track)。

ScrollBar的元素

 创建Scroll Bar

简单的Scroll Bar

1 2 3 4

ScrollBar sc = new ScrollBar(); sc.setMin(0); sc.setMax(100); sc.setValue(50);

 其中setMin和setMax方法定义了ScrollBar展示的最小值和最大值

当用户移动Thumb，Scroll Bar的值就会变化

 ，值是50，所以当应用程序启动时，Thumb在ScrollBar 的中间。ScrollBar默认是水平朝向的。但是你可以通过setOrientation方法来设置其为垂直朝向

用户点击左或者右按钮(垂直朝向时是上或者下)来滚动一个单位(Unit)。UNIT_INCREMENT属性指定了当一个按钮被点击时Scroll Bar调整的量。另一种方式是点击Track来滚动一个块(block)。BLOCK_INCREMENT属性定义了当Track被点击时ScrollBar调整的量 

在你的应用程序中，你可以使用多种ScrollBar中的一种来滚过超出可用空间边界的图像内容 

在应用程序中使用ScrollBar

例子：

实现了一个可滚动的Scene来查看图像。这个应用程序的任务就是使用户可以查看比Scene还要高的VBox里的内容 

package scrollbarsample;

import javafx.application.Application;
import javafx.beans.value.ObservableValue;
import javafx.geometry.Orientation;
import javafx.scene.Group;
import javafx.scene.Scene;
import javafx.scene.control.ScrollBar;
import javafx.scene.effect.DropShadow;
import javafx.scene.image.Image;
import javafx.scene.image.ImageView;
import javafx.scene.layout.VBox;
import javafx.scene.paint.Color;
import javafx.stage.Stage;

public class ScrollBarSample extends Application {

    final ScrollBar sc = new ScrollBar();//创建一个ScrollBar类型对象
    final Image[] images = new Image[5];//创建5个图片对象
    final ImageView[] pics = new ImageView[5];//创建5个图片视图区域对象
    final VBox vb = new VBox();//创建一个VBox类型布局对象
    DropShadow shadow = new DropShadow();//创建一个阴影特效对象

    @Override
    public void start(Stage stage) {//javaFX的UI组件的启动舞台场景函数，生命周期入口方法
        Group root = new Group();//创建一个节点组对象
        Scene scene = new Scene(root, 1200, 800);//创建场景对象
        scene.setFill(Color.BEIGE);//场景填充色
        stage.setScene(scene);//舞台上布置场景
        stage.setTitle("Scrollbar演示");//舞台上设置标题
        root.getChildren().addAll(vb, sc);//节点组添加VboxL类型布局对象和scrollerBar对象

        shadow.setColor(Color.GREY);//设置图像阴影效果颜色
        shadow.setOffsetX(2);//设置阴影效果水平位移
        shadow.setOffsetY(2);//设置阴影效果垂直位移

        vb.setLayoutX(5);//设置vbox布局器的水平方向左侧布局位置,5个像素
        vb.setSpacing(100);//设置布局对象中被布局元素对象直接的空间大小为100像素距离

        sc.setLayoutX(scene.getWidth() - sc.getWidth());//设置sc对象在layout坐标系中的X轴坐标位置
        sc.setMin(0);//设置scrollBar对象的最小值
        sc.setOrientation(Orientation.VERTICAL);//设置scrollBar对象的朝向，本例中为垂直方向
        sc.setPrefHeight(1000);//设置ScrollBar对象的初始化高度
        sc.setMax(360);//设置scrollBar对象的活动位置最大值

        for (int i = 0; i < 5; i++) {//将Image图片挂载到ImageView类型视图区域对象中，再将ImageView类型对象添加到Vbox布局类型对象的布局区域内，并将Image类型图形对象设置阴影效果
            final Image image = images[i] =
                    new Image(getClass().getResourceAsStream("fw" + (i + 1) + ".jpg"));
            final ImageView pic = pics[i] =
                    new ImageView(images[i]);
            pic.setEffect(shadow);//给图像设置阴影效果
            vb.getChildren().add(pics[i]);//给vBOX容器中添加ImageView类型对象
        }


        sc.valueProperty().addListener((ObservableValue<? extends Number> ov,
                                        Number old_val, Number new_val) -> {//scrollBar对象进行改变值事件监听处理机制
            vb.setLayoutY(-new_val.doubleValue());//当scrollBar对象被滑动时将vBox容器对象的Y轴坐标设置为滑动后的逆向取值
        });

        stage.show();//显示舞台
    }

    public static void main(String[] args) {
        launch(args);
    }
}

当Scroll Bar的VALUE属性变化时，VBox的Y坐标会相应的变化。因此当Thumb每次移动，或者按钮和Track被点击时，VBox都会移动 

为垂直VBox实现滚动 

sc.valueProperty().addListener((ObservableValue<? extends Number> ov,

    Number old_val, Number new_val) -> {

        vb.setLayoutY(-new_val.doubleValue());

});

 程序展示了ScrollBar的一种典型应用。你可以定制这个类在Scene中创建一个滚动区域,ScrollBar可以通过应用样式来改变其默认外观，每个UI组件和Node都是这样的