Android的Window类

Android的Window类(一)Android的GUI层并不复杂。它的复杂度类似于WGUI这类基于布局和对话框的GUI,与MFC、QT等大型框架没有可比性,甚至飞漫魏永明的MiniGUI都比它复杂许多。您也许会问,这样简单的GUI如何实现浏览器呢?原因很简单,浏览器有自己一套GUI。Android浏览器(WebKit)的GUI和Android的GUI实用同一套GDI——Skia,但GUI层是完全不同的设计,分别自成体系。

Windown类,位于代码树frameworks\base\core\java\android\view\Windowjava.java文件。连同注释,这个文件总共一千多行,它概括了Android窗口的基本属性和基本功能。

Window属性列举如下:

FEATURE_OPTIONS_PANEL=0;功能不明,参见后面的说明(默认使能)

FEATURE_NO_TITLE=1;无标题栏

FEATURE_PROGRESS=2;在标题栏上显示加载进度,例如webview加载网页时(条状进度条)

FEATURE_LEFT_ICON=3;在标题栏左侧显示一个图标

FEATURE_RIGHT_ICON=4;在标题栏右侧显示一个图标

FEATURE_INDETERMINATE_PROGRESS=5;不确定的进度(圆圈状等待图标)

FEATURE_CONTEXT_MENU=6;上下文菜单,相当于PC上的右键菜单(默认使能)

FEATURE_CUSTOM_TITLE=7;自定义标题栏,该属性不能与其他标题栏属性合用

FEATURE_OPENGL=8;如果开启OpenGL,那么2D将由OpenGL处理(OpenGL中2D是3D的子集)

PROGRESS_VISIBILITY_ON=-1;进度条可见

PROGRESS_VISIBILITY_OFF=-2;进度条不可见

PROGRESS_INDETERMINATE_ON=-3;开启不确定模式

PROGRESS_INDETERMINATE_OFF=-4;关闭不确定模式

PROGRESS_START=0;第一进度条的最小值

PROGRESS_END=10000;第一进度条的最大值

PROGRESS_SECONDARY_START=20000;第二进度条的最小值

PROGRESS_SECONDARY_END=30000;第二进度条的最大值

*说明:FEATURE_OPTIONS_PANEL的意思大概是:当用户选中菜单时,窗口将调用onOptionsItemSelected函数,以处理菜单功能。如果没有FEATURE_OPTIONS_PANEL选项,那么菜单就不响应了?没试过,网上也没找到。

应用示例:

1、隐藏标题栏

requestWindowFeature(Window.FEATURE_NO_TITLE);

2、在标题栏显示进度条

requestWindowFeature(Window.FEATURE_PROGRESS);

setContentView(R.layout.progressbar_1);

setProgressBarVisibility(true);

finalProgressBarprogressHorizontal=(ProgressBar)findViewById(R.id.progress_horizontal);

setProgress(progressHorizontal.getProgress()*100);

setSecondaryProgress(progressHorizontal.getSecondaryProgress()*100);

3、使用自定义标题栏

requestWindowFeature(Window.FEATURE_CUSTOM_TITLE);

setContentView(R.layout.xxx);

getWindow().setFeatureInt(Window.FEATURE_CUSTOM_TITLE,R.layout.my_title_bar);

4、清除标题栏内容,而区域保留

((ViewGroup)getWindow().findViewById(com.android.internal.R.id.title_container)).removeAllViews();

5、隐藏标题栏

((ViewGroup)getWindow().

findViewById(com.android.internal.R.id.title_container)).setVisibility(View.GONE);

6、显示标题栏

...setVisibility(View.VISIBLE);

其他注意事项

(1)requestWindowFeature()要在setContentView()之前调用;

(2)设置各种Feature,是具有排它性的,一旦设置,后续不可更改为别的类型;

(3)当使用TabHost(由ActivityGroup派生)时,各个Tab里的Activity,要么都是NO_TITLE,要么都是CUSTOM_TITLE,无法分别进行设置。、

Android的Window类(二)

Window类除去一大堆FEATURE_属性之外,剩下的内容无外乎两大部分:

一、定义Callback接口,它包含一系列dispatchXxxx函数和一系列onXxxx函数,用于处理UI事件;

二、定义了自己的WindowManager——LocalWindowManager。主要修改了addView函数,设置title。

Callback接口包含以下函数:

publicbooleandispatchKeyEvent(KeyEventevent);

处理Key事件。至少,你的代码要调用superDispatchKeyEvent函数。

publicbooleandispatchTouchEvent(MotionEventevent);

处理touch事件。至少,你的代码要调用superDispatchTouchEvent函数。

publicbooleandispatchTrackballEvent(MotionEventevent);

处理trackball事件。至少,你的代码要调用superDispatchTrackballEvent函数。

publicbooleandispatchPopulateAccessibilityEvent(AccessibilityEventevent);

处理Accessibility事件(辅助事件,如焦点变化,按钮被点击等),处理完成后返回true。

创建显示panel的view

可返回null,将为你创建默认content(通常是一个menu)。

应返回放置panel的顶层view。

publicViewonCreatePanelView(intfeatureId);

初始化panel菜单,如果onCreatePanelView函数返回null将调用此函数,创建一个标准菜单,你可以向它添加菜单项。只有当panel第一次显示时方调用此函数。如果返回false,panel将无法显示。

publicbooleanonCreatePanelMenu(intfeatureId,Menumenu);

每次panel窗口显示前,都会调用此函数。应当返回true,如果返回false将不显示。

publicbooleanonPreparePanel(intfeatureId,Viewview,Menumenu);

当用户打开panel的菜单时被调用。当菜单样式切换时也会调用。例如,从图标菜单切换至扩展菜单。

返回true允许菜单打开,返回false阻止菜单打开。

publicbooleanonMenuOpened(intfeatureId,Menumenu);

用户选择菜单项。

publicbooleanonMenuItemSelected(intfeatureId,MenuItemitem);

当前窗口属性改变。

publicvoidonWindowAttributesChanged(WindowManager.LayoutParamsattrs);

窗口的view发生改变。

publicvoidonContentChanged();

窗口焦点变化。

publicvoidonWindowFocusChanged(booleanhasFocus);

窗口附加到窗口管理器上。

publicvoidonAttachedToWindow();

窗口从窗口管理器上摘除。

publicvoidonDetachedFromWindow();

panel关闭时被调用。

如果一个后续的panel将展开(此panel为后续panel腾出空间),则不会调用此函数。

publicvoidonPanelClosed(intfeatureId,Menumenu);

当用户按下了search按钮。

如果启动了搜索界面则返回true,如果不能执行则返回false。

publicbooleanonSearchRequested();

WindowManager干什么?它并不是什么“窗口管理器”,WindowManagerService才是窗口管理器。名字叫的玄乎,而实际上WindowManager主要管理一堆状态字,而这些状态字里,最常用的就是LayoutParams。

派生关系如下:

ViewManager

|

---->WindowManager

ViewManager只有三个函数:addView,updateViewLayout,removeView。

而WindowManager的LayoutParams子类内容十分丰富。其实WindowManager.java的主要内容就是由这个类定义构成。它的定义如下:

publicstaticclassLayoutParamsextendsViewGroup.LayoutParamsimplementsParcelable

派生关系如下:

ViewManager.LayoutParams

|

---->WindowManager.LayoutParams

ViewManager的LayoutParams主要有两个宏,两个变量。

两个宏:

FILL_PARENT

WRAP_CONTENT

两个变量:

width

height

Android的Window类(三)

WindowManager的LayoutParams子类,可用“内容丰富”一词形容。

如果忽略gravity属性,那么它表示窗口的绝对X位置。

什么是gravity属性呢?简单地说,就是窗口如何停靠。

当设置了Gravity.LEFT或Gravity.RIGHT之后,x值就表示到特定边的距离。

publicintx;

如果忽略gravity属性,那么它表示窗口的绝对Y位置。

当设置了Gravity.TOP或Gravity.BOTTOM之后,y值就表示到特定边的距离。

publicinty;

在纵向上,为关联的view预留了多少扩展空间(像素)。如果是0,那么此view不能被拉伸。

其他情况下,扩展空间(像素)将被widget所均分。

publicfloathorizontalWeight;

publicfloatverticalWeight;

窗口类型。有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之间。

用于特定的系统功能。它不能用于应用程序,使用时需要特殊权限。

publicinttype;

下面定义了type的取值:

应用程序窗口。

publicstaticfinalintFIRST_APPLICATION_WINDOW=1;

所有程序窗口的“基地”窗口,其他应用程序窗口都显示在它上面。

publicstaticfinalintTYPE_BASE_APPLICATION=1;

普通应哟功能程序窗口。token必须设置为Activity的token,以指出该窗口属谁。

publicstaticfinalintTYPE_APPLICATION=2;

用于应用程序启动时所显示的窗口。应用本身不要使用这种类型。

它用于让系统显示些信息,直到应用程序可以开启自己的窗口。

publicstaticfinalintTYPE_APPLICATION_STARTING=3;

应用程序窗口结束。

publicstaticfinalintLAST_APPLICATION_WINDOW=99;

子窗口。子窗口的Z序和坐标空间都依赖于他们的宿主窗口。

publicstaticfinalintFIRST_SUB_WINDOW=1000;

面板窗口,显示于宿主窗口上层。

publicstaticfinalintTYPE_APPLICATION_PANEL=FIRST_SUB_WINDOW;

媒体窗口,例如视频。显示于宿主窗口下层。

publicstaticfinalintTYPE_APPLICATION_MEDIA=FIRST_SUB_WINDOW+1;

应用程序窗口的子面板。显示于所有面板窗口的上层。(GUI的一般规律,越“子”越靠上)

publicstaticfinalintTYPE_APPLICATION_SUB_PANEL=FIRST_SUB_WINDOW+2;

对话框。类似于面板窗口,绘制类似于顶层窗口,而不是宿主的子窗口。

publicstaticfinalintTYPE_APPLICATION_ATTACHED_DIALOG=FIRST_SUB_WINDOW+3;

媒体信息。显示在媒体层和程序窗口之间,需要实现透明(半透明)效果。(例如显示字幕)

publicstaticfinalintTYPE_APPLICATION_MEDIA_OVERLAY=FIRST_SUB_WINDOW+4;

子窗口结束。

publicstaticfinalintLAST_SUB_WINDOW=1999;

系统窗口。非应用程序创建。

publicstaticfinalintFIRST_SYSTEM_WINDOW=2000;

状态栏。只能有一个状态栏;它位于屏幕顶端,其他窗口都位于它下方。

publicstaticfinalintTYPE_STATUS_BAR=FIRST_SYSTEM_WINDOW;

搜索栏。只能有一个搜索栏;它位于屏幕上方。

publicstaticfinalintTYPE_SEARCH_BAR=FIRST_SYSTEM_WINDOW+1;

电话窗口。它用于电话交互(特别是呼入)。它置于所有应用程序之上,状态栏之下。

publicstaticfinalintTYPE_PHONE=FIRST_SYSTEM_WINDOW+2;

系统提示。它总是出现在应用程序窗口之上。

publicstaticfinalintTYPE_SYSTEM_ALERT=FIRST_SYSTEM_WINDOW+3;

锁屏窗口。

publicstaticfinalintTYPE_KEYGUARD=FIRST_SYSTEM_WINDOW+4;

信息窗口。用于显示toast。

publicstaticfinalintTYPE_TOAST=FIRST_SYSTEM_WINDOW+5;

系统顶层窗口。显示在其他一切内容之上。此窗口不能获得输入焦点,否则影响锁屏。

publicstaticfinalintTYPE_SYSTEM_OVERLAY=FIRST_SYSTEM_WINDOW+6;

电话优先,当锁屏时显示。此窗口不能获得输入焦点,否则影响锁屏。

publicstaticfinalintTYPE_PRIORITY_PHONE=FIRST_SYSTEM_WINDOW+7;

系统对话框。(例如音量调节框)。

publicstaticfinalintTYPE_SYSTEM_DIALOG=FIRST_SYSTEM_WINDOW+8;

锁屏时显示的对话框。

publicstaticfinalintTYPE_KEYGUARD_DIALOG=FIRST_SYSTEM_WINDOW+9;

系统内部错误提示,显示于所有内容之上。

publicstaticfinalintTYPE_SYSTEM_ERROR=FIRST_SYSTEM_WINDOW+10;

内部输入法窗口,显示于普通UI之上。应用程序可重新布局以免被此窗口覆盖。

publicstaticfinalintTYPE_INPUT_METHOD=FIRST_SYSTEM_WINDOW+11;

内部输入法对话框,显示于当前输入法窗口之上。

publicstaticfinalintTYPE_INPUT_METHOD_DIALOG=FIRST_SYSTEM_WINDOW+12;

墙纸窗口。

publicstaticfinalintTYPE_WALLPAPER=FIRST_SYSTEM_WINDOW+13;

状态栏的滑动面板。

publicstaticfinalintTYPE_STATUS_BAR_PANEL=FIRST_SYSTEM_WINDOW+14;

系统窗口结束。

publicstaticfinalintLAST_SYSTEM_WINDOW=2999;

指出窗口所使用的内存缓冲类型。默认为NORMAL。

publicintmemoryType;

窗口缓冲位于主内存。

publicstaticfinalintMEMORY_TYPE_NORMAL=0;

窗口缓冲位于可以被DMA访问,或者硬件加速的内存区域。

publicstaticfinalintMEMORY_TYPE_HARDWARE=1;

窗口缓冲位于可被图形加速器访问的区域。

publicstaticfinalintMEMORY_TYPE_GPU=2;

窗口缓冲不拥有自己的缓冲区,不能被锁定。缓冲区由本地方法提供。

publicstaticfinalintMEMORY_TYPE_PUSH_BUFFERS=3;

行为选项/旗标,默认为none

publicintflags;

窗口之后的内容变暗。

publicstaticfinalintFLAG_DIM_BEHIND=0x00000002;

窗口之后的内容变模糊。

publicstaticfinalintFLAG_BLUR_BEHIND=0x00000004;

不许获得焦点。

不能获得按键输入焦点,所以不能向它发送按键或按钮事件。那些时间将发送给它后面的可以获得焦点的窗口。此选项还会设置FLAG_NOT_TOUCH_MODAL选项。设置此选项,意味着窗口不能与软输入法进行交互,所以它的Z序独立于任何活动的输入法(换句话说,它可以全屏显示,如果需要的话,可覆盖输入法窗口)。要修改这一行为,可参考FLAG_ALT_FOCUSALBE_IM选项。

publicstaticfinalintFLAG_NOT_FOCUSABLE=0x00000008;

不接受触摸屏事件。

publicstaticfinalintFLAG_NOT_TOUCHABLE=0x00000010;

当窗口可以获得焦点(没有设置FLAG_NOT_FOCUSALBE选项)时,仍然将窗口范围之外的点设备事件(鼠标、触摸屏)发送给后面的窗口处理。否则它将独占所有的点设备事件,而不管它们是不是发生在窗口范围之内。

publicstaticfinalintFLAG_NOT_TOUCH_MODAL=0x00000020;

如果设置了这个标志,当设备休眠时,点击触摸屏,设备将收到这个第一触摸事件。

通常第一触摸事件被系统所消耗,用户不会看到他们点击屏幕有什么反应。

publicstaticfinalintFLAG_TOUCHABLE_WHEN_WAKING=0x00000040;

当此窗口为用户可见时,保持设备常开,并保持亮度不变。

publicstaticfinalintFLAG_KEEP_SCREEN_ON=0x00000080;

窗口占满整个屏幕,忽略周围的装饰边框(例如状态栏)。此窗口需考虑到装饰边框的内容。

publicstaticfinalintFLAG_LAYOUT_IN_SCREEN=0x00000100;

允许窗口扩展到屏幕之外。

publicstaticfinalintFLAG_LAYOUT_NO_LIMITS=0x00000200;

窗口显示时,隐藏所有的屏幕装饰(例如状态条)。使窗口占用整个显示区域。

publicstaticfinalintFLAG_FULLSCREEN=0x00000400;

此选项将覆盖FLAG_FULLSCREEN选项,并强制屏幕装饰(如状态条)弹出。

publicstaticfinalintFLAG_FORCE_NOT_FULLSCREEN=0x00000800;

抖动。指的是对半透明的显示方法。又称“点透”。图形处理较差的设备往往用“点透”替代Alpha混合。

publicstaticfinalintFLAG_DITHER=0x00001000;

不允许屏幕截图。

publicstaticfinalintFLAG_SECURE=0x00002000;

一种特殊模式,布局参数用于指示显示比例。

publicstaticfinalintFLAG_SCALED=0x00004000;

当屏幕有可能贴着脸时,这一选项可防止面颊对屏幕造成误操作。

publicstaticfinalintFLAG_IGNORE_CHEEK_PRESSES=0x00008000;

当请求布局时,你的窗口可能出现在状态栏的上面或下面,从而造成遮挡。当设置这一选项后,窗口管理器将确保窗口内容不会被装饰条(状态栏)盖住。

publicstaticfinalintFLAG_LAYOUT_INSET_DECOR=0x00010000;

反转FLAG_NOT_FOCUSABLE选项。

如果同时设置了FLAG_NOT_FOCUSABLE选项和本选项,窗口将能够与输入法交互,允许输入法窗口覆盖;

如果FLAG_NOT_FOCUSABLE没有设置而设置了本选项,窗口不能与输入法交互,可以覆盖输入法窗口。

publicstaticfinalintFLAG_ALT_FOCUSABLE_IM=0x00020000;

如果你设置了FLAG_NOT_TOUCH_MODAL,那么当触屏事件发生在窗口之外事,可以通过设置此标志接收到一个MotionEvent.ACTION_OUTSIDE事件。注意,你不会收到完整的down/move/up事件,只有第一次down事件时可以收到ACTION_OUTSIDE。

publicstaticfinalintFLAG_WATCH_OUTSIDE_TOUCH=0x00040000;

当屏幕锁定时,窗口可以被看到。这使得应用程序窗口优先于锁屏界面。可配合FLAG_KEEP_SCREEN_ON选项点亮屏幕并直接显示在锁屏界面之前。可使用FLAG_DISMISS_KEYGUARD选项直接解除非加锁的锁屏状态。此选项只用于最顶层的全屏幕窗口。

publicstaticfinalintFLAG_SHOW_WHEN_LOCKED=0x00080000;

请求系统墙纸显示在你的窗口后面。窗口必须是半透明的。

publicstaticfinalintFLAG_SHOW_WALLPAPER=0x00100000;

窗口一旦显示出来,系统将点亮屏幕,正如用户唤醒设备那样。

publicstaticfinalintFLAG_TURN_SCREEN_ON=0x00200000;

解除锁屏。只有锁屏界面不是加密的才能解锁。如果锁屏界面是加密的,那么用户解锁之后才能看到此窗口,除非设置了FLAG_SHOW_WHEN_LOCKED选项。

publicstaticfinalintFLAG_DISMISS_KEYGUARD=0x00400000;

锁屏界面淡出时,继续运行它的动画。

publicstaticfinalintFLAG_KEEP_SURFACE_WHILE_ANIMATING=0x10000000;

以原始尺寸显示窗口。用于在兼容模式下运行程序。

publicstaticfinalintFLAG_COMPATIBLE_WINDOW=0x20000000;

用于系统对话框。设置此选项的窗口将无条件获得焦点。

publicstaticfinalintFLAG_SYSTEM_ERROR=0x40000000;

软输入法模式选项:

publicintsoftInputMode;

以下选项与输入法模式有关:

软输入区域是否可见。

publicstaticfinalintSOFT_INPUT_MASK_STATE=0x0f;

未指定状态。

publicstaticfinalintSOFT_INPUT_STATE_UNSPECIFIED=0;

不要修改软输入法区域的状态。

publicstaticfinalintSOFT_INPUT_STATE_UNCHANGED=1;

隐藏输入法区域(当用户进入窗口时)。

publicstaticfinalintSOFT_INPUT_STATE_HIDDEN=2;

当窗口获得焦点时,隐藏输入法区域。

publicstaticfinalintSOFT_INPUT_STATE_ALWAYS_HIDDEN=3;

显示输入法区域(当用户进入窗口时)。

publicstaticfinalintSOFT_INPUT_STATE_VISIBLE=4;

当窗口获得焦点时,显示输入法区域。

publicstaticfinalintSOFT_INPUT_STATE_ALWAYS_VISIBLE=5;

窗口应当主动调整,以适应软输入窗口。

publicstaticfinalintSOFT_INPUT_MASK_ADJUST=0xf0;

未指定状态,系统将根据窗口内容尝试选择一个输入法样式。

publicstaticfinalintSOFT_INPUT_ADJUST_UNSPECIFIED=0x00;

当输入法显示时,允许窗口重新计算尺寸,使内容不被输入法所覆盖。

不可与SOFT_INPUT_ADJUSP_PAN混合使用;如果两个都没有设置,系统将根据窗口内容自动设置一个选项。

publicstaticfinalintSOFT_INPUT_ADJUST_RESIZE=0x10;

输入法显示时平移窗口。它不需要处理尺寸变化,框架能够移动窗口以确保输入焦点可见。

不可与SOFT_INPUT_ADJUST_RESIZE混合使用;如果两个都没有设置,系统将根据窗口内容自动设置一个选项。

publicstaticfinalintSOFT_INPUT_ADJUST_PAN=0x20;

当用户转至此窗口时,由系统自动设置,所以你不要设置它。

当窗口显示之后该标志自动清除。

publicstaticfinalintSOFT_INPUT_IS_FORWARD_NAVIGATION=0x100;

Gravity设置

publicintgravity;

水平边距,容器与widget之间的距离,占容器宽度的百分率。

publicfloathorizontalMargin;

纵向边距。

publicfloatverticalMargin;

期望的位图格式。默认为不透明。参考android.graphics.PixelFormat。

publicintformat;

窗口所使用的动画设置。它必须是一个系统资源而不是应用程序资源,因为窗口管理器不能访问应用程序。

publicintwindowAnimations;

整个窗口的半透明值,1.0表示不透明,0.0表示全透明。

publicfloatalpha=1.0f;

当FLAG_DIM_BEHIND设置后生效。该变量指示后面的窗口变暗的程度。

1.0表示完全不透明,0.0表示没有变暗。

publicfloatdimAmount=1.0f;

用来覆盖用户设置的屏幕亮度。表示应用用户设置的屏幕亮度。

从0到1调整亮度从暗到最亮发生变化。

publicfloatscreenBrightness=-1.0f;

窗口的标示符。

publicIBindertoken=null;

此窗口所在的包名。

publicStringpackageName=null;

屏幕方向,参见android.content.pm.ActivityInfo#screenOrientation。

publicintscreenOrientation=ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED;

下面定义了各种“CHANGE”信息,为copyFrom函数所使用。

publicstaticfinalintLAYOUT_CHANGED=1<<0;

publicstaticfinalintTYPE_CHANGED=1<<1;

publicstaticfinalintFLAGS_CHANGED=1<<2;

publicstaticfinalintFORMAT_CHANGED=1<<3;

publicstaticfinalintANIMATION_CHANGED=1<<4;

publicstaticfinalintDIM_AMOUNT_CHANGED=1<<5;

publicstaticfinalintTITLE_CHANGED=1<<6;

publicstaticfinalintALPHA_CHANGED=1<<7;

publicstaticfinalintMEMORY_TYPE_CHANGED=1<<8;

publicstaticfinalintSOFT_INPUT_MODE_CHANGED=1<<9;

publicstaticfinalintSCREEN_ORIENTATION_CHANGED=1<<10;

publicstaticfinalintSCREEN_BRIGHTNESS_CHANGED=1<<11;

在兼容模式下,备份/恢复参数所使用的内部缓冲区。

privateint[]mCompatibilityParamsBackup=null;

相关推荐