GridBagLayout(网格布局管理器)结构分析与功能使用详解 (2)

java awtjava awt 类类 GridBagLayoutGridBagLayout java lang Object java awt GridBagLayoutjava awt GridBagLayout 所有已实现的接口 所有已实现的接口 LayoutManager LayoutManager2 Serializable public class GridBagLayoutGridBagLayout extends Object implements LayoutManager2 Serializable GridBagLayout 类是一个灵活的布局管理器 它不要求组件的大小相同便可以 将组件垂直 水平或沿它们的基线对齐 每个 GridBagLayout 对象维持一个动 态的矩形单元网格 每个组件占用一个或多个这样的单元 该单元被称为显示 区域 每个由 GridBagLayout 管理的组件都与 GridBagConstraints 的实例相关联 Constraints 对象指定组件的显示区域在网格中的具体放置位置 以及组件在其 显示区域中的放置方式 除了 Constraints 对象之外 GridBagLayout 还考虑每 个组件的最小大小和首选大小 以确定组件的大小 网格的总体方向取决于容器的 ComponentOrientation 属性 对于水平的从左到 右的方向 网格坐标 0 0 位于容器的左上角 其中 X 向右递增 Y 向下递 增 对于水平的从右到左的方向 网格坐标 0 0 位于容器的右上角 其中 X 向左递增 Y 向下递增 为了有效使用网格包布局 必须自定义与组件关联的一个或多个 GridBagConstraints 对象 可以通过设置一个或多个实例变量来自定义 GridBagConstraints 对象 GridBagConstraints gridx GridBagConstraints gridy 指定包含组件显示区域的前导角的单元 在此显示区域中 位于网格原 点的单元地址是 gridx 0 gridy 0 对于水平的从左到右的布局 组件的前导角是其左上角 对于水平的从右到左的布局 组件的前导角 是其右上角 使用 GridBagConstraints RELATIVE 默认值 指定会 将组件直接放置在之前刚添加到容器中的组件的后面 沿 X 轴向为 gridx 或 Y 轴向为 gridy GridBagConstraints gridwidth GridBagConstraints gridheight 指定组件的显示区域中行 针对 gridwidth 或列 针对 gridheight 中的单元数 默认值为 1 使用 GridBagConstraints REMAINDER 指定 组件的显示区域 该区域的范围是从 gridx 到该行 针对 gridwidth 中的最后一个单元 或者从 gridy 到该列 针对 gridheight 中的最 后一个单元 使用 GridBagConstraints RELATIVE 指定组件的显示区 域 该区域的范围是从 gridx 到其所在行 针对 gridwidth 的倒数第 二个单元 或者从 gridy 到其所在列 针对 gridheight 的倒数第二 个单元 GridBagConstraints fill 当组件的显示区域大于组件的所需大小时 用于确定是否 以及如何 调整组件 可能的值为 GridBagConstraints NONE 默认值 GridBagConstraints HORIZONTAL 加宽组件直到它足以在水平方向上填 满其显示区域 但不更改其高度 GridBagConstraints VERTICAL 加 高组件直到它足以在垂直方向上填满其显示区域 但不更改其宽度 和 GridBagConstraints BOTH 使组件完全填满其显示区域 GridBagConstraints ipadx GridBagConstraints ipady 指定布局中组件的内部填充 即对组件最小大小的添加量 组件的宽度 至少为其最小宽度加上 ipadx 像素 类似地 组件的高度至少为其最小 高度加上 ipady 像素 GridBagConstraints insets 指定组件的外部填充 即组件与其显示区域边缘之间间距的最小量 GridBagConstraints anchor 指定组件应置于其显示区域中何处 可能的值有三种 绝对值 相对于 方向的值和相对于基线的值 相对于方向的值是相对于容器的 ComponentOrientation 属性进行解释的 而绝对值则不然 相关于基线 的值是相对于基线进行计算的 有效值包括 绝对值绝对值相对于方向的值相对于方向的值相对于基线的值相对于基线的值 GridBagConstraints NORTH GridBagConstraints SOUTH GridBagConstraints WEST GridBagConstraints EAST GridBagConstraints NORTHWEST GridBagConstraints NORTHEAST GridBagConstraints SOUTHWEST GridBagConstraints SOUTHEAST GridBagConstraints CENTER 默认值 GridBagConstraints PAGE START GridBagConstraints PAGE END GridBagConstraints LINE START GridBagConstraints LINE END GridBagConstraints FIRST LINE START GridBagConstraints FIRST LINE END GridBagConstraints LAST LINE START GridBagConstraints LAST LINE END GridBagConstraints BASELINE GridBagConstraints BASELINE LEADING GridBagConstraints BASELINE TRAILING GridBagConstraints ABOVE BASELINE GridBagConstraints ABOVE BASELINE LEADING GridBagConstraints ABOVE BASELINE TRAILING GridBagConstraints BELOW BASELINE GridBagConstraints BELOW BASELINE LEADING GridBagConstraints BELOW BASELINE TRAILING GridBagConstraints weightx GridBagConstraints weighty 用于确定分布空间的方式 这对于指定调整行为至关重要 除非在行 weightx 和列 weighty 中至少指定一个组件的权重 否则所有组件 都会聚集在其容器的中央 这是因为 当权重为零 默认值 时 GridBagLayout 对象会将所有额外空间置于其单元网格和容器边缘之间 每行可以有一条基线 具体取决于该行中具有有效基线并沿此基线对齐的组件 组件的锚值是 BASELINE BASELINE LEADING 或 BASELINE TRAILING 其中之 一 如果行中没有具有有效基线的组件 则该行没有基线 如果组件跨多行 则它与起始行 如果基线调整行为是 CONSTANT ASCENT 或 结束行 如果基线调整行为是 CONSTANT DESCENT 的基线对齐 用来对齐组件 的行称为主导行 下图显示了基线布局并包括横跨行的组件 此布局由三个组件组成 起始于 0 行并结束于 1 行的面板 该面板有一个 CONSTANT DESCENT 基线调 整行为以及 BASELINE 的锚 因为基线调整行为是 CONSTANT DESCENT 所以 该面板的主要行是第 1 行 两个按钮 每个按钮都带有 CENTER OFFSET 基线调整行为和 BASELINE 的锚 因为第二个按钮和面板共享相同的主要行 所以它们都沿其基线对齐 使用一个相对于基线的值定位的组件调整不同于使用绝对值或相对于方向的值 组件更改的方式由主要行的基线更改方式指示 如果基于相同主导行的所有组 件具有 CONSTANT DESCENT 基线调整行为 则基线定位到显示区域底部 否则 基线定位到显示区域顶部 下述规则指示调整大小的行为 位于基线上方的可调整大小的组件只能增长到与该基线一样高 例如 如果基线为 100 且位于顶部 则位于基线上方的可调整大小的组件的增长永远都不能超过 100 个单位 同样地 位于基线下方的可调整大小的组件只能增长到和显示高度与基线之间的差 值一样高 仅当调整了大小的基线适应显示区域时 才能调整基线上具有 OTHER 基线调整行 为的可调整大小组件 如果不能将基线放入显示区域 则该组件不能调整大小 位于该基线上没有 OTHER 基线调整行为的组件只能增长到和显示高度 基线 组件基线一样高 如果沿基线放置一个组件 但该组件没有有效的基线 那么它将在其空间中垂 直居中对齐 同样地 如果已放置一个相对于基线的组件且行中的所有组件都 没有有效的基线 则该组件垂直居中对齐 下图显示了由网格包布局管理的十个组件 均为按钮 图 2 显示水平方向从 左到右的容器的布局 图 3 显示水平方向从右到左的容器的布局 图 2 水平方向 从左到右图 3 水平方向 从右到左 十个组件的每一个组件都会将与之相关的 GridBagConstraints 对象的 fill 字段设置为 GridBagConstraints BOTH 此外 这些组件还具有以下非默认值 约束 Constraints Button1 Button2 Button3 weightx 1 0 Button4 weightx 1 0 gridwidth GridBagConstraints REMAINDER Button5 gridwidth GridBagConstraints REMAINDER Button6 gridwidth GridBagConstraints RELATIVE Button7 gridwidth GridBagConstraints REMAINDER Button8 gridheight 2 weighty 1 0 Button9 Button 10 gridwidth GridBagConstraints REMAINDER 下面是实现上述示例的代码 import java awt import java util import java applet Applet public class GridBagEx1 extends Applet protected void makebutton String name GridBagLayout gridbag GridBagConstraints c Button button new Button name gridbag setConstraints button c add button public void init GridBagLayout gridbag new GridBagLayout GridBagConstraints c new GridBagConstraints setFont new Font SansSerif Font PLAIN 14 setLayout gridbag c fill GridBagConstraints BOTH c weightx 1 0 makebutton Button1 gridbag c makebutton Button2 gridbag c makebutton Button3 gridbag c c gridwidth GridBagConstraints REMAINDER end row makebutton Button4 gridbag c c weightx 0 0 reset to the default makebutton Button5 gridbag c another row c gridwidth GridBagConstraints RELATIVE next to last in row makebutton Button6 gridbag c c gridwidth GridBagConstraints REMAINDER end row makebutton Button7 gridbag c c gridwidth 1 reset to the default c gridheight 2 c weighty 1 0 makebutton Button8 gridbag c c weighty 0 0 reset to the default c gridwidth GridBagConstraints REMAINDER end row c gridheight 1 reset to the default makebutton Button9 gridbag c makebutton Button10 gridbag c setSize 300 100 public static void main String args Frame f new Frame GridBag Layout Example GridBagEx1 ex1 new GridBagEx1 ex1 init f add Center ex1 f pack f setSize f getPreferredSize f show 从以下版本开始 从以下版本开始 JDK1 0 另请参见 另请参见 GridBagConstraints GridBagLayoutInfo ComponentOrientation 序 列化表格 字段摘要字段摘要 double columnWeightscolumnWeights 此字段保持对列权重的重写 int columnWidthscolumnWidths 此字段保持对列最小宽度的重写 protected Hashtable comptablecomptable 此哈希表维持组件与其网格包约束之间的关联 protected GridBagConstraint s defaultConstraintsdefaultConstraints 此字段保持包含默认值的网格包约束实例 因此 如果某个组件没有与其相关联的网格包约束 则会分配给该 组件一个 defaultConstraints 的副本 protected GridBagLayoutInfo layoutInfolayoutInfo 此字段保持网格包的布局信息 protected static int MAXGRIDSIZEMAXGRIDSIZE 此字段不再用于保留数组和保持向后兼容性 protected static int MINSIZEMINSIZE 网格包布局可以布置的最小网格 protected static int PREFERREDSIZEPREFERREDSIZE 网格包布局可以布置的首选网格大小 int rowHeightsrowHeights 此字段保持对行最小高度的重写 double rowWeightsrowWeights 此字段保持对行权重的重写 构造方法摘要构造方法摘要 GridBagLayoutGridBagLayout 创建网格包布局管理器 方法摘要方法摘要 voidaddLayoutComponentaddLayoutComponent Component comp Object constraints 使用指定 constraints 对象将指定组件添加到布 局中 voidaddLayoutComponentaddLayoutComponent String name Component comp 无效 因为此布局管理器不使用每组件字符串 protected voidadjustForGravityadjustForGravity GridBagConstraints constraints Rectangle r 根据约束几何结构和填充将 x y 宽度和高度四 个字段调整为正确值 protected voidAdjustForGravityAdjustForGravity GridBagConstraints constraints Rectangle r 此方法已过时 仅为提供向后兼容性 新代码应 该调用 adjustForGravity 来代替 protected voidarrangeGridarrangeGrid Container parent 布置网格 protected voidArrangeGridArrangeGrid Container parent 此方法已过时 仅为提供向后兼容性 新代码应 该调用 arrangeGrid 来代替 GridBagConstraint s getConstraintsgetConstraints Component comp 获取指定组件的约束 floatgetLayoutAlignmentXgetLayoutAlignmentX Container parent 返回沿 X 轴的对齐方式 floatgetLayoutAlignmentYgetLayoutAlignmentY Container parent 返回沿 y 轴的对齐方式 int getLayoutDimensionsgetLayoutDimensions 确定布局网格的列宽度和行高度 protected GridBagLayoutInfo getLayoutInfogetLayoutInfo Container parent int sizeflag 为当前受管子级的集合填充 GridBagLayoutInfo 的实例 protected GridBagLayoutInfo GetLayoutInfoGetLayoutInfo Container parent int sizeflag 此方法已过时 仅为提供向后兼容性 新代码应 该调用 getLayoutInfo 来代替 PointgetLayoutOrigingetLayoutOrigin 在目标容器的图形坐标空间确定布局区域的原点 double getLayoutWeightsgetLayoutWeights 确定布局网格的行与列的权重 protected Dimension getMinSizegetMinSize Container parent GridBagLayoutInfo info 基于 getLayoutInfo 中的信息计算其所有者的最 小大小 protected Dimension GetMinSizeGetMinSize Container parent GridBagLayoutInfo info 此方法已过时 仅为提供向后兼容性 新代码应 该调用 getMinSize 来代替 voidinvalidateLayoutinvalidateLayout Container target 使布局失效 指示如果布局管理器缓存了信息 则应该将其丢弃 voidlayoutContainerlayoutContainer Container parent 使用此网格包布局布置指定容器 Pointlocationlocation int x int y 确定在布局网格中哪个单元包含由 x y 指定 的点 protected GridBagConstraint s lookupConstraintslookupConstraints Component comp 检索指定组件的约束 DimensionmaximumLayoutSizemaximumLayoutSize Container target 在给出指定目标容器中的组件的前提下 返回此 布局的最大维数 DimensionminimumLayoutSizeminimumLayoutSize Container parent 使用此网格包布局确定 parent 容器的最小大小 DimensionpreferredLayoutSizepreferredLayoutSize Container parent 使用此网络包布局确定 parent 容器的首选大小 voidremoveLayoutComponentremoveLayoutComponent Component comp 从此布局移除指定组件 voidsetConstraintssetConstraints Component comp GridBagConstraints constraints 设置此布局中指定组件的约束条件 StringtoStringtoString 返回此网格包布局的值的字符串表示形式 从类从类 java lang java lang ObjectObject 继承的方法继承的方法 clone equals finalize getClass hashCode notify notifyAll wait wait wait 字段详细信息字段详细信息 MAXGRIDSIZEMAXGRIDSIZE protected static final int MAXGRIDSIZEMAXGRIDSIZE 此字段不再用于保留数组和保持向后兼容性 以前 此是网格包布局布 置的网格位置 既包括水平的位置 也包括垂直的位置 的最大数 当 前实现不会对网格大小产生任何影响 另请参见 另请参见 常量字段值 MINSIZEMINSIZE protected static final int MINSIZEMINSIZE 网格包布局可以布置的最小网格 另请参见 另请参见 常量字段值 PREFERREDSIZEPREFERREDSIZE protected static final int PREFERREDSIZEPREFERREDSIZE 网格包布局可以布置的首选网格大小 另请参见 另请参见 常量字段值 comptablecomptable protected Hashtable comptablecomptable 此哈希表维持组件与其网格包约束之间的关联 comptable 中的键是组 件 值是 GridBagConstraints 的实例 另请参见 另请参见 GridBagConstraints defaultConstraintsdefaultConstraints protected GridBagConstraints defaultConstraintsdefaultConstraints 此字段保持包含默认值的网格包约束实例 因此如果某个组件没有与其 相关联的网格包约束 则会分配给该组件一个 defaultConstraints 的 副本 另请参见 另请参见 getConstraints Component setConstraints Component GridBagConstraints lookupConstraints Component layoutInfolayoutInfo protected GridBagLayoutInfo layoutInfolayoutInfo 此字段保持网格包的布局信息 此字段中的信息基于最近验证的网格包 如果 layoutInfo 为 null 这指示网格包中不存在组件 或者即使存在 也是尚未经过验证的组件 另请参见 另请参见 getLayoutInfo Container int columnWidthscolumnWidths public int columnWidthscolumnWidths 此字段保持对列最小宽度的重写 如果此字段为非 null 则在计算全部 最小列宽度之后将这些值应用到网格包 如果 columnWidths 的元素数 多于列数 则在网格包中添加列以匹配 columnWidth 中的元素数 另请参见 另请参见 getLayoutDimensions rowHeightsrowHeights public int rowHeightsrowHeights 此字段保持对行最小高度的重写 如果此字段为非 null 则在计算全部 最小行高度之后将这些值应用到网格包 如果 rowHeights 的元素数多 于行数 则在网格包中添加行以匹配 rowHeights 中的元素数 另请参见 另请参见 getLayoutDimensions columnWeightscolumnWeights public double columnWeightscolumnWeights 此字段保持对列权重的重写 如果此字段为非 null 则在计算全部列权 重之后将这些值应用到网格包 如果 columnWeights i 大于列 i 的权 重 则将 columnWeights i 中的权重分配给列 i 如果 columnWeights 的元素数多于列数 则多余的元素将被忽略 而不会 相应地创建更多列 rowWeightsrowWeights public double rowWeightsrowWeights 此字段保持对行权重的重写 如果此字段为非 null 则在计算全部行权 重之后将这些值应用到网格包 如果 rowWeights i 大于行 i 的权重 则将 rowWeights i 中的权重分配给行 i 如果 rowWeights 的元素多 于行数 则多余的元素将被忽略 它们不会导致更多行的创建 构造方法详细信息构造方法详细信息 GridBagLayoutGridBagLayout public GridBagLayoutGridBagLayout 创建网格包布局管理器 方法详细信息方法详细信息 setConstraintssetConstraints public void setConstraintssetConstraints Component comp GridBagConstraints constraints 设置此布局中指定组件的约束条件 参数 参数 comp 要修改的组件 constraints 要应用的约束条件 getConstraintsgetConstraints public GridBagConstraints getConstraintsgetConstraints Component comp 获取指定组件的约束 返回实际 GridBagConstraints 对象的副本 参数 参数 comp 要查询的组件 返回 返回 此网格包布局中指定组件的约束 返回实际约束对象的副本 lookupConstraintslookupConstraints protected GridBagConstraints lookupConstraintslookupConstraints Component comp 检索指定组件的约束 返回值不是副本 而是布局机制使用的实际 GridBagConstraints 对象 如果 comp 不在 GridBagLayout 中 则返回一组默认的 GridBagConstraints 值为 null 的 comp 值是无效的 返回 null 参数 参数 comp 要查询的组件 返回 返回 指定组件的约束 getLayoutOrigingetLayoutOrigin public Point getLayoutOrigingetLayoutOrigin 在目标容器的图形坐标空间确定布局区域的原点 此值表示布局区域的 左上角的像素坐标 不管容器的 ComponentOrientation 值如何 这与 单元坐标给定的网格原点 0 0 不同 大多数应用程序并不直接调用此 方法 返回 返回 布局网格左上角的单元的图形原点 从以下版本开始 从以下版本开始 JDK1 1 另请参见 另请参见 ComponentOrientation getLayoutDimensionsgetLayoutDimensions public int getLayoutDimensionsgetLayoutDimensions 确定布局网格的列宽度和行高度 大多数应用程序并不直接调用此方法 返回 返回 一个二维数组 包含布局列的宽度和布局行的高度 从以下版本开始 从以下版本开始 JDK1 1 getLayoutWeightsgetLayoutWeights public double getLayoutWeightsgetLayoutWeights 确定布局网格的行与列的权重 如果布局具有额外空间来填充 则权重 用于计算给定的行或列可以伸展得超过首选大小多少 大多数应用程序不直接调用此方法 返回 返回 一个二维数组 表示布局列的水平权重和布局行的垂直权重 从以下版本开始 从以下版本开始 JDK1 1 locationlocation public Point locationlocation int x int y 确定在布局网格中哪个单元包含由 x y 指定的点 每个单元由其列 索引 范围从 0 到列数减 1 和其行索引 范围从 0 到行数减 1 来 标识 如果 x y 点位于网格的外部 则使用以下规则 如果 x 位于从左到右容器 布局的左边或位于从右到左容器布局的右边 则列索引的返回值为 0 如果 x 位于从左到右容器布局的右边或位于从右到左容器布局的左边 则列索引的返 回值是列数 如果 y 位于布局的上边 则行索引的返回值为零 如果 y 位于 布局的下边 则行索引的返回值为行数 容器的方向由其 ComponentOrientation 属性确定 参数 参数 x 点的 x 坐标 y 点的 y 坐标 返回 返回 索引的有序对 指示布局网格中的哪个单元包含点 x y 从以下版本开始 从以下版本开始 JDK1 1 另请参见 另请参见 ComponentOrientation addLayoutComponentaddLayoutComponent public void addLayoutComponentaddLayoutComponent String name Component comp 无效 因为此布局管理器不使用每组件字符串 指定者 指定者 接口 LayoutManager 中的 addLayoutComponent 参数 参数 name 要与组件关联的字符串 comp 要添加的组件 addLayoutComponentaddLayoutComponent public void addLayoutComponentaddLayoutComponent Component comp Object constraints 使用指定 constraints 对象将指定组件添加到布局中 注意 约束条件 是可变的 因此缓存时应该复制 指定者 指定者 接口 LayoutManager2 中的 addLayoutComponent 参数 参数 comp 要添加的组件 constraints 确定如何将组件添加到布局的对象 抛出 抛出 IllegalArgumentException 如果 constraints 不是 GridBagConstraint removeLayoutComponentremoveLayoutComponent public void removeLayoutComponentremoveLayoutComponent Component comp 从此布局移除指定组件 大多数应用程序不直接调用此方法 指定者 指定者 接口 LayoutManager 中的 removeLayoutComponent 参数 参数 comp 要移除的组件 另请参见 另请参见 Container remove java awt Component Container removeAll preferredLayoutSizepreferredLayoutSize public Dimension preferredLayoutSizepreferredLayoutSize Container parent 使用此网络包布局确定 parent 容器的首选大小 大多数应用程序不直接调用此方法 指定者 指定者 接口 LayoutManager 中的 preferredLayoutSize 参数 参数 parent 在其中进行布局的容器 返回 返回 parent 容器的首选大小 另请参见 另请参见 Container getPreferredSize minimumLayoutSizeminimumLayoutSize public Dimension minimumLayoutSizeminimumLayoutSize Container parent 使用此网格包布局确定 parent 容器的最小大小 大多数应用程序不直接调用此方法 指定者 指定者 接口 LayoutManager 中的 minimumLayoutSize 参数 参数 parent 在其中进行布局的容器 返回 返回 parent 容器的最小大小 另请参见 另请参见 Container doLayout maximumLayoutSizemaximumLayoutSize public Dimension maximumLayoutSizemaximumLayoutSize Container target 在给出指定目标容器中的组件的前提下 返回此布局的最大维数 指定者 指定者 接口 LayoutManager2 中的 maximumLayoutSize 参数 参数 target 需要布置的容器 返回 返回 此布局的最大维数 另请参见 另请参见 Container minimumLayoutSize Container preferredLayoutSize Container getLayoutAlignmentXgetLayoutAlignmentX public float getLayoutAlignmentXgetLayoutAlignmentX Container parent 返回沿 X 轴的对齐方式 它指定该组件相对于其他组件如何对齐 该值 应该是一个介于 0 和 1 之间的数 其中 0 表示沿原点对齐 1 表示按 距原点最远的点对齐 0 5 表示居中对齐等 指定者 指定者 接口 LayoutManager2 中的 getLayoutAlignmentX 返回 返回 指示居中对齐的值 0 5f getLayoutAlignmentYgetLayoutAlignmentY public float getLayoutAlignmentYgetLayoutAlignmentY Container parent 返回沿 y 轴的对齐方式 它指定该组件相对于其他组件如何对齐 该值 应该是一个介于 0 和 1 之间的数 其中 0 表示沿原点对齐 1 表示按 距原点最远的点对齐 0 5 表示居中对齐等 指定者 指定者 接口 LayoutManager2 中的 getLayoutAlignmentY 返回 返回 指示居中对齐的值 0 5f invalidateLayoutinvalidateLayout public void invalidateLayoutinvalidateLayout Container target 使布局失效 指示如果布局管理器缓存了信息 则应该将其丢弃 指定者 指定者 接口 LayoutManager2 中的 invalidateLayout layoutContainerlayoutContainer public void layoutContainerlayoutContainer Container parent 使用此网格包布局布置指定容器 为了满足此 GridBagLayout 对象的约 束条件 此方法会重塑指定容器中的组件 大多数应用程序不直接调用此方法 指定者 指定者 接口 LayoutManager 中的 layoutContainer 参数 参数 parent 要在其中进行布局的容器 另请参见 另请参见 Container Container doLayout toStringtoString public String toStringtoString 返回此网格包布局的值的字符串表示形式 覆盖 覆盖 类 Object 中的 toString 返回 返回 此网格包布局的字符串表示形式 getLayoutInfogetLayoutInfo protected GridBagLayoutInfo getLayoutInfogetLayoutInfo C