Android 代码动态布局 LayoutParams 使用

先来看一个简单的布局，先用xml写

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@android:color/holo_blue_bright"
    android:gravity="center"
    tools:context=".MainActivity">

    <TextView
        android:layout_width="160px"
        android:layout_height="160px"
        android:background="@android:color/holo_red_dark"
        android:text="@string/tv" />

</LinearLayout>

效果也很简单

xml 设置效果

如果想要代码动态写出上面的布局，就需要使用 LayoutParams 这个关键类了，LayoutParams 是 ViewGroup 的一个内部类，这是一个基类，例如 FrameLayout、LinearLayout 等等，内部都有自己的 LayoutParams。

一、使用 LayoutParams 设置宽高

LayoutParams 的作用是：子控件告诉父控件，自己要如何布局。

代码实现：

public class LayoutParamsFragment extends Fragment {

    @Nullable
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container,
                             @Nullable Bundle savedInstanceState) {
        LinearLayout ll = new LinearLayout(getContext());
        // ll的父容器是MainActivity中的FrameLayout
        ll.setLayoutParams(new FrameLayout.LayoutParams(
                ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));
        ll.setGravity(Gravity.CENTER);
        ll.setBackgroundResource(android.R.color.holo_blue_bright);

        TextView tv = new TextView(getContext());
        // tv的父容器是LinearLayout
        LinearLayout.LayoutParams layoutParams = new LinearLayout.LayoutParams(160, 160);
        tv.setLayoutParams(layoutParams);// ①
        tv.setBackgroundResource(android.R.color.holo_red_dark);
        tv.setText(getText(R.string.tv));

        ll.addView(tv);// ②
        return ll;
    }
}

我们对 LinearLayout 和 TextView 的 LayoutParams 都进行了设置，效果图和上面 xml 的是一模一样的。

ll.setLayoutParams 设置的是其父布局 FrameLayout 的 LayoutParams，并且告诉父布局，宽高设置为 MATCH_PARENT。
vt.setLayoutParams 设置的也是其父布局 LinearLayout 的 LayoutParams，并且告诉父布局，宽高设置为 160px。

上面 ①、② 两行代码可以简化为一行，替换为 addView(View child, LayoutParams params) 这个重载方法，在添加到父布局时，设置 LayoutParams，通知父布局如何摆放自己。

ll.addView(vt, layoutParams);// 在添加到父布局的时候

二、不设置 LayoutParams

public class LayoutParamsFragment extends Fragment {

    @Nullable
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container,
                             @Nullable Bundle savedInstanceState) {
        LinearLayout ll = new LinearLayout(getContext());
        ll.setGravity(Gravity.CENTER);
        ll.setBackgroundResource(android.R.color.holo_blue_bright);

        TextView tv = new TextView(getContext());
        tv.setBackgroundResource(android.R.color.holo_red_dark);
        tv.setText(getText(R.string.tv));

        ll.addView(tv);
        return ll;
    }
}

效果如下：

不设置 LayoutParams 宽高

我们发现，在对 LinearLayout 和 TextView 的都不设置 LayoutParams 的情况下，LinearLayout 使用 MATCH_PARENT，而 TextView 使用 WRAP_CONTENT，至于为什么，我们要分析一下源码。

1. TextView 的 LayoutParams

进入 addView 看一下，不存在 LayoutParams 时，会调用 generateDefaultLayoutParams() 进行创建。

public void addView(View child, int index) {
    if (child == null) {
        throw new IllegalArgumentException("Cannot add a null child view to a ViewGroup");
    }
    LayoutParams params = child.getLayoutParams();
    if (params == null) {
        params = generateDefaultLayoutParams();
        if (params == null) {
            throw new IllegalArgumentException("generateDefaultLayoutParams() cannot return null");
        }
    }
    addView(child, index, params);
}

找到 LinearLayout 中 generateDefaultLayoutParams()，注意不是 ViewGroup 中的。

@Override
protected LayoutParams generateDefaultLayoutParams() {
    if (mOrientation == HORIZONTAL) {
        return new LayoutParams(LayoutParams.WRAP_CONTENT, LayoutParams.WRAP_CONTENT);
    } else if (mOrientation == VERTICAL) {
        return new LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.WRAP_CONTENT);
    }
    return null;
}

显而易见，由于我们没有指定方向，mOrientation 默认为 0，也就是 HORIZONTAL，所以 TextView 设置为 WRAP_CONTENT，为了证实猜想，我们设置 LinearLayout 的方向为 VERTICAL。

ll.setOrientation(LinearLayout.VERTICAL);

效果跟代码看到的一样，宽度为 MATCH_PARENT，高度为 WRAP_CONTENT：

LinearLayout 方向为 VERTICAL

2. LinearLayout 的 LayoutParams

和上面 TextView 一样，这个要进入 FrameLayout 中查看 generateDefaultLayoutParams()。

@Override
protected LayoutParams generateDefaultLayoutParams() {
    return new LayoutParams(LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT);
}

所以，在 FrameLayout 中的 LinearLayout 的宽高就是 MATCH_PARENT。

三、getLayoutParams 的使用

在不使用代码动态布局的情况下，大都是先通过 getLayoutParams() 获取 LayoutParams ，然后进行赋值，最后通过 setLayoutParams()设回控件，值得注意的是，获取 LayoutParams 务必要强转为父控件的类型，才会有该父控件特有的方法。

public class LayoutParamsFragment extends Fragment {

    @Nullable
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container,
                             @Nullable Bundle savedInstanceState) {
        LinearLayout ll = new LinearLayout(getContext());
        // ll的父容器是MainActivity中的FrameLayout
        FrameLayout.LayoutParams fl_params = (FrameLayout.LayoutParams) ll.getLayoutParams();// ①
        fl_params.width = ViewGroup.LayoutParams.MATCH_PARENT;
        fl_params.height = ViewGroup.LayoutParams.MATCH_PARENT;
        ll.setLayoutParams(fl_params);
        ll.setGravity(Gravity.CENTER);
        ll.setBackgroundResource(android.R.color.holo_blue_bright);

        TextView tv = new TextView(getContext());
        // tv的父容器是LinearLayout
        LinearLayout.LayoutParams ll_params = (LinearLayout.LayoutParams) tv.getLayoutParams();// ②
        ll_params.width = 160;
        ll_params.height = 160;
        tv.setLayoutParams(ll_params);
        tv.setBackgroundResource(android.R.color.holo_red_dark);
        tv.setText(getText(R.string.tv));

        ll.addView(tv);
        return ll;
    }
}

上面代码是有问题的，①、②处都会返回 null，导致空指针。
①处：此时还没有将 LinearLayout 作为返回值返回，也就没有添加到布局中，自然不存在 LayoutParams。
②处：此时还没有将 TextView 添加到 LinearLayout 中，也不存在 LayoutParams。

下面才是正确的示例：

public class LayoutParamsFragment extends Fragment {

    @Nullable
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container,
                             @Nullable Bundle savedInstanceState) {
        LinearLayout ll = new LinearLayout(getContext());
        // ll的父容器是MainActivity中的FrameLayout
        ll.setLayoutParams(new FrameLayout.LayoutParams(
                ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));
        ll.setGravity(Gravity.CENTER);// 子控件居中
        ll.setBackgroundResource(android.R.color.holo_blue_bright);

        TextView tv = new TextView(getContext());
        ll.addView(tv);// 添加到父控件，此时会构造一个LayoutParams出来。

        LinearLayout.LayoutParams ll_params = (LinearLayout.LayoutParams) tv.getLayoutParams();
        ll_params.width = 160;
        ll_params.height = 160;
        tv.setLayoutParams(ll_params);
        tv.setBackgroundResource(android.R.color.holo_red_dark);
        tv.setText(getText(R.string.tv));

        return ll;
    }
}

四、setLayoutParams 的作用

这里抛出一个问题：

上面代码中 getLayoutParams() 得到了 LayoutParams 的引用 ll_params，直接对 width 和 height 属性赋值，那么 setLayoutParams() 是不是不需要调用了？

这就需要看看 setLayoutParams() 里面干了什么

public void setLayoutParams(ViewGroup.LayoutParams params) {
    if (params == null) {
        throw new NullPointerException("Layout parameters cannot be null");
    }
    mLayoutParams = params;
    resolveLayoutParams();// 根据已解析的布局方向解析布局参数
    if (mParent instanceof ViewGroup) {
        ((ViewGroup) mParent).onSetLayoutParams(this, params);
    }
    requestLayout();
}

关键的最后一行 requestLayout() ，这个方法简单来说，就是重新执行 onMeasure() 和 onLayout()，而 onDraw() 需要适情况而定，这里就不具体展开说了。

现在就可以回答上面的问题了，在上面 onCreateView() 中的 setLayoutParams() 确实是多余的，因为在 onCreateView() 之后才会进行 View 的绘制。

当然这并不是说 setLayoutParams() 没有用，在自定义控件中，往往需要在 View 绘制后修改 LayoutParams 的值，那么这种场景下，如果不调用 setLayoutParams() 就会出现，设置不生效的问题。

总结：

在 LayoutParams 赋值后，如果确定还没有完成 View 的绘制，可以省略 setLayoutParams() ，在后面绘制期间，会取到前面的赋值，并使之生效。
如果已经完成了 View 的绘制，那么必须要调用 setLayoutParams() ，重新进行绘制。
不确定的情况下就 setLayoutParams() ，反正不会出问题。

五、使用 setWidth/setHeight 设置宽高

在设置控件宽高时，有些人为了方便，没有使用 LayoutParams ，直接通过 set 方法设置，但这种方式并不靠谱。

tv.setWidth(160);
tv.setHeight(160);

我这里对 TextView 和 Button 分别设置宽高为 160px。

public class LayoutParamsFragment extends Fragment {

    @Nullable
    @Override
    public View onCreateView(@NonNull LayoutInflater inflater, @Nullable ViewGroup container,
                             @Nullable Bundle savedInstanceState) {
        LinearLayout ll = new LinearLayout(getContext());
        // ll的父容器是MainActivity中的FrameLayout
        ll.setLayoutParams(new FrameLayout.LayoutParams(
                ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT));
        ll.setGravity(Gravity.CENTER);
        ll.setBackgroundResource(android.R.color.holo_blue_bright);

        TextView tv = new TextView(getContext());
        tv.setWidth(160);
        tv.setHeight(160);
        tv.setBackgroundResource(android.R.color.holo_red_dark);
        tv.setText(getText(R.string.tv));
        ll.addView(tv);

        Button bt = new Button(getContext());
        bt.setWidth(160);
        bt.setHeight(160);
        bt.setBackgroundResource(android.R.color.holo_green_dark);
        bt.setText(getText(R.string.tv));
        ll.addView(bt);
        return ll;
    }
}

TextView 设置宽高成功，Button 只在高度上生效，效果如下：

setWidth/setHeight 设置宽高

可以打印下控件宽高看下结果：

tv Width: 160
tv Height: 160
bt Width: 264
bt Height: 160

Button 也是继承 TextView，为什么会出现设置失效？进入 setWidth 方法，看到在这里只是设置了控件的最大值和最小值：

public void setWidth(int pixels) {
    mMaxWidth = mMinWidth = pixels;
    mMaxWidthMode = mMinWidthMode = PIXELS;

    requestLayout();
    invalidate();
}

LayoutParams 设置的宽高才是真正的宽高：

public LayoutParams(int width, int height) {
    this.width = width;
    this.height = height;
}

再看下onMeasure中，这里面设置 width 时，有很多类似下面判断：

if (mMaxWidthMode == EMS) {
    width = Math.min(width, mMaxWidth * getLineHeight());
} else {
    width = Math.min(width, mMaxWidth);
}

if (mMinWidthMode == EMS) {
    width = Math.max(width, mMinWidth * getLineHeight());
} else {
    width = Math.max(width, mMinWidth);
}

所以 setWidth()/setHeight 只代表想设置的宽高，并不是实际设定值。这就很好理解，当 set 的值大于 Button 最小宽度/高度时生效，在小于 Button 最小宽度/高度时，不能起到作用。

参考资料

Android LayoutParams详解

最后编辑于：2019.06.01 13:47:39

人面猴
序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
沈念sama阅读 217,657评论 6赞 505
死咒
序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
沈念sama阅读 92,889评论 3赞 394
救了他两次的神仙让他今天三更去死
文/潘晓璐我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
开封第一讲书人阅读 164,057评论 0赞 354
道士缉凶录：失踪的卖姜人
文/不坏的土叔我叫张陵，是天一观的道长。经常有香客问我，道长，这世上最难降的妖魔是什么？我笑而不...
开封第一讲书人阅读 58,509评论 1赞 293
港岛之恋（遗憾婚礼）
正文为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
茶点故事阅读 67,562评论 6赞 392
恶毒庶女顶嫁案：这布局不是一般人想出来的
文/花漫我一把揭开白布。她就那样静静地躺着，像睡着了一般。火红的嫁衣衬着肌肤如雪。梳的纹丝不乱的头发上，一...
开封第一讲书人阅读 51,443评论 1赞 302
城市分裂传说
那天，我揣着相机与录音，去河边找鬼。笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。我是一名探鬼主播，决...
沈念sama阅读 40,251评论 3赞 418
双鸳鸯连环套：你想象不到人心有多黑
文/苍兰香墨我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
开封第一讲书人阅读 39,129评论 0赞 276
万荣杀人案实录
序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
沈念sama阅读 45,561评论 1赞 314
护林员之死
正文独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋以下内容为张勋视角年9月15日...
茶点故事阅读 37,779评论 3赞 335
白月光启示录
正文我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
茶点故事阅读 39,902评论 1赞 348
活死人
序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
沈念sama阅读 35,621评论 5赞 345
日本核电站爆炸内幕
正文年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
茶点故事阅读 41,220评论 3赞 328
男人毒药：我在死后第九天来索命
文/蒙蒙一、第九天我趴在偏房一处隐蔽的房顶上张望。院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
开封第一讲书人阅读 31,838评论 0赞 22
一桩弑父案，背后竟有这般阴谋
文/苍兰香墨我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。一阵脚步声响...
开封第一讲书人阅读 32,971评论 1赞 269
情欲美人皮
我被黑心中介骗来泰国打工，没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。一个月前我还...
沈念sama阅读 48,025评论 2赞 370
代替公主和亲
正文我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
茶点故事阅读 44,843评论 2赞 354