1. 程式人生 > >Android使用WindowManager覆蓋狀態列

Android使用WindowManager覆蓋狀態列

屬性及可用的常量定義


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 的取值: 
      應用程式視窗。
      public static final int FIRST_APPLICATION_WINDOW = 1;
      
      所有程式視窗的“基地”視窗,其他應用程式視窗都顯示在它上面。     
      public static final int TYPE_BASE_APPLICATION   =1;       
    
      普通應喲功能程式視窗。token必須設定為Activity的token,以指出該視窗屬誰。
      public static final int TYPE_APPLICATION       = 2;
       用於應用程式啟動時所顯示的視窗。應用本身不要使用這種型別。
      它用於讓系統顯示些資訊,直到應用程式可以開啟自己的視窗。   
      public static final int TYPE_APPLICATION_STARTING = 3;
       
      應用程式視窗結束。
      public static final int LAST_APPLICATION_WINDOW = 99;


      子視窗。子視窗的Z序和座標空間都依賴於他們的宿主視窗。
      public static final int FIRST_SUB_WINDOW       = 1000;


      面板視窗,顯示於宿主視窗上層。
      public static final int TYPE_APPLICATION_PANEL  = FIRST_SUB_WINDOW;


      媒體視窗,例如視訊。顯示於宿主視窗下層。
      public static final int TYPE_APPLICATION_MEDIA  = FIRST_SUB_WINDOW+1;


      應用程式視窗的子面板。顯示於所有面板視窗的上層。(GUI的一般規律,越“子”越靠上)
      public static final int TYPE_APPLICATION_SUB_PANEL = FIRST_SUB_WINDOW +2;


      對話方塊。類似於面板視窗,繪製類似於頂層視窗,而不是宿主的子視窗。
      public static final int TYPE_APPLICATION_ATTACHED_DIALOG = FIRST_SUB_WINDOW +3;


      媒體資訊。顯示在媒體層和程式視窗之間,需要實現透明(半透明)效果。(例如顯示字幕)
      public static final int TYPE_APPLICATION_MEDIA_OVERLAY  = FIRST_SUB_WINDOW +4;


      子視窗結束。( End of types of sub-windows )
      public static final int LAST_SUB_WINDOW        = 1999;


      系統視窗。非應用程式建立。
      public static final int FIRST_SYSTEM_WINDOW    = 2000;


      狀態列。只能有一個狀態列;它位於螢幕頂端,其他視窗都位於它下方。
      public static final int TYPE_STATUS_BAR        =  FIRST_SYSTEM_WINDOW;


      搜尋欄。只能有一個搜尋欄;它位於螢幕上方。
      public static final int TYPE_SEARCH_BAR        = FIRST_SYSTEM_WINDOW+1;


      電話視窗。它用於電話互動(特別是呼入)。它置於所有應用程式之上,狀態列之下。
      public static final int TYPE_PHONE            = FIRST_SYSTEM_WINDOW+2;


      系統提示。它總是出現在應用程式視窗之上。
      public static final int TYPE_SYSTEM_ALERT      =  FIRST_SYSTEM_WINDOW +3;


      鎖屏視窗。
      public static final int TYPE_KEYGUARD          = FIRST_SYSTEM_WINDOW +4;


      資訊視窗。用於顯示toast。
      public static final int TYPE_TOAST            = FIRST_SYSTEM_WINDOW +5;


      系統頂層視窗。顯示在其他一切內容之上。此視窗不能獲得輸入焦點,否則影響鎖屏。
      public static final int TYPE_SYSTEM_OVERLAY    =  FIRST_SYSTEM_WINDOW +6;


      電話優先,當鎖屏時顯示。此視窗不能獲得輸入焦點,否則影響鎖屏。
      public static final int TYPE_PRIORITY_PHONE    =  FIRST_SYSTEM_WINDOW +7;


      系統對話方塊。(例如音量調節框)。
      public static final int TYPE_SYSTEM_DIALOG     =  FIRST_SYSTEM_WINDOW +8;


      鎖屏時顯示的對話方塊。
      public static final int TYPE_KEYGUARD_DIALOG   =  FIRST_SYSTEM_WINDOW +9;


      系統內部錯誤提示,顯示於所有內容之上。
      public static final int TYPE_SYSTEM_ERROR      =  FIRST_SYSTEM_WINDOW +10;


      內部輸入法視窗,顯示於普通UI之上。應用程式可重新佈局以免被此視窗覆蓋。
      public static final int TYPE_INPUT_METHOD      =  FIRST_SYSTEM_WINDOW +11;


      內部輸入法對話方塊,顯示於當前輸入法視窗之上。
      public static final int TYPE_INPUT_METHOD_DIALOG= FIRST_SYSTEM_WINDOW +12;


      牆紙視窗。
      public static final int TYPE_WALLPAPER         = FIRST_SYSTEM_WINDOW +13;


      狀態列的滑動面板。
      public static final int TYPE_STATUS_BAR_PANEL   = FIRST_SYSTEM_WINDOW +14;


      系統視窗結束。
      public static final int 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 的取值:
      視窗之後的內容變暗。
      public static final int FLAG_DIM_BEHIND       = 0x00000002;


      視窗之後的內容變模糊。
      public static final int FLAG_BLUR_BEHIND       = 0x00000004;
    
      不許獲得焦點。
      不能獲得按鍵輸入焦點,所以不能向它傳送按鍵或按鈕事件。那些時間將傳送給它後面的可以獲得焦點的視窗。此選項還會設定FLAG_NOT_TOUCH_MODAL選項。設定此選項,意味著視窗不能與軟輸入法進行互動,所以它的Z序獨立於任何活動的輸入法(換句話說,它可以全屏顯示,如果需要的話,可覆蓋輸入法視窗)。要修改這一行為,可參考FLAG_ALT_FOCUSALBE_IM選項。
      public static final int FLAG_NOT_FOCUSABLE     = 0x00000008;
      不接受觸控式螢幕事件。
      public static final int FLAG_NOT_TOUCHABLE     = 0x00000010;


      當視窗可以獲得焦點(沒有設定 FLAG_NOT_FOCUSALBE 選項)時,仍然將視窗範圍之外的點裝置事件(滑鼠、觸控式螢幕)傳送給後面的視窗處理。否則它將獨佔所有的點裝置事件,而不管它們是不是發生在視窗範圍內。
      public static final int FLAG_NOT_TOUCH_MODAL   = 0x00000020;


      如果設定了這個標誌,當裝置休眠時,點選觸控式螢幕,裝置將收到這個第一觸控事件。
      通常第一觸控事件被系統所消耗,使用者不會看到他們點選螢幕有什麼反應。
      public static final int FLAG_TOUCHABLE_WHEN_WAKING = 0x00000040;


      當此視窗為使用者可見時,保持裝置常開,並保持亮度不變。
      public static final int FLAG_KEEP_SCREEN_ON    = 0x00000080;


      窗口占滿整個螢幕,忽略周圍的裝飾邊框(例如狀態列)。此視窗需考慮到裝飾邊框的內容。
      public static final int FLAG_LAYOUT_IN_SCREEN   =0x00000100;


      允許視窗擴充套件到螢幕之外。
      public static final int FLAG_LAYOUT_NO_LIMITS   =0x00000200;


      視窗顯示時,隱藏所有的螢幕裝飾(例如狀態條)。使窗口占用整個顯示區域。
      public static final int FLAG_FULLSCREEN     = 0x00000400;


      此選項將覆蓋FLAG_FULLSCREEN選項,並強制螢幕裝飾(如狀態條)彈出。
      public static final int FLAG_FORCE_NOT_FULLSCREEN   =0x00000800;


      抖動。指 對半透明的顯示方法。又稱“點透”。圖形處理較差的裝置往往用“點透”替代Alpha混合。
      public static final int FLAG_DITHER           = 0x00001000;


      不允許螢幕截圖。
      public static final int FLAG_SECURE           = 0x00002000;


      一種特殊模式,佈局引數用於指示顯示比例。
      public static final int FLAG_SCALED           = 0x00004000;


      當螢幕有可能貼著臉時,這一選項可防止面頰對螢幕造成誤操作。
      public static final int FLAG_IGNORE_CHEEK_PRESSES   = 0x00008000;


      當請求佈局時,你的視窗可能出現在狀態列的上面或下面,從而造成遮擋。當設定這一選項後,視窗管理器將確保視窗內容不會被裝飾條(狀態列)蓋住。
      public static final int FLAG_LAYOUT_INSET_DECOR = 0x00010000;


      反轉FLAG_NOT_FOCUSABLE選項。
      如果同時設定了FLAG_NOT_FOCUSABLE選項和本選項,視窗將能夠與輸入法互動,允許輸入法視窗覆蓋;
      如果FLAG_NOT_FOCUSABLE沒有設定而設定了本選項,視窗不能與輸入法互動,可以覆蓋輸入法視窗。
      public static final int FLAG_ALT_FOCUSABLE_IM = 0x00020000;


      如果你設定了FLAG_NOT_TOUCH_MODAL,那麼當觸屏事件發生在視窗之外事,可以通過設定此標誌接收到一個MotionEvent.ACTION_OUTSIDE事件。注意,你不會收到完整的down/move/up事件,只有第一次down事件時可以收到ACTION_OUTSIDE。
      public static final int FLAG_WATCH_OUTSIDE_TOUCH = 0x00040000;


      當螢幕鎖定時,視窗可以被看到。這使得應用程式視窗優先於鎖屏介面。可配合FLAG_KEEP_SCREEN_ON選項點亮螢幕並直接顯示在鎖屏介面之前。可使用FLAG_DISMISS_KEYGUARD選項直接解除非加鎖的鎖屏狀態。此選項只用於最頂層的全螢幕視窗。
      public static final int FLAG_SHOW_WHEN_LOCKED = 0x00080000;


      請求系統牆紙顯示在你的視窗後面。視窗必須是半透明的。
      public static final int FLAG_SHOW_WALLPAPER = 0x00100000;


      視窗一旦顯示出來,系統將點亮螢幕,正如使用者喚醒裝置那樣。
      public static final int FLAG_TURN_SCREEN_ON = 0x00200000;


      解除鎖屏。只有鎖屏介面不是加密的才能解鎖。如果鎖屏介面是加密的,那麼使用者解鎖之後才能看到此視窗,除非設定了FLAG_SHOW_WHEN_LOCKED選項。
      public static final int FLAG_DISMISS_KEYGUARD = 0x00400000;


      鎖屏介面淡出時,繼續執行它的動畫。
      public static final int FLAG_KEEP_SURFACE_WHILE_ANIMATING =0x10000000;


      以原始尺寸顯示視窗。用於在相容模式下執行程式。
      public static final int FLAG_COMPATIBLE_WINDOW = 0x20000000;


      用於系統對話方塊。設定此選項的視窗將無條件獲得焦點。
      public static final int FLAG_SYSTEM_ERROR = 0x40000000;


7. public int softInputMode;
   軟輸入法模式選項:
以下選項與 softInputMode 有關:
      軟輸入區域是否可見。
      public static final int SOFT_INPUT_MASK_STATE = 0x0f;


      未指定狀態。
      public static final int SOFT_INPUT_STATE_UNSPECIFIED = 0;


      不要修改軟輸入法區域的狀態。
      public static final int SOFT_INPUT_STATE_UNCHANGED = 1;


      隱藏輸入法區域(當用戶進入視窗時)。
      public static final int SOFT_INPUT_STATE_HIDDEN = 2;


      當視窗獲得焦點時,隱藏輸入法區域。
      public static final int SOFT_INPUT_STATE_ALWAYS_HIDDEN = 3;


      顯示輸入法區域(當用戶進入視窗時)。
      public static final int SOFT_INPUT_STATE_VISIBLE = 4;


      當視窗獲得焦點時,顯示輸入法區域。
      public static final int SOFT_INPUT_STATE_ALWAYS_VISIBLE = 5;


      視窗應當主動調整,以適應軟輸入視窗。
      public static final int SOFT_INPUT_MASK_ADJUST = 0xf0;


      未指定狀態,系統將根據視窗內容嘗試選擇一個輸入法樣式。
      public static final int SOFT_INPUT_ADJUST_UNSPECIFIED = 0x00;


      當輸入法顯示時,允許視窗重新計算尺寸,使內容不被輸入法所覆蓋。
      不可與SOFT_INPUT_ADJUSP_PAN混合使用,如果兩個都沒有設定,系統將根據視窗內容自動設定一個選項。
      public static final int SOFT_INPUT_ADJUST_RESIZE = 0x10;


      輸入法顯示時平移視窗。它不需要處理尺寸變化,框架能夠移動視窗以確保輸入焦點可見。
      不可與SOFT_INPUT_ADJUST_RESIZE混合使用;如果兩個都沒設定,系統將根據視窗內容自動設定一個選項。
      public static final int SOFT_INPUT_ADJUST_PAN = 0x20;


      當用戶轉至此視窗時,由系統自動設定,所以你不要設定它。
      當視窗顯示之後該標誌自動清除。
      public static final int 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;