例 9.88. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZSingleTextLabelControlSmp _label;

    // ...（省略）...
private:
    SFCError Make(Void);

    // 操作可能モードで操作キー押下時の結果イベントを受信するハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.89. 実装

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // 単一行テキストラベルコントロールを作成する
    if ((_label = SFZSingleTextLabelControl::NewInstance(&error)) != null) {

        // 単一行テキストラベルコントロールの親を USRWindow に設定する
        error = _label->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // 操作可能モードで操作キー押下時の結果イベントを受信するハンドラを登録する
            // 操作不能モードの場合、呼び出されることがないためハンドラは登録しない
            error = _label->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // 表示するテキストを設定する
                // SFXWideString オブジェクトの設定 (※リソースファイルから設定することも可能)
                error = _label->SetText("hello world");
                if (error == SFERR_NO_ERROR) {

                    // 単一行テキストラベルコントロールの実領域を最適なサイズの矩形に設定する[始点は(10, 10)]
                    _label->SetRealBound(_label->GetSuitableBound().SetOrigin(10, 10));

                    // 操作可能モードの場合: すべての状態を true に設定する
                    _label->SetState(true, true, true, true);
                    // 操作不能モードの場合: 操作可能状態を false に設定する
                    // _label->SetState(true, true, false, false);
                }
            }
        }
    }

    return error;
}

// 操作可能モードで操作キー押下時の結果イベントを受信するハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // invoker には単一行テキストラベルコントロールが渡される
    // reason には SFP16_RESULT_OK が渡される
    // result には現在値が渡される [ 現在値 ＝ GetCurrentValue() の戻り値 ]

    // ...（省略）...

    return;
}

例 9.90. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZSingleEditLabelControlSmp _label;

    // ...（省略）...
private:
    SFCError Make(Void);

    // 操作可能モードでテキスト入力終了時の結果イベントを受信するハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.91. 実装

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // 単一行エディットラベルコントロールを作成する
    if ((_label = SFZSingleEditLabelControl::NewInstance(&error)) != null) {

        // 単一行エディットラベルコントロールの親を USRWindow に設定する
        error = _label->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // 操作可能モードでテキスト入力終了時の結果イベントを受信するハンドラを登録する
            // 操作不能モードの場合、呼び出されることがないためハンドラは登録しない
            error = _label->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // 数字入力モードを ON に設定する
                _label->SetInputMode(AEE_TM_NUMBERS);

                // パスワード入力モードを ON に設定する
                error = _label->SetPasswordMode(true);
                if (error == SFERR_NO_ERROR) {

                    // 表示するテキストを設定する
                    // SFXWideString オブジェクトの設定 (※リソースファイルから設定することも可能)
                    error = _label->SetText("0123456789");
                    if (error == SFERR_NO_ERROR) {

                        // 単一行エディットラベルコントロールの実領域を最適なサイズの矩形に設定する[始点は(10, 10)]
                        _label->SetRealBound(_label->GetSuitableBound().SetOrigin(10, 10));

                        // 操作可能モードの場合: すべての状態を true に設定する
                        _label->SetState(true, true, true, true);
                        // 操作不能モードの場合: 操作可能状態を false に設定する
                        // _label->SetState(true, true, false, false);
                    }
                }
            }
        }
    }

    return error;
}

// 操作可能モードでテキスト入力終了時の結果イベントを受信するハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    SFXWideString text;

    // invoker には単一行エディットラベルコントロールが渡される
    // reason には SFP16_RESULT_OK または SFP16_RESULT_ERROR が渡される

    switch (reason) {

        case SFP16_RESULT_OK:
            // テキスト入力が正常に終了した場合、reason には SFP16_RESULT_OK が渡される
            // このとき、result には現在値が渡される [ 現在値 ＝ GetCurrentValue() の戻り値 ]

            // 入力されたテキストを取得する
            text = _label->GetText();

            // 入力されたテキストをデバッグウィンドウに表示する
            TRACE("%S", text.GetCString());

            break;

        case SFP16_RESULT_ERROR:
            // テキスト入力が正常に終了した場合、reason には SFP16_RESULT_ERROR が渡される
            // このとき、result にはエラー値(SFCError 型)が渡される

            // ...（省略）...
            break;
    }

    return;
}

例 9.92. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZMultipleTextLabelControlSmp _label;

    // ...（省略）...
private:
    SFCError Make(Void);

    // 操作可能モードで操作キー押下時の結果イベントを受信するハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.93. 実装

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // 複数行テキストラベルコントロールを作成する
    if ((_label = SFZMultipleTextLabelControl::NewInstance(&error)) != null) {

        // 複数行テキストラベルコントロールの親を USRWindow に設定する
        error = _label->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // 操作可能モードで操作キー押下時の結果イベントを受信するハンドラを登録する
            // 操作不能モードの場合、呼び出されることがないためハンドラは登録しない
            error = _label->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // 表示するテキストを設定する
                // SFXWideString オブジェクトの設定 (※リソースファイルから設定することも可能)
                error = _label->SetText("hello world\nabc\nxyz");
                if (error == SFERR_NO_ERROR) {

                    // 複数行テキストラベルコントロールの実領域を USRWindow を (10, 10) だけ Deflate した矩形領域に収まる最適なサイズの矩形に設定する[始点は(10, 10)]
                    _label->SetRealBound(_label->GetSuitableBound(GetLocalBound().Deflate(10, 10)));

                    // 操作可能モードの場合: すべての状態を true に設定する
                    _label->SetState(true, true, true, true);
                    // 操作不能モードの場合: 操作可能状態を false に設定する
                    // _label->SetState(true, true, false, false);
                }
            }
        }
    }

    return error;
}

// 操作可能モードで操作キー押下時の結果イベントを受信するハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // invoker には複数行テキストラベルコントロールが渡される
    // reason には SFP16_RESULT_OK が渡される
    // result には現在値が渡される [ 現在値 ＝ GetCurrentValue() の戻り値 ]

    // ...（省略）...

    return;
}

例 9.94. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZMultipleEditLabelControlSmp _label;

    // ...（省略）...
private:
    SFCError Make(Void);

    // 操作可能モードでテキスト入力終了時の結果イベントを受信するハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.95. 実装

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // 複数行エディットラベルコントロールを作成する
    if ((_label = SFZMultipleEditLabelControl::NewInstance(&error)) != null) {

        // 複数行エディットラベルコントロールの親を USRWindow に設定する
        error = _label->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // 操作可能モードでテキスト入力終了時の結果イベントを受信するハンドラを登録する
            // 操作不能モードの場合、呼び出されることがないためハンドラは登録しない
            error = _label->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // 数字入力モードを ON に設定する
                _label->SetInputMode(AEE_TM_NUMBERS);

                // パスワード入力モードを ON に設定する
                error = _label->SetPasswordMode(true);
                if (error == SFERR_NO_ERROR) {

                    // 表示するテキストを設定する
                    // SFXWideString オブジェクトの設定 (※リソースファイルから設定することも可能)
                    error = _label->SetText("0123456789\n012\n789");
                    if (error == SFERR_NO_ERROR) {

                        // 複数行エディットラベルコントロールの実領域を USRWindow を (10, 10) だけ Deflate した矩形領域に収まる最適なサイズの矩形に設定する[始点は(10, 10)]
                        _label->SetRealBound(_label->GetSuitableBound(GetLocalBound().Deflate(10, 10)));

                        // 操作可能モードの場合: すべての状態を true に設定する
                        _label->SetState(true, true, true, true);
                        // 操作不能モードの場合: 操作可能状態を false に設定する
                        // _label->SetState(true, true, false, false);
                    }
                }
            }
        }
    }

    return error;
}

// 操作可能モードでテキスト入力終了時の結果イベントを受信するハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    SFXWideString text;

    // invoker には複数行エディットラベルコントロールが渡される
    // reason には SFP16_RESULT_OK または SFP16_RESULT_ERROR が渡される

    switch (reason) {

        case SFP16_RESULT_OK:
            // テキスト入力が正常に終了した場合、reason には SFP16_RESULT_OK が渡される
            // このとき、result には現在値が渡される [ 現在値 ＝ GetCurrentValue() の戻り値 ]

            // 入力されたテキストを取得する
            text = _label->GetText();

            // 入力されたテキストをデバッグウィンドウに表示する
            TRACE("%S", text.GetCString());

            break;

        case SFP16_RESULT_ERROR:
            // テキスト入力が正常に終了した場合、reason には SFP16_RESULT_ERROR が渡される
            // このとき、result にはエラー値(SFCError 型)が渡される

            // ...（省略）...
            break;
    }

    return;
}

例 9.96. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZImageLabelControlSmp _label;

    // ...（省略）...
private:
    SFCError Make(Void);

    // 操作可能モードで操作キー押下時の結果イベントを受信するハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.97. 実装

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // イメージラベルコントロールを作成する
    if ((_label = SFZImageLabelControl::NewInstance(&error)) != null) {

        // イメージラベルコントロールの親を USRWindow に設定する
        error = _label->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // 操作可能モードで操作キー押下時の結果イベントを受信するハンドラを登録する
            // 操作不能モードの場合、呼び出されることがないためハンドラは登録しない
            error = _label->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // 表示するイメージを設定する
                // SFBImage オブジェクトの設定 ( リソースファイルやファイルから設定可能 )
                error = _label->SetImage(SFXPath("resource.bar"), IMAGE_ID);
                if (error == SFERR_NO_ERROR) {

                    // イメージラベルコントロールの実領域を最適なサイズの矩形に設定する[始点は(10, 10)]
                    _label->SetRealBound(_label->GetSuitableBound().SetOrigin(10, 10));

                    // 操作可能モードの場合: すべての状態を true に設定する
                    _label->SetState(true, true, true, true);
                    // 操作不能モードの場合: 操作可能状態を false に設定する
                    // _label->SetState(true, true, false, false);
                }
            }
        }
    }

    return error;
}

// 操作可能モードで操作キー押下時の結果イベントを受信するハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // invoker にはイメージラベルコントロールが渡される
    // reason には SFP16_RESULT_OK が渡される
    // result には現在値が渡される [ 現在値 ＝ GetCurrentValue() の戻り値 ]

    // ...（省略）...

    return;
}

例 9.98. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZSingleTextBoxControlSmp _box;

    // ...（省略）...
private:
    SFCError Make(Void);

    // 操作キー押下時の結果イベントを受信するハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.99. 実装

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // 単一行テキストボックスコントロールを作成する
    if ((_box = SFZSingleTextBoxControl::NewInstance(&error)) != null) {

        // 単一行テキストボックスコントロールの親を USRWindow に設定する
        error = _box->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // 操作キー押下時の結果イベントを受信するハンドラを登録する
            error = _box->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // 表示するテキストを設定する
                // SFXWideString オブジェクトの設定 (※リソースファイルから設定することも可能)
                error = _box->SetText("hello world");
                if (error == SFERR_NO_ERROR) {

                    // 単一行テキストボックスコントロールの実領域を最適なサイズの矩形に設定する[始点は(10, 10)]
                    _box->SetRealBound(_box->GetSuitableBound().SetOrigin(10, 10));

                    // 単一行テキストボックスコントロールの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
                    _box->SetState(true, true, true, true);
                }
            }
        }
    }

    return error;
}

// 操作キー押下時の結果イベントを受信するハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // invoker には単一行テキストボックスコントロールが渡される
    // reason には SFP16_RESULT_OK が渡される
    // result には現在値が渡される [ 現在値 ＝ GetCurrentValue() の戻り値 ]

    // ...（省略）...

    return;
}

例 9.100. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZSingleEditBoxControlSmp _box;

    // ...（省略）...
private:
    SFCError Make(Void);

    // 入力終了時の結果イベントを受信するハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.101. 実装

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // 単一行エディットボックスコントロールを作成する
    if ((_box = SFZSingleEditBoxControl::NewInstance(&error)) != null) {

        // 単一行エディットボックスコントロールの親を USRWindow に設定する
        error = _box->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // 入力終了時の結果イベントを受信するハンドラを登録する
            error = _box->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // 数字入力モードを ON に設定する
                _box->SetInputMode(AEE_TM_NUMBERS);

                // パスワード入力モードを ON に設定する
                error = _box->SetPasswordMode(true);
                if (error == SFERR_NO_ERROR) {

                    // 表示するテキストを設定する
                    // SFXWideString オブジェクトの設定 (※リソースファイルから設定することも可能)
                    error = _box->SetText("0123456789");
                    if (error == SFERR_NO_ERROR) {

                        // 単一行エディットボックスコントロールの実領域を最適なサイズの矩形に設定する[始点は(10, 10)]
                        _box->SetRealBound(_box->GetSuitableBound().SetOrigin(10, 10));

                        // 単一行エディットボックスコントロールの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
                        _box->SetState(true, true, true, true);
                    }
                }
            }
        }
    }

    return error;
}

// 入力終了時の結果イベントを受信するハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    SFXWideString text;

    // invoker には単一行エディットボックスコントロールが渡される
    // reason には SFP16_RESULT_OK または SFP16_RESULT_ERROR が渡される

    switch (reason) {

        case SFP16_RESULT_OK:
            // テキスト入力が正常に終了した場合、reason には SFP16_RESULT_OK が渡される
            // このとき、result には現在値が渡される [ 現在値 ＝ GetCurrentValue() の戻り値 ]

            // 入力されたテキストを取得する
            text = _box->GetText();

            // 入力されたテキストをデバッグウィンドウに表示する
            TRACE("%S", text.GetCString());

            break;

        case SFP16_RESULT_ERROR:
            // テキスト入力が正常に終了した場合、reason には SFP16_RESULT_ERROR が渡される
            // このとき、result にはエラー値(SFCError 型)が渡される

            // ...（省略）...
            break;
    }

    return;
}

例 9.102. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZMultipleTextBoxControlSmp _box;

    // ...（省略）...
private:
    SFCError Make(Void);

    // 操作キー押下時の結果イベントを受信するハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.103. 実装

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // 複数行テキストボックスコントロールを作成する
    if ((_box = SFZMultipleTextBoxControl::NewInstance(&error)) != null) {

        // 複数行テキストボックスコントロールの親を USRWindow に設定する
        error = _box->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // 操作キー押下時の結果イベントを受信するハンドラを登録する
            error = _box->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // 表示するテキストを設定する
                // SFXWideString オブジェクトの設定 (※リソースファイルから設定することも可能)
                error = _box->SetText("hello world\nabc\nxyz");
                if (error == SFERR_NO_ERROR) {

                    // 複数行テキストボックスコントロールの実領域を USRWindow を (10, 10) だけ Deflate した矩形領域に収まる最適なサイズの矩形に設定する[始点は(10, 10)]
                    _box->SetRealBound(_box->GetSuitableBound(GetLocalBound().Deflate(10, 10)));

                    // 複数行テキストボックスコントロールの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
                    _box->SetState(true, true, true, true);
                }
            }
        }
    }

    return error;
}

// 操作キー押下時の結果イベントを受信するハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // invoker には複数行テキストボックスコントロールが渡される
    // reason には SFP16_RESULT_OK が渡される
    // result には現在値が渡される [ 現在値 ＝ GetCurrentValue() の戻り値 ]

    // ...（省略）...

    return;
}

例 9.104. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZMultipleEditBoxControlSmp _box;

    // ...（省略）...
private:
    SFCError Make(Void);

    // 入力終了時の結果イベントを受信するハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.105. 実装

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // 複数行エディットボックスコントロールを作成する
    if ((_box = SFZMultipleEditBoxControl::NewInstance(&error)) != null) {

        // 複数行エディットボックスコントロールの親を USRWindow に設定する
        error = _box->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // 入力終了時の結果イベントを受信するハンドラを登録する
            error = _box->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // 数字入力モードを ON に設定する
                _box->SetInputMode(AEE_TM_NUMBERS);

                // パスワード入力モードを ON に設定する
                error = _box->SetPasswordMode(true);
                if (error == SFERR_NO_ERROR) {

                    // 表示するテキストを設定する
                    // SFXWideString オブジェクトの設定 (※リソースファイルから設定することも可能)
                    error = _box->SetText("0123456789\n012\n789");
                    if (error == SFERR_NO_ERROR) {

                        // 複数行エディットボックスコントロールの実領域を USRWindow を (10, 10) だけ Deflate した矩形領域に収まる最適なサイズの矩形に設定する[始点は(10, 10)]
                        _box->SetRealBound(_box->GetSuitableBound(GetLocalBound().Deflate(10, 10)));

                        // 複数行エディットボックスコントロールの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
                        _box->SetState(true, true, true, true);
                    }
                }
            }
        }
    }

    return error;
}

// 入力終了時の結果イベントを受信するハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    SFXWideString text;

    // invoker には複数行エディットボックスコントロールが渡される
    // reason には SFP16_RESULT_OK または SFP16_RESULT_ERROR が渡される

    switch (reason) {

        case SFP16_RESULT_OK:
            // テキスト入力が正常に終了した場合、reason には SFP16_RESULT_OK が渡される
            // このとき、result には現在値が渡される [ 現在値 ＝ GetCurrentValue() の戻り値 ]

            // 入力されたテキストを取得する
            text = _box->GetText();

            // 入力されたテキストをデバッグウィンドウに表示する
            TRACE("%S", text.GetCString());

            break;

        case SFP16_RESULT_ERROR:
            // テキスト入力が正常に終了した場合、reason には SFP16_RESULT_ERROR が渡される
            // このとき、result にはエラー値(SFCError 型)が渡される

            // ...（省略）...
            break;
    }

    return;
}

例 9.106. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZImageBoxControlSmp _box;

    // ...（省略）...
private:
    SFCError Make(Void);

    // 操作キー押下時の結果イベントを受信するハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.107. 実装

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // イメージボックスコントロールを作成する
    if ((_box = SFZImageBoxControl::NewInstance(&error)) != null) {

        // イメージボックスコントロールの親を USRWindow に設定する
        error = _box->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // 操作キー押下時の結果イベントを受信するハンドラを登録する
            error = _box->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // 表示するイメージを設定する
                // SFBImage オブジェクトの設定 ( リソースファイルやファイルから設定可能 )
                error = _box->SetImage(SFXPath("resource.bar"), IMAGE_ID);
                if (error == SFERR_NO_ERROR) {

                    // イメージボックスコントロールの実領域を最適なサイズの矩形に設定する[始点は(10, 10)]
                    _box->SetRealBound(_box->GetSuitableBound().SetOrigin(10, 10));

                    // イメージボックスコントロールの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
                    _box->SetState(true, true, true, true);
                }
            }
        }
    }

    return error;
}

// 操作キー押下時の結果イベントを受信するハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // invoker にはイメージボックスコントロールが渡される
    // reason には SFP16_RESULT_OK が渡される
    // result には現在値が渡される [ 現在値 ＝ GetCurrentValue() の戻り値 ]

    // ...（省略）...

    return;
}

例 9.108. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZTextButtonControlSmp _button;

    // ...（省略）...
private:
    SFCError Make(Void);

    // テキストボタンコントロール操作時の結果イベントを受信するハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.109. 実装

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // テキストボタンコントロールを作成する
    if ((_button = SFZTextButtonControl::NewInstance(&error)) != null) {

        // テキストボタンコントロールの親を USRWindow に設定する
        error = _button->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // テキストボタンコントロール操作時の結果イベントを受信するハンドラを登録する
            error = _button->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // 表示するテキストを設定する
                // SFXWideString オブジェクトの設定(※リソースファイルから設定することも可能)
                error = _button->SetText("hello world");
                if (error == SFERR_NO_ERROR) {

                    // テキストボタンコントロールの実領域を最適なサイズの矩形に設定する[始点は(10, 10)]
                    _button->SetRealBound(_button->GetSuitableBound().SetOrigin(10, 10));

                    // テキストボタンコントロールの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
                    _button->SetState(true, true, true, true);
                }
            }
        }
    }

    return error;
}

// テキストボタンコントロール操作時の結果イベントを受信するハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // invoker にはテキストボタンコントロールが渡される
    // reason には SFP16_RESULT_OK が渡される
    // result には現在値が渡される [ 現在値 ＝ GetCurrentValue() の戻り値 ]

    // ...（省略）...

    return;
}

例 9.110. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZImageButtonControlSmp _button;

    // ...（省略）...
private:
    SFCError Make(Void);

    // イメージボタンコントロール操作時の結果イベントを受信するハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.111. 実装

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // イメージボタンコントロールを作成する
    if ((_button = SFZImageButtonControl::NewInstance(&error)) != null) {

        // イメージボタンコントロールの親を USRWindow に設定する
        error = _button->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // イメージボタンコントロール操作時の結果イベントを受信するハンドラを登録する
            error = _button->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // 表示するイメージを設定する
                // SFBImage オブジェクトの設定(リソースファイルやファイルから設定可能)
                error = _button->SetImage(SFXPath("resource.bar"), IMAGE_ID);
                if (error == SFERR_NO_ERROR) {

                    // イメージボタンコントロールの実領域を最適なサイズの矩形に設定する[始点は(10, 10)]
                    _button->SetRealBound(_button->GetSuitableBound().SetOrigin(10, 10));

                    // イメージボタンコントロールの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
                    _button->SetState(true, true, true, true);
                }
            }
        }
    }

    return error;
}

// イメージボタンコントロール操作時の結果イベントを受信するハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // invoker にはイメージボタンコントロールが渡される
    // reason には SFP16_RESULT_OK が渡される
    // result には現在値が渡される [ 現在値 ＝ GetCurrentValue() の戻り値 ]

    // ...（省略）...

    return;
}

例 9.112. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZContainerSmp _container;
    SFZScrollBarControlSmp _bar;

public:
    SFCError Make(Void);

    // ...
private:

    // コンテナの領域情報を読み取りスクロールバーのサムの位置と大きさを設定する関数
    Void Listen(SFYResponderPtr container);

    // コンテナの実領域と仮想領域に関する領域イベント用ハンドラ
    XANDLER_DECLARE_VOIDBOUND(OnContainerBound)
};

例 9.113. 実装

#define SCROLLBAR_WIDTH 5

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // コンテナを作成する
    if ((_container = SFZContainer::NewInstance(&error)) != null) {

        // コンテナの親を USRWindow に設定する
        error = _container->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // 実領域と仮想領域に関する領域イベント用ハンドラをコンテナに登録する
            error = _container->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_BOUND, SFEVT_RESPONDER_BOUND, SFP16_BOUND_REAL, SFP16_BOUND_VIRTUAL),
                XANDLER_INTERNAL(OnContainerBound)
            );

            if (error == SFERR_NO_ERROR) {

                // コンテナの背景色を設定する
                _container->SetBackgroundColor(SFXRGBColor(0xFF, 0xCC, 0xCC, 0x00));

                // コンテナの実領域をウィンドウのローカル領域からスクロールバーの分だけ除いた領域に設定する
                _container->SetRealBound(GetLocalBound().SubWidth(SCROLLBAR_WIDTH));

                // コンテナの仮想領域を実領域から上下に 100 ずつ広げた領域に設定する
                _container->SetVirtualBound(SFXRectangle(_container->GetRealBound()).Inflate(0, 100));

                // コンテナの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
                _container->SetState(true, true, true, true);
                if ((_bar = SFZScrollBarControl::NewInstance(&error)) != null) {

                    // スクロールバーの親を USRWindow に設定する
                    error = _bar->SetParent(GetThis());
                    if (error == SFERR_NO_ERROR) {

                        // コンテナの右横にスクロールバーを配置する
                        _bar->SetRealBound(GetLocalBound().SetX(_container->GetRealBound().GetRight()).SetWidth(SCROLLBAR_WIDTH));

                        // スクロールバーの状態を「可視＋活性＋操作不能＋非フォーカス」にまとめて設定する
                        _bar->SetState(true, true, false, false);

                        // コンテナの領域情報を読み取りスクロールバーのサムの位置と大きさを設定する
                        Listen(_container.Get());
                    }
                }
            }
        }
    }

    return error;
}

// コンテナの領域情報を読み取りスクロールバーのサムの位置と大きさを設定する関数
Void USRWindow::Listen(SFYResponderPtr container)
{
    SFXRectangle rx;
    SFXRectangle vx;
    SInt16 max;
    SInt16 cur;
    SInt16 page;

    if (_bar != null & container != null) {

        // コンテナの実領域を取得する
        rx = container->GetRealBound();

        // コンテナの仮想領域を取得する
        vx = container->GetVirtualBound();

        if (_bar->GetOrientation() == SFYScrollBarControl::VERTICAL) {
            // スクロールの方向が垂直の場合

            // max の値を仮想領域の縦幅に設定する
            max = vx.GetHeight();

            // cur の値をローカル座標系における実領域の始点の Y 値に設定する
            cur = -vx.GetTop();

            // page の値を実領域の縦幅に設定する
            page = rx.GetHeight();
        }
        else {
            // スクロールの方向が水平の場合

            // max の値を仮想領域の横幅に設定する
            max = vx.GetWidth();

            // cur の値をローカル座標系における実領域の始点の X 値に設定する
            cur = -vx.GetLeft();

            // page の値を実領域の横幅に設定する
            page = rx.GetWidth();
        }

        // 最小値を設定する (この値は常に 0 である)
        _bar->SetMinimumValue(0);

        // 最大値を設定する (この値は仮想領域の横幅もしくは縦幅になる)
        _bar->SetMaximumValue(max);

        // 現在値を設定する (この値はローカル領域座標系における実領域の始点の X 値または Y 値になる)
        _bar->SetCurrentValue(cur);

        // ページサイズを設定する (この値は実領域の横幅もしくは縦幅になる)
        _bar->SetPageValue(page);
    }
}

// コンテナの実領域と仮想領域に関する領域イベント用ハンドラの実装
XANDLER_IMPLEMENT_VOIDBOUND(USRWindow, OnContainerBound, invoker, reason, bound)
{
    unused(reason);
    unused(bound);

    // invoker にはコンテナが渡される

    // コンテナの領域が変更されたときにスクロールバーのサムの位置と大きさ更新する
    Listen(invoker);
}

例 9.114. 宣言

例 9.115. 実装

#define SCROLLBAR_WIDTH 5

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // コンテナを作成する
    if ((_container = SFZContainer::NewInstance(&error)) != null) {

        // コンテナの親を USRWindow に設定する
        error = _container->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // コンテナの背景色を設定する
            _container->SetBackgroundColor(SFXRGBColor(0xFF, 0xCC, 0xCC, 0x00));

            // コンテナの実領域をウィンドウのローカル領域からスクロールバーの分だけ除いた領域に設定する
            _container->SetRealBound(GetLocalBound().SubWidth(SCROLLBAR_WIDTH));

            // コンテナの仮想領域を実領域から上下に 100 ずつ広げた領域に設定する
            _container->SetVirtualBound(SFXRectangle(_container->GetRealBound()).Inflate(0, 100));

            // コンテナの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
            _container->SetState(true, true, true, true);
            if ((_bar = SFZContainerScrollBarControl::NewInstance(&error)) != null) {

                // スクロールバーの親を USRWindow に設定する
                error = _bar->SetParent(GetThis());
                if (error == SFERR_NO_ERROR) {

                    // コンテナの右横にスクロールバーを配置する
                    _bar->SetRealBound(GetLocalBound().SetX(_container->GetRealBound().GetRight()).SetWidth(SCROLLBAR_WIDTH));

                    // スクロールバーの状態を「可視＋活性＋操作不能＋非フォーカス」にまとめて設定する
                    _bar->SetState(true, true, false, false);

                    // コンテナと関連付ける
                    _bar->Bind(_container);
                }
            }
        }
    }

    return error;
}

例 9.116. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZListBoxControlSmp _listbox;

    // ...（省略）...
private:
    SFCError Make(Void);

    // 結果イベントを受信するハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.117. 実装

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // リストボックスコントロールを作成する
    if ((_listbox = SFZListBoxControl::NewInstance(&error)) != null) {

        // リストボックスコントロールの親を USRWindow に設定する
        error = _listbox->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // 結果イベントを受信するハンドラを登録する
            error = _listbox->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                for (SInt32 i = 0; i < 20; ++i) {

                    // 項目を追加する
                    error = _listbox->InsertLast(SFXWideString::Format("Item index is %d", i));

                    if (error != SFERR_NO_ERROR) break;
                }
                if (error == SFERR_NO_ERROR) {

                    // リストボックスコントロールの実領域を最適なサイズの矩形に設定する[始点は(20, 20)]
                    _listbox->SetRealBound(_listbox->GetSuitableBound(GetLocalBound().Deflate(20, 20)).SetOrigin(20, 20));

                    // リストボックスコントロールの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
                    _listbox->SetState(true, true, true, true);
                }
            }
        }
    }

    return error;
}

// リストボックスコントロール操作時の結果イベントを受信するハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    SFXWideString text;

    // invoker にはリストボックスコントロールが渡される
    // reason には SFP16_RESULT_OK または SFP16_RESULT_ESCAPE が渡される

    switch (reason) {

        case SFP16_RESULT_OK:  
            // 操作キー押下時、reason には SFP16_RESULT_OK が渡される
            // このとき、result には現在値(選択された項目インデックス値)が渡される [ 現在値 ＝ GetCurrentValue() の戻り値 ]

            // 選択された項目のテキストを取得する
            text = _listbox->GetItemText(result);

            // 選択された項目のテキストをデバッグウィンドウに表示する
            TRACE("%S", text.GetCString());

            break;

        case SFP16_RESULT_ESCAPE:
            // ESCAPE キー押下時、reason には SFP16_RESULT_ESCAPE が渡される
            // このとき、result には 0 が渡される

            // ...（省略）...
            break;
    }
    return;
}

例 9.118. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZComboBoxControlSmp _combobox;

    // ...
private:
    SFCError Make(Void);

    // 結果イベント用ハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.119. 実装

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // コンボボックスコントロールを作成する
    if ((_combobox = SFZComboBoxControl::NewInstance(&error)) != null) {

        // コンボボックスコントロールの親を USRWindow に設定する
        error = _combobox->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // コンボボックスコントロールに結果ハンドラを登録する
            error = _combobox->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                for (SInt32 i = 0; i < 10; ++i) {

                    // コンボボックスコントロールが内部的に保持するフレックスリストボックスコントロールに項目を追加する
                    error = _combobox->InsertLast(SFXWideString::Format("Item index is %d.", i));

                    if (error != SFERR_NO_ERROR) break;
                }
                if (error == SFERR_NO_ERROR) {

                    // コンボボックスコントロールの実領域を最適なサイズの矩形に設定する[始点は(20, 20)]
                    _combobox->SetRealBound(_combobox->GetSuitableBound(GetLocalBound().Deflate(20, 20)).SetOrigin(20, 20));

                    // コンボボックスコントロールの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
                    _combobox->SetState(true, true, true, true);
                }
            }
        }
    }

    return error;
}

// コンボボックスコントロールの結果ハンドラの実装
// ※このハンドラは、SetCurrentValue 関数で値を変更した場合は呼び出されない
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    SFXWideString text;

    // invoker にはコンボボックスコントロールが渡される
    // reason には SFP16_RESULT_OK が渡される
    // result には現在値(選択された項目インデックス値)が渡される [ 現在値 ＝ GetCurrentValue() の戻り値 ]

    // 選択された項目のテキストを取得する
    text = _combobox->GetItemText(result);

    // 選択された項目のテキストをデバッグウィンドウに表示する
    TRACE("%S", text.GetCString());

    return;
}

例 9.120. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZCheckboxControlSmp _checkbox;

    // ...（省略）...
private:
    SFCError Make(Void);

    // チェックボックスコントロール操作時の結果イベントを受信するハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.121. 実装

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // チェックボックスコントロールを作成する
    if ((_checkbox = SFZCheckboxControl::NewInstance(&error)) != null) {

        // チェックボックスコントロールの親を USRWindow に設定する
        error = _checkbox->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // チェックボックスコントロール操作時の結果イベントを受信するハンドラを登録する
            error = _checkbox->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // 表示するテキストを設定する
                // SFXWideString オブジェクトの設定 (※リソースファイルから設定することも可能)
                error = _checkbox->SetText("hello world");
                if (error == SFERR_NO_ERROR) {

                    // チェックボックスコントロールの状態をチェックされている状態に設定する
                    _checkbox->SetCurrentValue(true);

                    // チェックボックスコントロールの実領域を最適なサイズの矩形に設定する[始点は(10, 10)]
                    _checkbox->SetRealBound(_checkbox->GetSuitableBound().SetOrigin(10, 10));

                    // チェックボックスコントロールの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
                    _checkbox->SetState(true, true, true, true);
                }
            }
        }
    }

    return error;
}

// チェックボックスコントロール操作時の結果イベントを受信するハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // invoker にはチェックボックスコントロールが渡される
    // reason には SFP16_RESULT_OK が渡される
    // result には現在値が渡される [ 現在値 ＝ GetCurrentValue() の戻り値 ]

    // ...（省略）...

    return;
}

例 9.122. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZRadiobuttonControlSmp _radiobutton;

    // ...（省略）...
private:
    SFCError Make(Void);

    // ラジオボタンコントロール操作時の結果イベントを受信するハンドラ
    XANDLER_DECLARE_VOIDRESULT(OnResult)
};

例 9.123. 実装

SFCError USRWindow::Make(Void)
{
    SFCError error(SFERR_NO_ERROR);

    // ラジオボタンコントロールを作成する
    if ((_radiobutton = SFZRadiobuttonControl::NewInstance(&error)) != null) {

        // ラジオボタンコントロールの親を USRWindow に設定する
        error = _radiobutton->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {

            // ラジオボタンコントロール操作時の結果イベントを受信するハンドラを登録する
            error = _radiobutton->RegisterHandler(
                SFXEventRange(SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT, SFP16_BEGIN, SFP16_END),
                XANDLER_INTERNAL(OnResult)
            );
            if (error == SFERR_NO_ERROR) {

                // 表示するテキストを設定する
                // SFXWideString オブジェクトの設定 (※リソースファイルから設定することも可能)
                error = _radiobutton->SetText("hello world");
                if (error == SFERR_NO_ERROR) {

                    // ラジオボタンコントロールの状態をチェックされている状態に設定する
                    _radiobutton->SetCurrentValue(true);

                    // ラジオボタンコントロールの実領域を最適なサイズの矩形に設定する[始点は(10, 10)]
                    _radiobutton->SetRealBound(_radiobutton->GetSuitableBound().SetOrigin(10, 10));

                    // ラジオボタンコントロールの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
                    _radiobutton->SetState(true, true, true, true);
                }
            }
        }
    }

    return error;
}

// ラジオボタンコントロール操作時の結果イベントを受信するハンドラの実装
XANDLER_IMPLEMENT_VOIDRESULT(USRWindow, OnResult, invoker, reason, result)
{
    // invoker にはラジオボタンコントロールが渡される
    // reason には SFP16_RESULT_OK が渡される
    // result には現在値が渡される [ 現在値 ＝ GetCurrentValue() の戻り値 ]

    // ...（省略）...

    return;
}

例 9.124. 宣言

SFMTYPEDEFRESPONDER(USRWindow)
class USRWindow: public SFZWindow {
    SFMSEALRESPONDER(USRWindow)
    SFMRESPONDERINSTANTIATEFOUR(USRWindow, SFZWindow, SFYContainer, SFYWidget, SFYResponder)
private:
    SFZTabControlSmp _tab;

    // ...（省略）...
private:
    SFCError Make(Void);
};

例 9.125. 実装

SFCError USRWindow::Make(Void)
{
    SFBShellSmp shell;
    SFBImageSmp image;
    SFXWideString text;
    SFZTabPageSmp page[4];
    SFZTextButtonControlSmp button[4];
    SFXRectangle rectangle;
    SInt16 i;
    SFCError error(SFERR_NO_ERROR);

    // タブコントロールを作成する
    if ((_tab = SFZTabControl::NewInstance(&error)) != null) {

        // タブコントロールの親を USRWindow に設定する
        error = _tab->SetParent(GetThis());

        if (error == SFERR_NO_ERROR) {

            // タブコントロールの実領域を USRWindow のローカル領域に設定する
            _tab->SetRealBound(GetLocalBound());

            // タブコントロールの背景色を設定する
            _tab->SetBackgroundColor(SFXRGBColor(0xDD, 0xFF, 0xDD, 0x00));

            // タブコントロール領域に 3 つのタブページが表示されるように設定する
            _tab->SetFieldValue(3);

            // タブコントロールの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
            _tab->SetState(true, true, true, true);

            // SFBShell インスタンスを取得する
            shell = SFBShell::GetInstance();

            if (shell != null) {

                // 4 ページ分のタブページを作成した後、追加する
                for (i = 0; i < 4; ++ i) {

                    // タブページを作成する
                    page[i] = SFZTabPage::NewInstance(&error);
                    if (page[i] != null) {

                        // タブコントロールをタブページの親レスポンダにする
                        // タブページの実領域が自動的に設定される
                        error = page[i]->SetParent(_tab);

                        if (error == SFERR_NO_ERROR) {

                            // タブページのタイトルテキストを設定する
                            text = SFXWideString::Format("%c", 'A' + i);
                            page[i]->SetTitle(text);

                            // タブページのヒントテキストを設定する
                            text = SFXWideString::Format("Page %d", i);
                            error = page[i]->SetHint(text);
                            if (error == SFERR_NO_ERROR) {

                                // 画像をリソースファイルから読み込む
                                image = shell->LoadResImage(TAB_RES_FILE, IDI_OBJECT_5001 + i);
                                if (image != null) {

                                    // タブページのタイトル画像を設定する ( リソースファイルやファイルから設定可能 )
                                    page[i]->SetImage(image);

                                    // タブページの状態を「可視＋活性＋操作可能＋非フォーカス」にまとめて設定する
                                    // ※この状態はタブページのデフォルト初期設定と同じなので次の 1 行は無くても構わない
                                    page[i]->SetState(true, true, true, false);

                                    // タブページの中央にボタンを追加する

                                    // ボタンを作成する
                                    if ((button[i] = SFZTextButtonControl::NewInstance(&error)) != null) {

                                        // ボタンの親をタブページに設定する
                                        error = button[i]->SetParent(page[i]);

                                        if (error == SFERR_NO_ERROR) {

                                            // ボタンのラベルを設定する
                                            error = button[i]->SetText(SFXWideString::Format("Button %c", 'A' + i));

                                            if (error == SFERR_NO_ERROR) {

                                                // ボタンに最適な領域サイズを計算する
                                                rectangle = button[i]->GetSuitableBound(page[i]->GetLocalBound());

                                                // ボタンをタブページの中央に配置する
                                                rectangle.SnapCenterMiddle(page[i]->GetLocalBound().GetCenterMiddle());

                                                // ボタンの実領域を設定する
                                                button[i]->SetRealBound(rectangle);

                                                // ボタンの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
                                                button[i]->SetState(true, true, true, true);
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    }
                    if (error != SFERR_NO_ERROR) break;
                }
                if (error == SFERR_NO_ERROR) {

                    // FocusPage 関数の引数にタブページのインデックスを指定して
                    // 1 ページ目のタブページを最前面に移動させる(表示させる)
                    _tab->FocusPage(0);

                    // ★★★  禁止事項  ★★★
                    // 選択されているタブが現在表示されているタブページに一致しなくなる可能性があるため、
                    // 下記の方法によりタブページを最前面に移動させようとしてはいけない

                    // 方法 1． 1 ページ目のタブページにフォーカスを移動することで最前面に移動させる
                    // × page[0]->SetStateFocus(true);

                    // 方法 2． ToFront 関数を呼び出して 1 ページ目のタブページを最前面に移動させる
                    // × page[0]->ToFront();

                    // ■□■  タブページの仮想領域設定  ■□■
                    // ※1. タブページの子レスポンダがタブコントロールのコンテント領域外に配置される場合は、
                    //      SFYTabControl::AdjustPages 関数を呼び出してタブページの仮想領域を設定する必要がある 
                    // ※2. この例では、タブページの子レスポンダの配置がすべてコンテント領域内に収まっているので、
                    //      SFYTabControl::AdjustPages 関数を呼び出す必要はない 
                }
            }
        }
    }

    return error;
}

例 9.126. アプリケーションクラスでのソフトキーコントロールの作成

// 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()) {

           // ソフトキーコントロールを作成する
           // ※アプリケーションクラスはソフトキーコントロールを 1 つまで保持できる
           _softkey = SFZSoftKeyControl::NewInstance(&error);

           if (_softkey != null) {

                // ソフトキーコントロールの各種設定を行う

                // 親レスポンダをルートに設定する
                // ※1. ソフトキーコントロールの親レスポンダはルートでなければいけない
                // ※2. 内部処理によりソフトキーコントロールは常に最前面に配置される
                // ※3. ソフトキーコントロールはルートの次にソフトキー 1 〜 4 のキーイベントを受信する
                error = _softkey->SetParent(GetThis());


                if (error == SFERR_NO_ERROR) {

                    // スタイルを『拡張スタイル』に設定する
                    _softkey->SetStyle(SFZSoftKeyControl::EXTENSION);

                    // GetSuitableBound 関数を使用して実領域を設定する
                    // ★ソフトキーコントロール固有の GetSuitableBound() の仕様
                    // ※1. 引数には何も指定しない（指定しても無視される）
                    // ※2. 最適な始点の位置も自動計算される
                    _softkey->SetRealBound(_softkey->GetSuitableBound());

                    // 状態を「可視＋活性＋操作不能＋非フォーカス」に設定する
                    _softkey->SetState(true, true, false, false);

                    // _softkey->ToFront();  // 自動的に実行されるので不要

                    // 要素（テキスト、画像、3 色）を登録する
                    // ※1. 要素はソフトキーメニューの使用前に登録する
                    // ※2. 登録しなかった画像と 3 色は、デフォルト設定となる
                    _softkey->RegisterText(IDS_SK_EXIT,   SFXWideString("終了"));
                    _softkey->RegisterText(IDS_SK_EDIT,   SFXWideString("設定"));
                    _softkey->RegisterText(IDS_SK_ADD,    SFXWideString("追加"));
                    _softkey->RegisterText(IDS_SK_CHANGE, SFXWideString("変更"));
                    _softkey->RegisterText(IDS_SK_REMOVE, SFXWideString("削除"));

                    // ※リソースファイルからの一括登録も可能
                    // _softkey->RegisterTextRange(
                    //   IDS_SK_EXIT, SFXPath(SCREENSAVER_SFY_RES_FILE), IDS_SK_EXIT, IDS_SK_REMOVE
                    // );
                }
            }
        }

        // MainWindow を作成する
        if (error == SFERR_NO_ERROR) {

            _main = MainWindow::NewInstance(&error);

            // ...（省略）...
        }

        // ...（省略）...
    }
}

// ソフトキーコントロールを取得する関数の実装
SFZSoftKeyControlSmp screensaver_sfy::GetSoftKey(Void)
{
    return static_cast<screensaver_sfyPtr>(GetInstance())->_softkey;
}

例 9.127. レスポンダクラスでのソフトキーコントロールの設定

// MainWindow の定義
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]に変換される
        { 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) {

            if (!_softkey->ContainsMenuKey(MENUID_MAIN)) {
                // 固有のキー MENUID_MAIN に対応するソフトキーメニューが作成されていなければ、

                // ソフトキーメニューを作成する
                _softkey->CreateMenu(MENUID_MAIN);

                // ソフトキーメニューの各要素のキーを設定する
                // ※1. 要素はアプリケーションクラスのコンストラクタ内で登録済み
                // ※2. 左から SELECT, SOFTKEY_1, SOFTKEY_2, SOFTKEY_3, SOFTKEY_4 のラベルに対応する
                UInt32 keyText[] = {
                    IDS_SK_ADD, IDS_SK_EXIT, IDS_SK_EDIT, IDS_SK_CHANGE, IDS_SK_REMOVE
                };
                _softkey->SetTextKey(MENUID_MAIN, keyText, lengthof(keyText));
           }

           //  MainWindow にソフトキーメニューを関連付ける
           _softkey->Bind(this, MENUID_MAIN); 
           // "_softkey->Bind(GetThis(), MENUID_MAIN);" と記述しても良いが、パフォーマンスがやや悪くなる
        }
    }
}

例 9.128. ソフトキーイベントのハンドラの実装

// MainWindow のソフトキーイベントのハンドラの実装
// ※MainWindow は、アクティブレスポンダのときにしかソフトキーイベントを受信しない
XANDLER_IMPLEMENT_VOIDEVENT(MainWindow, OnSoftkey, invoker, event)
{

    // ...（省略）...

    switch (event.GetP16()) {

        case AVK_SOFT1:

            // 終了確認ダイアログの作成

            // ...（省略）...
            break;

        case AVK_SOFT2:

            // メニューの作成

            // ...（省略）...
            break;

         case AVK_SOFT3:

            // 変更処理

            // ...（省略）...
            break;

        case AVK_SOFT4:

            // 削除処理

            // ...（省略）...
            break;
    }

    return;
}

例 9.129. 宣言

SFMTYPEDEFRESPONDER(USRControl)
class USRControl: public SFYControl {
    SFMSEALRESPONDER(USRControl)
    SFMRESPONDERINSTANTIATETHREE(USRControl, SFYControl, SFYWidget, SFYResponder)
public:

    // レスポンダのタイプを定義する
    // 小文字と記号のみからなるタイプは予約されているので使えない
    enum CodeEnum {
        CODE_TYPE = four_char_code('U', 'C', 'N', 'T')
    };
    SFMTYPEDEFTYPE(CodeEnum)

public:
    static USRControlSmp NewInstance(SFCErrorPtr exception = null);
protected:
    explicit USRControl(Void) static_throws;
    virtual ~USRControl(Void);

    // 親クラスで定義されている仮想関数のうち、実装が推奨される仮想関数
    virtual Void HandleBoundRequest(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundOptimize(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundVirtual(Void);
    virtual Void HandleRenderRequest(SFXGraphicsPtr graphics) const;
};

例 9.130. 実装

USRControl::USRControl(Void) static_throws
{
    if (static_try()) {

        // レスポンダのタイプを設定する
        SetType(CODE_TYPE);

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

USRControl::~USRControl(Void)
{
    // 終了処理を記述する
}

USRControlSmp USRControl::NewInstance(SFCErrorPtr exception)
{
    return static_pointer_cast<USRControl>(Factory(::new USRControl, exception));
}

Void USRControl::HandleBoundRequest(SFXRectanglePtr rectangle) const
{
    // コントロールに最適な大きさを計算して rectangle パラメータに設定する
    // この関数内では、rectangle の原点は変更せず、rectangle のサイズだけを設定する(推奨)

    return;
}

Void USRControl::HandleBoundOptimize(SFXRectanglePtr rectangle) const
{
    // コントロールに最適な大きさを rectangle パラメータ内の大きさに
    // 収まるように計算し、rectangle パラメータに設定する
    // この関数内では、rectangle の原点は変更せず、rectangle のサイズだけを設定する(推奨)

    return;
}

Void USRControl::HandleBoundVirtual(Void)
{
    // 仮想領域が変更された場合に再計算が必要なものがあれば、ここに記述する

    return;
}

Void USRControl::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    // コントロールを描画する

    return;
}

例 9.131. 宣言

SFMTYPEDEFRESPONDER(USRLabelControl)
class USRLabelControl: public SFYLabelControl {
    SFMSEALRESPONDER(USRLabelControl)
    SFMRESPONDERINSTANTIATEFOUR(USRLabelControl, SFYLabelControl, SFYControl, SFYWidget, SFYResponder)
public:

    // レスポンダのタイプを定義する
    // 小文字と記号のみからなるタイプは予約されているので使えない
    enum CodeEnum {
        CODE_TYPE = four_char_code('U', 'L', 'B', 'L')
    };
    SFMTYPEDEFTYPE(CodeEnum)

public:
    static USRLabelControlSmp NewInstance(SFCErrorPtr exception = null);
protected:
    explicit USRLabelControl(Void) static_throws;
    virtual ~USRLabelControl(Void);

    // 親クラスで定義されている仮想関数のうち、実装が推奨される仮想関数
    virtual Void HandleBoundRequest(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundOptimize(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundVirtual(Void);
    virtual Void HandleRenderRequest(SFXGraphicsPtr graphics) const;
};

例 9.132. 実装

USRLabelControl::USRLabelControl(Void) static_throws
{
    if (static_try()) {

        // レスポンダのタイプを設定する
        SetType(CODE_TYPE);

        // ラベルコントロールは背景を持たないので透過モードに設定する
        SetPropertyTransparent(true);

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

USRLabelControl::~USRLabelControl(Void)
{
    // 終了処理を記述する
}

USRLabelControlSmp USRLabelControl::NewInstance(SFCErrorPtr exception)
{
    return static_pointer_cast<USRLabelControl>(Factory(::new USRLabelControl, exception));
}

Void USRLabelControl::HandleBoundRequest(SFXRectanglePtr rectangle) const
{
    // SFYLabelControl::DrawFocus 関数を利用するので、フォーカス枠の大きさ分だけ縮小する
    rectangle->Deflate(GetFocusMargin());

    // フォーカス枠内部に最適な大きさを計算して rectangle パラメータに設定する
    // この関数内では、rectangle の原点は変更せず、rectangle のサイズだけを設定する(推奨)

    // SFYLabelControl::DrawFocus 関数を利用するので、フォーカス枠の大きさ分だけ拡大する
    rectangle->Inflate(GetFocusMargin());

    return;
}

Void USRLabelControl::HandleBoundOptimize(SFXRectanglePtr rectangle) const
{
    // SFYLabelControl::DrawFocus 関数を利用するので、フォーカス枠の大きさ分だけ縮小する
    rectangle->Deflate(GetFocusMargin());

    // フォーカス枠内部に最適な大きさを rectangle パラメータ内の大きさに
    // 収まるように計算し、rectangle パラメータに設定する
    // この関数内では、rectangle の原点は変更せず、rectangle のサイズだけを設定する(推奨)

    // SFYLabelControl::DrawFocus 関数を利用するので、フォーカス枠の大きさ分だけ拡大する
    rectangle->Inflate(GetFocusMargin());

    return;
}

Void USRLabelControl::HandleBoundVirtual(Void)
{
    // 仮想領域が変更された場合に再計算が必要なものがあれば、ここに記述する

    return;
}

Void USRLabelControl::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    // SFYLabelControl::DrawFocus 関数を使用してフォーカス枠を描画する
    DrawFocus(graphics, GetLocalBound());

    // フォーカス枠内部を描画する

    return;
}

例 9.133. 宣言

SFMTYPEDEFRESPONDER(USRBoxControl)
class USRBoxControl: public SFYBoxControl {
    SFMSEALRESPONDER(USRBoxControl)
    SFMRESPONDERINSTANTIATEFOUR(USRBoxControl, SFYBoxControl, SFYControl, SFYWidget, SFYResponder)
public:

    // レスポンダのタイプを定義する
    // 小文字と記号のみからなるタイプは予約されているので使えない
    enum CodeEnum {
        CODE_TYPE = four_char_code('U', 'B', 'O', 'X')
    };
    SFMTYPEDEFTYPE(CodeEnum)

public:
    static USRBoxControlSmp NewInstance(SFCErrorPtr exception = null);
protected:
    explicit USRBoxControl(Void) static_throws;
    virtual ~USRBoxControl(Void);

    // 親クラスで定義されている仮想関数のうち、実装が推奨される仮想関数
    virtual Void HandleBoundRequest(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundOptimize(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundVirtual(Void);
    virtual Void HandleRenderRequest(SFXGraphicsPtr graphics) const;
};

例 9.134. 実装

USRBoxControl::USRBoxControl(Void) static_throws
{
    if (static_try()) {

        // レスポンダのタイプを設定する
        SetType(CODE_TYPE);

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

USRBoxControl::~USRBoxControl(Void)
{
    // 終了処理を記述する
}

USRBoxControlSmp USRBoxControl::NewInstance(SFCErrorPtr exception)
{
    return static_pointer_cast<USRBoxControl>(Factory(::new USRBoxControl, exception));
}

Void USRBoxControl::HandleBoundRequest(SFXRectanglePtr rectangle) const
{
    // SFYBoxControl::DrawBox 関数を利用するので、ボックスマージンの大きさ分だけ縮小する
    rectangle->Deflate(GetBoxMargin());

    // ボックス内部に最適な大きさを計算して rectangle パラメータに設定する
    // この関数内では、rectangle の原点は変更せず、rectangle のサイズだけを設定する(推奨)

    // SFYBoxControl::DrawBox 関数を利用するので、ボックスマージンの大きさ分だけ拡大する
    rectangle->Inflate(GetBoxMargin());

    return;
}

Void USRBoxControl::HandleBoundOptimize(SFXRectanglePtr rectangle) const
{
    // SFYBoxControl::DrawBox 関数を利用するので、ボックスマージンの大きさ分だけ縮小する
    rectangle->Deflate(GetBoxMargin());

    // ボックス内部に最適な大きさを rectangle パラメータ内の大きさに
    // 収まるように計算し、rectangle パラメータに設定する
    // この関数内では、rectangle の原点は変更せず、rectangle のサイズだけを設定する(推奨)

    // SFYBoxControl::DrawBox 関数を利用するので、ボックスマージンの大きさ分だけ拡大する
    rectangle->Inflate(GetBoxMargin());

    return;
}

Void USRBoxControl::HandleBoundVirtual(Void)
{
    // 仮想領域が変更された場合に再計算が必要なものがあれば、ここに記述する

    return;
}

Void USRBoxControl::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    // SFYBoxControl::DrawBox 関数を使用してボックスを描画する
    DrawBox(graphics, GetLocalBound());

    // ボックス内部を描画する

    return;
}

例 9.135. 宣言

SFMTYPEDEFRESPONDER(USRButtonControl)
class USRButtonControl: public SFYButtonControl {
    SFMSEALRESPONDER(USRButtonControl)
    SFMRESPONDERINSTANTIATEFOUR(USRButtonControl, SFYButtonControl, SFYControl, SFYWidget, SFYResponder)
public:

    // レスポンダのタイプを定義する
    // 小文字と記号のみからなるタイプは予約されているので使えない
    enum CodeEnum {
        CODE_TYPE = four_char_code('U', 'B', 'T', 'N')
    };
    SFMTYPEDEFTYPE(CodeEnum)

public:
    static USRButtonControlSmp NewInstance(SFCErrorPtr exception = null);
protected:
    explicit USRButtonControl(Void) static_throws;
    virtual ~USRButtonControl(Void);

    // 親クラスで定義されている仮想関数のうち、実装が推奨される仮想関数
    virtual Void HandleBoundRequest(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundOptimize(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundVirtual(Void);
    virtual Void HandleRenderRequest(SFXGraphicsPtr graphics) const;
};

例 9.136. 実装

USRButtonControl::USRButtonControl(Void) static_throws
{
    if (static_try()) {

        // レスポンダのタイプを設定する
        SetType(CODE_TYPE);

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

USRButtonControl::~USRButtonControl(Void)
{
    // 終了処理を記述する
}

USRButtonControlSmp USRButtonControl::NewInstance(SFCErrorPtr exception)
{
    return static_pointer_cast<USRButtonControl>(Factory(::new USRButtonControl, exception));
}

Void USRButtonControl::HandleBoundRequest(SFXRectanglePtr rectangle) const
{
    // SFYButtonControl::DrawButton 関数と SFYButtonControl::DrawShadow 関数を利用するので、
    // ボタンと影の大きさ分だけ縮小する
    rectangle->Deflate(GetShadowMargin());
    rectangle->Deflate(GetButtonMargin());

    // ボタン内部に最適な大きさを計算して rectangle パラメータに設定する
    // この関数内では、rectangle の原点は変更せず、rectangle のサイズだけを設定する(推奨)

    // SFYButtonControl::DrawButton 関数と SFYButtonControl::DrawShadow 関数を利用するので、
    // ボタンと影の大きさ分だけ拡大する
    rectangle->Inflate(GetButtonMargin());
    rectangle->Inflate(GetShadowMargin());

    return;
}

Void USRButtonControl::HandleBoundOptimize(SFXRectanglePtr rectangle) const
{
    // SFYButtonControl::DrawButton 関数と SFYButtonControl::DrawShadow 関数を利用するので、
    // ボタンと影の大きさ分だけ縮小する
    rectangle->Deflate(GetShadowMargin());
    rectangle->Deflate(GetButtonMargin());

    // ボタン内部に最適な大きさを rectangle パラメータ内の大きさに
    // 収まるように計算し、rectangle パラメータに設定する
    // この関数内では、rectangle の原点は変更せず、rectangle のサイズだけを設定する(推奨)

    // SFYButtonControl::DrawButton 関数と SFYButtonControl::DrawShadow 関数を利用するので、
    // ボタンと影の大きさ分だけ拡大する
    rectangle->Inflate(GetButtonMargin());
    rectangle->Inflate(GetShadowMargin());

    return;
}

Void USRButtonControl::HandleBoundVirtual(Void)
{
    // 仮想領域が変更された場合に再計算が必要なものがあれば、ここに記述する

    return;
}

Void USRButtonControl::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    // SFYButtonControl::DrawButton 関数と SFYButtonControl::DrawShadow 関数)を利用して
    // ボタンと影を描画する
    DrawButton(graphics, DrawShadow(graphics, GetLocalBound()));

    // ボタン内部を描画する

    return;
}

例 9.137. 宣言

SFMTYPEDEFRESPONDER(USRCheckboxControl)
class USRCheckboxControl: public SFYCheckboxControl {
    SFMSEALRESPONDER(USRCheckboxControl)
    SFMRESPONDERINSTANTIATEFIVE(USRCheckboxControl, SFYCheckboxControl, SFYButtonControl, SFYControl, SFYWidget, SFYResponder)
public:

    // レスポンダのタイプを定義する
    // 小文字と記号のみからなるタイプは予約されているので使えない
    enum CodeEnum {
        CODE_TYPE = four_char_code('U', 'C', 'H', 'K')
    };
    SFMTYPEDEFTYPE(CodeEnum)

public:
    static USRCheckboxControlSmp NewInstance(SFCErrorPtr exception = null);
protected:
    explicit USRCheckboxControl(Void) static_throws;
    virtual ~USRCheckboxControl(Void);

    // 親クラスで定義されている仮想関数のうち、実装が推奨される仮想関数
    virtual Void HandleBoundRequest(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundOptimize(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundVirtual(Void);
    virtual Void HandleRenderRequest(SFXGraphicsPtr graphics) const;
};

例 9.138. 実装

USRCheckboxControl::USRCheckboxControl(Void) static_throws
{
    if (static_try()) {

        // レスポンダのタイプを設定する
        SetType(CODE_TYPE);

        // チェックボックスコントロールのラベル部分は背景を持たないので透過モードに設定する
        SetPropertyTransparent(true);

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

USRCheckboxControl::~USRCheckboxControl(Void)
{
    // 終了処理を記述する
}

USRCheckboxControlSmp USRCheckboxControl::NewInstance(SFCErrorPtr exception)
{
    return static_pointer_cast<USRCheckboxControl>(Factory(::new USRCheckboxControl, exception));
}

Void USRCheckboxControl::HandleBoundRequest(SFXRectanglePtr rectangle) const
{
    // チェックボックスコントロールに最適な大きさを計算して rectangle パラメータに設定する
    // この関数内では、rectangle の原点は変更せず、rectangle のサイズだけを設定する(推奨)

    return;
}

Void USRCheckboxControl::HandleBoundOptimize(SFXRectanglePtr rectangle) const
{
    // チェックボックスコントロールに最適な大きさを rectangle パラメータ内の大きさに
    // 収まるように計算し、rectangle パラメータに設定する
    // この関数内では、rectangle の原点は変更せず、rectangle のサイズだけを設定する(推奨)

    return;
}

Void USRCheckboxControl::HandleBoundVirtual(Void)
{
    // 仮想領域が変更された場合に再計算が必要なものがあれば、ここに記述する

    return;
}

Void USRCheckboxControl::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    SFXGrid grid;

    // SFYCheckboxControl::DrawButton**/DrawShadow**/ DrawCheckmark** 関数を使用して、
    // チェックボックスと影を描画する

    // _height 変数はチェックボックス部分の高さを表し、
    // _origin 変数はチェックボックス部分の原点を表すものとする
    // ※これらの変数は、ラベル部分に使用するフォントの高さより計算する

    if (_height >= 28) {

        grid.Set(DrawShadow28(graphics, _origin));
        DrawButton27(graphics, grid);
        grid.Add(3, 3);
        DrawCheckmark21(graphics, grid);
    }
    else if (_height >= 14) {

        grid.Set(DrawShadow14(graphics, _origin));
        DrawButton13(graphics, grid);
        grid.Add(2, 2);
        DrawCheckmark09(graphics, grid);
    }

    // チェックボックスコントロールのラベル部分を描画する

    return;
}

例 9.139. 宣言

SFMTYPEDEFRESPONDER(USRRadiobuttonControl)
class USRRadiobuttonControl: public SFYRadiobuttonControl {
    SFMSEALRESPONDER(USRRadiobuttonControl)
    SFMRESPONDERINSTANTIATESIX(USRRadiobuttonControl, SFYRadiobuttonControl, SFYCheckboxControl, SFYButtonControl, SFYControl, SFYWidget, SFYResponder)
public:

    // レスポンダのタイプを定義する
    // 小文字と記号のみからなるタイプは予約されているので使えない
    enum CodeEnum {
        CODE_TYPE = four_char_code('U', 'R', 'D', 'O')
    };
    SFMTYPEDEFTYPE(CodeEnum)

public:
    static USRRadiobuttonControlSmp NewInstance(SFCErrorPtr exception = null);
protected:
    explicit USRRadiobuttonControl(Void) static_throws;
    virtual ~USRRadiobuttonControl(Void);

    // 親クラスで定義されている仮想関数のうち、実装が推奨される仮想関数
    virtual Void HandleBoundRequest(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundOptimize(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundVirtual(Void);
    virtual Void HandleRenderRequest(SFXGraphicsPtr graphics) const;
};

例 9.140. 実装

USRRadiobuttonControl::USRRadiobuttonControl(Void) static_throws
{
    if (static_try()) {

        // レスポンダのタイプを設定する
        SetType(CODE_TYPE);

        // ラジオボタンコントロールのラベル部分は背景を持たないので透過モードに設定する
        SetPropertyTransparent(true);

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

USRRadiobuttonControl::~USRRadiobuttonControl(Void)
{
    // 終了処理を記述する
}

USRRadiobuttonControlSmp USRRadiobuttonControl::NewInstance(SFCErrorPtr exception)
{
    return static_pointer_cast<USRRadiobuttonControl>(Factory(::new USRRadiobuttonControl, exception));
}

Void USRRadiobuttonControl::HandleBoundRequest(SFXRectanglePtr rectangle) const
{
    // ラジオボタンコントロールに最適な大きさを計算して rectangle パラメータに設定する
    // この関数内では、rectangle の原点は変更せず、rectangle のサイズだけを設定する(推奨)

    return;
}

Void USRRadiobuttonControl::HandleBoundOptimize(SFXRectanglePtr rectangle) const
{
    // ラジオボタンコントロールに最適な大きさを rectangle パラメータ内の大きさに
    // 収まるように計算し、rectangle パラメータに設定する
    // この関数内では、rectangle の原点は変更せず、rectangle のサイズだけを設定する(推奨)

    return;
}

Void USRRadiobuttonControl::HandleBoundVirtual(Void)
{
    // 仮想領域が変更された場合に再計算が必要なものがあれば、ここに記述する

    return;
}

Void USRRadiobuttonControl::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    SFXGrid grid;

    // SFYRadiobuttonControl::DrawButton**/DrawShadow**/DrawCheckmark** 関数を使用して
    // ラジオボタンと影を描画する

    // _height 変数はラジオボタン部分の高さを表し、
    // _origin 変数はラジオボタン部分の原点を表すものとする
    // ※これらの変数は、ラベル部分に使用するフォントの高さより計算する

    if (_height >= 28) {

        grid.Set(DrawShadow28(graphics, _origin));
        DrawButton27(graphics, grid);
        grid.Add(8, 8);
        DrawCheckmark11(graphics, grid);
    }
    else if (_height >= 14) {

        grid.Set(DrawShadow14(graphics, _origin));
        DrawButton13(graphics, grid);
        grid.Add(4, 4);
        DrawCheckmark05(graphics, grid);
    }

    // ラジオボタンコントロールのラベル部分を描画する

    return;
}