轉自: http://elsila.blog.163.com/blog/static/173197158201101913332356/
Android的Window類
預設分類 2011-01-19 13:33:32 閱讀204 評論0 字号:大中小 訂閱
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);
final ProgressBar progressHorizontal = (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接口包含以下函數:
public boolean dispatchKeyEvent(KeyEventevent);
處理Key事件。至少,你的代碼要調用superDispatchKeyEvent函數。
public booleandispatchTouchEvent(MotionEvent event);
處理touch事件。至少,你的代碼要調用superDispatchTouchEvent函數。
public booleandispatchTrackballEvent(MotionEvent event);
處理trackball事件。至少,你的代碼要調用superDispatchTrackballEvent函數。
public booleandispatchPopulateAccessibilityEvent(AccessibilityEventevent);
處理Accessibility事件(輔助事件,如焦點變化,按鈕被點選等),處理完成後傳回true。
建立顯示panel的view
可傳回null,将為你建立預設content(通常是一個menu)。
應傳回放置panel的頂層view。
public View onCreatePanelView(intfeatureId);
初始化panel菜單,如果onCreatePanelView函數傳回null将調用此函數,建立一個标準菜單,你可以向它添加菜單項。隻有當panel第一次顯示時方調用此函數。如果傳回false,panel将無法顯示。
public boolean onCreatePanelMenu(intfeatureId, Menu menu);
每次panel視窗顯示前,都會調用此函數。應當傳回true,如果傳回false将不顯示。
public boolean onPreparePanel(intfeatureId, View view, Menu menu);
當使用者打開panel的菜單時被調用。當菜單樣式切換時也會調用。例如,從圖示菜單切換至擴充菜單。
傳回true允許菜單打開,傳回false阻止菜單打開。
public boolean onMenuOpened(intfeatureId, Menu menu);
使用者選擇菜單項。
public boolean onMenuItemSelected(intfeatureId, MenuItem item);
目前視窗屬性改變。
public voidonWindowAttributesChanged(WindowManager.LayoutParamsattrs);
視窗的view發生改變。
public voidonContentChanged();
視窗焦點變化。
public void onWindowFocusChanged(booleanhasFocus);
視窗附加到視窗管理器上。
public voidonAttachedToWindow();
視窗從視窗管理器上摘除。
public voidonDetachedFromWindow();
panel關閉時被調用。
如果一個後續的panel将展開(此panel為後續panel騰出空間),則不會調用此函數。
public void onPanelClosed(int featureId,Menu menu);
當使用者按下了search按鈕。
如果啟動了搜尋界面則傳回true,如果不能執行則傳回false。
public booleanonSearchRequested();
WindowManager幹什麼?它并不是什麼“視窗管理器”,WindowManagerService才是視窗管理器。名字叫的玄乎,而實際上WindowManager主要管理一堆狀态字,而這些狀态字裡,最常用的就是LayoutParams。
派生關系如下:
ViewManager
|
---- >WindowManager
ViewManager隻有三個函數:addView,updateViewLayout,removeView。
而WindowManager的LayoutParams子類内容十分豐富。其實WindowManager.java的主要内容就是由這個類定義構成。它的定義如下:
public static class LayoutParams extendsViewGroup.LayoutParams implementsParcelable
派生關系如下:
ViewManager.LayoutParams
|
---- >WindowManager.LayoutParams
ViewManager的LayoutParams主要有兩個宏,兩個變量。
兩個宏:
FILL_PARENT
WRAP_CONTENT
兩個變量:
width
height
WindowManager的LayoutParams就比較豐富了,咱們下回分解。
Android的Window類(三)
WindowManager的LayoutParams子類,可用“内容豐富”一詞形容。
如果忽略gravity屬性,那麼它表示視窗的絕對X位置。
什麼是gravity屬性呢?簡單地說,就是視窗如何停靠。
當設定了Gravity.LEFT或Gravity.RIGHT之後,x值就表示到特定邊的距離。
public intx;
如果忽略gravity屬性,那麼它表示視窗的絕對Y位置。
當設定了Gravity.TOP或Gravity.BOTTOM之後,y值就表示到特定邊的距離。
public inty;
在縱向上,為關聯的view預留了多少擴充空間(像素)。如果是0,那麼此view不能被拉伸。
其他情況下,擴充空間(像素)将被widget所均分。
public floathorizontalWeight;
public floatverticalWeight;
視窗類型。有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 之間。
用于特定的系統功能。它不能用于應用程式,使用時需要特殊權限。
public inttype;
下面定義了type的取值:
應用程式視窗。
public staticfinal int FIRST_APPLICATION_WINDOW = 1;
所有程式視窗的“基地”視窗,其他應用程式視窗都顯示在它上面。
public staticfinal int TYPE_BASE_APPLICATION =1;
普通應喲功能程式視窗。token必須設定為Activity的token,以指出該視窗屬誰。
public staticfinal int TYPE_APPLICATION = 2;
用于應用程式啟動時所顯示的視窗。應用本身不要使用這種類型。
它用于讓系統顯示些資訊,直到應用程式可以開啟自己的視窗。
public staticfinal int TYPE_APPLICATION_STARTING = 3;
應用程式視窗結束。
public staticfinal int LAST_APPLICATION_WINDOW = 99;
子視窗。子視窗的Z序和坐标空間都依賴于他們的宿主視窗。
public staticfinal int FIRST_SUB_WINDOW = 1000;
面闆視窗,顯示于宿主視窗上層。
public staticfinal int TYPE_APPLICATION_PANEL =FIRST_SUB_WINDOW;
媒體視窗,例如視訊。顯示于宿主視窗下層。
public staticfinal int TYPE_APPLICATION_MEDIA =FIRST_SUB_WINDOW+1;
應用程式視窗的子面闆。顯示于所有面闆視窗的上層。(GUI的一般規律,越“子”越靠上)
public staticfinal int TYPE_APPLICATION_SUB_PANEL =FIRST_SUB_WINDOW+2;
對話框。類似于面闆視窗,繪制類似于頂層視窗,而不是宿主的子視窗。
public staticfinal int TYPE_APPLICATION_ATTACHED_DIALOG =FIRST_SUB_WINDOW+3;
媒體資訊。顯示在媒體層和程式視窗之間,需要實作透明(半透明)效果。(例如顯示字幕)
public staticfinal int TYPE_APPLICATION_MEDIA_OVERLAY =FIRST_SUB_WINDOW+4;
子視窗結束。
public staticfinal int LAST_SUB_WINDOW = 1999;
系統視窗。非應用程式建立。
public staticfinal int FIRST_SYSTEM_WINDOW = 2000;
狀态欄。隻能有一個狀态欄;它位于螢幕頂端,其他視窗都位于它下方。
public staticfinal int TYPE_STATUS_BAR =FIRST_SYSTEM_WINDOW;
搜尋欄。隻能有一個搜尋欄;它位于螢幕上方。
public staticfinal int TYPE_SEARCH_BAR =FIRST_SYSTEM_WINDOW+1;
電話視窗。它用于電話互動(特别是呼入)。它置于所有應用程式之上,狀态欄之下。
public staticfinal int TYPE_PHONE =FIRST_SYSTEM_WINDOW+2;
系統提示。它總是出現在應用程式視窗之上。
public staticfinal int TYPE_SYSTEM_ALERT = FIRST_SYSTEM_WINDOW+3;
鎖屏視窗。
public staticfinal int TYPE_KEYGUARD =FIRST_SYSTEM_WINDOW+4;
資訊視窗。用于顯示toast。
public staticfinal int TYPE_TOAST =FIRST_SYSTEM_WINDOW+5;
系統頂層視窗。顯示在其他一切内容之上。此視窗不能獲得輸入焦點,否則影響鎖屏。
public staticfinal int TYPE_SYSTEM_OVERLAY = FIRST_SYSTEM_WINDOW+6;
電話優先,當鎖屏時顯示。此視窗不能獲得輸入焦點,否則影響鎖屏。
public staticfinal int TYPE_PRIORITY_PHONE = FIRST_SYSTEM_WINDOW+7;
系統對話框。(例如音量調節框)。
public staticfinal int TYPE_SYSTEM_DIALOG = FIRST_SYSTEM_WINDOW+8;
鎖屏時顯示的對話框。
public staticfinal int TYPE_KEYGUARD_DIALOG = FIRST_SYSTEM_WINDOW+9;
系統内部錯誤提示,顯示于所有内容之上。
public staticfinal int TYPE_SYSTEM_ERROR = FIRST_SYSTEM_WINDOW+10;
内部輸入法視窗,顯示于普通UI之上。應用程式可重新布局以免被此視窗覆寫。
public staticfinal int TYPE_INPUT_METHOD = FIRST_SYSTEM_WINDOW+11;
内部輸入法對話框,顯示于目前輸入法視窗之上。
public staticfinal int TYPE_INPUT_METHOD_DIALOG=FIRST_SYSTEM_WINDOW+12;
牆紙視窗。
public staticfinal int TYPE_WALLPAPER =FIRST_SYSTEM_WINDOW+13;
狀态欄的滑動面闆。
public staticfinal int TYPE_STATUS_BAR_PANEL =FIRST_SYSTEM_WINDOW+14;
系統視窗結束。
public staticfinal int LAST_SYSTEM_WINDOW = 2999;
指出視窗所使用的記憶體緩沖類型。預設為NORMAL。
public intmemoryType;
視窗緩沖位于主記憶體。
public staticfinal int MEMORY_TYPE_NORMAL = 0;
視窗緩沖位于可以被DMA通路,或者硬體加速的記憶體區域。
public staticfinal int MEMORY_TYPE_HARDWARE = 1;
視窗緩沖位于可被圖形加速器通路的區域。
public staticfinal int MEMORY_TYPE_GPU = 2;
視窗緩沖不擁有自己的緩沖區,不能被鎖定。緩沖區由本地方法提供。
public staticfinal int MEMORY_TYPE_PUSH_BUFFERS = 3;
行為選項/旗标,預設為none
public intflags;
視窗之後的内容變暗。
public staticfinal int FLAG_DIM_BEHIND = 0x00000002;
視窗之後的内容變模糊。
public staticfinal int FLAG_BLUR_BEHIND = 0x00000004;
不許獲得焦點。
不能獲得按鍵輸入焦點,是以不能向它發送按鍵或按鈕事件。那些時間将發送給它後面的可以獲得焦點的視窗。此選項還會設定FLAG_NOT_TOUCH_MODAL選項。設定此選項,意味着視窗不能與軟輸入法進行互動,是以它的Z序獨立于任何活動的輸入法(換句話說,它可以全屏顯示,如果需要的話,可覆寫輸入法視窗)。要修改這一行為,可參考FLAG_ALT_FOCUSALBE_IM選項。
public staticfinal int FLAG_NOT_FOCUSABLE = 0x00000008;
不接受觸摸屏事件。
public staticfinal int FLAG_NOT_TOUCHABLE = 0x00000010;
當視窗可以獲得焦點(沒有設定FLAG_NOT_FOCUSALBE選項)時,仍然将視窗範圍之外的點裝置事件(滑鼠、觸摸屏)發送給後面的視窗處理。否則它将獨占所有的點裝置事件,而不管它們是不是發生在視窗範圍之内。
public staticfinal int FLAG_NOT_TOUCH_MODAL = 0x00000020;
如果設定了這個标志,當裝置休眠時,點選觸摸屏,裝置将收到這個第一觸摸事件。
通常第一觸摸事件被系統所消耗,使用者不會看到他們點選螢幕有什麼反應。
public staticfinal int FLAG_TOUCHABLE_WHEN_WAKING = 0x00000040;
當此視窗為使用者可見時,保持裝置常開,并保持亮度不變。
public staticfinal int FLAG_KEEP_SCREEN_ON = 0x00000080;
視窗占滿整個螢幕,忽略周圍的裝飾邊框(例如狀态欄)。此視窗需考慮到裝飾邊框的内容。
public staticfinal int FLAG_LAYOUT_IN_SCREEN =0x00000100;
允許視窗擴充到螢幕之外。
public staticfinal int FLAG_LAYOUT_NO_LIMITS =0x00000200;
視窗顯示時,隐藏所有的螢幕裝飾(例如狀态條)。使視窗占用整個顯示區域。
public staticfinal int FLAG_FULLSCREEN = 0x00000400;
此選項将覆寫FLAG_FULLSCREEN選項,并強制螢幕裝飾(如狀态條)彈出。
public staticfinal int FLAG_FORCE_NOT_FULLSCREEN =0x00000800;
抖動。指的是對半透明的顯示方法。又稱“點透”。圖形處理較差的裝置往往用“點透”替代Alpha混合。
public staticfinal int FLAG_DITHER = 0x00001000;
不允許螢幕截圖。
public staticfinal int FLAG_SECURE = 0x00002000;
一種特殊模式,布局參數用于訓示顯示比例。
public staticfinal int FLAG_SCALED = 0x00004000;
當螢幕有可能貼着臉時,這一選項可防止面頰對螢幕造成誤操作。
public staticfinal int FLAG_IGNORE_CHEEK_PRESSES = 0x00008000;
當請求布局時,你的視窗可能出現在狀态欄的上面或下面,進而造成遮擋。當設定這一選項後,視窗管理器将確定視窗内容不會被裝飾條(狀态欄)蓋住。
public staticfinal int FLAG_LAYOUT_INSET_DECOR = 0x00010000;
反轉FLAG_NOT_FOCUSABLE選項。
如果同時設定了FLAG_NOT_FOCUSABLE選項和本選項,視窗将能夠與輸入法互動,允許輸入法視窗覆寫;
如果FLAG_NOT_FOCUSABLE沒有設定而設定了本選項,視窗不能與輸入法互動,可以覆寫輸入法視窗。
public staticfinal int FLAG_ALT_FOCUSABLE_IM = 0x00020000;
如果你設定了FLAG_NOT_TOUCH_MODAL,那麼當觸屏事件發生在視窗之外事,可以通過設定此标志接收到一個MotionEvent.ACTION_OUTSIDE事件。注意,你不會收到完整的down/move/up事件,隻有第一次down事件時可以收到ACTION_OUTSIDE。
public staticfinal int FLAG_WATCH_OUTSIDE_TOUCH = 0x00040000;
當螢幕鎖定時,視窗可以被看到。這使得應用程式視窗優先于鎖屏界面。可配合FLAG_KEEP_SCREEN_ON選項點亮螢幕并直接顯示在鎖屏界面之前。可使用FLAG_DISMISS_KEYGUARD選項直接解除非加鎖的鎖屏狀态。此選項隻用于最頂層的全螢幕視窗。
public staticfinal int FLAG_SHOW_WHEN_LOCKED = 0x00080000;
請求系統牆紙顯示在你的視窗後面。視窗必須是半透明的。
public staticfinal int FLAG_SHOW_WALLPAPER = 0x00100000;
視窗一旦顯示出來,系統将點亮螢幕,正如使用者喚醒裝置那樣。
public staticfinal int FLAG_TURN_SCREEN_ON = 0x00200000;
解除鎖屏。隻有鎖屏界面不是加密的才能解鎖。如果鎖屏界面是加密的,那麼使用者解鎖之後才能看到此視窗,除非設定了FLAG_SHOW_WHEN_LOCKED選項。
public staticfinal int FLAG_DISMISS_KEYGUARD = 0x00400000;
鎖屏界面淡出時,繼續運作它的動畫。
public staticfinal int FLAG_KEEP_SURFACE_WHILE_ANIMATING =0x10000000;
以原始尺寸顯示視窗。用于在相容模式下運作程式。
public staticfinal int FLAG_COMPATIBLE_WINDOW = 0x20000000;
用于系統對話框。設定此選項的視窗将無條件獲得焦點。
public staticfinal int FLAG_SYSTEM_ERROR = 0x40000000;
軟輸入法模式選項:
public intsoftInputMode;
以下選項與輸入法模式有關:
軟輸入區域是否可見。
public staticfinal int SOFT_INPUT_MASK_STATE = 0x0f;
未指定狀态。
public staticfinal int SOFT_INPUT_STATE_UNSPECIFIED = 0;
不要修改軟輸入法區域的狀态。
public staticfinal int SOFT_INPUT_STATE_UNCHANGED = 1;
隐藏輸入法區域(當使用者進入視窗時)。
public staticfinal int SOFT_INPUT_STATE_HIDDEN = 2;
當視窗獲得焦點時,隐藏輸入法區域。
public staticfinal int SOFT_INPUT_STATE_ALWAYS_HIDDEN = 3;
顯示輸入法區域(當使用者進入視窗時)。
public staticfinal int SOFT_INPUT_STATE_VISIBLE = 4;
當視窗獲得焦點時,顯示輸入法區域。
public staticfinal int SOFT_INPUT_STATE_ALWAYS_VISIBLE = 5;
視窗應當主動調整,以适應軟輸入視窗。
public staticfinal int SOFT_INPUT_MASK_ADJUST = 0xf0;
未指定狀态,系統将根據視窗内容嘗試選擇一個輸入法樣式。
public staticfinal int SOFT_INPUT_ADJUST_UNSPECIFIED = 0x00;
當輸入法顯示時,允許視窗重新計算尺寸,使内容不被輸入法所覆寫。
不可與SOFT_INPUT_ADJUSP_PAN混合使用;如果兩個都沒有設定,系統将根據視窗内容自動設定一個選項。
public staticfinal int SOFT_INPUT_ADJUST_RESIZE = 0x10;
輸入法顯示時平移視窗。它不需要處理尺寸變化,架構能夠移動視窗以確定輸入焦點可見。
不可與SOFT_INPUT_ADJUST_RESIZE混合使用;如果兩個都沒有設定,系統将根據視窗内容自動設定一個選項。
public staticfinal int SOFT_INPUT_ADJUST_PAN = 0x20;
當使用者轉至此視窗時,由系統自動設定,是以你不要設定它。
當視窗顯示之後該标志自動清除。
public staticfinal int SOFT_INPUT_IS_FORWARD_NAVIGATION = 0x100;
Gravity設定
public intgravity;
水準邊距,容器與widget之間的距離,占容器寬度的百分率。
public floathorizontalMargin;
縱向邊距。
public floatverticalMargin;
期望的位圖格式。預設為不透明。參考android.graphics.PixelFormat。
public intformat;
視窗所使用的動畫設定。它必須是一個系統資源而不是應用程式資源,因為視窗管理器不能通路應用程式。
public intwindowAnimations;
整個視窗的半透明值,1.0表示不透明,0.0表示全透明。
public floatalpha = 1.0f;
當FLAG_DIM_BEHIND設定後生效。該變量訓示後面的視窗變暗的程度。
1.0表示完全不透明,0.0表示沒有變暗。
public floatdimAmount = 1.0f;
用來覆寫使用者設定的螢幕亮度。表示應用使用者設定的螢幕亮度。
從0到1調整亮度從暗到最亮發生變化。
public floatscreenBrightness = -1.0f;
視窗的标示符。
public IBindertoken = null;
此視窗所在的包名。
public StringpackageName = null;
螢幕方向,參見android.content.pm.ActivityInfo#screenOrientation。
public intscreenOrientation =ActivityInfo.SCREEN_ORIENTATION_UNSPECIFIED;
下面定義了各種“CHANGE”資訊,為copyFrom函數所使用。
public staticfinal int LAYOUT_CHANGED =1<<0;
public staticfinal int TYPE_CHANGED =1<<1;
public staticfinal int FLAGS_CHANGED =1<<2;
public staticfinal int FORMAT_CHANGED =1<<3;
public staticfinal int ANIMATION_CHANGED =1<<4;
public staticfinal int DIM_AMOUNT_CHANGED =1<<5;
public staticfinal int TITLE_CHANGED =1<<6;
public staticfinal int ALPHA_CHANGED =1<<7;
public staticfinal int MEMORY_TYPE_CHANGED =1<<8;
public staticfinal int SOFT_INPUT_MODE_CHANGED =1<<9;
public staticfinal int SCREEN_ORIENTATION_CHANGED =1<<10;
public staticfinal int SCREEN_BRIGHTNESS_CHANGED =1<<11;