【转载】黑莓开发学习（入门教程）04-标准界面的HelloWorld程序

本文转载自：http://hi.baidu.com/netis/blog/item/5e4c2b2a9a5b0591033bf6b8.html

作者：小叶 xiaoye.org

发布：http://hi.baidu.com/netis

可以任意转载, 转载时请务必以超链接形式标明文章原始出处和作者信息

摘要：看到Hello World显示在BB屏幕，是不是有些激动？但这个程序最多只能算是测试开发环境是否正常可用的实验代码，没有友好的界面，没有良好的交互。一个像样的程序只要要有个彩色的窗口、有用户输入、有按钮、有菜单吧？完善一下标准的HelloWorld程序。

标准的HelloWorld程序也太简陋了，有了太多的想法要实现：

▲能否设置一个漂亮的程序图标，而不是黑乎乎的命令行窗口？

▲能否设置一个程序标题？

▲能否放一个按钮点击后提示欢迎信息？

▲能否自定义一个菜单？

04.1-思维导图

04.1-为程序添加图标

在JDE的工作区点击FirstDemo，右键->properties....。在属性设置窗口点击Add添加一个图像文件，支持.png、.gif、.jpg。

图像文件名必须是英文名，否则编译的时候会提示“I/O Error: invalid UTF-8 encoding”

程序编译运行后图标就会显示成一个笑脸：

04.2-设置程序标题

通过如下代码即可实现：

//设置程序的标题
LabelField title = new LabelField("Hello World",Field.FIELD_HCENTER);
this.setTitle(title);

04.3-设置程序主界面的背景

要实现这个功能需要分两步，

第一步：从容器控件VerticalFieldManager基础一个新布局控件BackgroundManager，增加一个背景颜色的属性，并通过重载VerticalFieldManager的paintBackground来实现自定义设置的显示。

//定义一个窗口布局控件   主要是为了能改变窗口背景颜色
public static class BackgroundManager extends VerticalFieldManager
{
    private int bgColor = Color.NAVY;
    public BackgroundManager()
     {
        super( USE_ALL_HEIGHT | NO_VERTICAL_SCROLL | NO_VERTICAL_SCROLLBAR    );
         bgColor = Color.NAVY;
     }
    
    public BackgroundManager(int bgcolor)
     {
        super( USE_ALL_HEIGHT | NO_VERTICAL_SCROLL | NO_VERTICAL_SCROLLBAR    );
         bgColor = bgcolor;            
     }
   //重新设置程序背景色彩
    protected void paintBackground(Graphics g)
     {                   
         g.setBackgroundColor(bgColor);
         g.clear();
        super.paint(g);
     }
}

第二步：创建一个背景容器BackgroundManager命名为mgr，并将其他控件放置在这个背景容器上，最后将背景容器放置到程序主窗口HelloWorldScreen上。

//背景容器实例
BackgroundManager mgr = new BackgroundManager(Color.MEDIUMAQUAMARINE);
//添加一个输入域
edtName = new BasicEditField("输入您的姓名: ","小叶", 20,Field.FIELD_LEFT );
mgr.add(edtName);
//添加一个按钮 点击后根据输入的内容提示
btnShow = new ButtonField("显示欢迎信息",Field.FIELD_HCENTER | ButtonField.CONSUME_CLICK );
btnShow.setChangeListener(this);
mgr.add(btnShow);    
this.add(mgr);

下图为实施上两步后的效果：

04.4-增加一个用户输入域

通过如下代码即可实现：

为了后续点击按钮可以取得录入的内容，在构造函数前定义一个输入域控件。

//定义类的元素
private BasicEditField edtName = null;  //姓名输入域

创建和添加数据域。

//添加一个输入域
edtName = new BasicEditField("输入您的姓名: ","小叶", 20,Field.FIELD_LEFT );
mgr.add(edtName);

效果见上图。

04.5-添加一个按钮

//添加一个按钮 点击后根据输入的内容提示
btnShow = new ButtonField("显示欢迎信息",Field.FIELD_HCENTER | ButtonField.CONSUME_CLICK );
btnShow.setChangeListener(this);
mgr.add(btnShow);    
this.add(mgr);

对按钮事件接口也需要继承后定义下接口处理

//处理按钮事件
public void fieldChanged(Field field, int ctx)
{
    if (field == btnShow) {        
         Dialog.alert("欢迎您-"+edtName.getText());
     }
};

程序运行后，点击按钮，按钮就会根据录入的内容显示欢迎信息，如下图。

04.6-自定义菜单

首先，创建需要显示的子菜单，为区分与系统默认菜单项，菜单显示名称以*开始。

//定义显示信息菜单项目
public MenuItem showItem= new MenuItem("*显示欢迎信息", 160, 10 )
{
    public void run()
     {
         Dialog.alert("欢迎您-"+edtName.getText());
     }
};
//定义显示关闭菜单项目
public MenuItem closeItem= new MenuItem("*退出", 170, 10 )
{
    public void run()
     {
         onClose();
     }
};

其次，重载菜单生成函数，使得自定义菜单添加到系统默认菜单中。

//重载makeMenu 添加自定义的菜单
protected void makeMenu(Menu menu, int instance)
{       
   menu.add(showItem);
   menu.add(closeItem);
}

菜单显示效果如下：

点击菜单后显示对话框：

04.7-完整代码

为了代码的维护和可读性，将定义窗口类的代码单独成一个文件HelloWorldScreen.java。创建新程序文件的方法见第三部分的“03.4-建立程序文件”。

主程序HelloWorld.java

/*
HelloWorld.java
主程序
作者：小叶 xiaoye.org
发布：http://hi.baidu.com/netis
可以任意转载, 转载时请务必以超链接形式标明文章原始出处和作者信息
*/
package src;
//导入库
import net.rim.device.api.ui.Field;
import net.rim.device.api.ui.UiApplication;
import net.rim.device.api.ui.component.LabelField;
import net.rim.device.api.ui.container.MainScreen;
public class HelloWorld extends UiApplication {   
    //程序的构造函数       
    public HelloWorld() {   
         HelloWorldScreen screen = new HelloWorldScreen();   
         pushScreen(screen);   
     }   
     //程序的入口函数 java程序运行都需要这个 否则会提示找不到main的提示
    public static void main(String[] args) {   
         HelloWorld app = new HelloWorld();   
         app.enterEventDispatcher();   
     }
}

窗口类HelloWorldScreen.java

/*
HelloWorldScreen.java
窗口类 实现了程序的用户界面
作者：小叶 xiaoye.org
发布：http://hi.baidu.com/netis
可以任意转载, 转载时请务必以超链接形式标明文章原始出处和作者信息
*/
package src;
//导入库
import net.rim.device.api.ui.*;
import net.rim.device.api.ui.UiApplication;
import net.rim.device.api.ui.component.*;
import net.rim.device.api.ui.container.*;
import net.rim.device.api.ui.FieldChangeListener;
import net.rim.device.api.system.Display;
//窗口类    
final class HelloWorldScreen extends MainScreen implements FieldChangeListener {
    //定义类的元素
    private BasicEditField edtName = null;  //姓名输入域
    private ButtonField btnShow = null;      //显示按钮
    //构造函数
    public HelloWorldScreen() {
        //父类的事件 显示默认的上下文菜单
        super(DEFAULT_MENU | DEFAULT_CLOSE);
        //设置程序的标题
         LabelField title = new LabelField("Hello World",Field.FIELD_HCENTER);
        this.setTitle(title);
        //背景容器实例
         BackgroundManager mgr = new BackgroundManager(Color.MEDIUMAQUAMARINE);
        //添加一个输入域
         edtName = new BasicEditField("输入您的姓名: ","小叶", 20,Field.FIELD_LEFT );
         mgr.add(edtName);
        //添加一个按钮 点击后根据输入的内容提示
         btnShow = new ButtonField("显示欢迎信息",Field.FIELD_HCENTER | ButtonField.CONSUME_CLICK );
         btnShow.setChangeListener(this);
         mgr.add(btnShow);    
        this.add(mgr);
     }
    
    //定义显示信息菜单项目
    public MenuItem showItem= new MenuItem("*显示欢迎信息", 160, 10 )
     {
        public void run()
         {
             Dialog.alert("欢迎您-"+edtName.getText());
         }
     };
    //定义显示关闭菜单项目
    public MenuItem closeItem= new MenuItem("*退出", 170, 10 )
     {
        public void run()
         {
             onClose();
         }
     };
    
     //重载makeMenu 添加自定义的菜单
     protected void makeMenu(Menu menu, int instance)
      {       
         menu.add(showItem);
         menu.add(closeItem);
     }
    
    //处理按钮事件
    public void fieldChanged(Field field, int ctx)
     {
        if (field == btnShow) {        
             Dialog.alert("欢迎您-"+edtName.getText());
         }
     };  
    
    //重载onClose, 退出时提示
    public boolean onClose()
     {
        if ( Dialog.ask(Dialog.D_YES_NO, "确定退出吗?") == Dialog.YES )
         {
             System.exit(0);
            return true;
         }
        return false;
     }  
    
    //定义一个窗口布局控件   主要是为了能改变窗口背景颜色
    public static class BackgroundManager extends VerticalFieldManager
     {
        private int bgColor = Color.NAVY;
        public BackgroundManager()
         {
            super( USE_ALL_HEIGHT | NO_VERTICAL_SCROLL | NO_VERTICAL_SCROLLBAR    );
             bgColor = Color.NAVY;
         }
        
        public BackgroundManager(int bgcolor)
         {
            super( USE_ALL_HEIGHT | NO_VERTICAL_SCROLL | NO_VERTICAL_SCROLLBAR    );
             bgColor = bgcolor;            
         }
       //重新设置程序背景色彩
        protected void paintBackground(Graphics g)
         {                   
             g.setBackgroundColor(bgColor);
             g.clear();
            super.paint(g);
         }
     }
       
}