P06 GridBagLayout

超、凢脫俗 2024-04-05 05:59 66阅读 0赞

#### P06 GridBagLayout ####

*  1.概述
 *  2. 约束: GridBagConstraints
 *  3. 属性: GridBagConstraints 的属性
 *   *  3.1 显示区域 约束属性
     *   *  3.1.1 gridx, gridy
         *  3.1.2 gridwidth, gridheight
         *  3.1.3 weightx, weighty
     *  3.2 组件 约束属性
     *   *  3.2.1 fill
         *  3.2.2 anchor
         *  3.2.3 ipadx, ipady
         *  3.2.4 insets
 *  4.代码实例
 *  5.效果演示

> 系统：Win10  
> Java：1.8.0\_333  
> IDEA：2020.3.4  
> Gitee：[https://gitee.com/lijinjiang01/JavaSwing][https_gitee.com_lijinjiang01_JavaSwing]

## 1.概述 ##

官方 JavaDocsApi：[**java.awt.GridBagLayout**][java.awt.GridBagLayout]  
GridBagLayout，网格袋布局管理器。它不要求组件的大小相同便可以将组件垂直、水平或沿它们的基线对齐。每个 GridBagLayout 对象维持一个动态的矩形单元格（动态计算出单个单元格的大小），每个组件占用一个或多个的单元格，该单元格被称为 显示区域。每个组件显示区域按 从左到右，从上到下，依次排列。

## 2. 约束: GridBagConstraints ##

GridBagConstraints，封装了若干对组件的约束属性，每个由 GridBagLayout 管理的 组件都关联一个该约束实例，以指定 组件所在显示区域 的具体放置位置，以及 组件在其显示区域中 的对齐方式。  
给组件添加约束: GridBagLayout.setConstraints(Component comp, GridBagConstraints c)  
**提示: 要理解 组件（所在）显示区域（一个或多个单元格组成） 和 组件在其显示区域中的对齐方式 这两个不同的概念**

## 3. 属性: GridBagConstraints 的属性 ##

下面属性描述中的相关大写字母常量均定义在GridBagConstraints类中。

### 3.1 显示区域 约束属性 ###

组件的显示区域相关约束属性，直接作用在组件所在显示区域上。

#### 3.1.1 gridx, gridy ####

组件显示区域 开始显示的位置（单元格坐标），容器左上角第一个单元格位置为 (0, 0)，默认值为RELATIVE，表示放置在 “上一个组件”（所在行列最后添加的一个组件）的 “后面”。

#### 3.1.2 gridwidth, gridheight ####

组件显示区域 水平/竖直方向 所占单元格的个数，默认值为 1，如要占多行/列，需整体结果有足够的行/列。有如下两个常量特殊值可选:

REMAINDER: 占完所在行/列余下所有单元格（该值可实现 换行 作用）；
    RELATIVE: 占到所在行/列余下的倒数第二个单元格（使用该值，所在行/列的最后一个单元格需要“合理”安排组件，并手动换行）。

设置该值不能导致 “前面” 或 “后面” 单元格有留空白，否则可能无效。

#### 3.1.3 weightx, weighty ####

如何 分布额外空间（单元格区域外，容器边缘内 的间隔），当指定行/列中的其中 任意一个 组件的权重（大于0），则该行/列将（和其他行/列按权重比例）分配额外的水平/竖直空间。当权重为 0（默认值）时，则 整个单元格区域 居中于容器中心。  
**提示: 如果调用了 java.awt.Window.pack() 方法，该值无效，因为 pack 后已无额外的空间**

### 3.2 组件 约束属性 ###

组件相关约束属性，直接作用在组件上。

#### 3.2.1 fill ####

当 显示区域 大小大于 组件 所需要的大小时，组件 在其 显示区域内 的填充方式。可能的值如下:

NONE: （默认）不调整组件大小
    HORIZONTAL: 加宽组件，使它在水平方向上填满其显示区域，但是不改变高度
    VERTICAL: 加高组件，使它在垂直方向上填满其显示区域，但是不改变宽度
    BOTH: 使组件完全填满其显示区域

#### 3.2.2 anchor ####

组件 在 显示区域内 的位置（对齐方式），可能有如下三种值

<table> 
 <thead> 
  <tr> 
   <th align="left"><strong>绝对值</strong></th> 
   <th align="left"><strong>相对于方向的值</strong></th> 
   <th align="left"><strong>相对于基线的值</strong></th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">NORTH</td> 
   <td align="left">PAGE_START</td> 
   <td align="left">BASELINE</td> 
  </tr> 
  <tr> 
   <td align="left">SOUTH</td> 
   <td align="left">PAGE_END</td> 
   <td align="left">BASELINE_LEADING</td> 
  </tr> 
  <tr> 
   <td align="left">WEST</td> 
   <td align="left">LINE_START</td> 
   <td align="left">BASELINE_TRAILING</td> 
  </tr> 
  <tr> 
   <td align="left">EAST</td> 
   <td align="left">LINE_END</td> 
   <td align="left">ABOVE_BASELINE</td> 
  </tr> 
  <tr> 
   <td align="left">NORTHWEST</td> 
   <td align="left">FIRST_LINE_START</td> 
   <td align="left">ABOVE_BASELINE_LEADING</td> 
  </tr> 
  <tr> 
   <td align="left">NORTHEAST</td> 
   <td align="left">FIRST_LINE_END</td> 
   <td align="left">ABOVE_BASELINE_TRAILING</td> 
  </tr> 
  <tr> 
   <td align="left">SOUTHWEST</td> 
   <td align="left">LAST_LINE_START</td> 
   <td align="left">BELOW_BASELINE</td> 
  </tr> 
  <tr> 
   <td align="left">SOUTHEAST</td> 
   <td align="left">LAST_LINE_END</td> 
   <td align="left">BELOW_BASELINE_LEADING</td> 
  </tr> 
  <tr> 
   <td align="left">CENTER（默认值）</td> 
   <td align="left"></td> 
   <td align="left">BELOW_BASELINE_TRAILING</td> 
  </tr> 
 </tbody> 
</table>

#### 3.2.3 ipadx, ipady ####

组件的内部填充（可看做是 组件的内边距），即对组件最小大小的添加量。组件的宽度至少为其最小宽度/高度加上 ipadx/ipady 像素

#### 3.2.4 insets ####

组件的外部填充（可看做是 组件的外边距，也可看做是 显示区域 的内边距），即 组件 与其 显示区域边缘 之间间距的最小量  
**提示: 上面各属性值之间，以及其他因素，有可能存在冲突或不兼容，不一定设置了即有效，建议多做实验，多写测试 Demo 去尝试**

## 4.代码实例 ##

各按钮约束参数  
Button01, Button02, Button03：默认  
Button04：gridwidth = REMAINDER、fill = BOTH  
Button05：gridwidth = REMAINDER、fill = BOTH  
Button06：gridwidth = 2、fill = BOTH  
Button07：gridwidth = REMAINDER、fill = BOTH  
Button08：gridheight = 2、fill = BOTH  
Button09：gridwidth = REMAINDER、fill = BOTH  
Button10：gridwidth = REMAINDER、fill = BOTH

import com.lijinjiang.beautyeye.BeautyEyeLNFHelper;
    import javax.swing.*;
    import java.awt.*;
    
    public class GridBagLayoutDemo {
        
        public static void main(String[] args) {
        
            try {
        
                BeautyEyeLNFHelper.frameBorderStyle = BeautyEyeLNFHelper.FrameBorderStyle.generalNoTranslucencyShadow;
                BeautyEyeLNFHelper.launchBeautyEyeLNF();
            } catch (Exception e) {
        
            	e.printStackTrace();
            }
            JFrame frame = new JFrame("GridBagLayoutDemo");
    
            GridBagLayout gridBagLayout = new GridBagLayout();    // 布局管理器
            GridBagConstraints c = null;                    // 约束
    
            JPanel panel = new JPanel(gridBagLayout);
    
            JButton btn01 = new JButton("Button01");
            JButton btn02 = new JButton("Button02");
            JButton btn03 = new JButton("Button03");
            JButton btn04 = new JButton("Button04");
            JButton btn05 = new JButton("Button05");
            JButton btn06 = new JButton("Button06");
            JButton btn07 = new JButton("Button07");
            JButton btn08 = new JButton("Button08");
            JButton btn09 = new JButton("Button09");
            JButton btn10 = new JButton("Button10");
    
            /* 添加 组件 和 约束 到 布局管理器 */
            // Button01
            c = new GridBagConstraints();
            gridBagLayout.addLayoutComponent(btn01, c); // 内部使用的仅是 c 的副本
    
            // Button02
            c = new GridBagConstraints();
            gridBagLayout.addLayoutComponent(btn02, c);
    
            // Button03
            c = new GridBagConstraints();
            gridBagLayout.addLayoutComponent(btn03, c);
    
            // Button04 显示区域占满当前行剩余空间（换行），组件填充显示区域
            c = new GridBagConstraints();
            c.gridwidth = GridBagConstraints.REMAINDER;
            c.fill = GridBagConstraints.BOTH;
            gridBagLayout.addLayoutComponent(btn04, c);
    
            // Button05 显示区域独占一行（换行），组件填充显示区域
            c = new GridBagConstraints();
            c.gridwidth = GridBagConstraints.REMAINDER;
            c.fill = GridBagConstraints.BOTH;
            gridBagLayout.addLayoutComponent(btn05, c);
    
            // Button06 占两列，组件填充显示区域
            c = new GridBagConstraints();
            c.gridwidth = 2;
            c.fill = GridBagConstraints.BOTH;
            gridBagLayout.addLayoutComponent(btn06, c);
    
            // Button07 放置最后剩余空间，组件填充显示区域
            c = new GridBagConstraints();
            c.gridwidth = GridBagConstraints.REMAINDER;
            c.fill = GridBagConstraints.BOTH;
            gridBagLayout.addLayoutComponent(btn07, c);
    
            // Button08 显示区域占两行，组件填充显示区域
            c = new GridBagConstraints();
            c.gridheight = 2;
            c.fill = GridBagConstraints.BOTH;
            gridBagLayout.addLayoutComponent(btn08, c);
    
            // Button09 显示区域占满当前行剩余空间（换行），组件填充显示区域
            c = new GridBagConstraints();
            c.gridwidth = GridBagConstraints.REMAINDER;
            c.fill = GridBagConstraints.BOTH;
            gridBagLayout.addLayoutComponent(btn09, c);
    
            // Button10 显示区域占满当前行剩余空间（换行），组件填充显示区域
            c = new GridBagConstraints();
            c.gridwidth = GridBagConstraints.REMAINDER;
            c.fill = GridBagConstraints.BOTH;
            gridBagLayout.addLayoutComponent(btn10, c);
    
            /* 添加 组件 到 内容面板 */
            panel.add(btn01);
            panel.add(btn02);
            panel.add(btn03);
            panel.add(btn04);
            panel.add(btn05);
            panel.add(btn06);
            panel.add(btn07);
            panel.add(btn08);
            panel.add(btn09);
            panel.add(btn10);
    
            frame.setContentPane(panel);
            frame.pack();
            frame.setLocationRelativeTo(null);
            frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
            frame.setVisible(true);
        }
    }

## 5.效果演示 ##

![在这里插入图片描述][3eb66e686b854ec6b19d0f1e6278b7d2.png]

[https_gitee.com_lijinjiang01_JavaSwing]: https://gitee.com/lijinjiang01/JavaSwing
[java.awt.GridBagLayout]: https://docs.oracle.com/javase/8/docs/api/java/awt/GridBagLayout.html
[3eb66e686b854ec6b19d0f1e6278b7d2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/04/da3438b43c3c409f909ca54e3b20902b.png