Android 窗口Flags详解
Android 窗口Flags详解
这里主要探讨Touchable,Focusable,OutsideTouchable,TouchModal这四个混合使用的效果。
public static final int FLAG_NOT_FOCUSABLE = 0x00000008;
public static final int FLAG_NOT_TOUCHABLE = 0x00000010;
public static final int FLAG_NOT_TOUCH_MODAL = 0x00000020;
public static final int FLAG_WATCH_OUTSIDE_TOUCH = 0x00040000;
private int computeFlags(int curFlags) {
boolean mTouchable = true;
if (!mTouchable) {
curFlags |= WindowManager.LayoutParams.FLAG_NOT_TOUCHABLE;
} else {
curFlags &= ~WindowManager.LayoutParams.FLAG_NOT_TOUCHABLE;
}
boolean mFocusable = false;
if (!mFocusable) {
curFlags |= WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE;
} else {
curFlags &= ~WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE;
}
boolean mTouchModal = true;
if (!mTouchModal) {
curFlags |= WindowManager.LayoutParams.FLAG_NOT_TOUCH_MODAL;
} else {
curFlags &= ~WindowManager.LayoutParams.FLAG_NOT_TOUCH_MODAL;
}
boolean mOutsideTouchable = true;
if (mOutsideTouchable) {
curFlags |= WindowManager.LayoutParams.FLAG_WATCH_OUTSIDE_TOUCH;
} else {
curFlags &= ~WindowManager.LayoutParams.FLAG_WATCH_OUTSIDE_TOUCH;
}
return curFlags;
}
- Touchable (默认为true)
最简单的Touchable,
为false,表示窗口不接受触摸事件;
为true,表示窗口接受触摸事件;
要窗口接收事件,必须为true。窗口不接受事件,意味着事件会透传到下一个窗口。这里的窗口事件是指DOWN-UP,窗口是指窗口自身范围,窗口外的ACTION_OUTSIDE与此设置无关。
- OutsideTouchable(默认为false)
为false,表示对ACTION_OUTSIDE事件不感兴趣。
为true,表示对ACTION_OUTSIDE事件感兴趣,此时,如果新事件被另一个窗口消化,则会发送ACTION_OUTSIDE给该窗口。包括:
2.1. 如果窗口设置了Touchable为false。即使触摸事件在窗口内,由于不处理事件,导致事件透传,被另一个窗口消化,此时该窗口也会收到ACTION_OUTSIDE。
2.2 触摸事件在窗口外面触发,导致事件被另一个窗口消化,此时该窗口也会收到ACTION_OUTSIDE。
2.3 如果窗口设置了TouchModal和Focusable,导致窗口内外的事件被当前窗口截获,由于不是被另一个窗口消化,所以即使设置了OutsideTouchable,也不会有ACTION_OUTSIDE。
- Focusable(默认为true)
为false,表示不会聚焦,所以不会有软键盘。同时它的z-order可以在软键盘之上,覆盖软键盘。如果你在不聚焦的情况下,还需要软键盘,可以使用FLAG_ALT_FOCUSABLE_IM来修改。如果为false,会放弃TouchModal原来的值,强制设置TouchModal为false
为true,表示窗口可以聚焦。
Focusable生效,通常需要Touchable为true。如果窗口Touchable为false,窗口可以聚焦顶多可以弹出键盘,窗口自身不会收到Touch事件。
- TouchModal(默认为true)
TouchModal的设置,只有在Focusable为true时才有效,Focusable为false,会忽略TouchModal的值
为true,当窗口Focusable为true时,无论窗口内外,事件都被当前窗口接收。
为false,当窗口Focusable为true时,只有窗口内的事件被当前窗口接收。窗口外,OutsideTouchable的设置决定了是否有ACTION_OUTSIDE事件。
为true,当窗口Focusable为false时,设置不生效。
为false,当窗口Focusable为false时,设置不生效。
总结:
- 如何知道这些Flag的默认值?
FLAG_NOT_TOUCHABLE,意味着,默认是TOUCHABLE,必要时,才使用这个Flag关闭。
FLAG_NOT_FOCUSABLE,意味着,默认是FOCUSABLE,必要时,才使用这个Flag关闭。
FLAG_WATCH_OUTSIDE_TOUCH,意味着,默认是不关心,必要时,才使用这个Flag开启。
FLAG_NOT_TOUCH_MODAL,意味着,默认是TOUCH_MODAL,必要时,才使用这个Flag关闭。
- 如何看Flag注释里的enable/disable:
/** Window flag: this window won't ever get key input focus, so the
* user can not send key or other button events to it. Those will
* instead go to whatever focusable window is behind it. This flag
* will also enable {@link #FLAG_NOT_TOUCH_MODAL} whether or not that
* is explicitly set.
*
* <p>Setting this flag also implies that the window will not need to
* interact with
* a soft input method, so it will be Z-ordered and positioned
* independently of any active input method (typically this means it
* gets Z-ordered on top of the input method, so it can use the full
* screen for its content and cover the input method if needed. You
* can use {@link #FLAG_ALT_FOCUSABLE_IM} to modify this behavior. */
public static final int FLAG_NOT_FOCUSABLE = 0x00000008;
FLAG_NOT_FOCUSABLE的注释是这样的。This flag will also enable FLAG_NOT_TOUCH_MODAL whether or not that is explicitly set.
所谓的enable,就是使用这个Flag。直接翻译就是,使用了FLAG_NOT_FOCUSABLE这个Flag,就会同时使用FLAG_NOT_TOUCH_MODAL这个flag。
使用FLAG_NOT_FOCUSABLE就是关闭FOCUSABLE,使用FLAG_NOT_TOUCH_MODAL就是关闭TOUCH_MODAL。简述就是,关闭了FOCUSABLE,会同时关闭TOUCH_MODAL。
- 除了注释中有说明,否则这些Flag都是单独生效的。
比如,Touchable,当一个事件确实派发到窗口到时候,就看这个Flag,为true就是接受事件,为false就是不接受事件。你可以提前截获不让事件派发到窗口,但一旦派发到窗口,就是这个Flag来决定窗口是否接受事件。
比如,OutsideTouchable,你可以截获事件不让事件派发到另一个窗口,但一旦事件派发到另一个窗口,就是这个Flag决定当前窗口是否接受ACTION_OUTSIDE事件。
实例分析:
mWindowManager = (WindowManager) this.getSystemService(Context.WINDOW_SERVICE);
final WindowManager.LayoutParams p = new WindowManager.LayoutParams();
p.width = WindowManager.LayoutParams.WRAP_CONTENT;
p.height = WindowManager.LayoutParams.WRAP_CONTENT;
mWindowManager.addView(view, p);
以下,窗口内外是指,触点在窗口内/外。完整事件是指DOWN to UP事件流。ACTION_OUTSIDE事件只有一次。
-
WindowManager.LayoutParams使用默认设置。
意味着,都使用默认值:Touchable=true,OutsideTouchable=false,Focusable=true,TouchModal=true。
结果是:窗口内外事件都被当前弹窗截获。 -
上面参数把OutsideTouchable=true。即
Touchable=true,OutsideTouchable=true,Focusable=true,TouchModal=true。
结果是:同上,窗口内外事件都被当前弹窗截获。没有事件透传到下一个窗口,所以内外不会有ACTION_OUTSIDE事件。 -
Touchable=false,OutsideTouchable=false,Focusable=true,TouchModal=true。
结果是:内外的事件都透传,窗口收不到任何事件。(窗口内不接受事件,事件透传。窗口外由OutsideTouchable=false控制,不接收ACTION_OUTSIDE事件,所以窗口收不到任何事件) -
上面参数把OutsideTouchable=true。即
Touchable=false,OutsideTouchable=true,Focusable=true,TouchModal=true。
结果是:窗口内外都收到ACTION_OUTSIDE事件。(窗口内外事件都透传到下一个窗口,相当于对于窗口而言,都是窗口外,所以点击窗口内外,窗口都能收到ACTION_OUTSIDE事件)
总结,Touchable和OutsideTouchable分别控制了窗口内外的事件。
-
Touchable=true,OutsideTouchable=true,Focusable=true,TouchModal=true。
结果是:窗口内外事件都被当前弹窗截获,是完整事件。内外都不会有ACTION_OUTSIDE事件。 -
Touchable=true,OutsideTouchable=true,Focusable=true,TouchModal=false。
结果是:窗口内有完整事件;窗口外有ACTION_OUTSIDE事件。如果将OutsideTouchable设为false,则窗口外没有ACTION_OUTSIDE事件。 -
Touchable=true,OutsideTouchable=true,Focusable=false,TouchModal=false/true。
结果是:同上。窗口内有完整事件;窗口外有ACTION_OUTSIDE事件。如果将OutsideTouchable设为false,窗口外没有ACTION_OUTSIDE事件。
总结,当且仅当Focusable为true,TouchModal为true情况下,窗口内外事件才被当前窗口截获;否则,都是窗口内才有完整事件,窗口外才有ACTION_OUTSIDE事件。
注意,当前窗口收到的完整事件和ACTION_OUTSIDE事件,都是先分发到窗口的DecorView,即WindowManager.addView(view, p);里面的view实例。
当事件分发到View,就进入View的事件分发流程。