| <!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 设计器定制组件：创建 SMS 编写器应用程序 - 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 设计器定制组件：创建 SMS 编写器应用程序 </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>SMS 编写器是一个定制组件，它提供了相应机制和用户界面以使用短消息服务 (Short Message Service, SMS) 发送短消息。该组件使用 <a href="http://jcp.org/en/jsr/detail?id=120">JSR-120</a> Wireless Messaging API。该 API 不是 MIDP 2.0 规范的一部分，因此，只能将该定制组件部署到具有内置 JSR-120 支持的设备上。</P> | |
| <P>本教程介绍如何在支持 Wireless Messaging API (WMA) 的设备的 Mobile 应用程序中使用 SMS 编写器组件。您将了解该组件的基本功能，以及如何使用短消息服务发送消息。 </P> | |
| <P>除了 SMS 编写器定制组件以外，我们还需要使用其他两个 MIDP 组件："Splash Screen"（闪屏）和 "Alert"（警报）。 | |
| </P> | |
| <!--<p class="notes"><b>注意：</b>如果使用的是 NetBeans IDE 6.8，请参阅<a href="../../68/javame/smscomposer.html">在 NetBeans IDE 6.8 中创建 SMS 编写器应用程序</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">使用 SMS 编写器组件创建应用程序</a></li><div> | |
| <ul> | |
| <LI><A HREF="#create">创建 SMSComposerExample 项目</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="#insert">修改 "Wait Screen"（等待屏幕）任务</A> </LI> | |
| <LI><A HREF="#run">运行项目</A> </LI> | |
| </ul> | |
| </div> | |
| <li><a href="#javadoc-loginscreen">SMS 编写器组件的 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> | |
| <a name="sample-app"></a> | |
| <H2>安装并运行样例应用程序</H2> | |
| <P>开始之前，您可能希望查看本教程的最终结果。 </P> | |
| <P>请执行下列步骤以安装 <tt>SMSComposerExample</tt> 应用程序：</P> | |
| <OL> | |
| <LI>下载 <A HREF="https://netbeans.org/projects/samples/downloads/download/Samples/Mobile/SMSComposerExample.zip">SMSComposerExample.zip</A>。</LI> | |
| <LI>解压缩该文件。 </LI> | |
| <LI>在 IDE 中，选择 "File"（文件）> "Open Project"（打开项目），然后浏览至包含 <tt>SMSComposerExample</tt> 项目的解压缩文件的文件夹。<tt></tt><tt></tt></LI> | |
| <li>单击 "Open Project"（打开项目）。<br> | |
| "Projects"（项目）窗口应如下所示： | |
| <p class="align-center"> <img src="../../../images_www/articles/71/mobility/smscomposer/sms-project.png" alt="打开了 SMS 编写器示例的 "Projects"（项目）窗口" border=1></p> </LI> | |
| <LI>在 "Projects"（项目）窗口中，右键单击该项目节点，然后选择 "Run Project"（运行项目）（或按 F6 键）。<tt></tt> <br> | |
| 当应用程序运行时，将会打开一个仿真器窗口，其中显示了在缺省设备仿真器中运行的应用程序。 </LI> | |
| <LI>在仿真器窗口中，单击 "Launch" 下方的按钮。仿真器将显示闪屏组件，然后显示 SMS 编写器，如下所示： | |
| <p class="align-center"><img src="../../../images_www/articles/71/mobility/smscomposer/sms-emulator.png" alt="显示样例 SMS 编写器应用程序的 WTK 2.5 仿真器" border=1></p> </LI> | |
| </OL> | |
| <UL> | |
| <LI>将光标上移或下移以在可用的选项中导航，如 "Phone Number" 或 "Message"。 </LI> | |
| <li>单击中心按钮以允许编辑选定的文本字段。</li> | |
| <LI>单击 "Send" 下方的按钮以发送消息。 </LI> | |
| <LI>单击 "Exit" 下面的按钮以关闭应用程序。 </LI> | |
| </UL> | |
| <p class="align-center"><a href="#top">返回页首</a></p> | |
| <a name="create-app"></a> | |
| <H2 CLASS="western">使用 SMS 编写器定制组件创建应用程序 </H2> | |
| <P>现在，您已看到运行中的 SMS 编写器组件，接下来让我们从头开始创建此应用程序。要创建该应用程序，请执行以下操作： </P> | |
| <OL> | |
| <LI><A HREF="#create">创建SMSComposerExample 项目</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="#insert">修改 "Wait Screen"（等待屏幕）任务</A> </LI> | |
| <LI><A HREF="#run">运行项目</A> </LI> | |
| </OL> | |
| <A NAME="create"></A> | |
| <H3>创建 SMSComposerExample 项目</H3> | |
| <OL> | |
| <LI>选择 "File"（文件）> "New Project"（新建项目）（Ctrl-Shift-N 组合键）。<tt></tt><tt></tt>在 "Categories"（类别）下，选择 "JavaME"。在 "Projects"（项目）下，选择 "Mobile Application"（Mobile 应用程序），然后单击 "Next"（下一步）。 </LI> | |
| <LI>在 "Project Name"（项目名称）字段中输入 <CODE>SMSComposerExample</CODE>。将Project Location（项目位置）更改为系统中的某个目录。从现在开始，我们将此目录称为 <code>$PROJECTHOME</code>。 </LI> | |
| <LI>取消选中 "Create Hello MIDlet"（创建 Hello MIDlet）复选框。单击 "Next"（下一步）。 </LI> | |
| <LI>将 "Sun Java Wireless Toolkit" 保留为选定的仿真器平台。单击 "Next"（下一步）。 </LI> | |
| <LI>单击 "Finish"（完成）。 </LI> | |
| <p class="notes"><b>注意：</b>该项目文件夹中包含所有源代码和项目 meta 数据，如项目的 Ant 脚本。 </p> | |
| </OL> | |
| <A NAME="add"></A> | |
| <H3>在项目中添加包和 Visual MIDlet</H3> | |
| <OL> | |
| <LI>在 "Project"（项目）窗口中选择 <CODE>SMSComposerExample</CODE> 项目，然后选择 "File"（文件）> "New File"（新建文件）（Ctrl-N 组合键）。<tt></tt><tt></tt>在 "Categories"（类别）下，选择 "Java"。在 "File Types"（文件类型）下，选择 "Java Package"（Java 包）。单击 "Next"（下一步）。 </LI> | |
| <LI>在 "Package Name"（包名）字段中输入 <CODE>smscomposerexample</CODE>。单击 "Finish"（完成）。 </LI> | |
| <LI>在 "Project"（项目）窗口中选择 <CODE>smscomposerexample</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>SMSComposerExample</CODE>。单击 "Finish"（完成）。<br> | |
| 应用程序显示在可视 Mobile 设计器的 "Flow"（流）设计窗口中。 </LI> | |
| <p class="align-center"> <img src="../../../images_www/articles/71/mobility/smscomposer/sms-midlet.png" alt="可视 Mobile 设计器中的 SMSComposerExample" border=1></p> | |
| </OL> | |
| <H3><A NAME="addcomponent"></A>在项目中添加组件</H3> | |
| <OL> | |
| <LI>在 "Flow"（流）设计器窗口中，从 "Component Palette"（组件面板）中拖放以下组件：</LI> | |
| <UL> | |
| <LI>Splash Screen（闪屏）</LI> | |
| <LI>SMS 编写器</LI> | |
| <LI>Wait Screen（等待屏幕）</LI> | |
| <LI>Alert（警报） (x2)</LI> | |
| </UL> | |
| <LI>单击 "splashScreen"，并在 "Properties"（属性）窗口中将 "Text"（文本）属性值从 <tt>null</tt> 更改为 <tt>SMS Composer Example</tt>，然后按 Enter 键。</LI> | |
| <LI>单击 "alert"，然后在 "Properties（属性）窗口中，将 "Title"（标题）属性值从 <tt>alert</tt> 更改为 <tt>alertSent</tt>，与将 alert1 的 "Title"（标题）属性从 <tt>alert1</tt> 更改为 <tt>alertError</tt> 的方式相同。 </LI> | |
| <LI> | |
| 单击 "alert"，然后在 "Properties"（属性）窗口中，将 "String"（字符串）属性值更改为 <tt>Message Sent</tt>，与将 alertError 组件的 "String"（字符串）属性更改为 <tt>Error</tt> 的方式相同。</LI> | |
| <LI>单击 "smsComposer"，然后在 "Properties"（属性）窗口中，取消选中 "SMS Properties"（SMS 属性）类别中的 "Automatically Send"（自动发送）属性。 </LI> | |
| </OL> | |
| <H3><A NAME="addcommands"></A>在项目中添加命令</H3> | |
| <OL> | |
| <LI>打开 "Flow"（流）设计器。</LI> | |
| <LI>从 "Component Palette"（组件面板）的 "Commands"（命令）类别中选择 "Exit Command"（退出命令）。将其拖放至 "Flow"（流）设计器内的 smsComposer 组件中。</LI> | |
| </OL> | |
| <A NAME="connect"></A> | |
| <H3>连接组件以创建应用程序流</H3> | |
| <p>在 "Flow"（流）设计器窗口中，单击 "Mobile Device"（移动设备）上的“起点”并将其拖至 spalshScreen 组件中。采用相同的方法，按照下图所示连接各个组件。</p> | |
| <p class="align-center"> <img src="../../../images_www/articles/71/mobility/smscomposer/sms-flow.png" alt="显示包含由命令行连接的组件的 "Flow"（流）设计器" border=1></p> | |
| <A NAME="insert"></A> | |
| <H3>修改 "Wait Screen"（等待屏幕）任务</H3> | |
| <p>在 "Navigator"（导航）窗口的 "Resources"（资源）类别中，找到并右键单击 <tt>task</tt> 组件，然后从弹出式菜单中选择 "Go To Source"（转至源）。在 "Source"（源）窗口中，找到 <code>// write task-execution user code here</code> 部分并将其替换为 <code>smsComposer.sendSMS();</code>。 </p> | |
| <A NAME="run"></A> | |
| <H3>运行项目</H3> | |
| <p>按 F6 键运行主项目。此外，也可以选择 "Run"（运行）> "Run Main Project"（运行主项目）。<tt></tt><tt></tt></p> | |
| <p class="align-center"><a href="#top">返回页首</a></p> | |
| <a name="javadoc-loginscreen"></a> | |
| <H2>SMS 编写器组件的 Javadoc</H2> | |
| <P>NetBeans IDE 提供了 <tt>SMSComposer</tt> 组件以及可在 VMD 中使用的其他组件的 API Javadoc。阅读 <tt>SMSComposer</tt> 组件的 Javadoc： | |
| </P> | |
| <OL> | |
| <li>将光标放在源代码中的 <tt>SMSComposer</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/smscomposer/show-doc-button.png" alt=""Show documentation in external web browser"（在外部 Web 浏览器中显示文档）">)，以便在浏览器中查看有关 <tt>SMSComposer</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:%20SMS%20Composer">请将您的反馈发送给我们</a></div> | |
| <br style="clear:both;" > | |
| <a name="see-also"></a> | |
| <H2>另请参见</H2> | |
| <UL> | |
| <li><a href="filebrowser.html">可视 Mobile 设计器定制组件：创建移动设备文件浏览器</a></li> | |
| <li><a href="loginscreen.html">可视 Mobile 设计器定制组件：创建 Mobile 登录屏幕</a></li> | |
| <li><a href="pimbrowser.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> |