継承図

協調図

解説

ボタンコントロールを表現するレスポンダを作成するときのベースとなるクラスです。 開発者はこのクラスを継承して、適切な仮想関数をオーバーライドすることで独自の ボタンコントロールを簡単に実装することができます。必ずオーバーライドしなければ ならない関数は、HandleContent() 関数です。この関数はボタンの実態を 描画するための関数です。独自実装のボタンを作るときの基本的なコードは以下の ようになります。

SFMTYPEDEFCLASS(UserButton)
class UserButton : public SFRButtonBase {
  public:
    UserButton  (SFRResponderPtr, ConstSFURectRef, BehaviorType);
	~UserButton  (Void);
  private:
    virtual  Void  HandleContent  (SFUGraphicsPtr);
	virtual  Void  HandleRelease  (Void);
};

UserButton::UserButton(SFRResponderPtr director, ConstSFURectRef rect, BehaviorType behavior)
: SFRButtonBase(director, rect, behavior, FOUR_CHAR_CODE('U', 's', 'e', 'r'))
{
  return;
}

UserButton::~UserButton(Void)
{
  return;
}

Void UserButton::HandleContent(SFUGraphicsPtr graphic)
{
  SFUColor  color;

  if (GetInheriteEnable()) {
    if (GetInheriteFocus()) {
      if (GetStatusPress()) {
        color.Set(0x44, 0x44, 0x44);
      }
      else {
        color.Set(0x66, 0x66, 0x66);
      }
    }
    else {
      color.Set(0x88, 0x88, 0x88);
    }
  }
  else {
    color.Set(0xAA, 0xAA, 0xAA);
  }
  graphic->DrawRect(GetVirtualWorld(), color);
  return;
}

Void UserButton::HandleRelease(Void)
{
  Invoke(SFUEvent(SREVT_CONTROL, 0, reinterpret_brew<UInt32>(this)));
  return;
}

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

メンバ

解説

ボタンベースのコンストラクタです。

参照

SFRButtonBase::~SFRButtonBase

参照

SFRButtonBase::SFRButtonBase

解説

キーが押されている状態かどうかを取得します。 独自にボタンコントロールなどを実装する場合に、 キーの状態によって描画を変更したいときなどに、 この関数を使用することができます。

解説

ボタンのコンテント領域を描画する関数です。 ボタンを独自実装する場合は、この関数をオーバーライドして ボタン自身を描画します。

使用例

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

Void HandleContent(SFUGraphicsPtr graphic)
{
  SFUColor  color;

  if (GetInheriteEnable()) {
    if (GetInheriteFocus()) {
      if (GetStatusPress()) {
        color.Set(0x44, 0x44, 0x44);
      }
      else {
        color.Set(0x66, 0x66, 0x66);
      }
    }
    else {
      color.Set(0x88, 0x88, 0x88);
    }
  }
  else {
    color.Set(0xAA, 0xAA, 0xAA);
  }
  graphic->DrawRect(GetVirtualWorld(), color);
  return;
}

解説

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

使用例

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

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

解説

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

使用例

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

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

解説

ボタンの領域をアップデート領域として登録します。 独自にボタンコントロールを実装する場合などに、 ボタンの再描画が必要になったときこの関数を使用します。 この関数は、InvalidateVirtual() と同様の動作を 行います。ボタンの領域が仮想領域すべてではない場合などは、 この関数をオーバーライドしてください。

使用例

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

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

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

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

参照

SFRResponder::InvalidateVirtual

解説

コンテント領域をベース領域の座標で設定します。 SFRButtonBase を継承したクラスでは、この関数を 使用しても設定は無視されます。

参照

SFRResponder::GetContentBound | SFRResponder::SetContentBound

解説

仮想領域をコンテント領域の座標で設定します。 SFRButtonBase を継承したクラスでは、この関数を 使用しても設定は無視されます。

参照

SFRResponder::GetVirtualBound | SFRResponder::SetVirtualBound