原文地址http://download.oracle.com/javafx/2.0/ui_controls/separator.htm
JavaFX API中的Separator类呈现的是一条水平或者垂直的分隔线。它是用来分隔应用中用户接口的元素的,并不提供任何行为。不过,它也可以被美化,应用视效,甚至是动画。默认分隔线是水平的,可以使用
setOrientation方法改变它的方向。
Example 14-1 中的代码块创建了一条水平的一条垂直的分隔线。
Example 14-1 Vertical and Horizontal Separators
//Horizontal separator Separator separator1 = new Separator(); //Vertical separator Separator separator2 = new Separator(); separator2.setOrientation(Orientation.VERTICAL);
Separator
类继承了Node类,所以,分隔线就继承了
Node类的所有常量和变量。
一般分隔线是用来分隔UI控件成组的。研究下Example 14-2 中的代码,它将春天的月份和夏天的分开了
Example 14-2 Using a Separator Between Checkbox Categories
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);
运行效果见Figure 14-1 .
Figure 14-1 Checkboxes and a Separator
分隔线会占据分配给它的全部水平或垂直空间。setMaxWidth方法用来指定一个特定的宽度,
setValignment
方法指定了分隔线在其分配的布局空间内的垂直位置。类似地,也可以使用setHalignment
方法来设置其水平位置。
在Example 14-2中,分隔线被使用专用的方法add(index, node)加入了垂直盒子。可以使用这种方法在创建UI后或者动态改变UI时包括分隔线。
前面提到,分隔线可以将UI控件分组。可以使用它们构建用户接口,就像下面这样显示天气预报Figure 14-2 .
Figure 14-2 Structuring Weather Forecast Data with Separators
Label和
ImageView对象。研究下下面的代码
Example 14-3 .
Example 14-3 Using Separators in a Weather Forecast Application
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来改变分隔线的视觉外观。
要为 Example 14-3 中的分隔线应用相同的效果,可以创建CSS文件(例如controlStyle.css) 并保存在应用主类的相同包中。Example 14-4 是一些可以加入到controlStyle文件的CSS类。
Example 14-4 Using CSS Classes to Style Separators
/*controlStyle.css */ .separator{ -fx-background-color: #e79423; -fx-background-radius: 2; }
可以使用 Scene
类的getStylesheets
方法来应用分隔线风格,见 Example 14-5 .
Example 14-5 Enabling Style Sheets in a JavaFX Application
scene.getStylesheets().add("separatorsample/controlStyle.css");
Figure 14-3 是应用修改后运行时分隔线的效果。
Figure 14-3 Styled Separators
Description of "Figure 14-3 Styled Separators"