"HelloWorld" プログラムを作ろう ( BREW 3.1 編 ) - 3 / 3 -

イベントハンドラ

ユーザーが携帯電話のキーを押したり、 BREW アプレットを中断したりするたびに、 BREW 実行環境は HelloWorld_HandleEvent() 関数を呼び出します。このような関数を "イベントハンドラ" と呼びます。

イベントハンドラは、 2 番目の引数にどのようなイベントが通知されたかを表すイベントコードを受け取ります。

たとえば、ユーザーが何かキーを押しますと、 BREW 実行環境は 2 番目の引数に EVT_KEY を指定してイベントハンドラを呼び出します。

開発者は EVT_KEY イベントに対して、特定の動作を記述することで、 BREW アプレットの振る舞いを実装します。

BREW ウィザードが生成したコードでは、 EVT_APP_START イベント (アプレットが開始しましたよ～、という通知) と EVT_APP_STOP イベント (アプレットを終了しますよ～、という通知) に対して処理を行っています。

//
//  HelloWorld アプレットのイベント ハンドラ
//
static boolean HelloWorld_HandleEvent(
    IApplet * pi,       // アプレット構造体が渡される
    AEEEvent eCode,     // イベント コード
    uint16 wParam,      // イベント パラメータ (16ビット)
    uint32 dwParam)     // イベント パラメータ (32ビット)
{
    switch (eCode)
    {
    case EVT_APP_START:
        // ここにコードを追加します。
        return TRUE;

    case EVT_APP_STOP:
        // ここにコードを追加します。
        return TRUE;

 default:
        break;
    }
    return FALSE;
}

イベントハンドラでは、「アプレットが処理をした」イベントに対して TRUE を返し、「アプレットが処理をしない」イベントに対して FALSE を返さなければなりません。

ここでは EVT_APP_START イベントに対して TRUE を返すことで、 BREW 実行環境に対して「イベントを処理しましたよ～」と通知しています。

このような仕組みになっている理由は、アプレットが処理しないイベント (FALSE を返したイベント) に対して、 BREW 実行環境がデフォルトの処理を行うことがあるからです。

画面への描画

それでは BREW アプレットが起動したタイミングで、携帯電話の画面に文字列を表示してみましょう。

以下のコードを見てください。分かりやすくするために、 EVT_APP_START イベントを処理するHelloWorld_OnAppStart という関数を定義しています。

新しい関数を定義するので、コードの最初の部分にある前方宣言に、

static void HelloWorld_OnAppStart(AEEApplet *app);

を加えてください。

//
//  イベント ハンドラ
//
static boolean HelloWorld_HandleEvent(
    IApplet * pi,       // アプレット
    AEEEvent eCode,     // イベントコード
    uint16 wParam,      // イベント パラメータ (16ビット)
    uint32 dwParam)     // イベント パラメータ (32ビット)
{
    switch (eCode)
    {
    case EVT_APP_START:

        // ここにコードを追加します。
        HelloWorld_OnAppStart((AEEApplet*) pi);
        return TRUE;

    case EVT_APP_STOP:

        // ここにコードを追加します。
        return TRUE;

    default:
        break;
    }
    return FALSE;
}

//
//  アプレットが開始したときに呼び出される。
//
static void HelloWorld_OnAppStart(AEEApplet* app)
{
    AECHAR text[] = {'H','e','l','l','o',' ','W','o', 'r', 'l', 'd', '\0'};

    // 画面ビットマップに文字列を表示する
    IDISPLAY_DrawText(app->m_pIDisplay,
        AEE_FONT_BOLD,    // 太字のフォント
        text,             // 表示する文字列
        -1,               // -1 = 文字列をすべて表示する
        0,                // 無視される
        0,                // 無視される
        NULL,             // クリッピングしない
        IDF_ALIGN_CENTER | IDF_ALIGN_MIDDLE);   // 左右中央揃え、上下中央揃え

    // 更新された画面ビットマップを表示する
    IDISPLAY_Update (app->m_pIDisplay);

}

描画処理の詳細については今回は説明を行いません。ここに書いたとおり、そのまま入力してくださって結構です。

あれっ？と気づいた方おられるでしょう。 HelloWorld_HandleEvent() 関数の IApplet* 引数が AEEApplet* に強制キャストされています。

詳細は次回以降の連載で解説しますが、イベントハンドラの第1引数には、 AEEClsCreateInstance() 関数で作成したアプレット構造体が渡されます。また、アプレット構造体は IApplet 構造体を拡張した構造体でなければならず、実際 AEEApplet は IApplet を拡張した形で定義されています。

したがって、 IApplet* の引数を AEEApplet* に強制キャストしても何も害はないということです。

BREWエミュレータ用にコンパイルする

さて、すべてのソースコードの準備ができました。もう一度すべてのファイルを確認してみましょう。Helloworld.bid と HelloWorld.mif は他のファイルと同じフォルダ内に入れていますか？

ファイル	説明
HelloWorld.bid	HelloWorldアプレットのクラスIDを格納しているヘッダーファイル。
HelloWorld.mif	HelloWorldモジュールのメタ情報を格納しているファイル。HelloWorldアプレットの情報をxml 形式で記述している。
AEEAppGen.c	BREWプロジェクトで共通に使われるソースファイル。
AEEModGen.c	BREWプロジェクトで共通に使われるソースファイル。
HelloWorld.c	HelloWorldアプレットを実装しているソースファイル。