例 804. ソフトキーコントロールの定義と生成

// screensaver_sfy アプリケーションクラスの定義
SFMTYPEDEFCLASS(screensaver_sfy)
class screensaver_sfy : public SFYApplication {
    SFMSEALCOPY(screensaver_sfy)
private:
    SFZSoftKeyControlSmp _softkey;　// ソフトキーコントロールはアプリケーションクラスのグローバル変数として保持する
    MainWindowSmp _main;
public:
    static SFCInvokerPtr Factory(Void);
    static SFZSoftKeyControlSmp GetSoftKey(Void);
private:
    explicit screensaver_sfy(Void) static_throws;
    virtual ~screensaver_sfy(Void);
    XANDLER_DECLARE_VOIDRENDER(OnRenderRequest)
};

// screensaver_sfy アプリケーションクラスのコンストラクタ
screensaver_sfy::screensaver_sfy(Void) static_throws
{
    SFCError error;

    if (static_try()) {
        // 最初にソフトキーコントロールを作成する(ソフトキーコントロールはルートの最前面の子レスポンダ)
        if (static_try()) {
           // アプリケーションクラスはひとつだけソフトキーコントロールを持てる
           // ソフトキーコントロールを使うとき、
           // ソフトキー１〜４のキーイベントはすべてソフトキーコントロール内で処理される
           _softkey = SFZSoftKeyControl::NewInstance(&error);
            if (_softkey != null) {
                // 親レスポンダはアプリケーションクラスルート)とする
                // ※ソフトキーコントロールはルートの子レスポンダでなければいけない
                error = _softkey->SetParent(GetThis());
                if (error == SFERR_NO_ERROR) {
                    // スタイルを設定する(ここではエクステンションスタイルのソフトキーコントロール)
                    _softkey->SetStyle(SFZSoftKeyControl::EXTENSION);
                    // 実領域を設定する(携帯電話の画面のサイズとスタイルから自動的に計算して設定)
                    _softkey->SetRealBound(_softkey->GetSuitableBound());
                    // 状態を「可視＋活性＋操作不可能＋非フォーカス」にまとめて設定する
                    _softkey->SetState(true, true, false, false);
                    // 最前面に配置する(常に最前面になるように内部処理される)
                    // _softkey->ToFront();　// 内部的に自動的に実行されるので不要

                    // 適宜、ソフトキーにテキスト(、イメージ、カラー)を割り当てます。
                    // レスポンダとソフトキーメニューがバインドされ、テキスト(、イメージ、カラー)が、
                    // 実際に使用されてしまう前に割り当てる必要があります。
                    _softkey->RegisterText(KEY_TEXT_EXIT,     SFXWideString("終了"));
                    _softkey->RegisterText(KEY_TEXT_EDIT,     SFXWideString("設定"));
                    _softkey->RegisterText(KEY_TEXT_ADD,      SFXWideString("追加"));
                    _softkey->RegisterText(KEY_TEXT_CHANGE,   SFXWideString("変更"));
                    _softkey->RegisterText(KEY_TEXT_REMOVE,   SFXWideString("削除"));

                    // 適宜、ソフトキーメニューを作成しラベルのキーをセットします。
                    // レスポンダとソフトキーメニューがバインドされる前に作成する必要があります。
                    _softkey->CreateMenu(KEY_MENU_MAIN);
                    // それぞれ SELECT, SOFTKEY_1, SOFTKEY_2, SOFTKEY_3, SOFTKEY_4 のラベルに対応します。
                    UInt32 key_text[] = {KEY_TEXT_EDIT, KEY_TEXT_EXIT, KEY_TEXT_ADD, KEY_TEXT_CHANGE, KEY_TEXT_REMOVE};
                    _softkey->SetTextKey(KEY_MENU_MAIN, key_text, lengthof(key_text));
                }
            }
        }

        // 次にメイン ウィンドウを作成する
        if (error == SFERR_NO_ERROR) {
            _main = MainWindow::NewInstance(&error);

                .................

        }


        .................
    }
}

// ソフトキーコントロールのインスタンスを取得する関数の定義
SFZSoftKeyControlSmp screensaver_sfy::GetSoftKey(Void)
{
    SFZSoftKeyControlSmp softkey(static_pointer_cast<SFZSoftKeyControl>(GetRoot()->GetChildFront()));

    if (softkey == null || softkey->GetType() != SFZSoftKeyControl::CODE_TYPE) {
        softkey = SFZSoftKeyControlSmp::EmptyInstance();
    }
    return softkey;
}

例 805. ソフトキーコントロールの作成とソフトキーハンドラの宣言・登録

// ソフトキーコントロールの定義とハンドラの宣言
SFMTYPEDEFRESPONDER(MainWindow)
class MainWindow : public SFZWindow {
    SFMSEALRESPONDER(MainWindow)
    SFMRESPONDERINSTANTIATEFOUR(MainWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
public:

        ................

private:
    SFZSoftKeyControlSmp _softkey;// ソフトキーコントロール

        ................

private:
    XANDLER_DECLARE_VOIDEVENT(OnKey)     // キーハンドラ
    XANDLER_DECLARE_VOIDEVENT(OnSoftkey) // ソフトキーハンドラ

        ................

};

// MainWindow のコンストラクタ
// ソフトキーコントロールのバインド、各種設定、ハンドラ登録
MainWindow::MainWindow(Void) static_throws
{
    static SFXEventRange::AtomRecConst range[] = {
        {SFEVT_APP_SUSPEND, SFEVT_APP_SUSPEND, SFP16_BEGIN, SFP16_END},
        {SFEVT_APP_RESUME, SFEVT_APP_RESUME, SFP16_BEGIN, SFP16_END},
        {SFEVT_KEY, SFEVT_KEY, SFP16_BEGIN, SFP16_END},
        {SFEVT_RESPONDER_SOFTKEY, SFEVT_RESPONDER_SOFTKEY, AVK_SOFT1, AVK_SOFT4}  // ソフトキーコントロールのイベント
    };
    SFYHandler::RuleRec rule[lengthof(range)];

    if (static_try()) {
        SetType(CODE_TYPE);
        // ハンドラの登録
        rule[0].spp = XANDLER_FUNCTION(OnSuspend);
        rule[0].reference = this;
        rule[1].spp = XANDLER_FUNCTION(OnResume);
        rule[1].reference = this;
        rule[2].spp = XANDLER_FUNCTION(OnKey);
        rule[2].reference = this;
        rule[3].spp = XANDLER_FUNCTION(OnSoftkey); // ソフトキーコントロールのハンドラ
        rule[3].reference = this;
        static_throw(RegisterHandler(atomic_cast(range), rule, lengthof(range)));

        // ソフトキーコントロールの設定
        // ソフトキーコントロールのインスタンスを取得する
        if ((_softkey = screensaver_sfy::GetSoftKey()) != null) {
           // ソフトキーコントロールを MainWindow、KEY_MENU_MAIN にバインドする
           // ※ 以下の関数呼び出しでバインドするレスポンダの引数は SFYResponderPtr 型を要求しているので this を指定している
           _softkey->Bind(this, KEY_MENU_MAIN);
        }
    }
}

例 806. ソフトキーコントロールのハンドラの実装

// ソフトキーコントロールのハンドラの実装 : ソフトキー１〜４のキーイベントを受信したときのハンドラ
// ソフトキーコントロールにバインドされたフォーカスを持つ他のレスポンダよりも前面にあり、
// MainWindow がフォーカスを持つ場合にしか呼び出されない
XANDLER_IMPLEMENT_VOIDEVENT(MainWindow, OnSoftkey, invoker, event)
{

                .................


    switch (event.GetP16()) {
        case AVK_SOFT1:
            //  終了確認ダイアログの作成

                .................

            break;
        case AVK_SOFT2:
            // メニューの作成

                .................

}