Java图形化编程之BorderLayout源码解析

BorderLayout是一个限制性布局,它只允许在东、南、西、北和中心五大区域内去放置组件,每个区域至多一个组件.虽然感觉这个布局在实际使用中被使用到的情况不多,但是我们还是来看下它的主要实现吧:

Java图形化编程之BorderLayout源码解析_第1张图片
BorderLayout核心方法

preferredLayoutSize

  • 这个方法在布局之前就会调用来确定大小尺寸.
public Dimension preferredLayoutSize(Container target) {
  synchronized (target.getTreeLock()) {
    //初始化盒子尺寸类
    Dimension dim = new Dimension(0, 0);
    //布局是否是LTR模式
    boolean ltr = target.getComponentOrientation().isLeftToRight();
    //组件
    Component c = null;

    //根据布局方向返回EAST的布局
    if ((c = getChild(EAST, ltr)) != null) {
      //获取组件的预设尺寸大小
      Dimension d = c.getPreferredSize();
      //更新盒子的宽度(加上组件的宽度和水平间隙)
      dim.width += d.width + hgap;
      //更新盒子的高度(现有高度和组件的高度的最大值)
      dim.height = Math.max(d.height, dim.height);
    }

    //根据布局方向返回WEST的布局
    if ((c = getChild(WEST, ltr)) != null) {
      //获取组件的预设尺寸大小
      Dimension d = c.getPreferredSize();
      //更新盒子的宽度(加上组件的宽度和水平间隙)
      dim.width += d.width + hgap;
      //更新盒子的高度(现有高度和组件的高度的最大值)
      dim.height = Math.max(d.height, dim.height);
    }

    //根据布局方向返回CENTER的布局
    if ((c = getChild(CENTER, ltr)) != null) {
      //获取组件的预设尺寸大小
      Dimension d = c.getPreferredSize();
      //更新盒子的宽度(加上组件的宽度)
      dim.width += d.width;
      //更新盒子的高度(现有高度和组件的高度的最大值)
      dim.height = Math.max(d.height, dim.height);
    }

    //根据布局方向返回NORTH的布局
    if ((c = getChild(NORTH, ltr)) != null) {
      //获取组件的预设尺寸大小
      Dimension d = c.getPreferredSize();
      //更新盒子的宽度(现有宽度和组件的宽度的最大值)
      dim.width = Math.max(d.width, dim.width);
      //更新盒子的高度(加上组件高度和垂直间隙)
      dim.height += d.height + vgap;
    }

    //根据布局方向返回SOUTH的布局
    if ((c = getChild(SOUTH, ltr)) != null) {
      //获取组件的预设尺寸大小
      Dimension d = c.getPreferredSize();
      //更新盒子的宽度(现有宽度和组件的宽度的最大值)
      dim.width = Math.max(d.width, dim.width);
      //更新盒子的高度(加上组件高度和垂直间隙)
      dim.height += d.height + vgap;
    }

    //最后再加上容器四周的内间距即可得出所需的尺寸大小
    Insets insets = target.getInsets();
    dim.width += insets.left + insets.right;
    dim.height += insets.top + insets.bottom;

    return dim;
  }
}

minimumLayoutSize

  • 这个方法用途是在计算布局所需的最小尺寸大小
public Dimension minimumLayoutSize(Container target) {
  synchronized (target.getTreeLock()) {
    //初始化盒子尺寸类
    Dimension dim = new Dimension(0, 0);
    //布局是否是LTR模式
    boolean ltr = target.getComponentOrientation().isLeftToRight();
    //组件
    Component c = null;

    //根据布局方向返回EAST的布局
    if ((c = getChild(EAST, ltr)) != null) {
      //获得组件的最小尺寸
      Dimension d = c.getMinimumSize();
      //更新盒子的宽度(加上组件的宽度和水平间隙)
      dim.width += d.width + hgap;
      //更新盒子的高度(现有高度和组件的高度的最大值)
      dim.height = Math.max(d.height, dim.height);
    }

    //根据布局方向返回WEST的布局
    if ((c = getChild(WEST, ltr)) != null) {
      //获得组件的最小尺寸
      Dimension d = c.getMinimumSize();
      //更新盒子的宽度(加上组件的宽度和水平间隙)
      dim.width += d.width + hgap;
      //更新盒子的高度(现有高度和组件的高度的最大值)
      dim.height = Math.max(d.height, dim.height);
    }

    //根据布局方向返回CENTER的布局
    if ((c = getChild(CENTER, ltr)) != null) {
      //获得组件的最小尺寸
      Dimension d = c.getMinimumSize();
      //更新盒子的宽度(加上组件的宽度)
      dim.width += d.width;
      //更新盒子的高度(现有高度和组件的高度的最大值)
      dim.height = Math.max(d.height, dim.height);
    }

    //根据布局方向返回NORTH的布局
    if ((c = getChild(NORTH, ltr)) != null) {
      //获得组件的最小尺寸
      Dimension d = c.getMinimumSize();
      //更新盒子的宽度(现有宽度和组件的宽度的最大值)
      dim.width = Math.max(d.width, dim.width);
      //更新盒子的高度(加上组件高度和垂直间隙)
      dim.height += d.height + vgap;
    }

    //根据布局方向返回SOUTH的布局
    if ((c = getChild(SOUTH, ltr)) != null) {
      //获得组件的最小尺寸
      Dimension d = c.getMinimumSize();
      //更新盒子的宽度(现有宽度和组件的宽度的最大值)
      dim.width = Math.max(d.width, dim.width);
      //更新盒子的高度(加上组件高度和垂直间隙)
      dim.height += d.height + vgap;
    }

    //最后再加上容器四周的内间距即可得出所需的尺寸大小
    Insets insets = target.getInsets();
    dim.width += insets.left + insets.right;
    dim.height += insets.top + insets.bottom;

    return dim;
  }
}

layoutContainer

  • 这个方法和Android中的onLayout方法很相似,因为它也是在父类Container也是onLayout方法中调用的。
public void layoutContainer(Container target) {
  synchronized (target.getTreeLock()) {
    //获取容器的四周内间距
    Insets insets = target.getInsets();
    //容器顶部
    int top = insets.top;
    //容器底部(减去底部内间隙)
    int bottom = target.height - insets.bottom;
    //容器左边
    int left = insets.left;
    //容器右边(容器宽度减去右间隙)
    int right = target.width - insets.right;
    //是否是LTR模式
    boolean ltr = target.getComponentOrientation().isLeftToRight();
    Component c = null;

    //根据布局方向返回NORTH的布局
    if ((c = getChild(NORTH, ltr)) != null) {
      //设置组件的宽高(宽会被拉伸)
      c.setSize(right - left, c.height);
      //获取预设尺寸
      Dimension d = c.getPreferredSize();
      //设置位置
      c.setBounds(left, top, right - left, d.height);
      //因为已经在NORTH方位上放置了组件,所以顶部应该向下偏移(偏移量:组件的高度加垂直间隙)
      top += d.height + vgap;
    }

    //根据布局方向返回SOUTH的布局
    if ((c = getChild(SOUTH, ltr)) != null) {
      //设置组件的宽高(宽会被拉伸)
      c.setSize(right - left, c.height);
      //获取预设尺寸
      Dimension d = c.getPreferredSize();
      //设置位置
      c.setBounds(left, bottom - d.height, right - left, d.height);
      //因为在SOUTH方位上放置了组件,所以底部应该向上偏移(偏移量:组件的高度加垂直间隙)
      bottom -= d.height + vgap;
    }

    //根据布局方向返回EAST的布局
    if ((c = getChild(EAST, ltr)) != null) {
      //设置组件的宽高(高会被拉伸)
      c.setSize(c.width, bottom - top);
      //获取预设尺寸
      Dimension d = c.getPreferredSize();
      //设置位置
      c.setBounds(right - d.width, top, d.width, bottom - top);
      //因为在EAST方位上放置了组件,所以右边应该向左偏移(偏移量:组件的宽度加上水平间隙)
      right -= d.width + hgap;
    }

    //根据布局方向返回WEST的布局
    if ((c = getChild(WEST, ltr)) != null) {
      //设置组件的宽高(高会被拉伸)
      c.setSize(c.width, bottom - top);
      //获取预设尺寸
      Dimension d = c.getPreferredSize();
      //设置位置
      c.setBounds(left, top, d.width, bottom - top);
      //因为在WEST方位上放置了组件,所以左边边应该向右偏移(偏移量:组件的宽度加上水平间隙)
      left += d.width + hgap;
    }

    //根据布局方向返回CENTER的布局
    if ((c = getChild(CENTER, ltr)) != null) {
      //设置位置
      c.setBounds(left, top, right - left, bottom - top);
    }
  }
}

getChild

  • 这个方法根据相应的常数和布局方向获取对应的组件
private Component getChild(String key, boolean ltr) {
  Component result = null;
  //在NORTH和SOUTH情况下不受LTR影响
  if (key == NORTH) {
    //在NORTH情况下 再进行判断是否使用了firstLine,根据规则优先返回firstLine
    result = (firstLine != null) ? firstLine : north;
  } else if (key == SOUTH) {
    //在SOUTH情况下 再进行判断是否使用了lastLine,根据规则优先返回lastLine
    result = (lastLine != null) ? lastLine : south;
  } else if (key == WEST) {
    //在SOUTH情况下判断布局方向 根据布局方向返回对应的值
    result = ltr ? firstItem : lastItem;
    if (result == null) {
      //如果为空则说明没有使用优先字段firstItem/lastItem
      result = west;
    }
  } else if (key == EAST) {
    //在EAST情况下判断布局方向 根据布局方向返回对应的值
    result = ltr ? lastItem : firstItem;
    if (result == null) {
      //如果为空则说明没有使用优先字段firstItem/lastItem
      result = east;
    }
  } else if (key == CENTER) {
    //在CENTERT情况下直接返回对应的值
    result = center;
  }
  if (result != null && !result.visible) {
    //如果组件非可视化的返回null
    result = null;
  }
  return result;
}

注:firstLine, lastLine, firstItem, lastItem,center相对定位常数,可以代替北,难,东,西或者中心混合使用两种常数会导致不可预料的结果。如果你使用了这两种类型,相对常数将优先。例如:如果在方向为左到右的容器中添加使用NORTH和BEFORE_FIRST_LINE常量, 则只有BEFORE_FIRST_LINE将被布局

你可能感兴趣的:(Java图形化编程之BorderLayout源码解析)