継承図

協調図

解説

■ 仕様と使い方

テキストを表示するボタンコントロール(SFZTextButtonControl)は、 SFYButtonControl::SetOperateKey 関数で設定する操作キーを押下後に離すと、 結果イベント [SFXEvent(SFEVT_RESPONDER_RESULT, SFP16_RESULT_OK, SFYControl::GetCurrentValue())] を受信します。

	注意
	この結果イベントは SFYButtonControl::HandleOperateKeyRelease 関数内で発生します。

文字数が多くスクロールして表示する必要がある場合には、 フォーカスされているときに自動的にスクロールを開始します。

図 436. 動作例

デフォルトの実装では、 テキストボタンコントロールは状態に応じて以下のように描画されます。

図 437. テキストボタンコントロールの拡大図[活性状態または操作可能状態]

テキストはボタンコントロール内ベベル領域の幅２ピクセル分の枠（フォーカス・フレーム）で囲まれるコンテンツ領域に描画されます。

詳細情報 : SFYButtonControl::DrawButton | SFYButtonControl::DrawShadow

図 438. テキストボタンコントロールの拡大図[非活性状態]

テキストは SFZTextButtonControl::SetTextColor 関数で設定した色を非活性状態に合わせて補正した色で描画されます。

詳細情報 : SFYButtonControl::DrawButton | SFYButtonControl::DrawShadow

図 439. テキストボタンコントロールの拡大図[フォーカス状態・非押下時]

詳細情報 : SFYButtonControl::DrawButton | SFYButtonControl::DrawShadow

図 440. テキストボタンコントロールの拡大図[フォーカス状態・押下時]

詳細情報 : SFYButtonControl::DrawButton | SFYButtonControl::DrawShadow

参照

テキストを表示するボタンコントロール [SFZTextButtonControl] | 状態 | SFYControl | SFYButtonControl | SFYSingleTextWidget

メンバ

解説

このコンストラクタは、以下の初期化処理を行います。

	注意
	SFZTextButtonControl クラスを継承するレスポンダでは、 上記イベントが発生すると、それに対応するハンドラが呼び出されます。

内部実装

このコンストラクタの内部実装は以下の通りです。

/*protected */SFZTextButtonControl::SFZTextButtonControl(Void) static_throws
{
    static SFXEventRange::AtomRecConst          trange[] = {
        { SFEVT_RESPONDER_STATE,  SFEVT_RESPONDER_STATE,    SFP16_STATE_FOCUS,    SFP16_STATE_FOCUS},
        { SFEVT_RESPONDER_STATE,  SFEVT_RESPONDER_STATE,    SFP16_STATE_PRESS,    SFP16_STATE_PRESS}
    };
    static SFXEventRange::AtomRecConst          crange[] = {
        { SFEVT_RESPONDER_STYLE,  SFEVT_RESPONDER_STYLE,          SFP16_BEGIN,            SFP16_END}
    };
    SFYHandler::RuleRec                         trule[lengthof(trange)];
    SFYHandler::RuleRec                         crule[lengthof(crange)];
    SFCError                                    error;

    if (static_try()) {
        SetType(CODE_TYPE);
        trule[0].spp = XANDLER_FUNCTION(OnStateFocus);
        trule[0].reference = this;
        trule[1].spp = XANDLER_FUNCTION(OnStatePress);
        trule[1].reference = this;
        static_throw(RegisterHandler(atomic_cast(trange), trule, lengthof(trange)));
        if (static_try()) {
            if ((_widget = SFYSingleTextWidget::NewInstance(&error)) != null) {
                crule[0].spp = XANDLER_FUNCTION(OnWidgetStyle);
                crule[0].reference = this;
                static_throw(_widget->RegisterHandler(atomic_cast(crange), crule, lengthof(crange)));
                if (static_try()) {
                    static_throw(_widget->SetParent(GetThis()));
                    if (static_try()) {
                        _widget->SetState(true, true, false, false);
                        Relocate();
                    }
                }
            }
            else {
                static_throw(error);
            }
        }
    }
}// SFZTextButtonControl::SFZTextButtonControl //

/*private */XANDLER_IMPLEMENT_VOIDSTATE(SFZTextButtonControl, OnStateFocus, invoker, reason, state)
{
    unused(invoker);
    unused(reason);
    (state) ? (_widget->StartScroll()) : (_widget->StopScroll());
    return;
}// XANDLER_IMPLEMENT_VOIDSTATE(SFZTextButtonControl, OnStateFocus) //

/*private */XANDLER_IMPLEMENT_VOIDSTATE(SFZTextButtonControl, OnStatePress, invoker, reason, state)
{
    SFXRectangle                                lx;

    unused(invoker);
    unused(reason);
    lx.Set(_widget->GetRealBound());
    (state) ? (lx.Offset(GetPressOffset())) : (lx.Unoffset(GetPressOffset()));
    _widget->SetRealBound(lx);
    return;
}// XANDLER_IMPLEMENT_VOIDSTATE(SFZTextButtonControl, OnStatePress) //

/*private */XANDLER_IMPLEMENT_VOIDSTYLE(SFZTextButtonControl, OnWidgetStyle, invoker, reason)
{
    unused(invoker);
    InvokeBackward(SFXEvent(SFEVT_RESPONDER_STYLE, reason, 0), true);
    return;
}// XANDLER_IMPLEMENT_VOIDSTYLE(SFZTextButtonControl, OnWidgetStyle) //

/*private */Void SFZTextButtonControl::Relocate(Void)
{
    SFXRectangle                                lx;

    lx.Set(GetLocalBound());
    lx.Deflate(GetShadowMargin());
    lx.Deflate(GetButtonMargin());
    if (GetStatePress()) {
        lx.Offset(GetPressOffset());
    }
    _widget->SetRealBound(lx);
    return;
}// SFZTextButtonControl::Relocate //

参照

SFYResponder::SetType | SFZTextButtonControl::CodeEnum | SFYResponder::SetParent | SFYResponder::SetState | SFZTextButtonControl::SetText | SFZTextButtonControl::SetFont | SFZTextButtonControl::SetTextColor | SFZTextButtonControl::SetHorizontalAlign | SFZTextButtonControl::SetVerticalAlign | SFZTextButtonControl::SetScrollDirection | SFZTextButtonControl::SetScrollInterval | SFZTextButtonControl::SetScrollStep | SFZTextButtonControl::SetWaitInterval | SFZTextButtonControl::HorizontalEnum | SFZTextButtonControl::VerticalEnum | SFZTextButtonControl::DirectionEnum | SFZTextButtonControl::DefaultEnum | SFYSingleTextWidget::NewInstance | SFYSingleTextWidget | SFXRGBColor | タイプ | 状態 | イベント | 状態イベント[SFEVT_RESPONDER_STATE]

解説

このデストラクタは、何も行いません。

内部実装

このデストラクタの内部実装は以下の通りです。

/*protected virtual */SFZTextButtonControl::~SFZTextButtonControl(Void)
{
}// SFZTextButtonControl::~SFZTextButtonControl //

戻り値

フォント。

解説

この関数は、フォントを取得します。

戻り値

水平アライメントの値。

解説

この関数は、水平アライメントの値を取得します。

参照

SFZTextButtonControl::SetHorizontalAlign | SFZTextButtonControl::HorizontalEnum

戻り値

スクロールの移動方向。

解説

この関数は、スクロールの移動方向を取得します。

参照

SFZTextButtonControl::SetScrollDirection

戻り値

スクロールインターバル。[単位:ミリ秒]

解説

この関数は、スクロールインターバルを取得します。[単位:ミリ秒]

参照

SFZTextButtonControl::SetScrollInterval

戻り値

スクロール移動量。[単位:ピクセル]

解説

この関数は、スクロール移動量を取得します。[単位:ピクセル]

参照

SFZTextButtonControl::SetScrollStep

戻り値

テキスト。

解説

この関数は、テキストを取得します。

参照

SFZTextButtonControl::GetText

戻り値

テキストの色。

解説

この関数は、テキストの色を取得します。

戻り値

垂直アライメントの値。

解説

この関数は、垂直アライメントの値を取得します。

参照

SFZTextButtonControl::SetVerticalAlign | SFZTextButtonControl::VerticalEnum

戻り値

スクロール開始までの待ち時間。[単位:ミリ秒]

解説

この関数は、スクロール開始までの待ち時間を取得します。[単位:ミリ秒]

参照

SFZTextButtonControl::SetWaitInterval

戻り値

ボタンテキスト描画用に子レスポンダとして内部で保持する SFYSingleTextWidget クラス。

解説

ボタンテキスト描画用に子レスポンダとして内部で保持する SFYSingleTextWidget クラスを返します。

ボタンテキストの描画は、SFYSingleTextWidget クラスに委譲して処理します。

参照

SFYSingleTextWidget

解説

この関数は、 領域イベント [SFXEvent(SFEVT_RESPONDER_BOUND, SFP16_BOUND_OPTIMIZE, rectangle)] を受信したときに呼び出されます。

引数 rectangle で指定した矩形領域に収まる範囲内で、レスポンダの最適な領域を計算します。

計算結果のレスポンダに最適なサイズは、rectangle 引数の size 要素（サイズ）に格納されます。 なお、領域イベントの P32 パラメータとして渡された rectangle 引数の origin 要素（始点）はこの関数内で変更しないことを推奨します。

デフォルトの実装は以下の通りです。

	領域イベント[(SFEVT_RESPONDER_BOUND, SFP16_BOUND_OPTIMIZE) イベント]
	SFYResponder::GetSuitableBound 関数は、 引数にヒント領域を指定した場合は 領域イベント [SFXEvent(SFEVT_RESPONDER_BOUND, SFP16_BOUND_OPTIMIZE, rectangle)] をレスポンダに送信します。 SFYWidget クラスを継承するレスポンダが領域イベントを受信すると、 SFYWidget::SFYWidget コンストラクタで最初に登録した領域イベント専用ハンドラの処理により、 SFYWidget::HandleBoundOptimize 仮想関数が呼び出されます。 ※ 領域イベントの P32 パラメータ rectangle にはヒント領域が初期設定されています。

	(SFEVT_RESPONDER_BOUND, SFP16_BOUND_OPTIMIZE) イベント受信時の最適な領域計算
	SFYWidget::HandleBoundOptimize 仮想関数をオーバーライドする以外に、 領域イベント専用ハンドラ[XANDLER_DECLARE_VOIDBOUND]を定義・実装し レスポンダに登録して行うことも可能です。 最適な領域の計算は、最初に SFYWidget::HandleBoundOptimize 仮想関数を実行し、 次に領域イベント専用ハンドラを登録した順に実行して行われます。 領域イベント専用ハンドラを宣言し登録する手間が省けるので、 通常は SFYWidget::HandleBoundOptimize 仮想関数をオーバーライドして処理を記述します。

参照: SFYSingleTextWidget::HandleBoundOptimize

内部実装

この関数の内部実装は以下の通りです。

SFYSingleTextWidgetSmp          _widget;

/*protected virtual */Void SFZTextButtonControl::HandleBoundOptimize(SFXRectanglePtr rectangle) const
{
    rectangle->Deflate(GetShadowMargin());
    rectangle->Deflate(GetButtonMargin());
    rectangle->SetSize(_widget->GetSuitableBound(*rectangle).GetSize());
    rectangle->Inflate(GetButtonMargin());
    rectangle->Inflate(GetShadowMargin());
    return;
}// SFZTextButtonControl::HandleBoundOptimize //

参照

SFYResponder::GetSuitableBound | SFYButtonControl::GetButtonMargin | SFZTextButtonControl::SetText | SFZTextButtonControl::SetFont | SFYSingleTextWidget::HandleBoundOptimize | SFYSingleTextWidget | SFXEvent | 領域イベント[SFEVT_RESPONDER_BOUND]

解説

この関数は、 領域イベント [SFXEvent(SFEVT_RESPONDER_BOUND, SFP16_BOUND_REQUEST, rectangle)] を受信したときに呼び出されます。

レスポンダの最適な領域を計算します。

計算結果のレスポンダに最適なサイズは、rectangle 引数の size 要素（サイズ）に格納されます。 なお、領域イベントの P32 パラメータとして渡された rectangle 引数の origin 要素（始点）はこの関数内で変更しないことを推奨します。

デフォルトの実装は以下の通りです。

	領域イベント[(SFEVT_RESPONDER_BOUND, SFP16_BOUND_REQUEST) イベント]
	SFYResponder::GetSuitableBound 関数は、 引数に何も指定しない場合は 領域イベント [SFXEvent(SFEVT_RESPONDER_BOUND, SFP16_BOUND_REQUEST, rectangle)] をレスポンダに送信します。 SFYWidget クラスを継承するレスポンダが領域イベントを受信すると、 SFYWidget::SFYWidget コンストラクタで最初に登録した領域イベント専用ハンドラの処理により、 SFYWidget::HandleBoundRequest 仮想関数が呼び出されます。 ※ 領域イベントの P32 パラメータ rectangle には実領域が初期設定されています。 Tip 実領域のデフォルト値は SFXRectangle(0, 0, 0, 0) です。

	(SFEVT_RESPONDER_BOUND, SFP16_BOUND_REQUEST) イベント受信時の最適な領域計算
	SFYWidget::HandleBoundRequest 仮想関数をオーバーライドする以外に、 領域イベント専用ハンドラ[XANDLER_DECLARE_VOIDBOUND]を定義・実装し レスポンダに登録して行うことも可能です。 最適な領域の計算は、最初に SFYWidget::HandleBoundRequest 仮想関数を実行し、 次に領域イベント専用ハンドラを登録した順に実行して行われます。 領域イベント専用ハンドラを宣言し登録する手間が省けるので、 通常は SFYWidget::HandleBoundRequest 仮想関数をオーバーライドして処理を記述します。

参照: SFYSingleTextWidget::HandleBoundRequest

内部実装

この関数の内部実装は以下の通りです。

SFYSingleTextWidgetSmp          _widget;

/*protected virtual */Void SFZTextButtonControl::HandleBoundRequest(SFXRectanglePtr rectangle) const
{
    rectangle->Deflate(GetShadowMargin());
    rectangle->Deflate(GetButtonMargin());
    rectangle->SetSize(_widget->GetSuitableBound().GetSize());
    rectangle->Inflate(GetButtonMargin());
    rectangle->Inflate(GetShadowMargin());
    return;
}// SFZTextButtonControl::HandleBoundRequest //

参照

SFYResponder::GetSuitableBound | SFYButtonControl::GetButtonMargin | SFZTextButtonControl::SetText | SFZTextButtonControl::SetFont | SFYSingleTextWidget::HandleBoundRequest | SFYSingleTextWidget | SFXEvent | 実領域 | 領域イベント[SFEVT_RESPONDER_BOUND]

解説

この関数は、領域イベント [SFXEvent(SFEVT_RESPONDER_BOUND, SFP16_BOUND_VIRTUAL, rectangle)] を受信したときに呼び出されます。

仮想領域の変更時に追加の処理を行いたい場合は、この関数をオーバーライドします。

デフォルトの実装は、 ボタンコントロールのコンテンツ領域を内部で保持するテキストウィジェット(SFYSingleTextWidget)の実領域として設定します。

SFZTextButtonControl::SetText 関数によって設定されたテキストは、 内部でテキストウィジェット(SFYSingleTextWidget)として保持されます。

	領域イベント[(SFEVT_RESPONDER_BOUND, SFP16_BOUND_VIRTUAL) イベント]
	SFYResponder::SetRealBound / SFYResponder::SetVirtualBound 関数は、 この関数内の処理により仮想領域が変化すると、 領域イベント [SFXEvent(SFEVT_RESPONDER_BOUND, SFP16_BOUND_VIRTUAL, rectangle)] をレスポンダに送信します。 SFYWidget クラスを継承するレスポンダが領域イベントを受信すると、 SFYWidget::SFYWidget コンストラクタで最初に登録した領域イベント専用ハンドラの処理により、 SFYWidget::HandleBoundVirtual 仮想関数が呼び出されます。 ※ 領域イベントの P32 パラメータ rectangle には変更後の仮想領域が設定されています。

	仮想領域の変更処理
	SFYWidget::HandleBoundVirtual 仮想関数をオーバーライドする以外に、 領域イベント専用ハンドラ[XANDLER_DECLARE_VOIDBOUND]を定義・実装し レスポンダに登録して行うことも可能です。 仮想領域の変更処理は、最初に SFYWidget::HandleBoundVirtual 仮想関数を実行し、 次に領域イベント専用ハンドラを登録した順に実行して行われます。 領域イベント専用ハンドラを宣言し登録する手間が省けるので、 通常は SFYWidget::HandleBoundVirtual 仮想関数をオーバーライドして処理を記述します。

内部実装

この関数の内部実装は以下の通りです。

SFYSingleTextWidgetSmp          _widget;

/*protected virtual */Void SFZTextButtonControl::HandleBoundVirtual(Void)
{
    Relocate();
    return;
}// SFZTextButtonControl::HandleBoundVirtual //

/*private */Void SFZTextButtonControl::Relocate(Void)
{
    SFXRectangle                                lx;

    lx.Set(GetLocalBound());
    lx.Deflate(GetShadowMargin());
    lx.Deflate(GetButtonMargin());
    if (GetStatePress()) {
        lx.Offset(GetPressOffset());
    }
    _widget->SetRealBound(lx);
    return;
}// SFZTextButtonControl::Relocate //

参照

SFYSingleTextWidget | SFZTextButtonControl::SetText | SFYResponder::SetRealBound | SFYResponder::SetVirtualBound | SFYSingleTextWidget | SFXEvent | 領域イベント[SFEVT_RESPONDER_BOUND]

解説

この関数は、SFYButtonControl::SetOperateKey 関数で設定した操作キーの SFEVT_KEY イベント （キーイベント[SFEVT_KEY]）を受信したときに呼び出されます。

独自のキーイベント処理を行いたい場合は、この関数をオーバーライドします。

デフォルトの実装は、テキストのスクロール位置を初期化します。

内部実装

この関数の内部実装は以下の通りです。

SFYSingleTextWidgetSmp          _widget;

/*protected virtual */Void SFZTextButtonControl::HandleOperateKey(Void)
{
    _widget->StopScroll();
    _widget->StartScroll();
    return;
}// SFZTextButtonControl::HandleOperateKey //

参照

SFYButtonControl::SetOperateKey | SFYSingleTextWidget | SFXEvent | キーイベント[SFEVT_KEY]

解説

この関数は、 描画イベント [SFXEvent(SFEVT_RESPONDER_RENDER, SFP16_RENDER_REQUEST, graphics)] を受信したときに呼び出されます。

独自の描画処理を行いたい場合は、この関数をオーバーライドします。

デフォルトの実装では、 状態に応じて以下のようにテキストボタンコントロールを描画します。

■テキストボタンコントロールの描画処理

図 441. テキストボタンコントロールの拡大図[活性状態または操作可能状態]

テキストはボタンコントロール内ベベル領域の幅２ピクセル分の枠（フォーカス・フレーム）で囲まれるコンテンツ領域に描画されます。

詳細情報 : SFYButtonControl::DrawButton | SFYButtonControl::DrawShadow

図 442. テキストボタンコントロールの拡大図[非活性状態]

テキストは SFZTextButtonControl::SetTextColor 関数で設定した色を非活性状態に合わせて補正した色で描画されます。

詳細情報 : SFYButtonControl::DrawButton | SFYButtonControl::DrawShadow

図 443. テキストボタンコントロールの拡大図[フォーカス状態・非押下時]

詳細情報 : SFYButtonControl::DrawButton | SFYButtonControl::DrawShadow

図 444. テキストボタンコントロールの拡大図[フォーカス状態・押下時]

詳細情報 : SFYButtonControl::DrawButton | SFYButtonControl::DrawShadow

レスポンダの描画手順

SFYResponder::Invalidate 関数を使用して再描画領域を登録します。 イベントループの最後、 アプリ開始/レジュームまたは優先的イベントハンドラ終了のタイミング、 あるいは、コールバックなどのイベントループの外で、 自動的に、あるいは、明示的に SFYResponder::Render 関数を呼び出します。 描画エンジンが起動されます。 再描画が必要なレスポンダだけが描画イベントを受信します。 SFYWidget クラスを継承するレスポンダが描画イベントを受信すると、 SFYWidget::SFYWidget コンストラクタで最初に登録した描画ハンドラの処理により、 SFYWidget::HandleRenderRequest 仮想関数が呼び出されます。 その後、描画ハンドラが登録した順に呼び出されます。 実際にレスポンダが描画されます。 Tip 描画ハンドラの宣言と登録の手間を省けるので、 通常は SFYWidget::HandleRenderRequest 仮想関数だけを利用してレスポンダを描画します。

内部実装

この関数の内部実装は以下の通りです。

/*protected virtual */Void SFZTextButtonControl::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    DrawButton(graphics, DrawShadow(graphics, GetLocalBound()));
    return;
}// SFZTextButtonControl::HandleRenderRequest //

参照

SFYButtonControl::DrawButton | SFYButtonControl::DrawShadow | SFZTextButtonControl::SetText | SFZTextButtonControl::SetHorizontalAlign | SFZTextButtonControl::SetVerticalAlign | SFZTextButtonControl::SetTextColor | SFZTextButtonControl::SetFont | SFYButtonControl::SetButtonColor | SFYButtonControl::SetFocusColor | SFYButtonControl::SetShadowColor | SFYButtonControl::SetOperateKey | SFZTextButtonControl::SetScrollDirection | SFZTextButtonControl::SetScrollInterval | SFZTextButtonControl::SetScrollStep | SFYSingleTextWidget::HandleRenderRequest | SFYResponder::Invalidate | SFYResponder::Render | SFYResponder::InvokeBackward | SFYSingleTextWidget | SFXEvent | 描画イベント[SFEVT_RESPONDER_RENDER] | 描画イベント専用ハンドラ[XANDLER_DECLARE_VOIDRENDER] | 描画処理 | 状態

引数

戻り値

解説

この関数は、SFZTextButtonControl クラスの新しいインスタンスを作成します。

インスタンスの作成に成功した場合は null 以外のポインタを返します。 失敗した場合は、null ポインタを返します。

exception 引数を指定した場合、 この引数にはエラー値が返ります。

使用例

以下は、テキストボタンのインスタンスを生成するためのコードです。

// テキストボタンのインスタンスを生成する
SFZTextButtonControlSmp _textbutton;
SFCError error;

if ((_textbutton = SFZTextButtonControl::NewInstance(&error)) != null) {
    // ...
}

解説

この関数は、フォントを設定します。

デフォルト値: AEE_FONT_NORMAL

解説

この関数は、水平アライメントを設定します。

デフォルト値: SFYSingleTextWidget::DEFAULT_HORIZONTAL

SFYSingleTextWidget::DEFAULT_HORIZONTAL の値は SFYSingleTextWidget::HorizontalEnum を参照してください。

参照

SFZTextButtonControl::GetHorizontalAlign | SFZTextButtonControl::HorizontalEnum | SFYSingleTextWidget::HorizontalEnum

解説

この関数は、スクロール移動方向を設定します。

デフォルト値: SFYSingleTextWidget::DEFAULT_DIRECTION

SFYSingleTextWidget::DEFAULT_DIRECTION の値は SFYSingleTextWidget::DirectionEnum を参照してください。

参照

SFZTextButtonControl::GetScrollDirection | SFZTextButtonControl::DirectionEnum | SFYSingleTextWidget::DirectionEnum

解説

この関数は、スクロールインターバルを設定します。[単位:ミリ秒]

デフォルト値 SFYSingleTextWidget::DEFAULT_SCROLL ミリ秒

SFYSingleTextWidget::DEFAULT_SCROLL の値は SFYSingleTextWidget::DefaultEnum を参照してください。

参照

SFZTextButtonControl::GetScrollInterval | SFZTextButtonControl::DefaultEnum | SFYSingleTextWidget::DefaultEnum

解説

この関数は、1 回のスクロールで移動するピクセル数を設定します。

−1（デフォルト値）を設定すると、使用しているフォントの半角空白文字 1 文字分（" "）の幅がスクロール移動量となります。

デフォルト値: SFYSingleTextWidget::DEFAULT_STEP [単位:ピクセル]

SFYSingleTextWidget::DEFAULT_STEP の値は SFYSingleTextWidget::DefaultEnum を参照してください。

参照

SFZTextButtonControl::GetScrollStep | SFZTextButtonControl::DefaultEnum | SFYSingleTextWidget::DefaultEnum

戻り値

解説

この関数は、テキストを設定します。

テキストを直接、あるいは、リソースファイルから読み込むように指定します。

デフォルト値: ""[空文字列]

参照

SFZTextButtonControl::GetText | SFZTextButtonControl::SetTextColor | SFZTextButtonControl::SetScrollDirection | SFZTextButtonControl::SetScrollInterval | SFZTextButtonControl::SetScrollStep | SFZTextButtonControl::StartScroll | SFZTextButtonControl::StopScroll | SFZTextButtonControl::SetWaitInterval | SFZTextButtonControl::SetHorizontalAlign | SFZTextButtonControl::SetVerticalAlign

解説

この関数は、テキストの色を設定します。

デフォルト値: SFXRGBColor(0x00, 0x00, 0x00, 0x00)[黒色]

非活性状態にあるときは、この関数で設定された色の明度が 0x7F より大きい場合はこの色の RGB 値からそれぞれ 0x44 を減算した色、 0x7F 以下の場合はこの色の RGB 値にそれぞれ 0x44 を加算した色でテキストは描画されます。

色の明度とは、SFXRGBColor::GetBrightness 関数によって得られる値です。

参照

SFZTextButtonControl::GetTextColor | SFXRGBColor::GetBrightness | SFXRGBColor | 状態

解説

この関数は、垂直アライメントを設定します。

デフォルト値: SFYSingleTextWidget::DEFAULT_VERTICAL

SFYSingleTextWidget::DEFAULT_VERTICAL の値は SFYSingleTextWidget::VerticalEnum を参照してください。

参照

SFZTextButtonControl::GetVerticalAlign | SFZTextButtonControl::VerticalEnum | SFYSingleTextWidget::VerticalEnum

解説

この関数は、スクロール開始までの待ち時間を設定します。[単位:ミリ秒]

デフォルト値: SFYSingleTextWidget::DEFAULT_WAIT ミリ秒

SFYSingleTextWidget::DEFAULT_WAIT の値は SFYSingleTextWidget::DefaultEnum を参照してください。

参照

SFZTextButtonControl::GetWaitInterval | SFZTextButtonControl::DefaultEnum | SFYSingleTextWidget::DefaultEnum

解説

この関数は、テキストのスクロールを開始します。

仮想領域の幅がテキストの幅よりも大きいときは何もしません。

SFEVT_APP_SUSPEND イベントと SFEVT_APP_RESUME イベントに自動的に応答しますが、 SFEVT_APP_SUSPEND イベントの受信後から SFEVT_APP_RESUME イベントの受信までの間にこの関数を呼び出したときの動作は未定です。

解説

この関数は、テキストのスクロールを停止します。

参照

SFYResponder::GetType | SFYResponder::SetType

参照

SFYSingleTextWidget::HorizontalEnum

参照

SFYSingleTextWidget::VerticalEnum