例 9.35. 宣言

SFMTYPEDEFCLASS(USRApplication)
class USRApplication: public SFYApplication {
    SFMSEALCOPY(USRApplication)
public:
    static SFCInvokerPtr Factory(Void);
private:
    explicit USRApplication(Void) static_throws;
    virtual ~USRApplication(Void);
};

例 9.36. 実装

// ブートローダ: BREW アプリで最初に実行される関数
SFCApplet::FactorySPP SFCApplet::Boot(AEECLSID id, SFXAnsiStringPtr license)
{
    // ここにライセンスコードを記述する
    *license = "heap://";

    return (id == AEECLSID_USRAPPLICATION) ? (&USRApplication::Factory): (null);
}

// ファクトリ関数: ユーザー定義アプリケーションクラスのインスタンスを生成する関数
SFCInvokerPtr USRApplication::Factory(Void)
{
    return ::new USRApplication;
}

// コンストラクタ
USRApplication::USRApplication(Void) static_throws
{
    if (static_try()) {

        // 初期化処理を記述する
    }
}

// デストラクタ
USRApplication::~USRApplication(Void)
{
    // 終了処理を記述する
}

	コンストラクタやデストラクタ内の return 文
	C++ ではコンストラクタやデストラクタでは return 文を記述しません。 GCC を使う場合、コンストラクタやデストラクタ内で return 文を記述すると、 特定の継承関係になっているときにコンパイラがフリーズするバグが確認されています。

例 9.37. SFYApplication::HandleEvent 関数の実装

// BREW 環境からイベントを受信したときに呼び出される仮想関数
/*protected virtual */Bool SFYApplication::HandleEvent(SFXEventConstRef event)
{
    // ここに BREW 環境から受信した各種イベントの分岐処理を記述する

    SFCError  error;
    Bool      result(false);

    // 配信エンジンを起動し、トレーサを使用してイベントを配信する
    // イベントを最初に受信するのはルートに関連付けられた SFYDistributer インスタンス
    // その後、トレーサの配信規則に基づいてルートを頂点とするレスポンダツリー上のレスポンダにイベントは配信される
    // ※_root はルート(SFZRoot)
    if ((error = _root->Distribute(event, &result)) == SFERR_NO_ERROR) {

        if (result) { // ※result 引数には、イベントの配信結果が格納されている

            if (IsRenderable()) { // 画面を再描画しても良い場合（優先的イベントハンドラが登録されていない場合）

                // 描画エンジンを起動し、画面を再描画する
                error = _root->Render();
            }
        }
    }
    if (error != SFERR_NO_ERROR) {

        // 配信エンジンや描画エンジンの起動時にメモリ不足などの致命的エラーが発生した場合、HandleError() を呼び出す
        if (HandleError(event, error)) {

            result = true;
        }
    }

    return result; // イベントを処理したときは true を返し, そうでないときは false を返す

}// SFYApplication::HandleEvent //

参照: SFYResponder::Distribute | SFYResponder::Render | SFCApplication::HandleEvent | SFCApplication::IsRenderable | SFCApplication::HandleError | SFZRoot | ルート | トレーサ | 配信エンジン | 描画エンジン

例 9.38. SFYApplication::HandleRender 関数の実装

// 全画面の再描画が必要なときに呼び出される仮想関数
/*protected virtual */Bool SFYApplication::HandleRender(SFXEventConstRef event)
{
    // ここにアプリ開始時とレジューム時の全画面の再描画処理を記述する

    SFCError  error;
    Bool      result(false);

    if (IsRenderable()) { // 画面が再描画可能なら(優先的イベントハンドラが登録されていないなら)

        // 全画面を再描画する ( Render() の引数に "true" が指定されているため )
        // ※_root はルート(SFZRoot)
        if ((error = _root->Render(true)) == SFERR_NO_ERROR) {

            result = true;
        }

        // 描画エンジンの起動時にメモリ不足などの致命的エラーが発生した場合、HandleError() を呼び出す
        else if (HandleError(event, error)) {

            result = true;
        }
    }

    return result; // 全画面を再描画したときは true を返し, そうでないときは false を返す

}// SFYApplication::HandleRender //

参照: SFYResponder::Render | SFCApplication::HandleRender | SFCApplication::IsRenderable | SFCApplication::HandleError | SFZRoot | ルート | 描画エンジン