system_bar 使用方法

system_bar是一个位于屏幕上方的窗口,通常用来显示当前窗口的标题、时间、电池电量、网络信号和关闭当前窗口的按钮等。

system_bar是可选的,可以启用也可以不启用。如果要启用system_bar,可以按下列方法:

一、创建system_bar窗口

system_bar和普通窗口类似,你可以用代码创建,也可以用XML UI描述文件创建,比如下面是demoui中的system_bar的XML UI描述文件(system_bar.xml):

  1. <system_bar h="30">
  2. <column x="0" y="0" w="-40" h="100%">
  3. <label style="title" x="10" y="m" w="55%" h="100%" name="title"/>
  4. <digit_clock style="time" x="r" y="m" w="40%" h="100%" format="h:m"/>
  5. </column>
  6. <button style="close" x="r:5" y="m" w="26" h="26" name="close" text="x"/>
  7. </system_bar>

在system_bar窗口中,有两个控件比较特殊(均为可选):

  • 1.名为title的label控件。它自动显示当前主窗口的标题或名称。

窗口的标题可以用窗口的text属性指定。

  • 2.名为close的button控件。点击它时,它向当前主窗口放送EVT_REQUEST_CLOSE_WINDOW事件。

缺省情况下,窗口收到EVT_REQUEST_CLOSE_WINDOW事件时,窗口会被关闭。

如果窗口不想接受EVT_REQUEST_CLOSE_WINDOW事件,可以设置窗口的closable属性为”no”,此时close按钮自动禁用。如:

  1. <window closable="no" anim_hint="htranslate">

如果窗口希望收到EVT_REQUEST_CLOSE_WINDOW事件时,由用户决定是否关闭当前。可以设置窗口的closable属性为”confirm”,同时处理EVT_REQUEST_CLOSE_WINDOW事件,根据当前的情况决定是否关闭窗口。

二、打开窗口

如果要启用system_bar窗口,必须在打开应用程序的窗口之前打开system_bar窗口。

可以在资源加载窗口之后打开system_bar窗口,但是资源加载窗口顶部区域需要留白。

  1. window_open("system_bar");

三、style

system_bar的style和其它窗口一样,可以在styles目录下放一个与窗口同名的style文件(system_bar.xml)。比如下面是demoui中的system_bar的style(system_bar.xml):

  1. <system_bar>
  2. <style name="default">
  3. <normal bg_color="#404040"/>
  4. </style>
  5. </system_bar>
  6. <label>
  7. <style name="title" text_align_h="left">
  8. <normal text_color="white" />
  9. </style>
  10. </label>
  11. <digit_clock>
  12. <style name="time">
  13. <normal text_color="white" />
  14. </style>
  15. </digit_clock>
  16. <button>
  17. <style name="close" icon="earth">
  18. <normal icon="close_n"/>
  19. <pressed icon="close_p"/>
  20. <over icon="close_n"/>
  21. <disable icon="close_d"/>
  22. </style>
  23. </button>

如果整个屏幕用一张大的背景图,可以把背景图片设置到窗口管理器上,这样就不需要为system_bar和应用窗口分别指定背景图片了。如:

  1. <window_manager>
  2. <style name="default">
  3. <normal bg_image="bg800x480"/>
  4. </style>
  5. </window_manager>