継承図

協調図

解説

必要に応じて仮想関数をオーバーライドして独自のボタンコントロールを実装します。

SFRButtonBase::HandleContent 関数をオーバーライドする必要があります。

独自のボタンを実装するとき、コードは以下のようになります。

SFMTYPEDEFCLASS(UserButton)
class UserButton : public SFRButtonBase {
    // コピー禁止マクロ
    SFMSEALCOPY(UserButton)
  public:
    // コンストラクタとデストラクタの宣言
    UserButton(SFRResponderPtr, SFXRectangleConstRef, BehaviorType);
    virtual ~UserButton(Void);
  private:
    // 描画ハンドラの宣言
    virtual  Void  HandleContent(SFXGraphicsPtr);
    // キーリリース ハンドラの宣言
    virtual  Void  HandleRelease(Void);
};

// コンストラクタ
UserButton::UserButton(SFRResponderPtr director, SFXRectangleConstRef rect, BehaviorType behavior)
: SFRButtonBase(director, rect, behavior, four_char_code('U', 's', 'e', 'r'))
{
  return;
}

// デストラクタ
UserButton::~UserButton(Void)
{
  return;
}
// ボタンを描画
Void UserButton::HandleContent(SFXGraphicsPtr graphic)
{
  SFXRGBColor  color;

  // 応答可能か
  if (GetInheritEnable()) {
    // フォーカスされているか
    if (GetInheritFocus()) {
       // キーが押されているか
      if (GetStatusPress()) {
        color.SetRGB(0x44, 0x44, 0x44);
      }
      else {
        color.SetRGB(0x66, 0x66, 0x66);
      }
    }
    else {
      color.SetRGB(0x88, 0x88, 0x88);
    }
  }
  else {
    color.SetRGB(0xAA, 0xAA, 0xAA);
  }
  
  // ボタンを描画
  graphic->DrawRectangle(GetVirtualWorld(), color);
  
  return;
}

// キーリリース時の処理を行う関数
Void UserButton::HandleRelease(Void)
{
  // SREVT_CONTROL イベントを自分自身に送信
  Invoke(SFXEvent(SREVT_CONTROL, 0, reinterpret_cast<UInt32>(this)));
  return;
}

SFRButtonBase クラスを継承したクラスには、SFRButtonControl クラスがあります。

参照

SFRResponder | SFRApplication | SFRWindow | SFRDialog | SFRControl | SFRButtonControl | ボタン

メンバ

参照

SFRButtonBase::~SFRButtonBase

参照

SFRButtonBase::SFRButtonBase

戻り値

解説

独自にボタンコントロールなどを実装する場合に、 キーの状態によって描画を変更するときなどに使います。

解説

ボタンを独自実装する場合は、HandleContent 関数をオーバーライドしてボタン自身を描画します。

使用例

独自にボタンを描画します。

操作可能 / 不可能、フォーカス / 非フォーカス、押されているかどうかで色を変更して描画します。

// ボタンを描画
Void UserButton::HandleContent(SFXGraphicsPtr graphic)
{
  SFXRGBColor  color;

  // 応答可能か
  if (GetInheritEnable()) {
    // フォーカスされているか
    if (GetInheritFocus()) {
       // キーが押されているか
      if (GetStatusPress()) {
        color.SetRGB(0x44, 0x44, 0x44);
      }
      else {
        color.SetRGB(0x66, 0x66, 0x66);
      }
    }
    else {
      color.SetRGB(0x88, 0x88, 0x88);
    }
  }
  else {
    color.SetRGB(0xAA, 0xAA, 0xAA);
  }
  
  // ボタンを描画
  graphic->DrawRectangle(GetVirtualWorld(), color);
  
  return;
}

解説

独自実装のボタンで、キーのキーイベントを受信したときに独自の処理を行いたい場合は、HandlePress 関数をオーバーライドする必要があります。

使用例

キーのキーイベントを受信したときに独自のイベントを送信します。

Void HandlePress(Void)
{
  Invoke(SFXEvent(USEREVT_CONTROL, USERP16_CONTROL_PRESS, reinterpret_cast<UInt32>(this)));
  return;
}

解説

独自実装のボタンで、キーが放されたときに独自の処理を行いたい場合は、HandleRelease 関数をオーバーライドする必要があります。

使用例

キーが放されたときに独自のイベントを送信します。

Void HandleRelease(Void)
{
  Invoke(SFXEvent(USEREVT_CONTROL, USERP16_CONTROL_RELEASE, reinterpret_cast<UInt32>(this)));
  return;
}

解説

独自にボタンコントロールを実装する場合などに、ボタンの再描画が必要になったときに使います。

InvalidateVirtual 関数と同様の動作を行います。 ボタンの領域が仮想領域すべてでないときは、InvalidateButton 関数をオーバーライドする必要があります。

使用例

独自実装のボタンでタイトル文字列が変更されたときに、アップデート領域を登録します。

if (param != _title) {
  _title = param;
  InvalidateButton();
}

独自実装のボタンでアップデート領域として登録しなければならない領域が、仮想領域すべてでないとき

Void InvalidateButton(Void)
{
  InvalidateVirtual(_updateArea);
}

参照

SFRResponder::InvalidateVirtual

参照

SFRResponder::SetBaseBound

参照

SFRResponder::GetContentBound | SFRResponder::SetContentBound

参照

SFRResponder::GetVirtualBound | SFRResponder::SetVirtualBound