Android中WindowManager.LayoutParams类详解

刺骨的言语ヽ痛彻心扉 2022-06-03 05:22 142阅读 0赞

WindowManager.LayoutParams 是 WindowManager 接口的嵌套类；继承于 ViewGroup.LayoutParams 。  
 它的内容十分丰富。其实WindowManager.java的主要内容就是由这个类定义构成。下面来分析一下这个类：  
  
 定义  
 public static class WindowManager.LayoutParams extends ViewGroup.LayoutParams implements Parcelable  
  
 继承关系  
 java.lang.Object  
 android.view.ViewGroup.LayoutParams  
 android.view.WindowManager.LayoutParams  
  
 继承来的属性与常量  
 从ViewManager.LayoutParams 继承来的属性：  
 android:layout\_height  
 Specifies the basic height of the view.  
 android:layout\_width  
 Specifies the basic width of the view.  
  
 从ViewManager.LayoutParams继承的常量：  
 FILL\_PARENT  
 WRAP\_CONTENT  
 MATCH\_PARENT  
  
 两个变量：  
 width  
 height  
  
 属性及可用的常量定义  
  
 1. public int x;  
 如果忽略gravity属性，那么它表示窗口的绝对X位置。  
 什么是gravity属性呢？简单地说，就是窗口如何停靠。  
 当设置了 Gravity.LEFT 或 Gravity.RIGHT 之后，x值就表示到特定边的距离。  
  
  2. public int y;  
 如果忽略gravity属性，那么它表示窗口的绝对Y位置。  
 当设置了 Gravity.TOP 或 Gravity.BOTTOM 之后，y值就表示到特定边的距离。  
  
 3. public float horizontalWeight;  
 public float verticalWeight;  
 在纵/横向上，为关联的view预留了多少扩展空间（像素）。如果是0，那么此view不能被拉伸。  
 其他情况下，扩展空间（像素）将被widget所均分。  
  
 4. public int type;  
 窗口类型。  
  
 有3种主要类型：  
  
  Applicationwindows：  
 取值在 FIRST\_APPLICATION\_WINDOW 和 LAST\_APPLICATION\_WINDOW 之间。  
 是通常的、顶层的应用程序窗口。必须将 token 设置成 activity 的 token 。  
  
 Sub\_windows：  
 取值在 FIRST\_SUB\_WINDOW 和 LAST\_SUB\_WINDOW 之间。  
 与顶层窗口相关联，token 必须设置为它所附着的宿主窗口的 token。  
  
  Systemwindows：  
 取值在 FIRST\_SYSTEM\_WINDOW 和 LAST\_SYSTEM\_WINDOW 之间。  
 用于特定的系统功能。它不能用于应用程序，使用时需要特殊权限。

下面定义了 type 的取值：

\[java\] [view plain][] [copy][view plain]

1.  //应用程序窗口。
2.  publicstaticfinalint FIRST\_APPLICATION\_WINDOW = 1; 
3.  
4.  //所有程序窗口的“基地”窗口，其他应用程序窗口都显示在它上面。 
5.  publicstaticfinalint TYPE\_BASE\_APPLICATION =1; 
6.  
7.  //普通应用功能程序窗口。token必须设置为Activity的token，以指出该窗口属谁。
8.  publicstaticfinalint TYPE\_APPLICATION = 2; 
9.  
10. //用于应用程序启动时所显示的窗口。应用本身不要使用这种类型。
11. //它用于让系统显示些信息，直到应用程序可以开启自己的窗口。 
12. publicstaticfinalint TYPE\_APPLICATION\_STARTING = 3; 
13. 
14. //应用程序窗口结束。
15. publicstaticfinalint LAST\_APPLICATION\_WINDOW = 99; 
16. 
17. //子窗口。子窗口的Z序和坐标空间都依赖于他们的宿主窗口。
18. publicstaticfinalint FIRST\_SUB\_WINDOW = 1000; 
19. 
20. //面板窗口，显示于宿主窗口上层。
21. publicstaticfinalint TYPE\_APPLICATION\_PANEL = FIRST\_SUB\_WINDOW; 
22. 
23. //媒体窗口，例如视频。显示于宿主窗口下层。
24. publicstaticfinalint TYPE\_APPLICATION\_MEDIA = FIRST\_SUB\_WINDOW+1; 
25. 
26. //应用程序窗口的子面板。显示于所有面板窗口的上层。（GUI的一般规律，越“子”越靠上）
27. publicstaticfinalint TYPE\_APPLICATION\_SUB\_PANEL = FIRST\_SUB\_WINDOW +2; 
28. 
29. //对话框。类似于面板窗口，绘制类似于顶层窗口，而不是宿主的子窗口。
30. publicstaticfinalint TYPE\_APPLICATION\_ATTACHED\_DIALOG = FIRST\_SUB\_WINDOW +3; 
31. 
32. //媒体信息。显示在媒体层和程序窗口之间，需要实现透明（半透明）效果。（例如显示字幕）
33. publicstaticfinalint TYPE\_APPLICATION\_MEDIA\_OVERLAY = FIRST\_SUB\_WINDOW +4; 
34. 
35. //子窗口结束。（ End of types of sub-windows ）
36. publicstaticfinalint LAST\_SUB\_WINDOW = 1999; 
37. 
38. //系统窗口。非应用程序创建。
39. publicstaticfinalint FIRST\_SYSTEM\_WINDOW = 2000; 
40. 
41. //状态栏。只能有一个状态栏；它位于屏幕顶端，其他窗口都位于它下方。
42. publicstaticfinalint TYPE\_STATUS\_BAR = FIRST\_SYSTEM\_WINDOW; 
43. 
44. //搜索栏。只能有一个搜索栏；它位于屏幕上方。
45. publicstaticfinalint TYPE\_SEARCH\_BAR = FIRST\_SYSTEM\_WINDOW+1; 
46. 
47. //电话窗口。它用于电话交互（特别是呼入）。它置于所有应用程序之上，状态栏之下。
48. publicstaticfinalint TYPE\_PHONE = FIRST\_SYSTEM\_WINDOW+2; 
49. 
50. //系统提示。它总是出现在应用程序窗口之上。
51. publicstaticfinalint TYPE\_SYSTEM\_ALERT = FIRST\_SYSTEM\_WINDOW +3; 
52. 
53. //锁屏窗口。
54. publicstaticfinalint TYPE\_KEYGUARD = FIRST\_SYSTEM\_WINDOW +4; 
55. 
56. //信息窗口。用于显示toast。
57. publicstaticfinalint TYPE\_TOAST = FIRST\_SYSTEM\_WINDOW +5; 
58. 
59. //系统顶层窗口。显示在其他一切内容之上。此窗口不能获得输入焦点，否则影响锁屏。
60. publicstaticfinalint TYPE\_SYSTEM\_OVERLAY = FIRST\_SYSTEM\_WINDOW +6; 
61. 
62. //电话优先，当锁屏时显示。此窗口不能获得输入焦点，否则影响锁屏。
63. publicstaticfinalint TYPE\_PRIORITY\_PHONE = FIRST\_SYSTEM\_WINDOW +7; 
64. 
65. //系统对话框。（例如音量调节框）。
66. publicstaticfinalint TYPE\_SYSTEM\_DIALOG = FIRST\_SYSTEM\_WINDOW +8; 
67. 
68. //锁屏时显示的对话框。
69. publicstaticfinalint TYPE\_KEYGUARD\_DIALOG = FIRST\_SYSTEM\_WINDOW +9; 
70. 
71. //系统内部错误提示，显示于所有内容之上。
72. publicstaticfinalint TYPE\_SYSTEM\_ERROR = FIRST\_SYSTEM\_WINDOW +10; 
73. 
74. //内部输入法窗口，显示于普通UI之上。应用程序可重新布局以免被此窗口覆盖。
75. publicstaticfinalint TYPE\_INPUT\_METHOD = FIRST\_SYSTEM\_WINDOW +11; 
76. 
77. //内部输入法对话框，显示于当前输入法窗口之上。
78. publicstaticfinalint TYPE\_INPUT\_METHOD\_DIALOG= FIRST\_SYSTEM\_WINDOW +12; 
79. 
80. //墙纸窗口。
81. publicstaticfinalint TYPE\_WALLPAPER = FIRST\_SYSTEM\_WINDOW +13; 
82. 
83. //状态栏的滑动面板。
84. publicstaticfinalint TYPE\_STATUS\_BAR\_PANEL = FIRST\_SYSTEM\_WINDOW +14; 
85. 
86. //系统窗口结束。
87. publicstaticfinalint LAST\_SYSTEM\_WINDOW = 2999;

5. public int memoryType;  
  指出窗口所使用的内存缓冲类型。默认为 NORMAL 。  
  
 下面定义了 memoryType 的取值：  
  
 窗口缓冲位于主内存。  
 public static final int MEMORY\_TYPE\_NORMAL = 0;  
 窗口缓冲位于可以被DMA访问，或者硬件加速的内存区域。  
 public static final int MEMORY\_TYPE\_HARDWARE = 1;  
 窗口缓冲位于可被图形加速器访问的区域。  
 public static final int MEMORY\_TYPE\_GPU = 2;  
 窗口缓冲不拥有自己的缓冲区，不能被锁定。缓冲区由本地方法提供。  
 public static final int MEMORY\_TYPE\_PUSH\_BUFFERS = 3;  
  
 6. public int flags;  
 行为选项/旗标，默认为 none .下面定义了 flags 的取值：  
  
java代码：

\[java\] [view plain][] [copy][view plain]

1.  //窗口之后的内容变暗。
2.  publicstaticfinalint FLAG\_DIM\_BEHIND = 0x00000002; 
3.  
4.  //窗口之后的内容变模糊。
5.  publicstaticfinalint FLAG\_BLUR\_BEHIND = 0x00000004; 
6.  
7.  不许获得焦点。 
8.  不能获得按键输入焦点，所以不能向它发送按键或按钮事件。那些时间将发送给它后面的可以获得焦点的窗口。此选项还会设置FLAG\_NOT\_TOUCH\_MODAL选项。设置此选项，意味着窗口不能与软输入法进行交互，所以它的Z序独立于任何活动的输入法（换句话说，它可以全屏显示，如果需要的话，可覆盖输入法窗口）。要修改这一行为，可参考FLAG\_ALT\_FOCUSALBE\_IM选项。 
9.  publicstaticfinalint FLAG\_NOT\_FOCUSABLE = 0x00000008; 
10. 
11. //不接受触摸屏事件。
12. publicstaticfinalint FLAG\_NOT\_TOUCHABLE = 0x00000010; 
13. 
14. 当窗口可以获得焦点（没有设置 FLAG\_NOT\_FOCUSALBE 选项）时，仍然将窗口范围之外的点设备事件（鼠标、触摸屏）发送给后面的窗口处理。否则它将独占所有的点设备事件，而不管它们是不是发生在窗口范围内。 
15. publicstaticfinalint FLAG\_NOT\_TOUCH\_MODAL = 0x00000020; 
16. 
17. 如果设置了这个标志，当设备休眠时，点击触摸屏，设备将收到这个第一触摸事件。 
18. 通常第一触摸事件被系统所消耗，用户不会看到他们点击屏幕有什么反应。 
19. publicstaticfinalint FLAG\_TOUCHABLE\_WHEN\_WAKING = 0x00000040; 
20. 
21. 当此窗口为用户可见时，保持设备常开，并保持亮度不变。 
22. publicstaticfinalint FLAG\_KEEP\_SCREEN\_ON = 0x00000080; 
23. 
24. 窗口占满整个屏幕，忽略周围的装饰边框（例如状态栏）。此窗口需考虑到装饰边框的内容。 
25. publicstaticfinalint FLAG\_LAYOUT\_IN\_SCREEN =0x00000100; 
26. 
27. 允许窗口扩展到屏幕之外。 
28. publicstaticfinalint FLAG\_LAYOUT\_NO\_LIMITS =0x00000200; 
29. 
30. 窗口显示时，隐藏所有的屏幕装饰（例如状态条）。使窗口占用整个显示区域。 
31. publicstaticfinalint FLAG\_FULLSCREEN = 0x00000400; 
32. 
33. 此选项将覆盖FLAG\_FULLSCREEN选项，并强制屏幕装饰（如状态条）弹出。 
34. publicstaticfinalint FLAG\_FORCE\_NOT\_FULLSCREEN =0x00000800; 
35. 
36. 抖动。指 对半透明的显示方法。又称“点透”。图形处理较差的设备往往用“点透”替代Alpha混合。 
37. publicstaticfinalint FLAG\_DITHER = 0x00001000; 
38. 
39. //不允许屏幕截图。
40. publicstaticfinalint FLAG\_SECURE = 0x00002000; 
41. 
42. //一种特殊模式，布局参数用于指示显示比例。
43. publicstaticfinalint FLAG\_SCALED = 0x00004000; 
44. 
45. //当屏幕有可能贴着脸时，这一选项可防止面颊对屏幕造成误操作。
46. publicstaticfinalint FLAG\_IGNORE\_CHEEK\_PRESSES = 0x00008000; 
47. 
48. //当请求布局时，你的窗口可能出现在状态栏的上面或下面，从而造成遮挡。当设置这一选项后，窗口管理器将确保窗口内容不会被装饰条（状态栏）盖住。
49. publicstaticfinalint FLAG\_LAYOUT\_INSET\_DECOR = 0x00010000; 
50. 
51. //反转FLAG\_NOT\_FOCUSABLE选项。
52. //如果同时设置了FLAG\_NOT\_FOCUSABLE选项和本选项，窗口将能够与输入法交互，允许输入法窗口覆盖；
53. 如果FLAG\_NOT\_FOCUSABLE没有设置而设置了本选项，窗口不能与输入法交互，可以覆盖输入法窗口。 
54. publicstaticfinalint FLAG\_ALT\_FOCUSABLE\_IM = 0x00020000; 
55. 
56. //如果你设置了FLAG\_NOT\_TOUCH\_MODAL，那么当触屏事件发生在窗口之外事，可以通过设置此标志接收到一个MotionEvent.ACTION\_OUTSIDE事件。注意，你不会收到完整的down/move/up事件，只有第一次down事件时可以收到ACTION\_OUTSIDE。
57. publicstaticfinalint FLAG\_WATCH\_OUTSIDE\_TOUCH = 0x00040000; 
58. 
59. //当屏幕锁定时，窗口可以被看到。这使得应用程序窗口优先于锁屏界面。可配合FLAG\_KEEP\_SCREEN\_ON选项点亮屏幕并直接显示在锁屏界面之前。可使用FLAG\_DISMISS\_KEYGUARD选项直接解除非加锁的锁屏状态。此选项只用于最顶层的全屏幕窗口。
60. publicstaticfinalint FLAG\_SHOW\_WHEN\_LOCKED = 0x00080000; 
61. 
62. //请求系统墙纸显示在你的窗口后面。窗口必须是半透明的。
63. publicstaticfinalint FLAG\_SHOW\_WALLPAPER = 0x00100000; 
64. 
65. //窗口一旦显示出来，系统将点亮屏幕，正如用户唤醒设备那样。
66. publicstaticfinalint FLAG\_TURN\_SCREEN\_ON = 0x00200000; 
67. 
68. //解除锁屏。只有锁屏界面不是加密的才能解锁。如果锁屏界面是加密的，那么用户解锁之后才能看到此窗口，除非设置了FLAG\_SHOW\_WHEN\_LOCKED选项。
69. publicstaticfinalint FLAG\_DISMISS\_KEYGUARD = 0x00400000; 
70. 
71. //锁屏界面淡出时，继续运行它的动画。
72. publicstaticfinalint FLAG\_KEEP\_SURFACE\_WHILE\_ANIMATING =0x10000000; 
73. 
74. //以原始尺寸显示窗口。用于在兼容模式下运行程序。
75. publicstaticfinalint FLAG\_COMPATIBLE\_WINDOW = 0x20000000; 
76. 
77. //用于系统对话框。设置此选项的窗口将无条件获得焦点。
78. publicstaticfinalint FLAG\_SYSTEM\_ERROR = 0x40000000;

7. public int softInputMode;  
 软输入法模式选项：以下选项与 softInputMode 有关：  
  
java代码：

\[java\] [view plain][] [copy][view plain]

1.  //软输入区域是否可见。
2.  publicstaticfinalint SOFT\_INPUT\_MASK\_STATE = 0x0f; 
3.  
4.  //未指定状态。
5.  publicstaticfinalint SOFT\_INPUT\_STATE\_UNSPECIFIED = 0; 
6.  
7.  //不要修改软输入法区域的状态。
8.  publicstaticfinalint SOFT\_INPUT\_STATE\_UNCHANGED = 1; 
9.  
10. //隐藏输入法区域（当用户进入窗口时）。
11. publicstaticfinalint SOFT\_INPUT\_STATE\_HIDDEN = 2; 
12. 
13. //当窗口获得焦点时，隐藏输入法区域。
14. publicstaticfinalint SOFT\_INPUT\_STATE\_ALWAYS\_HIDDEN = 3; 
15. 
16. //显示输入法区域（当用户进入窗口时）。
17. publicstaticfinalint SOFT\_INPUT\_STATE\_VISIBLE = 4; 
18. 
19. //当窗口获得焦点时，显示输入法区域。
20. publicstaticfinalint SOFT\_INPUT\_STATE\_ALWAYS\_VISIBLE = 5; 
21. 
22. //窗口应当主动调整，以适应软输入窗口。
23. publicstaticfinalint SOFT\_INPUT\_MASK\_ADJUST = 0xf0; 
24. 
25. //未指定状态，系统将根据窗口内容尝试选择一个输入法样式。
26. publicstaticfinalint SOFT\_INPUT\_ADJUST\_UNSPECIFIED = 0x00; 
27. 
28. //当输入法显示时，允许窗口重新计算尺寸，使内容不被输入法所覆盖。
29. //不可与SOFT\_INPUT\_ADJUSP\_PAN混合使用,如果两个都没有设置，系统将根据窗口内容自动设置一个选项。
30. publicstaticfinalint SOFT\_INPUT\_ADJUST\_RESIZE = 0x10; 
31. 
32. //输入法显示时平移窗口。它不需要处理尺寸变化，框架能够移动窗口以确保输入焦点可见。
33. //不可与SOFT\_INPUT\_ADJUST\_RESIZE混合使用;如果两个都没设置,系统将根据窗口内容自动设置一个选项。
34. publicstaticfinalint SOFT\_INPUT\_ADJUST\_PAN = 0x20; 
35. 
36. //当用户转至此窗口时，由系统自动设置，所以你不要设置它。
37. //当窗口显示之后该标志自动清除。
38. publicstaticfinalint SOFT\_INPUT\_IS\_FORWARD\_NAVIGATION = 0x100;

8. public int gravity;  
 gravity 属性。什么是gravity属性呢？简单地说，就是窗口如何停靠。  
  
 9. public float horizontalMargin;  
 水平边距，容器与widget之间的距离，占容器宽度的百分率。  
  
 10. public float verticalMargin;  
 纵向边距。  
  
 11. public int format;  
 期望的位图格式。默认为不透明。参考android.graphics.PixelFormat。  
  
 12. public int windowAnimations;  
 窗口所使用的动画设置。它必须是一个系统资源而不是应用程序资源，因为窗口管理器不能访问应用程序。  
  
 13. public float alpha = 1.0f;  
 整个窗口的半透明值，1.0表示不透明，0.0表示全透明。  
  
 14. public float dimAmount = 1.0f;  
 当FLAG\_DIM\_BEHIND设置后生效。该变量指示后面的窗口变暗的程度。  
 1.0表示完全不透明，0.0表示没有变暗。  
  
 15. public float screenBrightness = -1.0f;  
 用来覆盖用户设置的屏幕亮度。表示应用用户设置的屏幕亮度。  
 从0到1调整亮度从暗到最亮发生变化。  
  
 16. public IBinder token = null;  
 窗口的标示符。( Identifier for this window. This will usually be filled in for you. )  
  
 17. public String packageName = null;  
 此窗口所在的包名。  
  
 18. public int screenOrientation =ActivityInfo.SCREEN\_ORIENTATION\_UNSPECIFIED;  
 屏幕方向，参见android.content.pm.ActivityInfo\#screenOrientation。  
  
 19. 在兼容模式下，备份/恢复参数所使用的内部缓冲区。  
 public int\[\] mCompatibilityParamsBackup = null;

[view plain]: http://blog.csdn.net/listening_music/article/details/7169330#