例 9.4. タイプの設定

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

        // タイプは必ずこの場所で設定する
        // このようにすると親クラスのコンストラクタ内でエラーが発生した場合は
        // 親クラスのタイプが保持され、自クラスのコンストラクタ内でエラーが
        // 発生した場合は自クラスのタイプが設定されるようになる
        // 外部からこのクラスを利用する場合にエラーの発生個所を特定しやすくなる
        SetType(four_char_code('U', 'R', 'S', 'P'));

        // その他の初期化処理を記述する
        ...
    }
}

例 9.5. タイプの利用

Void USRResponder::PrintType(SFYResponderSmpConstRef param) const
{
    switch (param->GetType()) {
        case SFZWindow::CODE_TYPE:
            TRACE("It is a SFZWindow class.");
            break;
        case SFZDialog::CODE_TYPE:
            TRACE("It is a SFZDialog class.");
            break;
        case SFZTextButtonControl::CODE_TYPE:
            TRACE("It is a SFZTextButtonControl class.");
            break;
        default:
            TRACE("It is an unknown class.");
            break;
    }
    return;
}

例 9.6. ID の設定

SFCError USRResponder::MakeButton(Void)
{
    SFZTextButtonControlSmp button;
    SFCError error(SFERR_NO_ERROR);

    if ((button = SFZTextButtonControl::NewInstance(&error)) != null) {
        if ((error = button->SetParent(GetThis())) == SFERR_NO_ERROR) {
            button->SetID(100);
            ...
        }
    }
    return error;
}

例 9.7. ID を用いた検索

SFZTextButtonControlSmp USRResponder::GetButton(Void) const
{
    // ID を用いて子レスポンダを取得できる
    // このようにするとクラス変数を用いて子レスポンダを
    // 管理する必要がなくなる
    return static_pointer_cast<SFZTextButtonControl>(GetChildFront(100));
}

例 9.8. ルートレスポンダと配信エンジン、描画エンジンの接続

SFCError USRApplication::MakeRoot(Void)
{
    SFYDistributer distributer;  // 配信エンジン
    SFYRenderer renderer;        // 描画エンジン
    SFZRootSmp root;             // ルート
    SFCError error(SFERR_NO_ERROR);

    // 配信エンジンを初期化する
    error = distributer.Initialize();
    if (error == SFERR_NO_ERROR) {
        // 描画エンジンを初期化し、レスポンダ空間を携帯電話の画面全体に設定する
        error = renderer.Initialize(SFXGraphics::GetDeviceRectangle());
        if (error == SFERR_NO_ERROR) {
            // ルートを生成する
            if ((root = SFZRoot::NewInstance(&error)) != null) {
                // ルートに配信エンジンを接続する
                root->SetDistributer(&distributer);
                // ルートに描画エンジンを接続する
                root->SetRenderer(&renderer);
                // ルートの実領域を携帯電話の画面全体(レスポンダ空間)に設定する
                root->SetRealBound(root->GetSuitableBound());
                // ルートの状態を「可視＋活性＋操作可能＋フォーカス」にまとめて設定する
                root->SetState(true, true, true, true);
            }
        }
    }
    return error;
}

	SFZRoot クラス
	SFZRoot はルートレスポンダとして最適化されたレスポンダなので、 ルートレスポンダとして利用するとき SFZRoot を継承して新たなルートを作成する必要はありません。

	注意
	実際のアプレット開発では、 SFYApplication クラスがルートレスポンダとしてデフォルトでルート(SFZRoot)を保持し、 配信エンジンと描画エンジンを接続しているので、 上記のコードをプログラミングする必要はありません。

例 9.9. 親レスポンダの設定

SFCError USRResponder::SetButtonParent(Void)
{
    SFZWindowSmp window;
    SFZTextButtonControlSmp button;
    SFCError error(SFERR_NO_ERROR);

    ...

    // button の親レスポンダを window に設定する
    if ((error = button->SetParent(window)) == SFERR_NO_ERROR) {

        ...
    }
    return error;
}

	Tip
	レスポンダに親レスポンダを設定するには、SFYResponder::SetParent 関数の引数に親レスポンダを指定します。 また、この操作によりこのレスポンダは親レスポンダが所属しているレスポンダツリーに接続されます。

例 9.10. 親レスポンダのクリア

SFCError USRResponder::ClearButtonParent(Void)
{
    SFZTextButtonControlSmp button;
    SFCError error(SFERR_NO_ERROR);

    ...

    // button の親レスポンダをクリアするには SFYResponderSmp::EmptyInstance() を設定する
    if ((error = button->SetParent(SFYResponderSmp::EmptyInstance())) == SFERR_NO_ERROR) {
        ...
    }
    return error;
}

	Tip
	レスポンダの親レスポンダをクリアするには、SFYResponder::SetParent 関数の引数に SFYResponderSmp::EmptyInstance() を指定します。 また、この操作によりこのレスポンダは元のレスポンダツリーから分離されます。

例 9.11. 子レスポンダの検索

SFYResponderSmp USRResponder::SearchChild(SInt32 index) const
{
    // 可視な子レスポンダの中で前面から index 番目の
    // 子レスポンダを検索する
    // この他にも数多くの検索方法を利用できる
    return GetChildForward(index, true, false, false, false);
}

例 9.12. 姉妹レスポンダの検索

SFYResponderSmp USRResponder::SearchNextSister(Void) const
{
    SFYResponderSmp parent;
    SFYResponderSmp result;

    // 自レスポンダと同じ親レスポンダを持つすべての姉妹レスポンダの中で
    // 自レスポンダの次の姉妹レスポンダを検索する
    if ((parent = GetParent()) != null) {
        if ((index = GetNthBackward(false, false, false, false)) > 0) {
            result = parent->GetChildBackward(index - 1, false, false, false, false);
        }
    }
    return result;
}

例 9.13. 最適な大きさを取得し実領域を設定

Void USRResponder::SetButtonBound(Void)
{
    SFZTextButtonControlSmp button;

    ...
    button->SetRealBound(button->GetSuitableBound().SetOrigin(10, 10));
    ...
    return;
}

例 9.14. 仮想領域のスクロール

Void USRResponder::ScrollVirtualBound(Void)
{
    // 現在の仮想領域を取得し、原点の Y 座標を 10 ピクセル移動させ設定する
    // このようにすると仮想領域は実領域に対して上に移動することになる
    SetVirtualBound(SFXRectangle(GetVirtualBound()).SubY(10));
    return;
}

例 9.15. ローカル領域を用いた描画

XANDLER_IMPLEMENT_VOIDRENDER(USRResponder, OnRenderRequest, invoker, reason, graphics)
{
    // ローカル領域全体を白色で塗り潰す
    graphics->FillRectangle(GetLocalBound(), SFXRGBColor(0xFF, 0xFF, 0xFF, 0x00));
    return;
}

例 9.16. 透過属性の設定

Void USRResponder::SetTransparent(Void)
{
    SetPropertyTransparent(true);
    return;
}

例 9.17. 状態の設定

Void USRResponder::SetState(Void)
{
    // 可視＋活性＋操作可能＋フォーカスにまとめて設定する
    SetState(true, true, true, true);

    // 可視状態を不可視に設定する
    // このときフォーカス状態は自動的に非フォーカスになる
    SetStateVisible(false);

    // 再度可視に設定すると、自動的にフォーカスされた状態に戻る
    SetStateVisible(true);

    // 下記のように明示的にフォーカスに設定する必要はない
    // SetStateFocus(true); ← このコードは不要

    return;
}

例 9.18. トレーサへの配信規則の登録

SFCError USRResponder::MakeTracer(Void)
{

    // AVK_SOFT1 から AVK_SOFT4 までのキーイベントについて
    // 『処理順序：前面から背面、配信条件：すべての状態、重複条件：なし』
    // という配信規則をトレーサに登録する
    return RegisterTracer(
        SFXEventRange(SFEVT_KEY, SFEVT_KEY, AVK_SOFT1, AVK_SOFT4),
        SFYTracer::ORDER_FORWARD, SFYTracer::STATE_ALL, false
    );
}

	Tip
	トレーサの配信規則は、RegisterTracer() 関数を利用して登録します。

例 9.19. ハンドラの登録

SFCError USRResponder::MakeHandler(Void)
{
    return RegisterHandler(
        SFXEventRange(SFEVT_KEY, SFEVT_KEY, SFP16_BEGIN, SFP16_END),
        XANDLER_INTERNAL(OnKey)
    );
}

	Tip
	ハンドラは、RegisterHandler() 関数を利用して登録します。

例 9.20. テキストボタンコントロールのラベル付け

SFZTextButtonControlSmp _button;
SInt32 i;

// 10 個のテキストボタンコントロールを作成し番号(リファレンス値)を設定する
for (i = 0; i < 10; ++i) {
    if ((_button = SFZTextButtonControl::NewInstance(&error)) != null) {
        error = _button->SetParent(GetThis());
        if (error == SFERR_NO_ERROR) {
            // テキストボタンコントロール識別用番号を設定する
            _button->SetReference(reinterpret_cast<VoidPtr>(i));
        }
    }
}

...

// テキストボタンコントロール識別用番号を取得する
SInt32 number = reinterpret_cast<SInt32>(_button->GetReference());