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

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	孩子结点的外部边空间.