public class GridPane extends Pane
GridPane将其孩子结点灵活地放置在行列网格中。若设置了边框和边缘(border and/or padding),它的内容只能在这些间隙内部。
孩子结点可以放置在任意位置并且可以跨行列。结点也可以在行列内随便覆盖,网格窗格孩子结点列表中的顺序决定了这些结点的堆栈顺序:***个在最下,***一个在上面。
GridPane也可以使用CSS来装饰。
网格约束
孩子结点的位置由其布局约束来定义:
约束 | 类型 | 描述 |
---|---|---|
columnIndex | integer | 孩子结点的起始列 |
rowIndex | integer | 孩子结点的起始行 |
columnSpan | integer | 孩子结点的水平跨列数目 |
rowSpan | integer | 孩子结点的垂直跨行数目 |
若孩子结点的位置没被指定,则将其放入***行列中。若跨行列数没有指定,默认为1。孩子结点的位置约束可以动态修改,网格窗格会随着更新。
总的行列数无需指定,窗格会根据内容自动扩展和收缩。
使用GridPane时,程序需要为孩子结点指定布局约束并将它们加入窗格中。约束使用的是该类的静态setter方法:
- GridPane gridpane = new GridPane();
- // Set one constraint at a time...
- Button button = new Button();
- GridPane.setRowIndex(button, 1);
- GridPane.setColumnIndex(button, 2);
- // or convenience methods set more than one constraint at once...
- Label label = new Label();
- GridPane.setConstraints(label, 3, 1);
- // column=3 row=1
- // don't forget to add children to gridpane
- gridpane.getChildren().addAll(button, label);
更可以使用整合了以上步骤的方法来设置约束:
- GridPane gridpane = new GridPane();
- gridpane.add(new Button(), 2, 1);
- // column=2 row=1
- gridpane.add(new Label(), 3, 1);
- // column=3 row=1
行列大小
行列尺寸默认是匹配内容的,列宽适应的是最宽的元素,行高适应的是***的元素。然而,如果程序需要指定行列尺寸,可以通过RowConstraints 和ColumnConstraints对象指定。比如,
- GridPane gridpane = new GridPane();
- gridpane.getColumnConstraints().add(new ColumnConstraints(100));
- // column 1 is 100 wide
- gridpane.getColumnConstraints().add(new ColumnConstraints(200));
- // column 2 is 200 wide
行列默认会动态修改大小。若程序需要特定的行列来适应额外的空间,可以设置 RowConstraints或 ColumnConstraints 对象的优先级。比如
- GridPane gridpane = new GridPane();
- ColumnConstraints column1 = new ColumnConstraints(100,100,Double.MAX_VALUE);
- column1.setHgrow(Priority.ALWAYS);
- ColumnConstraints column2 = new ColumnConstraints(100);
- gridpane.getColumnConstraints().addAll(column1, column2);
- // first column gets any extra width
百分百大小
或者,RowConstraints 和ColumnConstraints可以通过指定百分百来实现。
- GridPane gridpane = new GridPane();
- ColumnConstraints column1 = new ColumnConstraints();
- column1.setWidthPercent(50);
- ColumnConstraints column2 = new ColumnConstraints();
- column2.setWidthPercent(50);
- gridpane.getColumnConstraints().addAll(column1, column2); // each get 50% of width
指定百分百后,行列的三个最值都会被忽略。
如果百分百总值超过了100,它们的值会被当成权重。
可选布局约束
约束 | 类型 | 描述 |
---|---|---|
halignment | javafx.geometry.HPos | 布局区域中孩子结点的水平位置. |
valignment | javafx.geometry.VPos | 布局区域中孩子结点的垂直位置. |
hgrow | javafx.scene.layout.Priority | 孩子结点的水平成长优先级. |
vgrow | javafx.scene.layout.Priority | 孩子结点的垂直成长优先级. |
margin | javafx.geometry.Insets | 孩子结点的外部边空间. |
原文链接:http://somefuture.iteye.com/blog/1284339
【编辑推荐】