Microsoft Word - 第3章.doc

Transcription

1 第 3 章高级用户界面 无论是游戏程序还是大部分应用程序, 都和图形界面设计密不可分 在 J2ME 中高级图形用户界面由 MIDP(Mobile Information Device Profile, 移动信息设备简表 ) 实现, 所以也称为 MIDP 用户界面 MIDP 用户界面从功能上可以划分为高级用户界面和低级用户界面两部分 高级用户界面主要使用系统提供的组件进行游戏界面设计, 而低级用户界面则用于需要对显示屏精确控制的游戏过程设计中 通过本章的学习, 读者可以掌握下面的知识点 (1) 高级界面的管理和实现 (2) 高级屏幕类及其子类 (3) 高级界面应用 3.1 高级用户界面概述 LCDUI 包 根据 MIDP 的规格,LCDUI(Liquid Crystal Display User Interface) 包的设计分成高级 API 和低级 API 两种 由于手机一次只能显示出一个画面, 因此每个画面只能在高级 API 与低级 API 之间选择一种使用 如果使用了高级 API( 使用 Screen 的子类 ), 那么该画面就具有移植性 使用高级 API 撰写程序比较轻松, 但灵活性差 这是因为高级 API 所提供的组件都会由底层的虚拟机直接映射到该设备的原生用户界面, 所以开发人员无法决定组件的颜色 字形和外观, 因为这些都会由系统来决定, 因此对画面所能掌控的程度就比较低 另外, 当使用高级 API 时, 与用户的交互都会遵循该手机既有的用户界面的操作方式 使用低级 API( 使用 Canvas 的子类与 Graphics 类 ) 撰写程序相对复杂 这是因为使用低级 API 时, 开发人员将对整个手机的画面具有完全的控制权, 同时也能决定用户该如何与程序交互, 所以编写程序要考虑的事情比较多 由于每种设备都有不同的特性 ( 不同的操作方式 屏幕大小及颜色等 ), 因此一旦采用了低级 API, 那么将不保证程序可以在不同的机器上执行, 也不保证会有相同的执行结果 如果使用了低级 API 之后还希望能够跨平台, 那么开发人员必须花更多的时间让程序更有弹性才行, 例如, 开发人员不能假设屏幕的大小, 所以在屏幕上绘图时, 程序必须能动态调整绘图的结果才行 LCDUI 包的设计划分成低级 API 与高级 API 所以 LCDUI 包的体系结构区分成低级类库和高级类库 能够显示在屏幕上的组件都来自于 Displayable 这个抽象类, 而 Displayable 又派生出了 Screen 类和 Canvas 类, 如图 3-1 所示 从图 3-1 中可以看出,Displayable 这个抽象类的子类可以区分成两大类 :Canvas 类与 Screen 类, 其中 Canvas 类属于低级图形用户界面组件,Screen 类属于高级图形用户界面组

2 J2ME 手机游戏开发技术与实践 ( 第 2 版 ) 件 在同一时间, 只能有唯一一个 Canvas 或 Screen 类的子类出现在屏幕上 每当调用 Display 的 setcurrent() 方法时, 前一个画面就会被取代掉, 因此开发人员必须自行将前一个画面与其状态保留起来, 并控制整个程序中画面的切换才行 52 图 3-1 LCDUI 包的体系结构 高级用户界面的类结构 高级屏幕对象分为以下两个范畴 (1) 封装了复杂的用户界面组件的屏幕对象 ( 例如类 List Alert 或者 TextBox 等 ) 这些屏幕类的结构是定义好的, 应用程序不能在这些屏幕对象上添加其他组件 (2) 通用的屏幕对象 ( 例如 Form), 应用程序可以在这个屏幕对象中添加 删除 修改文本 图像和简单的相关 UI 组合集合 Display 类负责管理显示这些屏幕对象 ( 也包括低级屏幕对象 Canvas 类 ), 每个 MIDlet 都有一个 Display 实例, 通过它可以获取关于设备显示屏幕的基本性能信息 Screen 类和 Canvas 类都是 Displayable 类的子类, 通过调用 Display 的方法 setcurrent() 可以使屏幕对象可见 高级屏幕对象都是 Screen 类的子类, 其中三个预定义好的子类如下 (1)List: 允许从三个预定义的选项组中选择, 常用以选择 (2)TextBox: 是一个比较简单的文本编辑器, 常用于输入文本 (3)Alert: 显示包含图片或文字的临时信息或者简单问询, 常用于提示信息 另外的子类 Form 是一个特殊的子类, 它更像一个容器 每个 Form 都可以添加下面 Item 子类的组合 (1)StringItem: 用于静态文本显示, 或者作为一个按钮或超链接 (2)ImageItem: 用于静态图像显示, 或者作为一个图标或超链接 (3)TextField: 用于带约束的文本类型输入 (4)DateField: 用于时间或者日期值的显示或输入

3 (5)Gauge: 用于进度条或者来自某个特定范围的数值输入 (6)ChoiceGroup: 用于一个选项集合的单选或多选 高级用户界面除了以上 4 个 Screen 屏幕类外, 还有 Command 类来完善高级事件机制, 从而实现用户界面交互功能 Ticker 类实现了滚动条功能, 可以添加到所有的 Screen 子类中 Choice 接口封装了用于选择的基本功能,Screen 的子类 TextBox 以及 Form 的 Choice- Group 组件实现了该接口 高级用户界面主要的类和接口结构如图 3-2 所示 图 3-2 高级用户界面主要的类和接口 Display 和 Displayable 类 1.Display 类 MIDP 的用户接口的基本设置是 Display 类和 Displayable 类 用 Displayable 对象表示画面本身,Display 对象是控制这个画面的显示管理器 MIDP 中使用类 Display 进行用户界面的管理, 负责与应用程序管理器进行交互 通过以 MIDlet 实例作参数调用静态方法 getdisplay(), 应用程序获得一个 MIDlet 对象 midlet 的 Display 对象实例 : Display display=display.getdisplay(midlet); // 获得 MIDlet 的 Display 对象获得 Display 的实例之后, 应用程序可以通过 Display 类的方法改变设备上显示的 Displayable 对象 使用如下方法, 设置需要显示的内容显示到屏幕上 : public void setcurrent(displayable nextdisplayable); 上面的方法中带一个参数, 参数就是要设置显示的对象, 该对象必须是 Displayable 的子类即 Canvas 子类或 Screen 子类中的一种 (Canvas 类和 Screen 类继承自 Displayable, 继承关系如图 3-2 所示 ) 假如有一个继承 Canvas 类的 Mycanvas 类, 并且这个类做的事情是显示一张图, 现在要让手机屏幕把这个 Mycanvas 类的对象 mycanvas 显示出来, 具体的方 53 第 3 章高级用户界面

4 J2ME 手机游戏开发技术与实践 ( 第 2 版 ) 法如下 : Display.setCurrent(mycanvas);// 设置 mycanvas 为当前屏幕显示的对象 54 设置成 mycanvas 后,mycanvas 显示的那张图就会出现在手机屏幕上 2.Displayable 类 Displayable 是一个抽象类, 它有两个子类 :Screen 类和 Canvas 类 每个子类及其子类的子类都可以作为一个 Displayable Displayable 对象具有以下特点 (1) 在屏幕上可以显示的对象都是 Displayable 对象, 而且在同一个时刻只能显示一个 Displayable 对象 (2)Displayable 对象可以添加零到多个 Command 按键 (3) 可以通过按键监听 (CommandListener) 控制按键响应 Displayable 与开发并没有直接关系 ( 因为它是抽象类 ), 最重要的就是它的两个子类 Screen 和 Canvas 3.2 Command 类与高级事件处理 Command 类 Command 类封装了游戏中的命令行为 ( 退出及开始游戏等 ) 的语义信息, 它只包含命令的信息, 而不是激活命令时实际执行的功能 操作在 CommandListener 接口中定义 可以使用如下方法构造一个新的 Command 对象 : Command comok=new Command("ok",Command.OK,1);// 创建 "ok" 命令对象 comok 构造方法中有三个参数 : 标签 类型和优先级 标签就是在屏幕上可显示的内容, 用以标识按键的功能信息, 本例中为 ok ; 类型是指明按键的意图, 本例中的 Command.OK 就可以表示确定或选中的意思 ; 优先级是用来描述在同一个屏幕上的同一类型的按键之间显示的先后顺序, 数字越小表示优先级越高 (1) 标签 : 每个按键都会包含一个标签字符串, 该标签字符串是应用程序用来显示给用户的, 以表示某个按键的名称 (2) 类型 : 应用程序使用按键类型指明按键的意图, 如果应用程序指定某个按键的类型为 BACK, 并且假设设备有一个确定的按键对应标准的后退操作, 则 MIDP 实现使用这个语义信息作为依据, 从而保持设备的风格 (3) 优先级 : 应用程序用优先级的值来描述在同一个屏幕上一个按键相对于其他按键的重要程度 优先级的值是一个整数, 数值越小的表明重要程度越高, 实际的值由应用程序选择 值为 1 表明这是一个最重要的按键, 其他依次为 2 3 和 4 等 不同种类的按钮, WTK 优先级排序 :ITEM SCREEN OK HELP BACK EXIT CANCEL STOP, 优先级高的按钮优先显示在上方 同一种类的按钮, 在构造函数内划分优先级, 数字越小越优先 BACK CANCEL EXIT 和 STOP 倾向于抢占左方, 优先顺序为 :BACK CANCEL EXIT 和 STOP 不同的按键之间比较优先级没有意义

5 注意 : 只是在 WTK 内满足这个规律, 其他模拟器可能不相同 创建了 Command 对象之后, 通过 Displayable 类的 addcommand() 方法和 remove- Command() 方法增加或者删除命令 实例 3-1 命令对象 import javax.microedition.lcdui.*; import javax.microedition.midlet.midlet; import javax.microedition.midlet.midletstatechangeexception; public class CmdDemo extends MIDlet private Form frm; private Display dis; private Command cmddel; private Command cmdedit; private Command cmdexit; private Command cmdback; public CmdDemo() frm = new Form(" 请您选择相应操作 "); frm.append("hello! 大家好!"); cmddel = new Command(" 删除该号码 ",Command.SCREEN,1); cmdedit = new Command(" 编辑该号码 ",Command.SCREEN,1); cmdexit = new Command(" 退出该程序 ",Command.SCREEN,1); cmdback = new Command(" 返回 ",Command.BACK,1); protected void destroyapp(boolean arg0) throws MIDletStateChange Exception // TODO Auto-generated method stub protected void pauseapp() // TODO Auto-generated method stub protected void startapp() throws MIDletStateChangeException dis = Display.getDisplay(this); // 获得当前 MIDlet 上的显示对象 dis.setcurrent(frm); // 将 frm 设置为当前界面 frm.addcommand(cmddel); frm.addcommand(cmdedit); frm.addcommand(cmdexit); frm.addcommand(cmdback); 上面的实例主要在窗体上显示字符串并增加 4 个命令按键, 按照前面所讲的有关优先级的知识,BACK 类型的按键会抢占左方位置, 显示结果如图 3-3 所示 高级事件处理 55 在前面代码中添加的 Command 按键没有实际作用, 因为没有实现相应的用户事件, 因此应用程序为 Command 对 图 3-3 命令对象实例 第 3 章高级用户界面

6 J2ME 手机游戏开发技术与实践 ( 第 2 版 ) 56 象设置一个按键监听器 (CommandListener) 实现的类, 它负责接收来自 MIDP 实现的高级事件, 应用程序可以实现 CommandListener 接口, 或者使用一个嵌套类或内部类 综合前面的 Displayable 类和 Command 类, 下面实现了一个带有高级事件的 MIDlet 程序 实例 3-2 高级事件 import javax.microedition.lcdui.*; import javax.microedition.midlet.*; public class CmdListenerDemo extends MIDlet implements CommandListener private Command cmd1; private Form frm; public CmdListenerDemo() frm = new Form(" 事件响应演示 "); cmd1= new Command(" 退出 ", Command.EXIT,1); protected void startapp() throws MIDletStateChangeException Display.getDisplay(this).setCurrent(frm); // 显示当前界面 frm frm.addcommand(cmd1); // 增加命令按键 // 注意在 J2SE 中是直接绑定控件, 但在 J2ME 中是绑定 Displayable 对象 frm.setcommandlistener(this); // 绑定 frm 界面与实现了 CommandListener 接 // 口的类对象 protected void destroyapp(boolean arg0)throws MIDletStateChangeException // TODO Auto-generated method stub protected void pauseapp() // TODO Auto-generated method stub // 重写 commandaction 方法 public void commandaction(command c, Displayable d) // TODO Auto-generated method stub if (c==cmd1) System.out.println(" 按钮被按下啦 "); // 按下命令按键时在控制台输出字符串 this.notifydestroyed(); // 程序结束退出 上例程序运行时, 按下退出按键, 在命令控制台上就会显示 按钮被按下啦, 然后程序结束退出 3.3 高级界面类 Screen 类 高级用户界面是指输入框和列表框等界面, 一般是在手机应用软件中使用, 游戏开发中用得比较少, 只有在低级用户界面没办法满足游戏需求的时候才会使用高级用户界面,

7 如有的游戏需要输入玩家名字, 那就需要用到输入框了 Screen 类继承了 Displayable, 它是高级界面 API, 封装了完整的用户界面组件 (TextBox List Alert 及 Form) 的高层对象 其子类的对象可以作为参数传递给方法 : public void setcurrent(displayable nextdisplayable); 用来在手机屏幕上显示高级屏幕组件 Screen 类是所有高级用户界面类的公共父类, 在 Displayable 类的基础之上增加了可选的标题和滚动条 (Ticker) 两个属性, 要显示的内容以及用户的交互由其子类定义 TextBox List Alert 及 Form 都是 Screen 类的子类, 下面对它们的功能和用法分别进行介绍 TextBox 组件 TextBox 组件允许用户输入并且编辑文本, 当游戏中需要输入一些信息的时候就需要用到它, 例如, 很多游戏的高分榜都需要输入玩家的姓名, 所以 TextBox 组件是一个在游戏开发中常用的组件 TextBox 的构造方法形式如下 : TextBox(String Title,String text,int maxsize,int constraints) 构造方法有 4 个参数, 第 1 个参数是这个组件的标题 ; 第 2 个参数是初始的内容 ; 第 3 个参数是可输入的最大长度 ; 第 4 个参数是限制输入的内容 限制的内容是用来限制当前要输入的内容是什么类型的, 可以限定只能输入数字, 也可以限定只能输入字母, 表 3-1 列出了 TextField 对应的 7 种类型的限制内容 限制参数 TextField.ANY TextField. ADDR TextField.NUMBER TextField.PASSWD TextField.PHONENUMBER TextField.URL TextField.DECIMAL 表 3-1 TextField 的限制参数功能任意文字邮件地址整数口令电话号码网络地址数字 下面给出一段代码实例, 看一下具体的用法 实例 3-3 使用 TextBox import javax.microedition.midlet.*; // 引用 MIDlet 包 import javax.microedition.lcdui.*; // 引用图形用户界面 public class TextDemo extends MIDlet // 继承 MIDlet 类 private Display display; // 创建 display 对象 TextBox tb=new TextBox("TextBox 测试 ","TextBox 测试内容如下 :",20,TextField. ANY); // 创建新的 TextBox tb, 名字为 test, 可输入 20 个字符, 可输入任意类型 // 这里选用的参数为任意文字, 可以修改成别的参数进行测试 public TextDemo() 57 第 3 章高级用户界面

8 J2ME 手机游戏开发技术与实践 ( 第 2 版 ) 58 // 获取当前 MIDlet 的 Display 对象 display=display.getdisplay(this); protected void startapp() throws MIDletStateChangeException // 通过 display 调用 TextBox 的对象 tb 显示 display.setcurrent(tb); public void pauseapp() // 暂停功能 public void destroyapp(boolean b) /// 销毁功能 protected void destroyapp(boolean arg0) throws MIDletStateChangeException // TODO Auto-generated method stub 运行代码后, 显示结果如图 3-4 所示 List 组件 List 是一个包含选择列表的 Screen 子类, 在 List 对象中可以加入多个文本字符串条目, 每个条目还可以带图片 当 List 对象太多超出屏幕时, 会自动提供滚动机制 ( 如使用上下移动键 ) List 常用的构造方法形式如下 : List(String title,int listtype) 两个参数分别是屏幕标题和列表类型 列表类型有三种, 分别为 EXCLUSIVE( 单选类型 ) MULTIPLE( 多选类型 ) 和 IMPLICIT( 互斥类型, 通过隐式按钮实现 ) 图 3-4 使用 TextBox 显示结果另外一个构造方法可以设置一个字符串数组和图像类型数组, 用来对 List 的内容做初始化 如果不采用这种形式构造, 其工作也可以在构造之后单独进行 形式如下 : List(String title,int listtype,string[] stringelements,image[] imageelements) 其中,stringElements 是字符串数组, 可以指定具体的列表选项 ;imageelements 可以指定具体的列表选项以及列表选项的图标 List 的常用方法如表 3-2 所示 表 3-2 List 的常用方法 方法 int append(string stringpart, Image imagepart) void delete(int elementnum) String getstring(int elementnum) int getselectedindex() 功能添加一个选项到列表中删除索引值为 elementnum 的选项获得索引值为 elementnum 的选项的图片返回所选条目的下标

9 方法 void setfitpolicy(int fitpolicy) int size() void setselectedflags(boolean[] selectedarray) void setticker(ticker ticker) void settitle(string s) 功能设置列表的布局方式获取现有元素的数目设置被选择数组设置滚动条设置标题 续表 1.EXCLUSIVE 类型用户在所有选项中只能选择一项, 用户选择一个选项时, 前面选择的将被取消, 焦点转移到当前选择的选项上, 在选择或取消选择时不会触发事件, 所以通常会使用 Command, 当 Command 被触发时, 利用 List 的 getselectedindex() 方法来判断是哪一个选项被选择 程序示例如下 实例 3-4 List 组件使用一 import javax.microedition.midlet.*; import javax.microedition.lcdui.*; public class ListTest extends MIDlet implements CommandListener private Command cmdcommit; private Display display; public ListTest() display = Display.getDisplay(this); cmdcommit = new Command(" 确定 ", Command.OK,1); public void startapp() List l = new List(" 游戏项目 ",Choice.EXCLUSIVE); l.setcommandlistener(this); // 监听命令按键 l.append(" 五子棋 ",null); // 增加 五子棋 选项 l.append(" 斗地主 ",null); // 增加 斗地主 选项 l.append(" 象棋 ",null); // 增加 象棋 选项 l.addcommand(cmdcommit); display.setcurrent(l); public void pauseapp() public void destroyapp(boolean unconditional) public void commandaction(command c, Displayable s) if (c == cmdcommit) List tmp = (List) s; // 控制台打印选项 int selected = tmp.getselectedindex(); // 获得当前选项的索引 System.out.println("Item" + selected + "selected"); // 控制台打印选项 switch(selected) 59 第 3 章高级用户界面

10 J2ME 手机游戏开发技术与实践 ( 第 2 版 ) 60 case 0: display.setcurrent( new TextBox("TestList"," 五子棋 ",256,0)); break; case 1: display.setcurrent( new TextBox("TestList"," 斗地主 ",256,0)); break; case 2: display.setcurrent(new TextBox("TestList"," 象棋 ",256,0)); 上例程序在 List 中添加了三个选项, 当选择其中一项后可按 确定 键进入相应的文本显示, 运行结果如图 3-5 所示 图 3-5 EXCLUSIVE 类型的运行结果 2.MULTIPLE 类型选择操作会固定焦点元素的选择状态, 应用程序不会获得通知, 这种类似于复选框, 用户可以选择 0 或多个选项, 选择动作不会触发事件, 所以仍需要借由 Command 来触发 当选项被用户选择之后, 首先使用 List 的 size() 方法得到 List 之中有多少个选项, 再循环使用 isselected() 方法来判定各个选项是否被选择 程序示例如下 实例 3-5 List 组件使用二 import javax.microedition.midlet.*; import javax.microedition.lcdui.*; public class ListMutest extends MIDlet implements CommandListener private Command cmdcommit; private Display display; public ListMutest () display = Display.getDisplay(this); cmdcommit = new Command(" 确定 ", Command.OK,1);

11 public void startapp() List l = new List(" 游戏项目 ",Choice.MULTIPLE); l.setcommandlistener(this); // 监听命令按键 l.append(" 五子棋 ",null); l.append(" 斗地主 ",null); l.append(" 象棋 ",null); l.addcommand(cmdcommit); display.setcurrent(l); public void pauseapp() public void destroyapp(boolean unconditional) public void commandaction(command c, Displayable s) if (c == cmdcommit) List tmp = (List) s; // 控制台打印选项 int num = tmp.size(); for(int i = 0; i < num;i++) if(tmp.isselected(i)) // 选择需要的选项 System.out.println("Item" + i + "selected"); // 控制台打印选项 程序运行结果如图 3-6 所示 3.IMPLICIT 类型与前面两种不同, 对于这种类型的 List, 如果设置了 CommandListener, 选择操作会立即被通知到应用程序 在调用这个 List 的 CommandListener() 方法之前, 获得焦点的元素将被选择,SELECT_COMMAND 是用于事件通知的固有参数 程序示例如下 实例 3-6 List 组件使用三 import javax.microedition.midlet.*; import javax.microedition.lcdui.*; 图 3-6 MULTIPLE 类型的运行结果 public class ListImplitest extends MIDlet implements CommandListener private Command exitcommand; private Display display; public ListImplitest() display = Display.getDisplay(this); exitcommand = new Command("Exit", Command.EXIT,1); public void startapp() 61 第 3 章高级用户界面

12 J2ME 手机游戏开发技术与实践 ( 第 2 版 ) 62 List l = new List(" 游戏项目 ",Choice.IMPLICIT); l.setcommandlistener(this); // 监听命令按键 l.append(" 五子棋 ",null); // 增加选项 l.append(" 斗地主 ",null); l.append(" 象棋 ",null); l.addcommand(exitcommand); display.setcurrent(l); public void pauseapp() public void destroyapp(boolean unconditional) public void commandaction(command c, Displayable s) if (c == exitcommand) notifydestroyed(); // 按 Exit 按键退出 If (c == List.SELECT_COMMAND) // 选择选项时立即响应 List tmp = (List)s; // 控制台打印选项 int selected = tmp.getselectedindex(); System.out.println("Item" + selected + "selected"); // 控制台打印选项 switch(selected) case 0: display.setcurrent(new TextBox("TestImplictList"," 五子棋 ",256,0)); break; case 1: display.setcurrent(new TextBox("TestImplictList"," 斗地主 ",256,0)); break; case 2: display.setcurrent(new TextBox("TestImplictList"," 象棋 ",256,0)); break; 运行程序, 选择其中的一个选项, 按下模拟器中间的确认键, 即可显示相应的文本内容, 显示结果如图 3-7 所示 Alert 组件 Alert 是一个比较特殊的屏幕型对象 (Screen 类的子类 ), 当利用 Display 类的 setcurrent() 方法将它设为目前显示在屏幕上的画面时, 它会先发出一段声音, 然后将自己显示在屏幕上, 过一段时间之后, 它会自动跳回之前的画面 请注意, 调用 Display 类的 setcurrent() 方法将 Alert 设为目前显示在屏幕上的画面之前, 系统本身一定要存在一个画面, 这样才能让 Alert 有地方可以跳回 (Alert 的默认行为 ) 因

13 此, 如果在 MIDlet 一启动直接就将 Alert 设为第一个显示在屏幕上的画面, 会出现错误信息, 除非利用 setcommandlistener() 方法设定了自己的事件处理函数 图 3-7 IMPLICIT 类型的运行结果 由于 Alert 这种与众不同的特性, 所以基本上可以把它看作是窗口系统上所使用的对话框 一般印象中的对话框会一直显示在屏幕上, 等待用户确定之后, 它才会回到原先的画面 因此 Alert 最适合用来作一般应用程序常见的启动画面 (Splash Screen) 这时可以利用 Display 有两个参数的 setcurrent() 方法 Alert 类有两个构造方法, 第一个构造方法只需要指定 Alert 的标题, 而不用设定所有属性, 而第二个构造方法需要指定标题 内容 图像和警告类型 例如 : // 构造方法, Alert 标题为 Hello Alert alert = new Alert("Hello"); // 设置图片 alert.setimage(icon); // 设置内容 alert.setstring(" 游戏设计讲解 "); // 设置延时 alert.settimeout(3000); // 设置类型 alert.settype(alerttype.error); 上面的代码等价于下面的构造方法 : Alert alert = new Alert("Hello", " 游戏设计讲解 ", icon, AlertType.ERROR); 警告的类型有以下几种 (1)ALARM( 警报 ): 向用户警告一个事件, 它是用户预先请求的通知 (2)CONFIRMATION( 确定 ): 用来确认一个用户动作, 比如用户在保存操作完成之后, 可以显示这样一条消息 数据已经成功保存 (3)ERROR( 错误 ): 向用户警告一个错误操作, 比如 内存不足, 无法保存数据 (4)INFO( 通知 ): 一般向用户提示非危险性信息, 比如可以用它来制作简单的闪屏 (5)WARNING( 警告 ): 向用户警告一个危险操作, 比如 该操作将删除所有数据 63 第 3 章高级用户界面

14 J2ME 手机游戏开发技术与实践 ( 第 2 版 ) 64 定义好 Alert 类之后, 通过调用 Display.setCurrent() 方法来显示, 可以使用方法 Display.setCurrent(Displayable nextdisplayable), 因为考虑 Alert 类是 Screen 的子类, 可以作为 Displayable 参数传递给此方法 程序示例如下 实例 3-7 Alert 组件的应用 import javax.microedition.midlet.*; import javax.microedition.lcdui.*; public class AlertTest extends MIDlet private Display display; public AlertTest() display = Display.getDisplay(this); boolean registered = false; public void startapp() Form f = new Form(" 主画面 "); f.append(" 请您在此处注册 "); display.setcurrent(f); // 在此判断用户是否注册了 if(!registered) Alert al = new Alert(" 您还没有注册 "); al.settype(alerttype.warning); al.settimeout(alert.forever); al.setstring(" 您应该尽快注册!"); display.setcurrent(al); public void pauseapp() public void destroyapp(boolean unconditional) 程序运行结果如图 3-8 所示 图 3-8 Alert 的运行结果

15 3.4 屏幕表单 (Form 类 ) 及其组件 Form 类 Form 类是一个典型的容器控件类, 用于包含其他高层用户界面控件, 一般不单独显示在屏幕上, 它可以容纳其他可视组件 (Item), 它们都是 Item 类的子类 Item 类是表单组件对象通用属性或方法的一个集合 Form 类提供了方法对表单组件进行操作, 例如添加 删除及插入等, 或者获得表单组件的引用, 从而直接对组件内容进行操作 Form 类是 Screen 的子类, 它可以包含以下 8 种组件的任意组合 :TextField( 文本组件 ) StringItem( 字符串组件 ) ImageItem( 图像组件 ) DataField( 日期组件 ) ChoiceGroup ( 选项集合 ) Gauge( 标尺 ) 以及 MIDP 2.0 引入的 CustomItem( 自定义组件 ) 和 Spacer ( 占位符 ) 这些元素都是 Item 类的子类, 即 Form 类作为一个容器, 可以容纳 Item 子类的组件 MIDP 实现可处理 Form 的布局, 元素的切换和滚动, 包含在 Form 中的任何组件都没有任何滚动机制, 而是整个内容一起滚动 Form 类所提供的常用方法如表 3-3 所示 表 3-3 Form 类的常用方法方法功能 int append(image img) 向表单的末尾添加图像 int append(item item) 添加一个 Item 的子类对象 int append(string str) 添加字符串 void delete(int itemnum) 从表单中删除指定位置的项目, 并使表单的大小减 1 Item get(int itemnum) 取得表单中指定位置的项目 void insert(int itemnum,item item) 在指定的索引之前向表单插入一个项目 int set(int itemnum,item item) 把 itemnum 引用的项目设置成指定的 Item, 从而替换原来的项目 int size() 得到表单当前的项目数量 Form 类的构造方法有以下两种形式 Form(String title) // 创建一个有标题的没有项目的 Form 对象 使用上面这种构造方法后要结合 append() 方法或 insert() 方法动态地插入元素, 例如 : Form myform = new Form (" 表单演示 "); myform.append(item); 另外一种构造方法是 Form(String title, Item[] item), 可以用来创建一个有标题 有项目元素的 Form 对象 下面是 Form 类的构造方法的程序示例 实例 3-8 Form 的应用 import javax.microedition.midlet.*; import javax.microedition.lcdui.*; 65 第 3 章高级用户界面

16 J2ME 手机游戏开发技术与实践 ( 第 2 版 ) 66 public class FormTest extends MIDlet implements CommandListener private Display display; private List list; private Form form1; private Form form2; private Command exit; private Command back; public FormTest() display = Display.getDisplay(this); back = new Command(" 返回 ", Command.BACK, 0); exit = new Command(" 退出 ", Command.EXIT, 1); list = new List(" 表单的例子 ",List.IMPLICIT); list.append(" 第一个游戏 : 雷电 ", null); // 列表项一 list.append(" 第二个游戏 : 功夫熊猫 ", null); // 列表项二 list.addcommand(exit); list.setcommandlistener(this); form1 = new Form(" 第一个游戏说明 "); // 表单的第一种构造方法 form1.append(" 雷电简介 : 基本操作说明 "); // 增加文本内容 form1.append(" 雷电关卡 : 关卡介绍 "); // 增加文本内容 form1.addcommand(back); form1.setcommandlistener(this); // 监听表单 StringItem[] str = new StringItem(" 功夫熊猫简介 :"," 基本剧情 "), new StringItem(" 熊猫招数 :"," 招数说明 "); form2 = new Form(" 第二个游戏说明 ", str); // 表单的第二种构造方法 form2.addcommand(back); form2.setcommandlistener(this); public void startapp() display.setcurrent(list); public void pauseapp() public void destroyapp(boolean condition) public void commandaction(command command, Displayable displayable) if(command == List.SELECT_COMMAND) switch(((list)displayable).getselectedindex()) case 0: display.setcurrent(form1); break; case 1: display.setcurrent(form2); break; if(command == back) display.setcurrent(list); if(command == exit) // 根据所选选项的索引进行 // 相应的操作

17 destroyapp(false); notifydestroyed(); 程序运行结果如图 3-9 所示 图 3-9 Form 程序运行结果 Item 类和 Item 状态监听 Item 类的子类是 Form 中的组件 Item 有 8 个直接子类, 下面主要介绍其中常用的 6 个, 如表 3-4 所示 表 3-4 Item 常用子类 Item 子类名称 StringItem TextField DataField Gauge ChoiceGroup ImageItem 描述在用户界面显示字符串单行的输入区域用于输入日期的 TextField 显示进度以及从一个范围中选取一个值的控件类似于单选框 复选框的控件显示图片的控件 1.StringItem StringItem 是包含一个字符串的 Form( 表单 ) 组件, 只用来显示而不能编辑内容, 但应用程序可以更改它的标签和文本内容 StringItem 的构造方法形式如下 : StringItem(String label,string text) 其中需要两个参数 label 和 text, 分别用来构造 StringItem 的标签和文本内容, 也可以把它们设置为 null, 表示标签或文本为空 程序示例如下 实例 3-9 StringItem 的应用 67 import javax.microedition.midlet.*; 第 3 章高级用户界面

18 J2ME 手机游戏开发技术与实践 ( 第 2 版 ) import javax.microedition.lcdui.*; 68 public class StringItemTest extends MIDlet implements CommandListener private Display display; Command commit; public StringItemTest() display = Display.getDisplay(this); public void startapp() commit = new Command(" 确定 ",Command.SCREEN,1); Form f = new Form("StringItem 测试 "); f.append(" 开始游戏 "); f.append(new StringItem(null," 游戏介绍 ")); // 增加字符串组件对象 f.append(new StringItem(" 超级玛莉 "," 主人公介绍 ")); f.append(new StringItem(" 蘑菇道具 "," 道具的使用 ")); f.addcommand(commit); f.setcommandlistener(this); display.setcurrent(f); public void pauseapp() public void destroyapp(boolean unconditional) public void commandaction(command c,displayable s) Form tmp = (Form) s; for(int i = 0; i < tmp.size(); i++) StringItem si = (StringItem)tmp.get(i);// 获得当前选项 System.out.println(si.getText()); // 在控制台输出当前选项的文本内容 程序运行结果如图 3-10 所示 2.TextField 在和手机交互的过程中, 文本输入框是最常见的 例如, 输入姓名 电话号码 网址及短信等,J2ME 中提供了 TextField 这个控件 TextField 和 TextBox 有点相似, 可用于文本的显示和编辑 不过 TextBox 是多行的, 而 TextField 是单行的 而且 TextBox 是全屏类型的对象,TextField 是 Item 的直接子类, 只能被容器包含, 不能够单独显示 TextField 的构造方法形式如下 : public TextField(String label,string text,int maxsize,int constraints) 图 3-10 StringItem 程序运行结果构造方法中有 4 个参数,label 表示组件标签 ;text 表示初始的文本内容, 如果要设置为空则使用 null;maxsize 表示字符的最大容量, 与 TextBox 中的意义和用法相同 ;constraints 表示输入约束, 与 TextBox 中的意义和用法相同 程序示例如下 实例 3-10 TextField 的应用 import javax.microedition.midlet.*;

19 import javax.microedition.lcdui.*; public class TextFieldTest extends MIDlet implements ItemStateListener private Display display; Command commit; public TextFieldTest() display = Display.getDisplay(this); public void startapp() commit = new Command(" 确定 ",Command.SCREEN,1); Form f = new Form("TextFieldTest"); // 在当前表单下添加文本框 f.append(new TextField(" 请输入玩家名称 :"," 孙大圣 ",4,TextField.ANY)); f.addcommand(commit); display.setcurrent(f); public void pauseapp() public void destroyapp(boolean unconditional) 程序运行结果如图 3-11 所示 3.ItemStateListener 接口当放置于 Form 内部的组件状态发生改变时,Form 组件会对所有经由 setitemstate Listener() 方法向它注册的类中的 itemstatechanged() 方法发出状态改变的消息 ItemStateListener 只在用户交互中组件状态真的被改变时,itemStateChanged() 方法才被调用 应用程序使用 ItemStateListener 接口来接收 Form 对象内可交互组件的事件, 这些事件用来指示组件内部状态的改变 以下操作会调用 itemstatechanged (Item item ) 方法 (1) 输入或者改变了 TextField 中的值 ; (2) 改变 ChoiceGroup 中的选择状态 ; 图 3-11 TextField 程序运行结果 (3) 调整了 Gauge 的值 ; (4) 在 DateField 中输入一个新的日期或时间 在上例的 TextField 中, 如果需要如下操作 : 只要用户改变了 TextField 的内容, 就在控制台上输出 TextField 的内容, 需要使用 ItemStateListener 接口, 则首先让主类实现 ItemStateListener 接口 public class TextFieldTest extends MIDlet implements ItemStateListener 随后注册监听 : f.setitemstatelistener(this); 最后, 实现 ItemStateListener 接口里的 itemstatechanged() 方法 : 69 Public void itemstatechanged(item item) 第 3 章高级用户界面

20 J2ME 手机游戏开发技术与实践 ( 第 2 版 ) 70 完整代码实现如下 实例 3-11 ItemStateListener 接口的应用 import javax.microedition.midlet.*; import javax.microedition.lcdui.*; public class ItemStaListest extends MIDlet implements ItemStateListener private Display display; Command commit; public ItemStaListest() display = Display.getDisplay(this); public void startapp() commit = new Command(" 确定 ",Command.SCREEN,1); Form f = new Form("TextFieldTest"); f.append(new TextField(" 请输入玩家名称 :"," 孙大圣 ",4,TextField.ANY)); f.addcommand(commit); f.setitemstatelistener(this); // 注册监听表单里的组件状态 display.setcurrent(f); public void pauseapp() public void destroyapp(boolean unconditional) public void itemstatechanged(item item) // 当文本框内容改变时触发此方法 TextField tmp = (TextField)item; // 转换成 TextField 类型 System.out.println(tmp.getString()); // 在控制台输出文本框中的内容 每当用户改变 TextField 的内容时,itemStateChanged() 方法就会被调用 其中的参数是发生变化的 Item 对象 对其进行处理之前, 需将其转换为相应的子类对象, 即 TextField 对象 最后使用 TextField 的 getstring() 方法取得 TextField 的文本内容 4.ChoiceGroup ChoiceGroup 定义了一组可以放在窗体中的可选元素 它与 List 类似, 但最大不同在于 ChoiceGroup 必须依附在 Form 之中才有用, 而且只有 Choice.EXCLUSIVE( 单选 ) Choice.MULTIPLE ( 多选 ) 及 Choice.POPUP ( 弹出式菜单 ) 三种类型, 无法使用 Choice.IMPLICIT 类型 ChoiceGroup 的构造方法形式如下 : Public ChoiceGroup(String label,int choicetype) public ChoiceGroup(String label, int choicetype, String[] values, Image[] images); 第 1 个参数定义一个 label, 一个可选字符串, 显示在 ChoiceGroup 的上方或旁边 如果不需要 label 就传递 null 第 2 个参数定义选择方式 第 1 种构造函数创建一个空的 ChoiceGroup, 内容在运行时是变化的情况下才有用 如果一个 ChoiceGroup 的内容是静态的, 则使用第 2 种构造函数的第 3 和第 4 个参数定义其初始内容, 如下所示 : public static final String[] values = new String[] "Apples", "Oranges", "Bananas"; ChoiceGroup cg = new ChoiceGroup("Fruit", Choice.MULTIPLE,values,null);

21 无论 ChoiceGroup 是如何被初始化的, 都可以在运行时改变它的设置值, 即使用 append() delete() 及 insert() 等方法来实现 程序示例如下 实例 3-12 ChoiceGroup 的应用 import javax.microedition.midlet.*; import javax.microedition.lcdui.*; public class ChoiceGroupTest extends MIDlet implements ItemStateListener private Display display; private Form myform; // 声明三个 ChoiceGroup private ChoiceGroup myexclusivechoicegroup; private ChoiceGroup mymultiplechoicegroup; private ChoiceGroup mypopchoicegroup; // 通过 StringItem 将选中的信息显示出来 private StringItem mychoice; // 构造方法 public ChoiceGroupTest() // 初始化 display=display.getdisplay(this); mychoice=new StringItem(" 玩家基本信息 :",null); myform=new Form("ChoiceGrop 实例测试 "); // 采用两个参数的构造方法创建 ChoiceGroup 对象, 类型是单选按钮 myexclusivechoicegroup=new ChoiceGroup(" 选择性别 ",Choice.EXCLUSIVE); myexclusivechoicegroup.append(" 男 ", null); myexclusivechoicegroup.append(" 女 ", null); // 采用 4 个参数的构造方法创建 ChoiceGroup 对象, 类型是多选按钮 String [] aihaotype=" 看书 "," 篮球 "," 乒乓球 "," 爬山 "," 音乐 "; mymultiplechoicegroup=new ChoiceGroup(" 爱好 ",Choice.MULTIPLE,aihao Type,null); // 采用两个参数的构造方法创建 ChoiceGroup 对象, 类型是弹出式 mypopchoicegroup=new ChoiceGroup(" 选择婚姻状况 ",Choice.POPUP); mypopchoicegroup.append(" 已婚 ", null); mypopchoicegroup.append(" 未婚 ", null); myform.append(myexclusivechoicegroup); // 将 Item 对象添加到 form 中进行显示 myform.append(mymultiplechoicegroup); myform.append(mypopchoicegroup); myform.append(mychoice); myform.setitemstatelistener(this); // 注册监听 protected void destroyapp(boolean arg0) throws MIDletStateChangeException protected void pauseapp() protected void startapp() throws MIDletStateChangeException display.setcurrent(myform); public void itemstatechanged(item item) // 对应的各个 ChoiceGroup 被改变时, 将其通过 StringItem 显示出来 if(item==myexclusivechoicegroup) // 如果是单选类型 int index=myexclusivechoicegroup.getselectedindex(); // 获取所选项目 // 索引 71 第 3 章高级用户界面

22 J2ME 手机游戏开发技术与实践 ( 第 2 版 ) 72 // 设置所选择项目索引的字符串在 mychoice 中显示 mychoice.settext("\n"+myexclusivechoicegroup.getstring(index) +"\n"); if(item==mymultiplechoicegroup) // 如果是多选类型 String tmp="\n"; for(int i=0;i<mymultiplechoicegroup.size();i++) boolean index=mymultiplechoicegroup.isselected(i); if(index) // 判断是否选择了某项目 tmp=tmp+mymultiplechoicegroup.getstring(i)+"\n"; mychoice.settext(tmp); if(item==mypopchoicegroup) // 如果是弹出类型 int index=mypopchoicegroup.getselectedindex(); mychoice.settext("\n"+mypopchoicegroup.getstring(index)+"\n"); 上例程序分别用到了 ChoiceGroup 的两种构造方法, 并使用了它的三种类型, 对于每种类型的 ChoiceGroup 都可以选择项目, 并在 mychoice 中显示出来 程序运行结果如图 3-12 所示 图 3-12 ChoiceGroup 程序运行结果 如果想把选择的信息全部放在 mychoice 里面, 可以将方法 itemstatechanged(item item) 中的代码进行如下修改 public void itemstatechanged(item item) mychoice.settext("\n");

23 int index=myexclusivechoicegroup.getselectedindex(); mychoice.settext(mychoice.gettext()+myexclusivechoicegroup.getstring (index)+"\n"); String tmp=""; for(int i=0;i<mymultiplechoicegroup.size();i++) boolean index1=mymultiplechoicegroup.isselected(i); if(index1) tmp=tmp+mymultiplechoicegroup.getstring(i)+"\n"; mychoice.settext(mychoice.gettext()+tmp); int index2=mypopchoicegroup.getselectedindex(); mychoice.settext(mychoice.gettext()+mypopchoicegroup.getstring(index2) +"\n"); 修改代码后, 程序运行结果如图 3-13 所示 图 3-13 ChoiceGroup 修改后的程序运行结果 5.Gauge Gauge 的用途非常广泛, 一般常用于让用户做大小调整, 或是当作进度指示器使用 Gauge 的构造方法形式如下 : public Gauge(String label,boolean interactive,int maxvalue,int initial Value) 参数 label 代表标尺的名称 interactive 可以是 true 或 false, 代表交互标尺或非交互标尺, 在交互模式中, 用户可以修改指示器的当前值 通常, 用户可以使用移动电话的左右两个方向按键来增加或者减小标尺的值 在非交互模式中, 用户不能修改当前值 maxvalue 代表标尺的最大值, 必须大于 0 initialvalue 代表标尺的初始值 程序示例如下 实例 3-13 Gauge 的应用 73 import javax.microedition.lcdui.*; import javax.microedition.midlet.*; 第 3 章高级用户界面

24 J2ME 手机游戏开发技术与实践 ( 第 2 版 ) 74 public class GaugeTest extends MIDlet implements ItemStateListener private Display display; Gauge g1; // 声明 Gauge 对象引用 g1 Gauge g2; // 声明 Gauge 对象引用 g2 Gauge g3; // 声明 Gauge 对象引用 g3 public GaugeTest() display = Display.getDisplay(this); public void startapp() Form f = new Form("Gauge test"); g1 = new Gauge("voice",true,10,4); //g1 可以交互 g2 = new Gauge("voice+",false,10,4); //g2 不可以交互 g3 = new Gauge("voice-",false,10,6); //g3 不可以交互 f.append(g1); f.append(g2); f.append(g3); f.setitemstatelistener(this); // 监听表单 display.setcurrent(f); public void itemstatechanged(item item) if(item==g1) g2.setvalue(g1.getvalue()); // 设置 g2 的标尺值为 g1 的标尺值 g3.setvalue(10-g1.getvalue()); // 设置 g3 的标尺值 public void pauseapp() public void destroyapp(boolean unconditional) 程序运行结果如图 3-14 所示 在本例中, 由于传入 false 会造成长条状的 Gauge, 无法用按钮改变它的值, 必须在程序里利用 setvalue() 方法设定其值 ; 反之, 如果传入 true, 不但可以造成有高低起伏的 Gauge, 而且一旦该 Gauge 被选择之后, 还会出现箭头供调整其值 任何时候都可以使用 getmaxvalue() 方法或 setmaxvalue() 方法来取得或设定允许的最大值, 也可以使用 getvalue() 方法或 setvalue() 方法来设定当时的初始值 6.DataField DateField 是一种可以放到 Form 对象上的可编辑组件, 用来表示日历中的日期和时间信息 它有两种构造方法, 形式如下 : 图 3-14 Gauge 程序运行结果 DateField(String label,int mode) DateField(String label,int mode,timezone timezone) 两种构造方法都指定了标签和输入模式, 后者还指定了时区 如果 timezone 为 null,

25 则使用系统默认时区 程序示例如下 实例 3-14 DateField 的应用 import javax.microedition.lcdui.*; import javax.microedition.midlet.*; import java.util.*; public class DateFieldTest extends MIDlet private Display display; public test() display = Display.getDisplay(this); public void startapp() Form f = new Form(" 日期测试 "); Date now = new Date(); DateField df = new DateField ("DateFieldTest",DateField.DATE_TIME,TimeZone.getTimeZone("GMT +08")); // 标题, 显示类型和时区 df.setdate(now); // 显示当前时间和日期 f.append(df); display.setcurrent(f); public void pauseapp() public void destroyapp(boolean unconditional) DataField 的模式有三种, 分别为 DateField.DATE( 日期信息 ) DateField.TIME( 时间信息 ) 和 DateField.DATE_TIME( 日期和时间信息 ) 本例采用了第三种模式, 程序运行结果如图 3-15 所示 图 3-15 DateField 程序运行结果 7.ImageItem ImageItem 组件能够在 Form 中显示图片, 从而实现图文混排的效果 ImageItem 的用法与 StringItem 相似 如果要在 Form 之中加入 ImageItem, 可以使用 append() 方法, 然后 75 第 3 章高级用户界面

26 J2ME 手机游戏开发技术与实践 ( 第 2 版 ) 传入一个 ImageItem 即可 ImageItem 的构造方法形式如下 : 76 public ImageItem(String label,image img,int layout,string alttext); 构造 ImageItem 对象, 需要使用 4 个参数, 分别是标签 图像对象 布局方式和替换用的文本字符串 如果显示器不能正确地显示图像, 就在放图像的位置显示 alttext 参数指定的字符串,layout 参数决定了 ImageItem 的显示位置, 其参数是 ImageItem 类的静态常量, 如表 3-5 所示 表 3-5 layout 的参数说明 ImageItem.LAYOUT_CENTER 图像居中 ImageItem.LAYOUT_DEFAULT 图像容器的默认格式 ImageItem.LAYOUT_LEFT 图像居左 ImageItem.LAYOUT_NEWLINE_AFTER 绘制图像以后换行 ImageItem.LAYOUT_NEWLINE_BEFORE 绘制图像之前换行 ImageItem.LAYOUT_ RIGHT 图像居右 实例 3-15 DateField 的应用 import javax.microedition.midlet.*; import javax.microedition.lcdui.*; public class ImageItemTest extends MIDlet private Display display; Command commit; public ImageItemTest() display = Display.getDisplay(this); public void startapp() commit = new Command("Commit",Command.SCREEN,1); Form f = new Form("ImageItemTest"); f.append(" 显示图片 \n"); try Image image = Image.createImage("/cai01.png"); // 载入图片 ImageItem ima = new ImageItem ("pic",image,imageitem.layout_center,"error"); f.append(ima); catch(exception e) System.out.println(e.getMessage()); f.addcommand(commit); display.setcurrent(f); public void pauseapp() public void destroyapp(boolean unconditional) 程序运行结果如图 3-16 所示

27 图 3-16 ImageItem 程序运行结果 小 结 本章主要介绍了 MIDP 高级用户界面, 占用手机整个屏幕的 4 个控件分别是 :Alert List TextBox 和 Form 其中,Form 是一个特殊的控件, 它不仅是一个可显示的控件, 而且是一个可以容纳 Item 的容器 在 Item 中, 介绍了 StringItem TextField ChoiceGroup Gauge DataField 和 ImageItem 组件, 以及对应的高级事件处理机制 思考题 1. 高级用户界面的类结构是什么? 2.TextBox 组件的作用是什么? 3.List 组件的作用和类型是什么? 4. 可作为容器的组件有哪些? 77 第 3 章高级用户界面