FlowLayout将组件从左到右“流动"到窗体上,直到占满上方的空间,然后向下移动一行,继续流动。在FlowLayout中的组件都将被压缩到它们的最小尺寸,所以可能会得到令人惊讶的效果。那么FlowLayout内部的处理逻辑是如何做的呢,下图是它的几个核心方法:
preferredLayoutSize
- 这个方法在布局之前就会调用来确定大小尺寸.
public Dimension preferredLayoutSize(Container target) {
synchronized (target.getTreeLock()) {
//初始化一个大小为0子尺寸容器类来记录所有组件尺寸的总和
Dimension dim = new Dimension(0, 0);
//获取容器中的组件数量
int nmembers = target.getComponentCount();
//标记第一个组件是否可视
boolean firstVisibleComponent = true;
//基准线
boolean useBaseline = getAlignOnBaseline();
//上偏移量
int maxAscent = 0;
//下偏移量
int maxDescent = 0;
for (int i = 0; i < nmembers; i++) {
//遍历组件
Component m = target.getComponent(i);
//是否可见
if (m.isVisible()) {
//获取组件尺寸
Dimension d = m.getPreferredSize();
//计算当前能容纳下所有组件的最大高度
dim.height = Math.max(dim.height, d.height);
if (firstVisibleComponent) {
//如果是第一个可视组件width就不用加水平间隙hgap
firstVisibleComponent = false;
} else {
//否则的话加上水平间隙hagp
dim.width += hgap;
}
//容器的宽度增加一个组件的宽度
dim.width += d.width;
//基准线适配
if (useBaseline) {
//根据组件的宽高获取对应的基准线
int baseline = m.getBaseline(d.width, d.height);
//非负数情况
if (baseline >= 0) {
//记录向上的偏移量
maxAscent = Math.max(maxAscent, baseline);
//记录向下的偏移量
maxDescent = Math.max(maxDescent, d.height - baseline);
}
}
}
}
if (useBaseline) {
//高度修正
dim.height = Math.max(maxAscent + maxDescent, dim.height);
}
Insets insets = target.getInsets();
//因为容器的边缘和组件之间会存在一个间隙,所以最后需要加上四周的间隙来最终确定容器的尺寸大小
dim.width += insets.left + insets.right + hgap * 2;
dim.height += insets.top + insets.bottom + vgap * 2;
return dim;
}
}
minimumLayoutSize
- 这个方法用途是在计算布局所需的最小尺寸大小,但是在Debug过程中发现,无论是设置了容器大小还是未设置,这个方法均未调用。猜想很有可能这个方法和preferredLayoutSize方法在只会选择其一进行调用,因为它们的内部处理逻辑十分相似.
public Dimension minimumLayoutSize(Container target) {
synchronized (target.getTreeLock()) {
//判断是否使用了基准线
boolean useBaseline = getAlignOnBaseline();
//初始化一个大小为0子尺寸容器类来记录所有组件尺寸的总和
Dimension dim = new Dimension(0, 0);
//获取组件数量
int nmembers = target.getComponentCount();
//上偏移量
int maxAscent = 0;
//下偏移量
int maxDescent = 0;
//第一个可见组件
boolean firstVisibleComponent = true;
for (int i = 0; i < nmembers; i++) {
//遍历组件
Component m = target.getComponent(i);
//是否可见
if (m.visible) {
//获取最小尺寸
Dimension d = m.getMinimumSize();
//开始记录行高
dim.height = Math.max(dim.height, d.height);
if (firstVisibleComponent) {
firstVisibleComponent = false;
} else {
//记录水平间隙
dim.width += hgap;
}
//记录宽度
dim.width += d.width;
if (useBaseline) {
//如果使用了基准线的话需要对高度进行修正
int baseline = m.getBaseline(d.width, d.height);
if (baseline >= 0) {
maxAscent = Math.max(maxAscent, baseline);
maxDescent = Math.max(maxDescent,
dim.height - baseline);
}
}
}
}
//高度修正
if (useBaseline) {
dim.height = Math.max(maxAscent + maxDescent, dim.height);
}
Insets insets = target.getInsets();
//因为容器的边缘和组件之间会存在一个间隙,所以最后需要加上四周的间隙来最终确定容器的尺寸大小
dim.width += insets.left + insets.right + hgap * 2;
dim.height += insets.top + insets.bottom + vgap * 2;
return dim;
}
}
layoutContainer
- 这个方法和Android中的onLayout方法很相似,因为它也是在父类Container也是onLayout方法中调用的。
public void layoutContainer(Container target) {
//获取锁对象
synchronized (target.getTreeLock()) {
//获取内间距对象
Insets insets = target.getInsets();
//计算组件的真实宽度(除去左右内间距和间隙)
int maxwidth = target.width - (insets.left + insets.right + hgap * 2);
//获取组件数量
int nmembers = target.getComponentCount();
//初始化坐标
int x = 0, y = insets.top + vgap;
int rowh = 0, start = 0;
//获取组件的方向是否是LTR
boolean ltr = target.getComponentOrientation().isLeftToRight();
//基准线
boolean useBaseline = getAlignOnBaseline();
//上偏移量
int[] ascent = null;
//下偏移量
int[] descent = null;
//如果使用了基准线 那么就需要根据上下偏移量去修正位置
if (useBaseline) {
ascent = new int[nmembers];
descent = new int[nmembers];
}
for (int i = 0; i < nmembers; i++) {
//遍历容器中的组件
Component m = target.getComponent(i);
//可视化
if (m.isVisible()) {
//获取尺寸
Dimension d = m.getPreferredSize();
//设置宽高
m.setSize(d.width, d.height);
//基准线模式
if (useBaseline) {
//获取基准线
int baseline = m.getBaseline(d.width, d.height);
//非0情况
if (baseline >= 0) {
ascent[i] = baseline;
descent[i] = d.height - baseline;
} else {
//基准线为负数
ascent[i] = -1;
}
}
//单行之间的水平坐标计算
if ((x == 0) || ((x + d.width) <= maxwidth)) {
if (x > 0) {
//x>0说明当前组件不是第一个组件需要加上组件之间的水平间隙
x += hgap;
}
//坐标向右偏移
x += d.width;
//水平坐标修正
rowh = Math.max(rowh, d.height);
} else {
//换行
rowh = moveComponents(target, insets.left + hgap, y,
maxwidth - x, rowh, start, i, ltr,
useBaseline, ascent, descent);
x = d.width;
y += vgap + rowh;
rowh = d.height;
start = i;
}
}
}
//组件的真正摆放的是在这个方法中去处理的
moveComponents(target, insets.left + hgap, y, maxwidth - x, rowh,
start, nmembers, ltr, useBaseline, ascent, descent);
}
}
moveComponents
/**
* Centers the elements in the specified row, if there is any slack.
* 将元素放到指定的行中
*
* @param target the component which needs to be moved 需要被移动的组件
* @param x the x coordinate x坐标
* @param y the y coordinate y坐标
* @param width the width dimensions 宽
* @param height the height dimensions 高
* @param rowStart the beginning of the row 行始端
* @param rowEnd the the ending of the row 行末端
* @param useBaseline Whether or not to align on baseline. 是否发对齐基准线
* @param ascent Ascent for the components. This is only valid if
* useBaseline is true.
* 使组件向上偏移,这个只有在使用基准线的前提下有效
* @param descent Ascent for the components. This is only valid if
* useBaseline is true.
* 使组件向下偏移,这个只有在使用记住县的前提下有效
* @return actual row height 返回行高
*/
private int moveComponents(Container target, int x, int y, int width, int height,
int rowStart, int rowEnd, boolean ltr,
boolean useBaseline, int[] ascent,
int[] descent) {
//根据newAlign方式去修正
switch (newAlign) {
case LEFT:
//居左 LTR: X = X ; RTL: X = X + Width;
x += ltr ? 0 : width;
break;
case CENTER:
//居中
x += width / 2;
break;
case RIGHT:
//居右 LTR: X= X + width ; RTL: X = X;
x += ltr ? width : 0;
break;
case LEADING:
//沿着容器的左端
break;
case TRAILING:
//沿着容器的后端
x += width;
break;
}
//上偏移量
int maxAscent = 0;
//非基准线高度
int nonbaselineHeight = 0;
//基准线偏移量
int baselineOffset = 0;
//使用了基准线的情况
if (useBaseline) {
int maxDescent = 0;
for (int i = rowStart; i < rowEnd; i++) {
//遍历一行的组件
Component m = target.getComponent(i);
//可视的情况下
if (m.visible) {
if (ascent[i] >= 0) {
//记录上下偏移量
maxAscent = Math.max(maxAscent, ascent[i]);
maxDescent = Math.max(maxDescent, descent[i]);
} else {
//高度修正
nonbaselineHeight = Math.max(m.getHeight(),
nonbaselineHeight);
}
}
}
//高度修正
height = Math.max(maxAscent + maxDescent, nonbaselineHeight);
//基准线偏移量修正
baselineOffset = (height - maxAscent - maxDescent) / 2;
}
for (int i = rowStart; i < rowEnd; i++) {
//遍历一行的组件
Component m = target.getComponent(i);
//可视的情况下
if (m.isVisible()) {
//修正过后的y坐标值
int cy;
if (useBaseline && ascent[i] >= 0) {
//如果使用了基准线并且对应的向上偏移量非负数
cy = y + baselineOffset + maxAscent - ascent[i];
} else {
cy = y + (height - m.height) / 2;
}
//对当前的布局模式进行判断并设置组件的位置
if (ltr) {
m.setLocation(x, cy);
} else {
m.setLocation(target.width - x - m.width, cy);
}
//设置完以后x坐标向右偏移
x += m.width + hgap;
}
}
return height;
}
注:关于Insets类,它是一个容器边框的表示,它指定容器必须在每个边缘留下空间(可以为0),空间可以是边框,空格或标题。