corner imagecorner image
IDEPlatformPluginsDocs & SupportCommunityPartners

可视 Mobile 设计器定制组件：创建个人信息管理器应用程序

可视 Mobile 设计器 (VMD) 是 NetBeans Mobility 中的图形界面，您可以在该界面中使用拖放式组件设计移动应用程序。通过使用 VMD，您可以使用 IDE 提供的组件或您自己设计的组件定义应用程序流和设计 GUI。VMD 包含很多标准用户界面 (UI) 组件，您可以使用这些组件创建应用程序，如列表、警报、窗体和图像。它还包含一些定制组件，用于简化创建较复杂组件的过程，例如，等待屏幕、闪屏和表项等。

PIM 浏览器是一个定制组件，它可以轻松访问标准移动设备功能，如日历、通讯簿或任务列表。您可以使用 PIM 浏览器组件，以允许移动 Java 应用程序访问本地存储的个人信息数据库。该组件使用 PIM（个人信息管理）API，它是适用于 Java ME 平台的 JSR-75 规范 PDA 可选包的一部分。由于 JSR-75 不是 MIDP 2.0 规范的一部分，因此，从定义上讲，它是一个定制组件，只能在支持 JSR-75 的设备上使用。

本教程介绍如何在支持 JSR-75 的设备的移动应用程序中使用 PIM 浏览器组件。本教程介绍了该组件的基本功能，例如，浏览设备的 contact 数据库、日历或待做任务列表内容。除了 PIM 浏览器以外，我们还需要使用三个其他组件：闪屏、文本框和警报。

注意：如果使用的是 NetBeans IDE 6.8，请参阅在 NetBeans IDE 6.8 中创建个人信息管理器应用程序教程。

目录

本页上的内容适用于 NetBeans IDE 6.9 和 7.0

要学习本教程，您需要具备以下软件和资源。

软件或资源 要求的版本
带有 Java ME 的 NetBeans Beans 版本 6.9 和 7.0
Java Development Kit (JDK) 版本 6

如果您对 NetBeans Mobility 不太熟悉，应先阅读 NetBeans Java ME MIDP 快速入门指南，然后再继续学习本教程。

安装并运行样例应用程序

开始之前，您可能希望查看本教程的最终结果。

请执行下列步骤以安装 PIMBrowserExample 应用程序：

  1. 下载 PIMBrowserExample.zip。
  2. 解压缩该文件。
  3. 在 IDE 中，选择“文件”>“打开项目”，然后浏览到包含 PIMBrowserExample 项目的解压缩文件的文件夹。
  4. 单击“打开项目”。
    “项目”窗口应如下所示：

    5. 打开了 PIM 浏览器示例的“项目”窗口

  5. 在“项目”窗口中，右键单击项目节点并选择“运行项目”（或按 F6）。当应用程序运行时，将会打开一个仿真器窗口，其中显示了在缺省设备仿真器中运行的应用程序。

    6. 注意：缺省情况下，联系人列表为空。有关如何填充联系人列表的信息，请参见在 Wireless Toolkit Contact 数据库中添加联系人。

  6. 在仿真器窗口中，单击 "Launch" 下面的按钮。
    仿真器将显示闪屏组件，然后显示 PIM 浏览器，如下所示：

    7. 显示样例 PIM 浏览器应用程序的 WTK 2.5 仿真器

  7. 单击中心按钮以显示联系人详细信息：

    8. 显示样例 PIM 浏览器应用程序的 WTK 2.5 仿真器

  • 将光标上移或下移以在可用的位置之间导航。
  • 单击 "Back" 下面的按钮以返回到联系人列表。
  • 单击 "Exit" 下面的按钮以关闭应用程序。

返回页首

使用 PIM 浏览器定制组件创建应用程序

现在，您已看到运行中的 PIM 浏览器组件，接下来让我们从头开始创建此应用程序。要创建此应用程序，请执行以下操作：

  1. 创建 PIMBrowserExample 项目
  2. 在项目中添加包和 Visual MIDlet
  3. 在项目中添加组件
  4. 在项目中添加命令
  5. 连接组件以创建应用程序流
  6. 在 Wireless Toolkit Contact 数据库中添加联系人
  7. 运行项目

创建 PIMBrowserExample 项目

  1. 选择“文件”>“新建项目 (Ctrl-Shift-N)”。在“类别”下，选择 "Java ME"。在“项目”下，选择“Mobile 应用程序”，然后单击“下一步”。
  2. 在“项目名称”字段中输入 PIMBrowserExample。将“项目位置”更改为系统中的某个目录。从现在开始，我们将此目录称为 $PROJECTHOME。
  3. 取消选中“创建 Hello MIDlet”复选框。单击“下一步”。
  4. 将 "Sun Java Wireless Toolkit " 保留为选定的仿真器平台。单击“下一步”。
  5. 单击“完成”。

    6. 注意：此项目文件夹包含所有源代码和项目 meta 数据，例如，项目的 Ant 脚本。

向项目中添加包和 Visual MIDlet

  1. 在“项目”视图中选择 PIMBrowserExample 项目，然后选择“文件”>“新建文件 (Ctrl-N)”。在“类别”下选择 "Java"。在“文件类型”下，选择“Java 包”。单击“下一步”。
  2. 在“包名”字段中输入 pimbrowserexample。单击“完成”。
  3. 在“项目”视图中选择 pimbrowserexample 包，然后选择“文件”>“新建文件 (Ctrl-N)”。在“类别”下，选择 "MIDP"。在“文件类型”下，选择 "Visual MIDlet"。单击“下一步”。
  4. 在“MIDlet 名称”和“MIDP 类名”字段中输入 PIMBrowserExample。单击“完成”。
    应用程序显示在可视 Mobile 设计器的“流”视图中。

在项目中添加组件

  1. 在流设计器中，从组件面板中拖放以下组件：
    • 闪屏
    • 警报
    • PIM 浏览器
  2. 单击 "splashScreen"，然后在“属性”窗口中将“文本”值从 null 更改为 PIM Browser Example。
  3. 单击 "alert"，然后在“属性”窗口中将字符串属性值更改为 Contact selected。

在项目中添加命令

  1. 在流设计器中，从组件面板的“命令”类别中选择“退出命令”。
  2. 将其拖放至 pimBrowser 组件中。

连接组件以创建应用程序流

在流设计器中，单击“移动设备”上的“已启动”，然后将其拖至 splashScreen 组件上。采用相同的方法，按照下图所示连接各个组件。

显示包含由命令线连接的组件的流设计器

在 Wireless Toolkit Contact 数据库中添加联系人

将样例联系人复制到 $J2MEWTKHOME/2.5.2/appdb/DefaultColorPhone/pim/contacts/Contacts/ 用户目录的 j2mewtk 文件夹中。缺省情况下，该文件夹为空，因此，至少需要复制一个文件（联系人）才能测试 PIMBrowserExample 项目。

运行项目

按 F6 键以运行主项目，或者选择“运行”>“运行主项目”。

返回页首

PIM 浏览器组件的 Javadoc

NetBeans IDE 提供了 PIMBrowser 组件以及可以在 VMD 中使用的其他组件的 API Javadoc。要阅读 PIMBrowser 组件的 Javadoc，请执行以下操作：

  1. 将光标放在源代码中的 PIMBrowser 组件上，然后按 Ctr-Shift-空格键（或选择“源”>“显示文档”）。
    将在弹出式窗口中显示该元素的 Javadoc。
  2. 在弹出式窗口中单击“在外部 Web 浏览器中显示文档”图标 (在外部 Web 浏览器中显示文档)，以查看有关浏览器中的 PIMBrowser 组件的详细信息。

返回页首


另请参见

返回页首