可视 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 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 组件的详细信息。
返回页首
另请参见
返回页首
