JavaFX UI控件教程（十六）之Separator

翻译自  Separator

本章介绍如何使用分隔符组织JavaFX应用程序的UI组件。

SeparatorJavaFX API中可用的类表示水平或垂直分隔线。它用于划分应用程序用户界面的元素，不会产生任何操作。但是，您可以设置样式，对其应用视觉效果，甚至为其设置动画。默认情况下，分隔符是水平的。您可以使用该setOrientation方法更改其方向。

创建分隔符

例15-1中的代码片段创建了一个水平分隔符和一个垂直分隔符。

例15-1垂直和水平分隔符

//Horizontal separator
Separator separator1 = new Separator();
//Vertical separator
Separator separator2 = new Separator();
separator2.setOrientation(Orientation.VERTICAL);

该Separator班是的扩展Node类。因此，分隔符继承Node该类的所有实例变量。

通常，分隔符用于划分UI控件的组。研究例15-2中所示的代码片段。它将弹簧月复选框与夏月复选框分开。

示例15-2在复选框类别之间使用分隔符

final String[] names = new String[]{"March", "April", "May",
    "June", "July", "August"};
final CheckBox[] cbs = new CheckBox[names.length];
final Separator separator = new Separator();
final VBox vbox = new VBox();

for (int i = 0; i < names.length; i++) {
    cbs[i] = new CheckBox(names[i]);
}
                        
separator.setMaxWidth(40);
separator.setAlignment(Pos.CENTER_LEFT);
vbox.getChildren().addAll(cbs);
vbox.setSpacing(5);
vbox.getChildren().add(3, separator);

将此代码片段添加到应用程序时，会生成如图15-1所示的控件。

图15-1复选框和分隔符

分隔符占用分配给它的完整水平或垂直空间。该setMaxWidth方法用于定义特定宽度。该setValignment方法指定分隔符在分配的布局空间内的垂直位置。同样，您可以通过应用setHalignment方法设置分隔线的水平位置。

在例15-2中，通过使用专用方法将分隔符添加到垂直框中add(index, node)。您可以在应用程序中使用此方法在创建UI之后或动态更改UI时包含分隔符。

将分隔符添加到应用程序的UI中

如前所述，分隔符可用于划分UI控件组。您还可以使用它们来构建用户界面。考虑渲染天气预报数据的任务，如图15-2所示。

图15-2使用分隔符构建天气预报数据

对于图15-2中所示的应用程序，分隔符用于划分Label和ImageView对象。研究例15-3中所示的该应用程序的源代码。

示例15-3在天气预报应用程序中使用分隔符

import javafx.application.Application;
import javafx.geometry.Insets;
import javafx.geometry.Orientation;
import javafx.geometry.VPos;
import javafx.scene.Group;
import javafx.scene.Scene;
import javafx.scene.control.*;
import javafx.scene.image.Image;
import javafx.scene.image.ImageView;
import javafx.scene.layout.GridPane;
import javafx.scene.text.Font;
import javafx.stage.Stage;
 
public class Main extends Application {
 
    Label caption = new Label("Weather Forecast");
    Label friday = new Label("Friday");
    Label saturday = new Label("Saturday");
    Label sunday = new Label("Sunday");
 
    @Override
    public void start(Stage stage) {
        Group root = new Group();
        Scene scene = new Scene(root, 500, 300);
        stage.setScene(scene);
        stage.setTitle("Separator Sample");
 
        GridPane grid = new GridPane();
        grid.setPadding(new Insets(10, 10, 10, 10));
        grid.setVgap(2);
        grid.setHgap(5);
 
        scene.setRoot(grid);
 
        Image cloudImage = new Image(getClass().getResourceAsStream("cloud.jpg"));
        Image sunImage = new Image(getClass().getResourceAsStream("sun.jpg"));
 
        caption.setFont(Font.font("Verdana", 20));
        GridPane.setConstraints(caption, 0, 0);
        GridPane.setColumnSpan(caption, 8);
        grid.getChildren().add(caption);
 
        final Separator sepHor = new Separator();
        sepHor.setValignment(VPos.CENTER);
        GridPane.setConstraints(sepHor, 0, 1);
        GridPane.setColumnSpan(sepHor, 7);
        grid.getChildren().add(sepHor);
 
        friday.setFont(Font.font("Verdana", 18));
        GridPane.setConstraints(friday, 0, 2);
        GridPane.setColumnSpan(friday, 2);
        grid.getChildren().add(friday);
 
        final Separator sepVert1 = new Separator();
        sepVert1.setOrientation(Orientation.VERTICAL);
        sepVert1.setValignment(VPos.CENTER);
        sepVert1.setPrefHeight(80);
        GridPane.setConstraints(sepVert1, 2, 2);
        GridPane.setRowSpan(sepVert1, 2);
        grid.getChildren().add(sepVert1);
 
        saturday.setFont(Font.font("Verdana", 18));
        GridPane.setConstraints(saturday, 3, 2);
        GridPane.setColumnSpan(saturday, 2);
        grid.getChildren().add(saturday);
 
        final Separator sepVert2 = new Separator();
        sepVert2.setOrientation(Orientation.VERTICAL);
        sepVert2.setValignment(VPos.CENTER);
        sepVert2.setPrefHeight(80);
        GridPane.setConstraints(sepVert2, 5, 2);
        GridPane.setRowSpan(sepVert2, 2);
        grid.getChildren().add(sepVert2);
 
        sunday.setFont(Font.font("Verdana", 18));
        GridPane.setConstraints(sunday, 6, 2);
        GridPane.setColumnSpan(sunday, 2);
        grid.getChildren().add(sunday);
 
        final ImageView cloud = new ImageView(cloudImage);
        GridPane.setConstraints(cloud, 0, 3);
        grid.getChildren().add(cloud);
 
        final Label t1 = new Label("16");
        t1.setFont(Font.font("Verdana", 20));
        GridPane.setConstraints(t1, 1, 3);
        grid.getChildren().add(t1);
 
        final ImageView sun1 = new ImageView(sunImage);
        GridPane.setConstraints(sun1, 3, 3);
        grid.getChildren().add(sun1);
 
        final Label t2 = new Label("18");
        t2.setFont(Font.font("Verdana", 20));
        GridPane.setConstraints(t2, 4, 3);
        grid.getChildren().add(t2);
 
        final ImageView sun2 = new ImageView(sunImage);
        GridPane.setConstraints(sun2, 6, 3);
        grid.getChildren().add(sun2);
 
        final Label t3 = new Label("20");
        t3.setFont(Font.font("Verdana", 20));
        GridPane.setConstraints(t3, 7, 3);
        grid.getChildren().add(t3);
 
        stage.show();
    }
    public static void main(String[] args) {
        launch(args);
    }
}

此应用程序使用水平和垂直分隔符，并使分隔符跨越GridPane容器中的行和列。在您的应用程序中，您还可以设置分隔符的首选长度（水平分隔符的宽度和垂直分隔符的高度），以便在用户界面调整大小时动态更改。您还可以通过应用可用于Separator对象的CSS类来更改分隔符的可视外观。

造型分隔符

若要将相同的样式应用于示例15-3中的所有分隔符，请创建CSS文件（例如，controlStyle.css）并将此文件保存在与应用程序的主类相同的包中。例15-4演示了可以添加到controlStyle文件的CSS类。

示例15-4使用CSS类来设置样式分隔符

/*controlStyle.css */
 
.separator{
    -fx-background-color: #e79423;
    -fx-background-radius: 2;
}

您可以通过类的getStylesheets方法在应用程序中启用分隔符样式Scene，如例15-5所示。

示例15-5在JavaFX应用程序中启用样式表

scene.getStylesheets().add("separatorsample/controlStyle.css");

图15-3显示了编译和运行修改后的应用程序时天气预报中的分隔符的外观。

图15-3样式分隔符

相关的API文档 

• Separator

• JavaFX CSS规范