ビジュアルモバイルデザイナのカスタムコンポーネント: SMS コンポーザアプリケーションの作成
ビジュアルモバイルデザイナ (VMD) は NetBeans Mobility に含まれるグラフィカルインタフェースで、コンポーネントのドラッグ＆ドロップを使用することでモバイルアプリケーションをデザインできます。VMD を使用すると、IDE に含まれるコンポーネントまたは独自にデザインしたコンポーネントを使用して、アプリケーションフローを定義し、GUI をデザインできます。VMD には、リスト、警告、フォーム、画像など、アプリケーションの作成に使用できる標準のユーザーインタフェース (UI) コンポーネントが多数含まれます。また、待機画面、スプラッシュ画面、表項目など、より複雑な機能を簡単に作成できるカスタムコンポーネントも含まれます。
SMS コンポーザは、ショートメッセージサービス (SMS) を使用してショートメッセージを送信するメカニズムとユーザーインタフェースを備えたカスタムコンポーネントです。
このコンポーネントでは、JSR-120 の Wireless Messaging API が使用されます。この API は MIDP 2.0 仕様の一部ではないので、このカスタムコンポーネントは、JSR-120 のサポートが組み込まれているデバイスだけに配備できます。
このチュートリアルでは、Wireless Messaging API (WMA) 対応デバイス用モバイルアプリケーションで SMS コンポーザコンポーネントを使用する方法を示します。このコンポーネントの基本機能と、ショートメッセージサービスを使用してメッセージを送信する方法を学びます。
SMS コンポーザカスタムコンポーネントに加え、スプラッシュ画面と警告の 2 つの他の MIDP コンポーネントも使用する必要があります。
目次
このチュートリアルに従うには、次に示すソフトウェアとリソースが必要です。
サンプルアプリケーションのインストールと実行
始める前に、チュートリアルの最終結果を確認します。
次の手順で SMSComposerExample アプリケーションをインストールします。
- SMSComposerExample.zip をダウンロードします。
- ファイルを展開します。
- IDE で、「ファイル」>「プロジェクトを開く」を選択し、SMSComposerExample プロジェクトの展開したファイルがあるフォルダを参照します。
- 「プロジェクトを開く」をクリックします。
「プロジェクト」ウィンドウは次のようになります。
- 「プロジェクト」ウィンドウでプロジェクトノードを右クリックし、「プロジェクトを実行」を選択します (または F6 キーを押す)。
アプリケーションが実行されると、エミュレータウィンドウが開き、デフォルトのデバイスエミュレータでアプリケーションが実行されるところが表示されます。
- 「エミュレータ」ウィンドウで「起動」の下のボタンをクリックします。エミュレータにスプラッシュ画面コンポーネントが表示されてから、次に示す SMS コンポーザが表示されます。
- 電話番号やメッセージなどのオプション間を移動するには、カーソルを上下に移動します。
- 中央のボタンをクリックすると、選択されたテキストフィールドの編集が有効になります。
- メッセージを送信するには、「Send」の下のボタンをクリックします。
- アプリケーションを終了するには、「Exit」の下のボタンをクリックします。
ページの先頭へ
「SMS コンポーザ」カスタムコンポーネントを使用したアプリケーションの作成
SMS コンポーザコンポーネントが実際に動作するところを確認できたので、最初に戻ってこのアプリケーションを作成します。アプリケーションを作成するには、次の手順を実行します。
- SMSComposerExample プロジェクトを作成する
- プロジェクトにパッケージとビジュアル MIDlet を追加する
- プロジェクトにコンポーネントを追加する
- プロジェクトにコマンドを追加する
- コンポーネントを接続してアプリケーションフローを作成する
- 待機画面のタスクを変更する
- プロジェクトを実行する
SMSComposerExample プロジェクトの作成
- 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。「カテゴリ」で「JavaME」を選択します。「プロジェクト」で「モバイルアプリケーション」を選択して、「次へ」をクリックします。
- 「プロジェクト名」フィールドに
SMSComposerExample と入力します。「プロジェクトの場所」をシステム上の任意のディレクトリに変更します。以降、この例では、このディレクトリを $PROJECTHOME とします。
- 「Hello MIDlet を作成」チェックボックスの選択を解除します。「次へ」をクリックします。
- 「エミュレータプラットフォーム」は、「Sun Java Wireless Toolkit」を選択したままにしておきます。「次へ」をクリックします。
- 「完了」をクリックします。
注: このプロジェクトフォルダには、ソースおよび、プロジェクトの Ant スクリプトなどのプロジェクトメタデータのすべてが含まれます。
プロジェクトへのパッケージとビジュアル MIDlet の追加
- 「プロジェクト」ウィンドウで
SMSComposerExample プロジェクトを選択し、「ファイル」>「新規ファイル」(Ctrl-N) を選択します。「カテゴリ」から「Java」を選択します。「ファイルの種類」として「Java パッケージ」を選択します。「次へ」をクリックします。
- 「パッケージ名」フィールドに
smscomposerexample と入力します。「完了」をクリックします。
- 「プロジェクト」ウィンドウで
smscomposerexample パッケージを選択し、「ファイル」>「新規ファイル」(Ctrl-N) を選択します。「カテゴリ」にある「MIDP」を選択します。「ファイルの種類」として「ビジュアル MIDIlet」を選択します。「次へ」をクリックします。
- 「MIDlet 名」フィールドと「MIDP クラス名」フィールドに
SMSComposerExample と入力します。「完了」をクリックします。
アプリケーションはビジュアルモバイルデザイナの「フローデザイン」ウィンドウに表示されます。
プロジェクトへのコンポーネントの追加
- フローデザイナウィンドウで、コンポーネントパレットから次のコンポーネントをドラッグ＆ドロップします。
- スプラッシュ画面
- SMS コンポーザ
- 待機画面
- 警告 (x2)
- splashScreen をクリックし、「プロパティー」ウィンドウで「テキスト」プロパティーの値を「null」から「SMS Composer Example」に変更して、Enter を押します。
- alert をクリックし、「プロパティー」ウィンドウで、「タイトル」プロパティーの値を「alert」から「alertSent」に変更し、同様に、alert1 の「タイトル」プロパティーを「alert1」から「alertError」に変更します。
-
alert をクリックし、「プロパティー」ウィンドウで、「文字列」プロパティーの値を「Message Sent」に変更し、同様に、alertError コンポーネントの「文字列」プロパティーの値を「Error」に変更します。
- smsComposer をクリックし、「プロパティー」ウィンドウで、「SMS Properties」カテゴリの「自動的に送信」プロパティーをオフにします。
プロジェクトへのコマンドの追加
- フローデザイナを開きます。
- コンポーネントパレットの「コマンド」セクションで終了コマンドを選択します。これをフローデザイナの smsComposer コンポーネントにドラッグ＆ドロップします。
コンポーネントを接続してアプリケーションフローを作成する
フローデザイナで、モバイルデバイスの「起動」をクリックし、splashScreen コンポーネントまでドラッグします。同様に、次の図に示すようにコンポーネントを接続します。
待機画面のタスクの変更
ナビゲータのリソースカテゴリで、task コンポーネントを見つけて右クリックし、ポップアップメニューから「ソースへ移動」を選択します。ソースウィンドウで、// write task-execution user code here" というセクションを探し、smsComposer.sendSMS(); に置き換えます。
プロジェクトの実行
F6 キーを押して主プロジェクトを実行します。あるいは、「実行」>「主プロジェクトを実行」を選択してもかまいません。
ページの先頭へ
SMS コンポーザコンポーネントの Javadoc
NetBeans IDE には、SMSComposer コンポーネントや、VMD で使用できるその他のコンポーネントに関する API Javadoc が用意されています。SMSComposer コンポーネントの Javadoc を表示するには:
- ソースコードの SMSComposer コンポーネントにカーソルを合わせ、Ctr-Shift- スペースキーを押します (または「ソース」>「ドキュメントを表示」を選択します)。
この要素の Javadoc がポップアップウィンドウに表示されます。
- ポップアップウィンドウで「外部 Web ブラウザにドキュメントを表示」アイコン (
) をクリックすると、SMSComposer コンポーネントについての詳細な情報がブラウザに表示されます。
ページの先頭へ
関連項目
ページの先頭へ
