天天看點

Android Windows

轉自: 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;

繼續閱讀