Window的属性

基于Android U

WMS是Window的最终管理者,Window好比是员工,WMS是老板,为了方便老板管理员工则需要定义一些“协议”,这些“协议”就是Window的属性,它们被定义在WindowManager的内部类LayoutParams中,了解Window的属性能够更好地理解WMS的内部原理。Window的属性有很多种,与应用开发最密切的有三种,分别是Type(Window的类型)、Flag(Window的标志)和SoftInputMode(软键盘相关模式),下面分别介绍这三种Window的属性。

Window的类型和显示次序

Window的类型有很多种,比如应用程序窗口、系统错误窗口、输入法窗口、PopupWindow、Toast、Dialog等。总的来说,Window分为三大类型,分别是Application Window(应用程序窗口)、Sub Window(子窗口)、System Window(系统窗口),每个大类型中又包含了很多种类型,它们都定义在WindowManager的静态内部类LayoutParams中。

  1. 应用程序窗口

Activity就是一个典型的应用程序窗口,应用程序窗口包含的类型如下所示:

1
2
3
4
5
6
7
8
9
10
11
// 应用程序窗口类型初始值
public static final int FIRST_APPLICATION_WINDOW = 1;
// 窗口的基础值,其他的窗口值要大于这个值
public static final int TYPE_BASE_APPLICATION = 1;
// 普通的应用程序窗口类型
public static final int TYPE_APPLICATION = 2;
// 应用程序启动窗口类型,用于系统在应用程序窗口启动前显示的窗口
public static final int TYPE_APPLICATION_STARTING = 3;
public static final int TYPE_DRAWN_APPLICATION = 4;
// 应用程序窗口类型结束值
public static final int LAST_APPLICATION_WINDOW = 99;

应用程序窗口包含了以上几种Type值,应用程序窗口的Type值范围为1~99,这个数值的大小涉及窗口的层级。

  1. 子窗口

子窗口,顾名思义,它不能独立存在,需要附着在其他窗口才可以, PopupWindow就属于子窗口。子窗口的类型定义如下所示:

1
2
3
4
5
6
7
8
9
10
// 子窗口类型初始值
public static final int FIRST_SUB_WINDOW = 1000;
public static final int TYPE_APPLICATION_PANEL = FIRST_SUB_WINDOW;
public static final int TYPE_APPLICATION_MEDIA = FIRST_SUB_WINDOW + 1;
public static final int TYPE_APPLICATION_SUB_PANEL = FIRST_SUB_WINDOW + 2;
public static final int TYPE_APPLICATION_ATTACHED_DIALOG = FIRST_SUB_WINDOW + 3;
public static final int TYPE_APPLICATION_MEDIA_OVERLAY = FIRST_SUB_WINDOW + 4;
public static final int TYPE_APPLICATION_ABOVE_SUB_PANEL = FIRST_SUB_WINDOW + 5;
// 子窗口类型结束值
public static final int LAST_SUB_WINDOW = 1999;

可以看出子窗口的Type值范围为1000~1999。

  1. 系统窗口

Toast、输入法窗口、系统音量条窗口、系统错误窗口都属于系统窗口。系统窗口的类型定义如下所示:

1
2
3
4
5
6
7
8
9
10
11
// 系统窗口类型初始值
public static final int FIRST_SYSTEM_WINDOW = 2000;
public static final int TYPE_STATUS_BAR = FIRST_SYSTEM_WINDOW;
public static final int TYPE_SEARCH_BAR = FIRST_SYSTEM_WINDOW+1;
public static final int TYPE_PHONE = FIRST_SYSTEM_WINDOW+2;
public static final int TYPE_SYSTEM_ALERT = FIRST_SYSTEM_WINDOW+3;
public static final int TYPE_KEYGUARD = FIRST_SYSTEM_WINDOW+4;
public static final int TYPE_TOAST = FIRST_SYSTEM_WINDOW+5;
...
// 系统窗口类型结束值
public static final int LAST_SYSTEM_WINDOW = 2999;

这里只列出部分系统窗口的类型值,系统窗口的Type值范围为2000~2999。

  1. 窗口显示次序

当一个进程向WMS申请一个窗口时,WMS会为窗口确定显示次序。为了方便窗口显示次序的管理,手机屏幕可以虚拟地用X、Y、Z轴来表示,其中Z轴垂直于屏幕,从屏幕内指向屏幕外,这样确定窗口显示次序也就是确定窗口在Z轴上的次序,这个次序称为Z-Oder。Type值是Z-Oder排序的依据,我们知道应用程序窗口的Type值范围为1~99,子窗口1000~1999,系统窗口2000~2999,在一般情况下,Type值越大则Z-Oder排序越靠前,就越靠近用户。当多个窗口的Type值相同,WMS会结合各种情况给出最终的Z-Oder。

Window的标志

Window的标志也就是Flag,用于控制Window的显示,同样被定义在WindowManager的内部类LayoutParams中。这里列出几个常用的:

Flag 描述
FLAG_ALLOW_LOCK_WHILE_SCREEN_ON 只要窗口可见,就允许在开启状态的屏幕上锁屏
FLAG_NOT_FOCUSABLE 窗口不能获得输入焦点,设置该标志的同时,FLAG_NOT_TOUCH_MODAL也会被设置
FLAG_NOT_TOUCHABLE 窗口不接收任何触摸事件
FLAG_NOT_TOUCH_MODAL 将该窗口区域外的触摸事件传递给其他的Window,而自己只会处理窗口区域内的触摸事件
FLAG_KEEP_SCREEN_ON 只要窗口可见,屏幕就会一直亮着
FLAG_LAYOUT_NO_LIMITS 允许窗口超过屏幕之外
FLAG_FULLSCREEN 隐藏所有的屏幕装饰窗口,比如在游戏、播放器中的全屏显示
FLAG_SHOW_WHEN_LOCKED 窗口可以在锁屏的窗口之上显示
FLAG_IGNORE_CHEEK_PRESSES 当用户的脸贴近屏幕时(比如打电话),不会去相应此事件
FLAG_TURN_SCREEN_ON 窗口显示时将屏幕点亮

设置Window的Flag有三种方法。

  1. 通过Window的addFlags()方法。

    1
    2
    Window mWindow = getWindow();
    mWindow.addFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN);
  2. 通过Window的setFlags()方法。

    1
    2
    3
    Window mWindow = getWindow();
    mWindow.setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,
    WindowManager.LayoutParams.FLAG_FULLSCREEN);

    其实Window的addFlags()方法内部会调用setFlags()方法,因此这两种方法区别不大。

  3. 给LayoutParams设置Flag,并通过WindowManager的addView()方法进行添加。

    1
    2
    3
    4
    5
    WindowManager.LayoutParams mWindowLayoutParams = new WindowManager.LayoutParams();
    mWindowLayoutParams.flags = WindowManager.LayoutParams.FLAG_FULLSCREEN;
    WindowManager mWindowManager = (WindowManager) getSystemService(Context.WINDOW_SERVICE);
    TextView mTextView = new TextView(this);
    mWindowManager.addView(mTextView, mWindowLayoutParams);

软键盘相关模式

窗口和窗口的叠加是十分常见的场景,但如果其中的窗口是软键盘窗口,可能就会出现一些问题,比如典型的用户登录界面,默认的情况弹出的软键盘窗口可能会盖住输入框下方的按钮,这样用户体验会非常糟糕。为了使得软键盘窗口能够按照期望来显示,WindowManager的静态内部类LayoutParams中定义了软键盘相关模式。

SoftInputMode 描述
SOFT_INPUT_STATE_UNSPECIFIED 没有指定状态,系统会选择一个合适的状态或依赖于主题的设置
SOFT_INPUT_STATE_UNCHANGED 不会改变软键盘状态
SOFT_INPUT_STATE_HIDDEN 当用户进入该窗口时,软键盘默认隐藏
SOFT_INPUT_STATE_ALWAYS_HIDDEN 当窗口获取焦点时,软键盘总是被隐藏
SOFT_INPUT_ADJUST_RESIZE 当软键盘弹出时,窗口会调整大小
SOFT_INPUT_ADJUST_PAN 当软键盘弹出时,窗口不需要调整大小,要确保输入焦点是可见的

从上面给出的SoftInputMode,可以发现,它们与AndroidManifest中Activity的属性android:windowSoftInputMode是对应的。因此除了在AndroidManifest中为Activity设置android:windowSoftInputMode以外,还可以在Java代码中为Window设置SoftInputMode,如下所示:

1
getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_ADJUST_RESIZE);

Window的属性
https://citrus-maxima.github.io/2024/03/10/Window的属性/
作者
柚子树
发布于
2024年3月10日
许可协议