| <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> | |
| <!-- | |
| Copyright (c) 2009, 2010, Oracle and/or its affiliates. All rights reserved. | |
| --> | |
| <HTML> | |
| <HEAD> | |
| <TITLE>可视 Mobile 设计器定制组件：创建个人信息管理器应用程序 - NetBeans Java ME 教程</TITLE> | |
| <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" > | |
| <link rel="stylesheet" type="text/css" href="../../../netbeans.css"> | |
| <meta name="author" content="Karol Harelzak"> | |
| </HEAD> | |
| <BODY> | |
| <a name="top"></a> | |
| <H1>可视 Mobile 设计器定制组件：创建个人信息管理器应用程序</H1> | |
| <P>可视 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"（表项）等。 </P> | |
| <p>PIM 浏览器是一个定制组件，它可以用于轻松访问标准移动设备功能，如日历、通讯簿或任务列表。您可以使用 PIM 浏览器组件，使 Mobile Java 应用程序能够访问本地存储的个人信息数据库。该组件使用 PIM（个人信息管理）API，后者包含在 Java ME 平台的 <a href="http://jcp.org/en/jsr/detail?id=75">JSR-75 规范</a>的 PDA 可选包中。由于 JSR-75 不是 MIDP 2.0 规范的一部分，因此从定义上讲，它是一个定制组件，只能在支持 JSR-75 的设备上使用。</p> | |
| <P>本教程介绍如何在支持 JSR-75 的设备的 Mobile 应用程序中使用 PIM 浏览器组件。它还介绍了该组件的基本功能，如浏览设备的 contact 数据库、日历或待做任务列表内容。除了 PIM 浏览器以外，我们还需要使用其他三个组件："Splash Screen"（闪屏）、"Text Box"（文本框）和 "Alert"（警报）。 | |
| </P> | |
| <!--<p class="notes"><b>注意：</b>如果使用的是 NetBeans IDE 6.8，请参阅<a href="../../68/javame/pimbrowser.html">在 NetBeans IDE 6.8 中创建个人信息管理器应用程序</a>教程。</p>--> | |
| <p><b>目录</b></p> | |
| <img src="../../../images_www/articles/69/netbeans-stamp-69-70-71.png" class="stamp" alt="本页上的内容适用于 NetBeans IDE 6.9 及更高版本" title="本页上的内容适用于 NetBeans IDE 6.9 及更高版本" > | |
| <ul class="class"> | |
| <li><a href="#sample-app">安装并运行样例应用程序</a></li> | |
| <li><a href="#create-app">使用 PIM 浏览器定制组件创建应用程序</a></li><div> | |
| <ul> | |
| <LI><A HREF="#create">创建 PIMBrowserExample 项目</A> </LI> | |
| <LI><A HREF="#add">在项目中添加包和 Visual MIDlet</A> </LI> | |
| <LI><A HREF="#addcomponent">在项目中添加组件</A> </LI> | |
| <LI><A HREF="#addcommands">在项目中添加命令</A> </LI> | |
| <LI><A HREF="#connect">连接组件以创建应用程序流</A> </LI> | |
| <LI><A HREF="#storage">在 Wireless Toolkit Contact 数据库中添加联系人</A></LI> | |
| <LI><A HREF="#run">运行项目</A> </LI> | |
| </ul></div> | |
| <li><a href="#javadoc-pim">PIM 浏览器组件的 Javadoc</a></li> | |
| <li><a href="#see-also">另请参见</a></li> | |
| </ul> | |
| <p><b>要学习本教程，您需要具备下列软件和资源。</b></p> | |
| <table> | |
| <tbody> | |
| <tr> | |
| <th class="tblheader" scope="col">软件或资源</th> | |
| <th class="tblheader" scope="col">要求的版本</th> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"><a href="https://netbeans.org/downloads/index.html">带有 Java ME 的 NetBeans Beans</a></td> | |
| <td class="tbltd1">版本 6.9 及更高版本 </td> | |
| </tr> | |
| <tr> | |
| <td class="tbltd1"><a href="http://www.oracle.com/technetwork/java/javase/downloads/index.html">Java Development Kit</a> (JDK)</td> | |
| <td class="tbltd1">版本 6 和 7 </td> | |
| </tr> | |
| </tbody> | |
| </table> | |
| <p>如果您对 NetBeans Mobility 不太熟悉，应先阅读 <A HREF="../../docs/javame/quickstart.html"> NetBeans Java ME MIDP 快速入门指南</A>，然后再继续学习本教程。</p> | |
| <a name="sample-app"></a> | |
| <H2>安装并运行样例应用程序</H2> | |
| <P>开始之前，您可能希望查看本教程的最终结果。 | |
| </P> | |
| <P>请执行下列步骤以安装 PIMBrowserExample 应用程序：</P> | |
| <OL> | |
| <LI>下载 <A HREF="https://netbeans.org/projects/samples/downloads/download/Samples/Mobile/PIMBrowserExample.zip">PIMBrowserExample.zip</A></LI> | |
| <LI>解压缩该文件。</LI> | |
| <LI>在 IDE 中，选择 "File"（文件）> "Open Project"（打开项目），然后浏览至包含 <tt>PIMBrowserExample</tt> 项目的解压缩文件的文件夹。<tt></tt><tt></tt></li> | |
| <li>单击 "Open Project"（打开项目）。<br> | |
| "Projects"（项目）窗口应如下所示： </li> | |
| <p class="align-center"><img src="../../../images_www/articles/71/mobility/pimbrowser/pim-project.png" border=1 alt="打开了 PIM 浏览器示例的 "Project"（项目）窗口"> </p> | |
| <LI>在 "Projects"（项目）窗口中，右键单击项目节点并选择 "Run Project"（运行项目）（或按 F6）。当应用程序运行时，将会打开一个仿真器窗口，其中显示了在缺省设备仿真器中运行的应用程序。 </LI> | |
| <LI>在仿真器窗口中，单击 "Launch" 下面的按钮。<BR>仿真器将显示闪屏组件，然后显示 PIM 浏览器，如下所示：</li> | |
| <p class="align-center"> <img src="../../../images_www/articles/71/mobility/pimbrowser/pim-emulator70.png" border=1 alt="显示样例 PIM 浏览器应用程序的 SDK 3.0 仿真器"></p> | |
| <li>单击仿真器右上方的按钮以显示菜单项，如下所示： | |
| <p class="align-center"> <img src="../../../images_www/articles/71/mobility/pimbrowser/pim-emulator70-menu.png" border=1 alt="显示菜单项的 SDK 3.0 仿真器"></p></li> | |
| <LI>如果选中 "Details"（详细信息）项，请单击仿真器上的中心按钮，以显示联系人详细信息： </li> | |
| <p class="align-center"><img src="../../../images_www/articles/71/mobility/pimbrowser/pim-emulator2-70.png" border=1 alt="显示样例 PIM 浏览器应用程序的 WTK 2.5 仿真器"></p> | |
| </OL> | |
| <UL> | |
| <LI>将光标上移或下移以在可用的位置中导航。 </LI> | |
| <LI>单击 "Back" 下方的按钮以返回到联系人列表。 </LI> | |
| <LI>单击 "Exit" 下面的按钮以关闭应用程序。 </LI> | |
| </UL> | |
| <p class="align-center"><a href="#top">返回页首</a></p> | |
| <a name="create-app"></a> | |
| <H2 >使用 PIM 浏览器定制组件创建应用程序</H2> | |
| <P>现在，您已看到运行中的 PIM 浏览器组件，接下来让我们从头开始创建此应用程序。要创建该应用程序，请执行以下操作： </P> | |
| <OL> | |
| <LI><A HREF="#create">创建 PIMBrowserExample 项目</A> </LI> | |
| <LI><A HREF="#add">在项目中添加包和 Visual MIDlet</A> </LI> | |
| <LI><A HREF="#addcomponent">在项目中添加组件</A> </LI> | |
| <LI><A HREF="#addcommands">在项目中添加命令</A> </LI> | |
| <LI><A HREF="#connect">连接组件以创建应用程序流</A> </LI> | |
| <LI><A HREF="#storage">在 Wireless Toolkit Contact 数据库中添加联系人</A></LI> | |
| <LI><A HREF="#run">运行项目</A> </LI> | |
| </OL> | |
| <H3 ><A NAME="create"></A>创建 PIMBrowserExample 项目</H3> | |
| <OL> | |
| <LI>选择 "File"（文件）> "New Project"（新建项目）（Ctrl-Shift-N 组合键）。<tt></tt><tt></tt>在 "Categories"（类别）下，选择 "Java ME"。在 "Projects"（项目）下，选择 "Mobile Application"（Mobile 应用程序），然后单击 "Next"（下一步）。 </LI> | |
| <LI>在 "Project Name"（项目名称）字段中输入 <CODE>PIMBrowserExample</CODE>。将Project Location（项目位置）更改为系统中的某个目录。从现在开始，我们将此目录称为 <tt>$PROJECTHOME</tt>。 </LI> | |
| <LI>取消选中 "Create Hello MIDlet"（创建 Hello MIDlet）复选框。单击 "Next"（下一步）。 </LI> | |
| <LI>将 "Java (TM) Platform Micro Edition SDK 3.0" 保留为选定的仿真器平台。单击 "Next"（下一步）。 </LI> | |
| <LI>在 "More Configurations Selection"（选择更多配置）中，单击 "Finish"（完成）。 </li> | |
| <p class="notes"><b>注意：</b>该项目文件夹中包含所有源代码和项目 meta 数据，如项目的 Ant 脚本。</p> | |
| </OL> | |
| <H3 ><A NAME="add"></A>在项目中添加包和 Visual MIDlet</H3> | |
| <OL> | |
| <LI>在 "Project"（项目）视图中选择 <CODE>PIMBrowserExample</CODE> 项目，然后选择 "File"（文件）> "New File"（新建文件）（Ctrl-N 组合键）。<tt></tt><tt></tt>在 "Categories"（类别）下，选择 "Java"。在 "File Types"（文件类型）下，选择 "Java Package"（Java 包）。单击 "Next"（下一步）。 </LI> | |
| <LI>在 "Package Name"（包名）字段中输入 <CODE>pimbrowserexample</CODE>。单击 "Finish"（完成）。 | |
| </LI> | |
| <LI>在 "Project"（项目）视图中选择 <CODE>pimbrowserexample</CODE> 包，然后选择 "File"（文件）> "New File"（新建文件）（Ctrl-N 组合键）。<tt></tt><tt></tt>在 "Categories"（类别）下，选择 "MIDP"。在 "File Types"（文件类型）下，选择 "Visual MIDlet"。单击 "Next"（下一步）。 | |
| </LI> | |
| <LI>在 "MIDlet Name"（MIDlet 名称）和 "MIDP Class Name"（MIDP 类名）字段中输入 <CODE>PIMBrowserExample</CODE>。单击 "Finish"（完成）。<br> 应用程序显示在可视 Mobile 设计器的 "Flow"（流）视图中。 | |
| </LI> | |
| </OL> | |
| <H3><A NAME="addcomponent"></A>在项目中添加组件 </H3> | |
| <OL> | |
| <LI>在 "Flow"（流）设计器中，从 "Component Palette"（组件面板）中拖放以下组件： </LI> | |
| <UL> | |
| <li>Splash Screen（闪屏）<tt></tt></li> | |
| <li>Alert（警报）<tt></tt></li> | |
| <li>PIM Browser（PIM 浏览器）<tt></tt></li> | |
| </UL> | |
| <LI>单击 "splashScreen"，然后在 "Properties"（属性）窗口中将 "Text"（文本）值从 <tt>null</tt> 更改为 <tt>PIM Browser Example</tt>。<tt></tt><tt></tt> | |
| <LI>单击 "alert"，然后在 "Properties"（属性）窗口中将 "String"（字符串）属性值更改为 <tt>Contact selected</tt>。<tt></tt><tt></tt> | |
| </OL> | |
| <H3><A NAME="addcommands"></A>在项目中添加命令</H3> | |
| <OL> | |
| <li>在 "Flow"（流）设计器中，从 "Component Palette"（组件面板）的 "Commands"（命令）类别中选择 "Exit Command"（退出命令）。<tt></tt></li> | |
| <li>将其拖放至 <tt>pimBrowser</tt> 组件中。</li> | |
| </OL> | |
| <H3><A NAME="connect"></A>连接组件以创建应用程序流 </H3> | |
| <p>在 "Flow"（流）设计器中，单击 "Mobile Device"（移动设备）上的 "Started"（已启动），然后将其拖至 <tt>splashScreen</tt> 组件中。<tt></tt>采用相同的方法，按照下图所示连接各个组件。 </p> | |
| <p class="align-center"><img src="../../../images_www/articles/71/mobility/pimbrowser/pim-flow.png" border=1 alt="显示包含由命令行连接的组件的 "Flow"（流）设计器"></p> | |
| <H3><A NAME="storage"></A>在 Wireless Toolkit Contact 数据库中添加联系人</H3> | |
| <P> 将<A HREF="https://netbeans.org/files/documents/4/1613/SAMPLE.VCF">样例联系人</A>复制到 <tt>$JAVAME-SDKHOME/3.0/work/0/appdb/PIM/contacts/Contacts/</tt> 用户目录的 <tt>javame-sdk</tt> 文件夹中。<br> | |
| 缺省情况下，此文件夹中包含以下三个文件： | |
| <li> 1.vcf</li> | |
| <li> 2.vcf</li> | |
| <li>categories.txt</li> | |
| </P> | |
| <H3><A NAME="run"></A>运行项目</H3> | |
| <div> | |
| <p>按 F6 键以运行主项目，或者选择 "Run"（运行）> "Run Main Project"（运行主项目）。<tt></tt><tt></tt></p> | |
| </div> | |
| <p class="align-center"><a href="#top">返回页首</a></p> | |
| <a name="javadoc-pim"></a> | |
| <H2>PIM 浏览器组件的 Javadoc</H2> | |
| <P>NetBeans IDE 提供了 <tt>PIMBrowser</tt> 组件以及可在 VMD 中使用的其他组件的 API Javadoc。要阅读 <tt>PIMBrowser</tt> 组件的 Javadoc，请执行以下操作： | |
| </P> | |
| <OL> | |
| <li>将光标放在源代码中的 <tt>PIMBrowser</tt> 组件上，然后按 Ctr-Shift-空格组合键（或选择 "Source"（源）> "Show Documentation"（显示文档））。<tt></tt><tt></tt><br> | |
| 此时将在弹出式窗口中显示该元素的 Javadoc。 </li> | |
| <li>在弹出式窗口中单击 "Show documentation in external web browser"（在外部 Web 浏览器中显示文档）图标 (<img src="../../../images_www/articles/71/mobility/pimbrowser/show-doc-button.png" alt=""Show documentation in external web browser"（在外部 Web 浏览器中显示文档）">)，以便在浏览器中查看有关 <tt>PIMBrowser</tt> 组件的详细信息。</li> | |
| </OL> | |
| <p class="align-center"><a href="#top">返回页首</a></p> | |
| <div class="feedback-box"><a href="/about/contact_form.html?to=6&subject=NetBeans%20Java%20ME%20Custom%20Component:%20PIM%20Browser">请将您的反馈发送给我们</a></div> | |
| <br style="clear:both;" > | |
| <a name="see-also"></a> | |
| <H2>另请参见</H2> | |
| <UL> | |
| <li><a href="smscomposer.html">可视 Mobile 设计器定制组件：创建 SMS 编写器应用程序</a></li> | |
| <li><a href="loginscreen.html">可视 Mobile 设计器定制组件：创建 Mobile 登录屏幕</a></li> | |
| <li><a href="filebrowser.html">可视 Mobile 设计器定制组件：创建移动设备文件浏览器</a></li> | |
| <li><a href="splashscreen.html">可视 Mobile 设计器定制组件：在 Java ME 应用程序中使用闪屏</a></li> | |
| <li><a href="waitscreen.html">可视 Mobile 设计器定制组件：为 Mobile 应用程序创建等待屏幕</a></li> | |
| <li><a href="tableitem.html">可视 Mobile 设计器定制组件：在 Java ME 应用程序中使用表项</a></li> | |
| <li><a href="http://wiki.netbeans.org/VisualMobileDesignerPalatteReference">参考：可视 Mobile 设计器组件面板指南</a></li> | |
| </UL> | |
| <p class="align-center"><a href="#top">返回页首</a></p> | |
| </BODY> | |
| </HTML> |