ビジュアルモバイルデザイナのカスタムコンポーネント: PIM (Personal Information Manager) アプリケーションの作成
ビジュアルモバイルデザイナ (VMD) は NetBeans Mobility に含まれるグラフィカルインタフェースです。コンポーネントをドラッグ＆ドロップすることでモバイルアプリケーションをデザインできます。VMD を使用すると、IDE に含まれるコンポーネントまたは独自にデザインしたコンポーネントを使用して、アプリケーションフローを定義し、GUI をデザインできます。VMD には、リスト、警告、フォーム、画像など、アプリケーションの作成に使用できる標準のユーザーインタフェース (UI) コンポーネントが多数含まれます。また、待機画面、スプラッシュ画面、表項目など、より複雑な機能を簡単に作成できるカスタムコンポーネントも含まれます。
PIM ブラウザは、カレンダ、アドレス帳、タスクリストなど、モバイルデバイスの標準的な機能への容易なアクセスを実現するカスタムコンポーネントです。PIM ブラウザコンポーネントを使用して、モバイル Java アプリケーションから、ローカルに保存された個人情報データベースにアクセスできます。このコンポーネントでは PIM (Personal Information Management) API が使用されます。これは JSR-75 (PDA Optional Packagesfor the Java ME Platform) 仕様の一部です。JSR-75 は MIDP 2.0 仕様の一部ではないので、このコンポーネントはカスタムコンポーネントと定義され、JSR-75 対応のデバイスだけに使用できます。
このチュートリアルでは、JSR-75 対応デバイス用モバイルアプリケーションで PIM ブラウザコンポーネントを使用する方法を示します。デバイスの連絡先データベース、カレンダ、または To Do リストなどの内容の参照など、コンポーネントの基本機能を使用します。PIM ブラウザに加えて、スプラッシュ画面、テキストボックス、および警告の 3 つのコンポーネントを使用します。
注: NetBeans IDE 6.8 を使用している場合は、「PIM (Personal Information Manager) アプリケーションの作成」チュートリアル (NetBeans IDE 6.8 ドキュメント) を参照してください。
目次
このチュートリアルに従うには、次のソフトウェアとリソースが必要です。
NetBeans Mobility に習熟していない場合、次に進む前に「NetBeans Java ME MIDP 開発のクイックスタートガイド」から始めることをお勧めします。
サンプルアプリケーションのインストールと実行
始める前に、チュートリアルの最終結果を確認します。
次の手順で PIMBrowserExample アプリケーションをインストールします。
- PIMBrowserExample.zip をダウンロードします。
- ファイルを展開します。
- IDE で、「ファイル」>「プロジェクトを開く」を選択し、PIMBrowserExample プロジェクトのファイルを展開したフォルダを選択します。
- 「プロジェクトを開く」をクリックします。
「プロジェクト」ウィンドウは次のようになります。
- 「プロジェクト」ウィンドウでプロジェクトノードを右クリックし、「プロジェクトを実行」を選択します (または F6 キーを押す)。アプリケーションが実行されると、エミュレータウィンドウが開き、デフォルトのデバイスエミュレータでアプリケーションが実行されるところが表示されます。
注: 連絡先はデフォルトで空です。連絡先リストの入力方法については、「Wireless Toolkit の連絡先データベースに連絡先を追加する」を参照してください。
- 「エミュレータ」ウィンドウで「起動」の下のボタンをクリックします。
エミュレータにスプラッシュ画面コンポーネントが表示されてから、次に示す PIM ブラウザが表示されます。
- 中央のボタンをクリックして連絡先の詳細を表示します。
- 位置を移動するにはカーソルを上下に移動します。
- 連絡先リストに戻るには「Back」の下のボタンをクリックします。
- アプリケーションを終了するには、「Exit」の下のボタンをクリックします。
ページの先頭へ
「PIM ブラウザ」カスタムコンポーネントを使用したアプリケーションの作成
PIM ブラウザコンポーネントが実際に動作するところを確認できたので、最初に戻ってこのアプリケーションを作成します。アプリケーションを作成するには、次の手順を実行します。
- PIMBrowserExample プロジェクトを作成する
- プロジェクトにパッケージとビジュアル MIDlet を追加する
- プロジェクトにコンポーネントを追加する
- プロジェクトにコマンドを追加する
- コンポーネントを接続してアプリケーションフローを作成する
- Wireless Toolkit の連絡先データベースに連絡先を追加する
- プロジェクトを実行する
PIMBrowserExample プロジェクトの作成
- 「ファイル」>「新規プロジェクト」(Ctrl-Shift-N) を選択します。「カテゴリ」から「Java ME」を選択します。「プロジェクト」で「モバイルアプリケーション」を選択して、「次へ」をクリックします。
- 「プロジェクト名」フィールドに
PIMBrowserExample と入力します。「プロジェクトの場所」をシステム上の任意のディレクトリに変更します。以降、この例では、このディレクトリを $PROJECTHOME とします。
- 「Hello MIDlet を作成」チェックボックスの選択を解除します。「次へ」をクリックします。
- 「エミュレータプラットフォーム」は、「Sun Java Wireless Toolkit 」を選択したままにしておきます。「次へ」をクリックします。
- 「完了」をクリックします。
注: このプロジェクトフォルダには、ソースおよび、プロジェクトの Ant スクリプトなどのプロジェクトメタデータのすべてが含まれます。
プロジェクトへのパッケージとビジュアル MIDlet の追加
- 「プロジェクト」ビューで
PIMBrowserExample プロジェクトを選択し、「ファイル」>「新規ファイル」(Ctrl-N) を選択します。「カテゴリ」から「Java」を選択します。「ファイルの種類」として「Java パッケージ」を選択します。「次へ」をクリックします。
- 「パッケージ名」フィールドに
pimbrowserexample と入力します。「完了」をクリックします。
- 「プロジェクト」ビューで
pimbrowserexample パッケージを選択し、「ファイル」>「新規ファイル」(Ctrl-N) を選択します。「カテゴリ」にある「MIDP」を選択します。「ファイルの種類」として「ビジュアル MIDIlet」を選択します。「次へ」をクリックします。
- 「MIDlet 名」フィールドと「MIDP クラス名」フィールドに
PIMBrowserExample と入力します。「完了」をクリックします。
アプリケーションはビジュアルモバイルデザイナのフロービューに表示されます。
プロジェクトへのコンポーネントの追加
- フローデザイナで、コマンドパレットから次のコンポーネントをドラッグ＆ドロップします。
- splashScreen をクリックし、「プロパティー」ウィンドウで「テキスト」の値を「null」から「PIM Browser Example」に変更します。
- alert をクリックし、「プロパティー」ウィンドウで「文字列」プロパティーの値を「Contact selected」に変更します。
プロジェクトへのコマンドの追加
- フローデザイナで、コンポーネントパレットの「コマンド」セクションから「終了コマンド」を選択します。
- pimBrowser コンポーネントにドラッグ＆ドロップします。
コンポーネントを接続してアプリケーションフローを作成する
フローデザイナで、モバイルデバイスの「起動」をクリックし、splashScreen コンポーネントまでドラッグします。同様に、次の図に示すようにコンポーネントを接続します。
Wireless Toolkit の連絡先データベースに連絡先を追加する
連絡先サンプルを、ユーザーディレクトリ $J2MEWTKHOME/2.5.2/appdb/DefaultColorPhone/pim/contacts/Contacts/ 内の j2mewtk フォルダにコピーします。このフォルダはデフォルトで空であるため、PIMBrowserExample プロジェクトをテストするには少なくとも 1 つのファイル(連絡先)をコピーする必要があります。
プロジェクトの実行
F6 キーを押すか、「実行」>「主プロジェクトを実行」を選択して主プロジェクトを実行します。
ページの先頭へ
PIM ブラウザコンポーネントの Javadoc
NetBeans IDE には、PIMBrowser コンポーネントや、VMD で使用できるその他のコンポーネントに関する API Javadoc が用意されています。PIMBrowser コンポーネントの Javadoc を表示するには、次の手順を実行します。
- ソースコード内で PIMBrowser コンポーネントにカーソルを合わせて Ctrl-Shift-スペースキーを押します (または、「ソース」>「ドキュメントを表示」を選択します)。
この要素の Javadoc がポップアップウィンドウに表示されます。
- ポップアップウィンドウで「外部 Web ブラウザにドキュメントを表示」アイコン (
) をクリックすると、PIMBrowser コンポーネントの詳細情報がブラウザに表示されます。
ページの先頭へ
関連項目
ページの先頭へ
