レスポンダにはタイプという ４文字リテラル の識別子があります。 タイプは、アプリケーションやウィンドウなどを区別するために 使用されます。タイプはユーザーが設定することはできません。 ただし、SFRResponder クラスを継承して新たなクラスを作成するときのみ設定可能です。

タイプを設定するときは、４文字リテラルを使用してください。 ４文字リテラルを作成するには FOUR_CHAR_CODE マクロを使用します。

タイプを取得するには SFRResponder::GetType 関数を使用します。

レスポンダにはアトリビュートという４文字リテラルの識別子があります。 アトリビュートとは、オブジェクトの種類を表し、ウィンドウではタイトル付きや タイトルなし、コントロールでは各コントロールの種類を表しています。 アトリビュートはオブジェクト生成時にユーザーが独自に オーバーライトすることが可能です。 オーバーライトすることで検索関数を使うときにより便利になります。

アトリビュートを設定するときは、４文字リテラルを使用してください。 ４文字リテラルを作成するには、FOUR_CHAR_CODE マクロを使用します。

アトリビュートを取得するには SFRResponder::GetAttribute 関数を使用します。

レスポンダにはレスポンダの状態や見た目や属性を管理するフラグが 存在します。レスポンダの状態とは可視であるか不可視であるかなどであり ユーザーの操作にしたがって変化します。 属性とは透明かどうかや、移動可能かどうかなどであり ユーザーの操作によって変化することはありません。 レスポンダの状態は生成時に指定することや、生成後に関数を使用して 設定することもできます。見た目と属性は生成時にのみ指定可能です。 レスポンダの振る舞いは以下の定数で設定できます。

状態：

BEHAVIOR_NONE
STATUS_VISIBLE
STATUS_ENABLE
STATUS_FOCUS
STATUS_TARGET

STATUS_VISIBLE フラグは、可視状態であるか不可視状態で あるかを判断するためのフラグです。 標準状態ではこのフラグが設定されているときのみ オブジェクトは描画されます。

STATUS_ENABLE フラグは、応答可能か応答不可能かを 判断するためのフラグです。 標準状態ではこのフラグが設定されているときのみ オブジェクトはキー イベントやその他一部のイベントに応答します。 またフォーカス可能かどうかも STATUS_ENABLE フラグにより 決定されます。

STATUS_FOCUS フラグはフォーカスが当たっているかそうでないか を判断するためのフラグです。 ターゲット可能かどうかも STATUS_FOCUS フラグにより決定されます。

STATUS_TARGET フラグはターゲッティングされているかどうかを 判断するフラグです。 標準状態では、キー イベントやその他一部のイベントは ターゲッティングされているときに受け取ることができます。 PROPERTY_DIRECT フラグが設定されているときは、常に STATUS_TARGET フラグは 設定されています。

見た目：

APPEARANCE_TRANSPARENT

APPEARANCE_TRANSPARENT フラグはコンポーネントが透過領域を持っているかどうか を判断するためのフラグです。チェック ボックスやラジオ ボタンなど 一部のコントロールで使用されていますが、ウィンドウに使用することも 可能です。 このフラグが設定されているとレンダリング時の処理内容が透過領域を 意識したアルゴリズムに変更されます。

属性：

PROPERTY_DIRECT
PROPERTY_SELECT
PROPERTY_CLOSABLE
PROPERTY_MOVABLE
PROPERTY_SCROLLABLE

PROPERTY_DIRECT フラグはターゲッティングを行わなくてもイベントを 受け取れるかどうかを判断するフラグです。このフラグが設定されていると STATUS_TARGET フラグは常に設定されることになり、また関数を使用して STATUS_TARGET フラグをクリアすることもできなくなります。 コントロールなど一部のコンポーネントでは必ずこのフラグが設定されます。 ターゲッティングについては、以下の図を参照してください。

PROPERTY_SELECT フラグは背後にあるオブジェクトをターゲッティングしたときに 自動的に最前面に移動させるかどうかを判断するためのフラグです。 ウィンドウなど一部のコンポーネントは必ずこのフラグが設定されます。

PROPERTY_CLOSABLE フラグはクリア キーでオブジェクトを破棄できるか どうかを判断するためのフラグです。 標準状態ではすべてのコンポーネントは破棄不能となっています。

PROPERTY_MOVABLE フラグはユーザーがオブジェクトを移動可能かどうかを 判断するためのフラグです。Move 関数や GroupMove 関数を使用してオブジェクトを 移動させる場合にはこのフラグは適用されません。 標準状態ではすべてのコンポーネントは移動不可となっています。

PROPERTY_SCROLLABLE フラグはユーザーが仮想領域をスクロール可能かどうかを 判断するためのフラグです。Scroll 関数や GroupScroll 関数を使用して オブジェクトを移動させる場合はこのフラグは適用されません。 標準状態では SFRApplication 以外のコンポーネントはスクロール不可となっています。

SophiaFramework での状態の遷移は以下のように定義されています。

STATUS_VISIBLE が設定されているとき、STATUS_ENABLE が有効。 STATUS_ENABLE が設定されているとき、STATUS_FOCUS が有効。 STATUS_FOCUS が設定されているとき、STATUS_TARGET が有効。 STATUS_TARGET が設定されているとき、操作対象としてロック。

また、PROPERTY_DIRECT が設定されているときは、常に STATUS_TARGET は設定された 状態となります。

PROPERTY_CLOSABLE と PROPERTY_MOVABLE は STATUS_TARGET が設定されていないとき 有効です。また、PROPERTY_SELECT は背後にあるレスポンダを STATUS_TARGET 状態に するときに自動的に最前面に移動させるかどうかを判断します。

レスポンダには描画のための領域やレスポンダの位置を表す 領域など３つの領域があります。

ベース領域. レスポンダの位置を表します。 親レスポンダの仮想領域上での座標を指定します。

コンテント領域. 仮想領域のうち実際に描画される領域を表します。 この領域は、ベース領域よりも大きくなることはありません。

フレーム領域. ベース領域とコンテント領域の間の領域です。 ベース領域とコンテント領域が同じときは、フレーム領域は 存在しません。

仮想領域. 描画可能な仮想的な領域を表します。この領域は 実際に目に見える領域よりも大きくてもかまいません。

トレーサは特定のイベントがどのようにそれぞれの UI コンポーネントに 通知されるかの規則を保持しています。厳密に言えばどのように子階層の オブジェクトに通知されるかということです。トレーサは親の階層から継承され 子階層でオーバーライトすることもできます。たとえば、SFEVT_KEY などは フォーカスの当たっているオブジェクトを順にたどっていくという規則が 設定されています。また、SFEVT_RESUME などはすべてのオブジェクトに 通知されるという規則が設定されています。

トレーサの規則には以下の要素を設定できます。

１：イベント タイプと第１パラメータ

２：トレース順序（子階層への通知なし・フォーカスへ・後ろから前へ・前から後ろへ）

３：強制通知

４：状態フィルタ

イベント タイプと第一パラメータは BREW イベントのそれと同じです。 一致するイベントへのトレーサとなります。トレース順序は子階層へ イベントを通知するときの規則です。強制通知は自分と子階層の オブジェクトのうちあるオブジェクトがイベントを処理したとしても 強制的にイベントを通知し続けるかしないかのフラグです。SFEVT_KEY などは、 通常の用途ではどれか一つのオブジェクトがイベントを処理した場合は 通知を続ける必要は無いため強制通知フラグは設定されていません。 SFEVT_RESUME などはイベントの通知を打ち切ってしまうと不都合なので 強制通知フラグが設定されています。 状態フィルタは、可視状態や応答可能状態など特定の状態のときのみ イベントを受け取れるようにするためのフィルタです。

トレーサは親階層から継承されるために、デフォルトのトレーサは ほとんどがアプリケーション階層に登録されています。 メニュー イベントやコントロール イベントなどのトレーサは メニューやコントロールに登録されています。 一部の規則を変更したい場合は、ユーザーがトレーサを登録することによって デフォルトの規則を変更できます。

標準では以下のようになっています。

ハンドラは特定のイベントを処理する関数を保持しています。

ハンドラの規則には以下の要素を設定できます。

１：イベント タイプと第一パラメータ

２：処理のタイミング（子階層への通知の前・後）

イベント タイプと第一パラメータは BREW イベントのそれと同じです。 処理のタイミングは HANDLER_BEFORE と HANDLER_AFTER を使用して、子階層へ イベントを通知する前か後かを設定できます。 SFEVT_KEY などは普通フォーカスの当たっている子階層から イベント処理を開始することが多いために、 処理のタイミングは後となります。実際にイベントがどのようにハンドリング されるかは以下の図を参考にしてください。

ハンドラは標準でいくつか定義してありますが、 ユーザーが独自に定義して登録することも可能です。 またハンドラは親クラスで登録したものをオーバーライトすることも可能です。

ハンドラは次の型をもつ静的メンバ関数でなければなりません。

Bool  (*SFRResponderSPP)  (ConstSFUEventRef event, VoidPtr reference);

ここではハンドラの登録をするためのサンプル コードを示します。 ハンドラを登録するには RegisterHandler を、登録されているハンドラを 破棄するには UnregisterHandler を使用してください。 登録するときに、すでに同じイベントに対するハンドラが登録 されていたときはオーバーライトされます。 RegisterHandler と UnregisterHandler は数多くのオーバーロード版 の関数が用意されているので使いやすくなっています。

SREVT_CONTROL イベントに対するハンドラを子階層よりも前に処理する という規則で登録するには以下のように記述します。

SFRResponderPtr responder;
SFCError        error;

error = responder->RegisterHandler(SREVT_CONTROL, HANDLER_BEFORE, Control_static, this);

SFEVT_KEY から SFEVT_KEY_HELD までのイベント タイプでかつ 第一パラメータが AVK_SELECT のイベントに対するハンドラを 子階層よりも後に処理するという規則で登録するには以下のように記述します。

SFRResponderPtr responder;
SFCError        error;

error = responder->RegisterHandler(SFEVT_KEY, SFEVT_KEY_HELD, AVK_SELECT, HANDLER_AFTER, Key_static, this);

ハンドラは静的メンバ関数で登録しなければならないため、 通常は以下のようの使用方法が多くなると思われます。

inline SomeClass::SomeClass(Void)
{
  RegisterHandler(SFEVT_KEY, HANDLER_AFTER, Key_static, this);
  return;
}

static inline Bool Key_static(ConstSFUEventRef event, VoidPtr responder)
{
  return(SomeClassPtr(responder)->Key_handler(event));
}

inline Bool Key_handler(ConstSFUEventRef event)
{
  // something to do
  return(TRUE);
}

特定のイベントにおいては具体的なハンドリングはしないが、 処理したことにして TRUE を返したいことがときどきあります。 このようなときは TRUE を返すだけの関数を定義して それを登録する方法もありますが、コールバック エントリ を NULL で登録すれば効率的です。 コールバック エントリが NULL のときは具体的なハンドラは 呼び出されませんがイベントは処理されたことになります。

キーに関するイベントをすべてハンドルして無効にするには 以下のように記述します。

SFRResponderPtr responder;
SFCError        error;

error = responder->RegisterHandler(SFEVT_KEY, SFEVT_KEY_HELD, HANDLER_BEFORE, NULL, NULL);

ハンドラは新しく登録されたものほど有効です。 たとえば、以下のそれぞれのサンプルの挙動は違うことに注意してください。

SFRResponderPtr responder;

responder->RegisterHandler(SFEVT_KEY, HANDLER_AFTER, Key_static, this);
responder->RegisterHandler(SFEVT_KEY, SFEVT_KEY_HELD, HANDLER_AFTER, Held1_static, this);
responder->RegisterHandler(SFEVT_KEY, SFEVT_KEY_HELD, HANDLER_AFTER, Held2_static, this);

SFRResponderPtr responder;

responder->RegisterHandler(SFEVT_KEY, SFEVT_KEY_HELD, HANDLER_AFTER, Held1_static, this);
responder->RegisterHandler(SFEVT_KEY, SFEVT_KEY_HELD, HANDLER_AFTER, Held2_static, this);
responder->RegisterHandler(SFEVT_KEY, HANDLER_AFTER, Key_static, this);

トレーサとハンドラどちらも登録と破棄ができます。 またイベント タイプと第一パラメータは範囲指定で設定 することができます。たとえばイベント タイプが SFEVT_KEY から SFEVT_KEY_HELD までで AVK_SELECT を第１パラメータに持つイベントに 対して設定したり、イベント タイプが SFEVT_KEY で第一パラメータ が AVK_1 から AVK_9 までを持つものに対して設定したりできます。 どちらの登録時も親クラスで登録した規則をオーバーライトすることが 可能です。