標籤:
Android的Window類
2011-03-25 10:02 by Keis, 110 visits, 網摘, 收藏, 編輯
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;
內部IME視窗,顯示於普通UI之上。應用程式可重新布局以免被此視窗覆蓋。
public staticfinal int TYPE_INPUT_METHOD = FIRST_SYSTEM_WINDOW+11;
內部IME對話方塊,顯示於當前IME視窗之上。
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選項。設定此選項,意味著視窗不能與軟IME進行互動,所以它的Z序獨立於任何活動的IME(換句話說,它可以全螢幕顯示,如果需要的話,可覆蓋IME視窗)。要修改這一行為,可參考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選項和本選項,視窗將能夠與IME互動,允許IME視窗覆蓋;
如果FLAG_NOT_FOCUSABLE沒有設定而設定了本選項,視窗不能與IME互動,可以覆蓋IME視窗。
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;
軟IME模式選項:
public intsoftInputMode;
以下選項與IME模式有關:
軟輸入地區是否可見。
public staticfinal int SOFT_INPUT_MASK_STATE = 0x0f;
未指定狀態。
public staticfinal int SOFT_INPUT_STATE_UNSPECIFIED = 0;
不要修改軟IME地區的狀態。
public staticfinal int SOFT_INPUT_STATE_UNCHANGED = 1;
隱藏IME地區(當使用者進入視窗時)。
public staticfinal int SOFT_INPUT_STATE_HIDDEN = 2;
當視窗獲得焦點時,隱藏IME地區。
public staticfinal int SOFT_INPUT_STATE_ALWAYS_HIDDEN = 3;
顯示IME地區(當使用者進入視窗時)。
public staticfinal int SOFT_INPUT_STATE_VISIBLE = 4;
當視窗獲得焦點時,顯示IME地區。
public staticfinal int SOFT_INPUT_STATE_ALWAYS_VISIBLE = 5;
視窗應當主動調整,以適應軟輸入視窗。
public staticfinal int SOFT_INPUT_MASK_ADJUST = 0xf0;
未指定狀態,系統將根據視窗內容嘗試選擇一個IME樣式。
public staticfinal int SOFT_INPUT_ADJUST_UNSPECIFIED = 0x00;
當IME顯示時,允許視窗重新計算尺寸,使內容不被IME所覆蓋。
不可與SOFT_INPUT_ADJUSP_PAN混合使用;如果兩個都沒有設定,系統將根據視窗內容自動化佈建一個選項。
public staticfinal int SOFT_INPUT_ADJUST_RESIZE = 0x10;
IME顯示時平移視窗。它不需要處理尺寸變化,架構能夠移動視窗以確保輸入焦點可見。
不可與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;
(轉) Android的Window類