可视 Mobile 设计器定制组件：创建个人信息管理器应用程序
可视 Mobile 设计器 (Visual Mobile Designer, VMD) 是 NetBeans Mobility 中的图形界面，您可以在该界面中使用拖放式组件设计 Mobile 应用程序。通过 VMD，您可以使用 IDE 提供的组件或您自己设计的组件定义应用程序流和设计 GUI。VMD 包含很多标准用户界面 (User Interface, UI) 组件，您可以使用这些组件创建应用程序，如 "Lists"（列表）、"Alerts"（警报）、"Forms"（表单）、"Images"（图像）。它还包含一些定制组件，用于简化创建较复杂功能的过程，例如 "Wait Screen"（等待屏幕）、"Splash Screens"（闪屏）和 "Table Items"（表项）等。
PIM 浏览器是一个定制组件，它可以用于轻松访问标准移动设备功能，如日历、通讯簿或任务列表。您可以使用 PIM 浏览器组件，使 Mobile Java 应用程序能够访问本地存储的个人信息数据库。该组件使用 PIM（个人信息管理）API，后者包含在 Java ME 平台的 JSR-75 规范的 PDA 可选包中。由于 JSR-75 不是 MIDP 2.0 规范的一部分，因此从定义上讲，它是一个定制组件，只能在支持 JSR-75 的设备上使用。
本教程介绍如何在支持 JSR-75 的设备的 Mobile 应用程序中使用 PIM 浏览器组件。它还介绍了该组件的基本功能，如浏览设备的 contact 数据库、日历或待做任务列表内容。除了 PIM 浏览器以外，我们还需要使用其他三个组件："Splash Screen"（闪屏）、"Text Box"（文本框）和 "Alert"（警报）。
注意：如果使用的是 NetBeans IDE 6.8，请参阅在 NetBeans IDE 6.8 中创建个人信息管理器应用程序教程。
目录
要学习本教程，您需要具备下列软件和资源。
如果您对 NetBeans Mobility 不太熟悉，应先阅读 NetBeans Java ME MIDP 快速入门指南，然后再继续学习本教程。
安装并运行样例应用程序
开始之前，您可能希望查看本教程的最终结果。
请执行下列步骤以安装 PIMBrowserExample 应用程序：
- 下载 PIMBrowserExample.zip
- 解压缩该文件。
- 在 IDE 中，选择 "File"（文件）> "Open Project"（打开项目），然后浏览至包含 PIMBrowserExample 项目的解压缩文件的文件夹。
- 单击 "Open Project"（打开项目）。
"Projects"（项目）窗口应如下所示：
- 在 "Projects"（项目）窗口中，右键单击项目节点并选择 "Run Project"（运行项目）（或按 F6）。当应用程序运行时，将会打开一个仿真器窗口，其中显示了在缺省设备仿真器中运行的应用程序。
- 在仿真器窗口中，单击 "Launch" 下面的按钮。
仿真器将显示闪屏组件，然后显示 PIM 浏览器，如下所示：
- 单击仿真器右上方的按钮以显示菜单项，如下所示：
- 如果选中 "Details"（详细信息）项，请单击仿真器上的中心按钮，以显示联系人详细信息：
- 将光标上移或下移以在可用的位置中导航。
- 单击 "Back" 下方的按钮以返回到联系人列表。
- 单击 "Exit" 下面的按钮以关闭应用程序。
返回页首
使用 PIM 浏览器定制组件创建应用程序
现在，您已看到运行中的 PIM 浏览器组件，接下来让我们从头开始创建此应用程序。要创建该应用程序，请执行以下操作：
- 创建 PIMBrowserExample 项目
- 在项目中添加包和 Visual MIDlet
- 在项目中添加组件
- 在项目中添加命令
- 连接组件以创建应用程序流
- 在 Wireless Toolkit Contact 数据库中添加联系人
- 运行项目
创建 PIMBrowserExample 项目
- 选择 "File"（文件）> "New Project"（新建项目）（Ctrl-Shift-N 组合键）。在 "Categories"（类别）下，选择 "Java ME"。在 "Projects"（项目）下，选择 "Mobile Application"（Mobile 应用程序），然后单击 "Next"（下一步）。
- 在 "Project Name"（项目名称）字段中输入
PIMBrowserExample。将Project Location（项目位置）更改为系统中的某个目录。从现在开始，我们将此目录称为 $PROJECTHOME。
- 取消选中 "Create Hello MIDlet"（创建 Hello MIDlet）复选框。单击 "Next"（下一步）。
- 将 "Java (TM) Platform Micro Edition SDK 3.0" 保留为选定的仿真器平台。单击 "Next"（下一步）。
- 在 "More Configurations Selection"（选择更多配置）中，单击 "Finish"（完成）。
注意：该项目文件夹中包含所有源代码和项目 meta 数据，如项目的 Ant 脚本。
在项目中添加包和 Visual MIDlet
- 在 "Project"（项目）视图中选择
PIMBrowserExample 项目，然后选择 "File"（文件）> "New File"（新建文件）（Ctrl-N 组合键）。在 "Categories"（类别）下，选择 "Java"。在 "File Types"（文件类型）下，选择 "Java Package"（Java 包）。单击 "Next"（下一步）。
- 在 "Package Name"（包名）字段中输入
pimbrowserexample。单击 "Finish"（完成）。
- 在 "Project"（项目）视图中选择
pimbrowserexample 包，然后选择 "File"（文件）> "New File"（新建文件）（Ctrl-N 组合键）。在 "Categories"（类别）下，选择 "MIDP"。在 "File Types"（文件类型）下，选择 "Visual MIDlet"。单击 "Next"（下一步）。
- 在 "MIDlet Name"（MIDlet 名称）和 "MIDP Class Name"（MIDP 类名）字段中输入
PIMBrowserExample。单击 "Finish"（完成）。
应用程序显示在可视 Mobile 设计器的 "Flow"（流）视图中。
在项目中添加组件
- 在 "Flow"（流）设计器中，从 "Component Palette"（组件面板）中拖放以下组件：
- Splash Screen（闪屏）
- Alert（警报）
- PIM Browser（PIM 浏览器）
- 单击 "splashScreen"，然后在 "Properties"（属性）窗口中将 "Text"（文本）值从 null 更改为 PIM Browser Example。
- 单击 "alert"，然后在 "Properties"（属性）窗口中将 "String"（字符串）属性值更改为 Contact selected。
在项目中添加命令
- 在 "Flow"（流）设计器中，从 "Component Palette"（组件面板）的 "Commands"（命令）类别中选择 "Exit Command"（退出命令）。
- 将其拖放至 pimBrowser 组件中。
连接组件以创建应用程序流
在 "Flow"（流）设计器中，单击 "Mobile Device"（移动设备）上的 "Started"（已启动），然后将其拖至 splashScreen 组件中。采用相同的方法，按照下图所示连接各个组件。
在 Wireless Toolkit Contact 数据库中添加联系人
将样例联系人复制到 $JAVAME-SDKHOME/3.0/work/0/appdb/PIM/contacts/Contacts/ 用户目录的 javame-sdk 文件夹中。
缺省情况下，此文件夹中包含以下三个文件：
1.vcf
2.vcf
categories.txt
运行项目
按 F6 键以运行主项目，或者选择 "Run"（运行）> "Run Main Project"（运行主项目）。
返回页首
PIM 浏览器组件的 Javadoc
NetBeans IDE 提供了 PIMBrowser 组件以及可在 VMD 中使用的其他组件的 API Javadoc。要阅读 PIMBrowser 组件的 Javadoc，请执行以下操作：
- 将光标放在源代码中的 PIMBrowser 组件上，然后按 Ctr-Shift-空格组合键（或选择 "Source"（源）> "Show Documentation"（显示文档））。
此时将在弹出式窗口中显示该元素的 Javadoc。
- 在弹出式窗口中单击 "Show documentation in external web browser"（在外部 Web 浏览器中显示文档）图标 (
)，以便在浏览器中查看有关 PIMBrowser 组件的详细信息。
返回页首
另请参见
返回页首
