継承図

協調図

解説

■ 仕様と使い方

タイトル付きベベルフレームとは、 影領域とフラットフレーム領域とベベルフレーム領域[SFXMargin(2, 2, 3, 3)]に、 タイトルを表示するためのヘッダー領域を加えた領域を枠領域とするフレームです。

	枠領域の取得方法
	フレームの枠領域は、SFYResponder::GetSuitableMargin 関数を呼び出すことで取得できます。

図 445. タイトル付きベベルフレーム動作例[SFZTitleBevelFrame]

タイトル付きベベルフレームの枠領域は、 影領域とフラットフレーム領域とベベルフレーム領域[SFXMargin(2, 2, 3, 3)]に、 タイトルを表示するためのヘッダー領域を加えたマージン領域です。

図 446. タイトル付きベベルフレーム拡大図[SFZTitleBevelFrame]

黒色の線が影領域、青色（デフォルトは黒色）の線がフラットフレーム領域、白と灰色の線がベベルフレーム領域、 中央に文字列 "Title" が描画されている灰色系のベベルカラー矩形領域がヘッダー領域です。 この４つの領域の和集合がタイトル付きベベルフレームの枠領域です。そして、枠領域で囲まれた矩形領域はコンテンツ領域です。

ヘッダー領域の高さ(HeaderHeight)は

HeaderHeight = FontHeight + 2 * BevelFrameWidth + 2 * FrameMarginSize

FontHeight      : 使用しているフォントの高さ
BevelFrameWidth : ベベル枠の幅（１ピクセル）
FrameMarginSize : SetFrameSize 関数で設定するヘッダー領域のマージン（デフォルトは 1 ピクセル）

です。

ヘッダー領域の横幅(HeaderWidth)は

HeaderWidth = SFZTitleBevelFrameWidth - FlatFrameWidth - ShadowWidth

SFZTitleBevelFrameWidth : SFZTitleBevelFrame に設定されたローカル領域の幅
FlatFrameWidth          : フラットフレーム領域の幅（１ピクセル）
ShadowWidth             : 影領域の幅（１ピクセル）

です。

ヘッダー領域の背景は、 SFZTitleBevelFrame::SetHeaderColor 関数で設定したベベルカラー(SFXBevelColor)で塗り潰されます。

ヘッダーフレーム領域の上辺はヘッダー領域の直下に配置されます。

影領域、フラットフレーム領域、ベベルフレーム領域の幅は、それぞれ１ピクセルです。

1. 影領域は SFYPlainFrame::DrawShadow 関数が描画します（影領域の色は SFYPlainFrame::SetShadowColor 関数で設定）。
2. フラットフレーム領域は SFYFlatFrame::DrawFrame 関数が描画します（フラットフレーム領域の色は SFYFlatFrame::SetFrameColor / SFYFlatFrame::SetFocusColor 関数で設定）。
3. ヘッダー領域は SFZTitleBevelFrame::DrawHeader 関数が描画します（ヘッダー領域の色は SFZTitleBevelFrame::SetHeaderColor 関数で設定）。
4. ベベルフレーム領域は SFYBevelFrame::DrawBevel 関数が描画します（ベベルフレーム領域の色は SFYBevelFrame::SetBevelColor 関数で設定）。

	タイトル枠付きのレスポンダ
	タイトル付きベベルフレームをウィンドウやダイアログに装着することで、枠付きウィンドウや枠付きダイアログを実現することが可能になります。 装着はウィンドウやダイアログの SFYResponder::SetFrame 関数を呼び出すことによって行います。 ウィンドウやダイアログの実領域はタイトル付きベベルフレームの枠(マージン領域)で囲まれるコンテンツ領域となります。

// クラスの定義
SFMTYPEDEFCLASS(USRApplication)
class USRApplication : public SFYApplication {
  SFMSEALCOPY(USRApplication)
public:
  static SFCInvokerPtr Factory(Void);
private:
  explicit USRApplication(Void) static_throws;
  virtual ~USRApplication(Void);

  XANDLER_DECLARE_VOIDRENDER(OnRenderRequestSFZWindow) // ウィンドウの描画ハンドラ
  XANDLER_DECLARE_BOOLEVENT(OnKeySFZWindow)            // ウィンドウのキーハンドラ
};


// コンストラクタ
USRApplication::USRApplication(Void) static_throws
{
　// ... (省略) ...

  SFZTitleBevelFrameSmp frame;  // SFZTitleBevelFrame のスマートポインタ
  SFZWindowSmp          window; // SFZWindow のスマートポインタ
  SFCError              error(SFERR_NO_ERROR);

  // フレームを生成する
  if ((frame = SFZTitleBevelFrame::NewInstance(&error)) != null) {

    // フレームのタイトルを設定する
    frame->SetText("Title for SFZWindow");

    // 通常、フレームの状態は「可視+活性+操作可能+フォーカス」に設定する
    frame->SetState(true, true, true, true);

    // ウィンドウを生成する
    if ((window = SFZWindow::NewInstance(&error)) != null) {

      // ウィンドウの描画ハンドラを登録する : 文字列 "Hello World!" を描画する
      error = window->RegisterHandler(
        SFXEventRange(SFEVT_RESPONDER_RENDER, SFEVT_RESPONDER_RENDER, SFP16_RENDER_REQUEST, SFP16_RENDER_REQUEST),
        XANDLER_INTERNAL(OnRenderRequestSFZWindow)
      );
      if (error == SFERR_NO_ERROR) {

        // ウィンドウのキーハンドラを登録する : セレクトキーが押下されるとフレームを閉じる
        error = window->RegisterHandler(
          SFXEventRange(SFEVT_KEY, SFEVT_KEY, SFP16_BEGIN, SFP16_END),
          XANDLER_INTERNAL(OnKeySFZWindow)
        );
        if (error == SFERR_NO_ERROR) {

          // ウィンドウの親をアプリケーションクラス（ルート）に設定する
          error = window->SetParent(GetThis());
          if (error == SFERR_NO_ERROR) {

            // ウィンドウにフレームを装着する
            error = window->SetFrame(frame);
            if (error == SFERR_NO_ERROR) {

              // フレームの実領域をルートのローカル領域から (30, 30) だけ縮小した領域に設定する
              // ※自動的にフレームの実領域をフレーム余白領域だけ縮小した領域がウィンドウの実領域に設定される
              frame->SetRealBound(GetLocalBound().Deflate(30, 30));

              // ウィンドウの状態を「可視+活性+操作可能+フォーカス」にまとめて設定する
              window->SetState(true, true, true, true);

              // ウィンドウを最前面に移動する
              // ※自動的にフレームも最前面に移動する
              window->ToFront();
            }
          }
        }
      }
    }
  }
  static_throw(error);
}


// SFZWindow の描画ハンドラの実装
#define TROPICALBLUE_COLOR (SFXRGBColor(0xCE, 0xD8, 0xF8, 0x00))
#define COLOR_BLACK        (SFXRGBColor(0x00, 0x00, 0x00, 0x00))
XANDLER_IMPLEMENT_VOIDRENDER(helloworld, OnRenderRequestSFZWindow, invoker, reason, graphics)
{
  unused(invoker);
  unused(reason);

  // ウィンドウのローカル領域をトロピカルブルーで描画する
  graphics->FillRectangle(GetLocalBound(), TROPICALBLUE_COLOR);

  // ウィンドウの中央に文字列 "Hello World!" を黒色で描画する
  graphics->DrawSingleText("Hello World!", invoker->GetLocalBound(), COLOR_BLACK);

  return;
}

// SFZWindow のキーハンドラの実装
XANDLER_IMPLEMENT_BOOLEVENT(helloworld, OnKeySFZWindow, invoker, event)
{
  Bool result(false);
  unused(invoker);

  switch (event.GetP16()) {

    case AVK_SELECT:  // セレクトキーのキーイベントを受信したとき

         // ウィンドウだけを閉じる
         // ※自動的にフレームはウィンドウから切り離されて見えなくなる
         invoker->Terminate();

         result = true;  // イベントを処理したので true をセットする

         break;
  }

  return result;
}

図 447. サンプルコードの実行結果 : ウィンドウにフレームを付ける[SFZTitleBevelFrame と SFZWindow]

参照

SFZBevelFrame | SFYBevelFrame | SFYFlatFrame | SFYPlainFrame | SFYFrame | SFXMargin | 実領域 | SFYSingleTextWidget | SFYResponder::GetSuitableMargin | フレーム | SFYResponder::ToFront | SFYResponder::Terminate

メンバ

解説

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

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

内部実装

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

/*protected */SFZTitleBevelFrame::SFZTitleBevelFrame(Void) static_throws
{
    static SFXBevelColor::AtomRecConst          bevel[] = {
        {{{{0x00, 0xEE, 0xEE, 0xEE}}}, {{{0x00, 0xDD, 0xDD, 0xDD}}}, {{{0x00, 0x88, 0x88, 0x88}}}}
    };
    static SFXEventRange::AtomRecConst          trange[] = {
        { SFEVT_RESPONDER_STATE,  SFEVT_RESPONDER_STATE,    SFP16_STATE_FOCUS,    SFP16_STATE_FOCUS}
    };
    static SFXEventRange::AtomRecConst          urange[] = {
        { SFEVT_RESPONDER_STYLE,  SFEVT_RESPONDER_STYLE,    SFP16_STYLE_ALIGN,    SFP16_STYLE_ALIGN}
    };
    static SFXEventRange::AtomRecConst          crange[] = {
        { SFEVT_RESPONDER_STYLE,  SFEVT_RESPONDER_STYLE,          SFP16_BEGIN,            SFP16_END}
    };
    SFYHandler::RuleRec                         trule[lengthof(trange)];
    SFYHandler::RuleRec                         urule[lengthof(urange)];
    SFYHandler::RuleRec                         crule[lengthof(crange)];
    SFCError                                    error;

    if (static_try()) {
        SetType(CODE_TYPE);
        trule[0].spp = XANDLER_FUNCTION(OnStateFocus);
        trule[0].reference = this;
        static_throw(RegisterHandler(atomic_cast(trange), trule, lengthof(trange)));
        if (static_try()) {
            urule[0].spp = XANDLER_FUNCTION(OnStyleAlign);
            urule[0].reference = this;
            static_throw(RegisterHandler(atomic_cast(urange), urule, lengthof(urange)));
            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);
                            _frame = DEFAULT_FRAME;
                            _color.header.Set(bevel[0]);
                            Relocate();
                        }
                    }
                }
                else {
                    static_throw(error);
                }
            }
        }
    }
}// SFZTitleBevelFrame::SFZTitleBevelFrame //

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

/*private */XANDLER_IMPLEMENT_VOIDSTYLE(SFZTitleBevelFrame, OnStyleAlign, invoker, reason)
{
    unused(invoker);
    unused(reason);
    Relocate();
    return;
}// XANDLER_IMPLEMENT_VOIDSTYLE(SFZTitleBevelFrame, OnStyleAlign) //

/*private */XANDLER_IMPLEMENT_VOIDSTYLE(SFZTitleBevelFrame, OnWidgetStyle, invoker, reason)
{
    unused(invoker);
    switch (reason) {
        case SFP16_STYLE_FONT:
            Relocate();
            break;
        default:
            break;
    }
    InvokeBackward(SFXEvent(SFEVT_RESPONDER_STYLE, reason, 0), true);
    return;
}// XANDLER_IMPLEMENT_VOIDSTYLE(SFZTitleBevelFrame, OnWidgetStyle) //

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

    lx.Set(GetLocalBound());
    lx.Deflate(GetShadowMargin());
    lx.Deflate(GetFrameMargin());
    lx.Deflate(GetBevelMargin());
    lx.Deflate(_frame, _frame);
    lx.SetHeight(_widget->GetFontSize().GetHeight());
    _bound.Set(lx);
    _bound.Inflate(_frame, _frame);
    _bound.Inflate(GetBevelMargin());
    _widget->SetRealBound(lx);
    return;
}// SFZTitleBevelFrame::Relocate //

参照

SFYResponder::SetType | SFZTitleBevelFrame::CodeEnum | SFZTitleBevelFrame::SetFrameSize | SFZTitleBevelFrame::SetHeaderColor | SFZTitleBevelFrame::GetWidget | SFYResponder::SetState | SFZTitleBevelFrame::SetText | SFZTitleBevelFrame::SetTextColor | SFZTitleBevelFrame::SetFont | SFZTitleBevelFrame::SetHorizontalAlign | SFZTitleBevelFrame::SetScrollDirection | SFZTitleBevelFrame::SetScrollInterval | SFZTitleBevelFrame::SetScrollStep | SFZTitleBevelFrame::SetTextColor | SFZTitleBevelFrame::SetVerticalAlign | SFZTitleBevelFrame::SetWaitInterval | SFYSingleTextWidget::NewInstance | SFYSingleTextWidget::DirectionEnum | SFYSingleTextWidget::DefaultEnum | SFYSingleTextWidget | SFXBevelColor | SFXRGBColor | タイプ | 状態 | イベント | 状態イベント[SFEVT_RESPONDER_STATE]

解説

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

内部実装

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

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

解説

この関数は、タイトル付きベベルフレームのヘッダーを設定された色で塗り潰します。

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

	注意
	非活性状態の場合は、ベベルカラーのライトカラーとダークカラーはベースカラーに変更されて描画されます。

内部実装

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

/*protected */Void SFZTitleBevelFrame::DrawHeader(SFXGraphicsPtr graphics, SFXRectangleConstRef rectangle) const
{
    SFXBevelColor                               bevel;

    bevel.Set(_color.header);
    if (!GetStateActive(true)) {
        bevel.SetLight(bevel.GetBase());
        bevel.SetDark(bevel.GetBase());
    }
    graphics->FillBevelRectangle(rectangle, bevel);
    return;
}// SFZTitleBevelFrame::DrawHeader //

参照

SFZTitleBevelFrame::SetHeaderColor | SFXBevelColor | SFXRGBColor | SFXRectangle | 状態

参照

SFZTitleBevelFrame::SetFont | BREW API AEEFont

戻り値

ヘッダー領域の枠とタイトル文字表示領域間の余白。[単位：ピクセル]

解説

この関数は、ヘッダー領域の枠とタイトル文字表示領域間の余白を取得します。[単位：ピクセル]

参照

SFZTitleBevelFrame::SetFrameSize

戻り値

タイトル付きベベルフレームのヘッダー領域。

解説

この関数は、 タイトル付きベベルフレームのタイトルを表示するためのヘッダー領域を取得します。

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

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

ヘッダー領域の幅は、タイトル付きベベルフレームから影領域とフラットフレーム領域を取り除いた矩形領域の幅になります。

ヘッダー領域の高さは、SFZTitleBevelFrame::SetFrameSize 関数で設定する値の２倍に、 使用するフォントの高さとヘッダー領域ベベル枠の幅２ピクセルを加えた値になります。

この関数は、SFZTitleBevelFrame::HandleMarginRequest 関数の中でヘッダー領域を計算するときに呼び出されます。

図 448. タイトル付きベベルフレーム拡大図[SFZTitleBevelFrame]

参照

SFZTitleBevelFrame::HandleMarginRequest | SFZTitleBevelFrame::SetFrameSize

戻り値

タイトル付きベベルフレームに設定された色(SFXBevelColor)。

解説

この関数は、タイトル付きベベルフレームに設定された色を取得します。

参照

SFZTitleBevelFrame::SetHeaderColor | SFXBevelColor | SFXRGBColor

戻り値

タイトルの水平アライメントの値。

解説

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

参照

SFZTitleBevelFrame::SetHorizontalAlign | SFZTitleBevelFrame::HorizontalEnum

戻り値

タイトルのスクロール移動方向

解説

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

参照

SFZTitleBevelFrame::SetScrollDirection

戻り値

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

解説

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

参照

SFZTitleBevelFrame::SetScrollInterval

戻り値

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

解説

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

参照

SFZTitleBevelFrame::SetScrollStep

戻り値

タイトル。

解説

この関数は、タイトルを取得します。

参照

SFZTitleBevelFrame::SetText

戻り値

タイトルの色。

解説

この関数は、タイトルの色を取得します。

参照

SFZTitleBevelFrame::SetTextColor | SFXRGBColor

戻り値

タイトルの垂直アライメントの値。

解説

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

参照

SFZTitleBevelFrame::SetVerticalAlign | SFZTitleBevelFrame::VerticalEnum

戻り値

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

解説

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

参照

SFZTitleBevelFrame::SetWaitInterval

戻り値

タイトル描画用に子レスポンダとして内部で保持する SFYSingleTextWidget インスタンス。

解説

この関数は、 タイトル描画用に子レスポンダとして内部で保持する SFYSingleTextWidget インスタンスを取得します。

タイトルの描画は、SFYSingleTextWidget インスタンスに委譲して処理します。

参照

SFYSingleTextWidget

解説

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

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

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

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

タイトル表示領域は、 SFZTitleBevelFrame::GetHeaderBound 関数で取得できるヘッダー領域から SFZTitleBevelFrame::SetFrameSize 関数で設定するヘッダー領域のマージンを取り除いた領域です。

	領域イベント[(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 仮想関数をオーバーライドして処理を記述します。

内部実装

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

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

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

    lx.Set(GetLocalBound());
    lx.Deflate(GetShadowMargin());
    lx.Deflate(GetFrameMargin());
    lx.Deflate(GetBevelMargin());
    lx.Deflate(_frame, _frame);
    lx.SetHeight(_widget->GetFontSize().GetHeight());
    _bound.Set(lx);
    _bound.Inflate(_frame, _frame);
    _bound.Inflate(GetBevelMargin());
    _widget->SetRealBound(lx);
    return;
}// SFZTitleBevelFrame::Relocate //

参照

SFYSingleTextWidget | SFZTitleBevelFrame::SetText | SFZTitleBevelFrame::GetHeaderBound | SFZTitleBevelFrame::SetFrameSize | SFYResponder::SetRealBound | SFYResponder::SetVirtualBound | 領域イベント[SFEVT_RESPONDER_BOUND]

解説

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

フレーム余白領域を計算する場合は、この関数をオーバーライドします。

なお、この枠領域は、SFZTitleBevelFrame::HandleRenderRequest 関数によって描画されます。

デフォルトの実装は、影領域、フラットフレーム領域、ベベルフレーム領域、ヘッダー領域から構成されるマージン領域を計算します。

影領域、フラットフレーム領域、ベベルフレーム領域、ヘッダー領域は、それぞれ SFYPlainFrame::GetShadowMargin 関数、 SFYFlatFrame::GetFrameMargin 関数、 SFYBevelFrame::GetBevelMargin 関数、 SFZTitleBevelFrame::GetHeaderBound 関数を呼び出すことで取得できます。

図 449. タイトル付きベベルフレーム[SFZTitleBevelFrame]

図 450. タイトル付きベベルフレーム拡大図[SFZTitleBevelFrame]

ヘッダー領域の高さ HeaderHeight は

HeaderHeight = FontHeight + 2 * BevelFrameWidth + 2 * FrameMarginSize

FontHeight      : 使用しているフォントの高さ
BevelFrameWidth : ベベル枠の幅（１ピクセル）
FrameMarginSize : SetFrameSize 関数で設定するヘッダー領域のマージン（デフォルトは 1 ピクセル）

です。

ヘッダー領域の横幅は HeaderWidth は

HeaderWidth = SFZTitleBevelFrameWidth - FlatFrameWidth - ShadowWidth

SFZTitleBevelFrameWidth : SFZTitleBevelFrame に設定されたローカル領域の幅
FlatFrameWidth          : フラットフレーム領域の幅（１ピクセル）
ShadowWidth             : 影領域の幅（１ピクセル）

です。

ヘッダー領域の背景は、 SFZTitleBevelFrame::SetHeaderColor 関数で設定したベベルカラー(SFXBevelColor)で塗り潰されます。

ベベルフレーム領域の上辺はヘッダー領域の直下に配置されます。

影領域、フラットフレーム領域、ベベルフレーム領域の幅は、それぞれ１ピクセルです。

	余白イベント[(SFEVT_RESPONDER_MARGIN, SFP16_MARGIN_REQUEST) イベント]
	SFYResponder::GetSuitableMargin 関数は、 余白イベント [SFXEvent(SFEVT_RESPONDER_MARGIN, SFP16_MARGIN_REQUEST, margin)] をレスポンダに送信します。 SFYFrame クラスを継承するレスポンダが余白イベントを受信すると、 SFYFrame::SFYFrame コンストラクタで最初に登録した余白イベント専用ハンドラの処理により、 SFYFrame::HandleMarginRequest 仮想関数が呼び出されます。 ※ 余白イベントの P32 パラメータ margin には SFXMargin::ZeroInstance() が初期設定されています。

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

内部実装

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

/*protected virtual */Void SFZTitleBevelFrame::HandleMarginRequest(SFXMarginPtr margin) const
{
    margin->Add(GetShadowMargin());
    margin->Add(GetFrameMargin());
    margin->AddTop(_bound.GetHeight());
    margin->Add(GetBevelMargin());
    return;
}// SFZTitleBevelFrame::HandleMarginRequest //

参照

SFYResponder::GetSuitableMargin | SFYPlainFrame::GetShadowMargin | SFYFlatFrame::GetFrameMargin | SFYBevelFrame::GetBevelMargin | SFZTitleBevelFrame::GetHeaderBound | SFZTitleBevelFrame::HandleRenderRequest | SFXMargin | 余白イベント[SFEVT_RESPONDER_MARGIN]

解説

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

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

デフォルトの実装は、タイトル付きベベルフレームを描画します。

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

図 451. タイトル付きベベルフレーム[SFZBevelFrame]

タイトル付きベベルフレームの枠領域は、 影領域とフラットフレーム領域フレームとベベルフレーム領域[SFXMargin(2, 2, 3, 3)]に、 タイトルを表示するためのヘッダー領域を加えたマージン領域です。

図 452. タイトル付きベベルフレーム拡大図[SFZTitleBevelFrame]

黒色の線が影領域、青色（デフォルトは黒色）の線がフラットフレーム領域、白と灰色の線がベベルフレーム領域、 中央に文字列 "Title" が描画されているベベルカラーの矩形領域がヘッダー領域です。 この４つの領域の和集合がタイトル付きベベルフレームの枠領域です。そして、枠領域で囲まれた矩形領域はコンテンツ領域です。

影領域、フラットフレーム領域、ベベルフレーム領域の幅は、それぞれ１ピクセルです。

1. 影領域は SFYPlainFrame::DrawShadow 関数が描画します（影領域の色は SFYPlainFrame::SetShadowColor 関数で設定）。
2. フラットフレーム領域は SFYFlatFrame::DrawFrame 関数が描画します（フラットフレーム領域の色は SFYFlatFrame::SetFrameColor / SFYFlatFrame::SetFocusColor 関数で設定）。
3. ヘッダー領域は SFZTitleBevelFrame::DrawHeader 関数が描画します（ヘッダー領域の色は SFZTitleBevelFrame::SetHeaderColor 関数で設定）。
4. ベベルフレーム領域は SFYBevelFrame::DrawBevel 関数が描画します（ベベルフレーム領域の色は SFYBevelFrame::SetBevelColor 関数で設定）。

レスポンダの描画手順

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

内部実装

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

/*protected virtual */Void SFZTitleBevelFrame::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    SFXRectangle                                lx;

    lx.Set(DrawFrame(graphics, DrawShadow(graphics, GetLocalBound())));
    DrawHeader(graphics, _bound);
    lx.AddTop(_bound.GetHeight());
    DrawBevel(graphics, lx);
    return;
}// SFZTitleBevelFrame::HandleRenderRequest //

参照

SFYPlainFrame::DrawShadow | SFYPlainFrame::SetShadowColor | SFYFlatFrame::DrawFrame | SFYFlatFrame::SetFrameColor | SFYFlatFrame::SetFocusColor | SFZTitleBevelFrame::DrawHeader | SFZTitleBevelFrame::SetHeaderColor | SFZTitleBevelFrame::SetText | SFZTitleBevelFrame::SetHorizontalAlign | SFZTitleBevelFrame::SetVerticalAlign | SFZTitleBevelFrame::SetFont | SFZTitleBevelFrame::SetTextColor | SFYBevelFrame::DrawBevel | SFYBevelFrame::SetBevelColor | SFXBevelColor | SFYSingleTextWidget | SFYSingleTextWidget::HandleRenderRequest | SFYResponder::Invalidate | SFYResponder::Render | SFYResponder::InvokeBackward | 描画イベント[SFEVT_RESPONDER_RENDER] | 描画イベント専用ハンドラ[XANDLER_DECLARE_VOIDRENDER] | 描画処理

引数

戻り値

解説

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

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

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

使用例

以下は、タイトルベベルフレームのインスタンスを生成するためのコードです。

SFZTitleBevelFrameSmp _titlebevelframe;
SFCError error;

if ((_titlebevelflame = SFZTitleBevelFrame::NewInstance(&error)) != null) {
    // ...
}

解説

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

デフォルト値: AEE_FONT_NORMAL

参照

SFZTitleBevelFrame::GetFont | BREW API AEEFont

解説

ヘッダー領域の枠とタイトル文字表示領域間の余白を設定します。[単位：ピクセル]

タイトル付きベベルフレームのヘッダー領域の枠と、 タイトル文字を表示するための領域間の余白を設定します。[単位：ピクセル]

デフォルト値: 1 ピクセル。

	ヘッダー領域の高さ
	この関数で指定する値を２倍した数値に、 使用しているフォントの高さを加えた値がヘッダー領域の高さになります。

	ヘッダー領域の１ピクセル枠
	タイトル付きベベルフレームのヘッダー領域をベベルカラーで描画する幅１ピクセルの枠線は余白に含まれません。

参照

SFZTitleBevelFrame::GetFrameSize

解説

この関数は、タイトル付きベベルフレームのヘッダー領域の色を設定します。

デフォルトでは、下記の設定になっています。

static SFXBevelColor::AtomRecConst bevel[] = {
      {{{{0x00, 0xEE, 0xEE, 0xEE}}},     // ライトカラー
      {{{0x00, 0xDD, 0xDD, 0xDD}}},      // ベースカラー
      {{{0x00, 0x88, 0x88, 0x88}}}}      // ダークカラー
};

	非活性状態のときのヘッダー領域の色
	ベベルフレームが非活性状態にあるとき、 ライトカラーとダークカラーはベベルカラー(SFXBevelColor)のベースカラーに設定されます。 ヘッダー領域はベベルカラーのベースカラーだけで描画されるので平面的に見えます。

参照

SFZTitleBevelFrame::GetHeaderColor | SFXBevelColor | SFXRGBColor | 状態

解説

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

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

デフォルト値: SFYSingleTextWidget::DEFAULT_HORIZONTAL

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

参照

SFYSingleTextWidget | SFZTitleFlatFrame::SetText | SFZTitleBevelFrame::GetHorizontalAlign | SFZTitleBevelFrame::HorizontalEnum | SFYSingleTextWidget::HorizontalEnum

解説

タイトルのスクロール移動方向を設定します。

デフォルト値: SFYSingleTextWidget::DEFAULT_DIRECTION

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

参照

SFZTitleBevelFrame::GetScrollDirection | SFZTitleBevelFrame::DirectionEnum | SFYSingleTextWidget::DirectionEnum

解説

この関数は、タイトルのスクロールインターバルを設定します。

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

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

参照

SFZTitleBevelFrame::GetScrollInterval | SFZTitleBevelFrame::DefaultEnum | SFYSingleTextWidget::DefaultEnum

解説

この関数は、タイトルのスクロール移動量を設定します。[単位:ピクセル]

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

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

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

参照

SFZTitleBevelFrame::GetScrollStep | SFZTitleBevelFrame::DefaultEnum | SFYSingleTextWidget::DefaultEnum

戻り値

解説

この関数は、タイトルを設定します。

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

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

参照

SFZTitleBevelFrame::GetText | SFZTitleBevelFrame::SetHorizontalAlign | SFZTitleBevelFrame::SetVerticalAlign SFZTitleBevelFrame::SetTextColor | SFZTitleBevelFrame::SetFont

解説

この関数は、タイトルの色を設定します。

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

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

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

参照

SFZTitleBevelFrame::GetTextColor | SFXRGBColor::GetBrightness | SFXRGBColor | 状態

解説

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

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

デフォルト値: SFYSingleTextWidget::DEFAULT_VERTICAL

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

参照

SFZTitleBevelFrame::GetVerticalAlign | SFYSingleTextWidget | SFZTitleFlatFrame::SetText | SFZTitleBevelFrame::VerticalEnum | SFYSingleTextWidget::VerticalEnum

解説

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

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

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

参照

SFZTitleBevelFrame::GetWaitInterval | SFZTitleBevelFrame::DefaultEnum | SFYSingleTextWidget::DefaultEnum

解説

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

仮想領域の幅がタイトルの幅よりも大きいときは何もしません。

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

参照

SFZTitleBevelFrame::StopScroll

解説

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

参照

SFZTitlePlainFrame::StartScroll

参照

SFYResponder::GetType | SFYResponder::SetType

参照

SFYSingleTextWidget::DefaultEnum

参照

SFYSingleTextWidget::DirectionEnum

参照

SFYSingleTextWidget::HorizontalEnum

参照

SFYSingleTextWidget::VerticalEnum