（翻译）JavaFX2.0网格布局窗格GridPane

public class GridPane extends Pane

?

GridPane将其孩子结点灵活地放置在行列网格中。若设置了边框和边缘（border and/or padding），它的内容只能在这些间隙内部。

孩子结点可以放置在任意位置并且可以跨行列。结点也可以在行列内随便覆盖，网格窗格孩子结点列表中的顺序决定了这些结点的堆栈顺序：第一个在最下，最后一个在上面。

GridPane也可以使用CSS来装饰。

网格约束

孩子结点的位置由其布局约束来定义:

?

约束类型描述columnIndexinteger孩子结点的起始列rowIndexinteger孩子结点的起始行columnSpaninteger孩子结点的水平跨列数目rowSpaninteger孩子结点的垂直跨行数目

若孩子结点的位置没被指定，则将其放入第一行列中。若跨行列数没有指定，默认为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，它们的值会被当成权重。

?

可选布局约束约束类型描述halignmentjavafx.geometry.HPos布局区域中孩子结点的水平位置.valignmentjavafx.geometry.VPos布局区域中孩子结点的垂直位置.hgrowjavafx.scene.layout.Priority孩子结点的水平成长优先级.vgrowjavafx.scene.layout.Priority孩子结点的垂直成长优先级.marginjavafx.geometry.Insets孩子结点的外部边空间.

?