継承図

協調図

解説

SFRResponder クラスはイベント ハンドリングと再描画を行います。

ウィンドウやコントロールなどすべての UI コンポーネント( レスポンダ )は SFRResponder クラスを継承します。

	レスポンダとは
	SophiaFramework UNIVERSE では、ウィンドウやコントロールなどの UI コンポーネントをレスポンダと呼びます。

図 278. 継承関係

参照

SFRApplication | SFRWindow | SFRDialog | SFRControl | SFRPane | SFRMenu | レスポンダ

メンバ

参照

SFRResponder::~SFRResponder | SFRResponder::BehaviorEnum

参照

SFRResponder::SFRResponder

戻り値

解説

PROPERTY_DIRECT が設定されていなくて、ターゲットされている場合は、ターゲットを解除します。

ターゲットが解除されている、または PROPERTY_DIRECT が設定されていてフォーカスされている場合、PROPERTY_CLOSABLE が設定されていればレスポンダを破棄します。

SFRHandler::RegisterHandler 関数でクリアキーイベントなどのイベントと関連付ける必要があります。

詳細情報 : 振る舞い

使用例

RegisterHandler(SFEVT_KEY,
                AVK_CLR,
                HANDLER_AFTER,
                HANDLER_FUNCTION(ClearHandler)));

参照

SFRResponder::SelectHandler

戻り値

戻り値

解説

「可視かつ応答可能」なレスポンダがフォーカス移動先の対象となります。

そのレスポンダと X 軸成分で重なりがある、１つ下のレスポンダにフォーカスが移動します。

	「可視かつ応答可能」
	詳細情報 : 振る舞い

	フォーカスとは
	詳細情報 : フォーカス

参照

SFRResponder::FocusUp | SFRResponder::FocusLeft | SFRResponder::FocusRight | SFRResponder::FocusNext | SFRResponder::FocusPrevious

戻り値

解説

「可視かつ応答可能」なレスポンダがフォーカス移動先の対象となります。

そのレスポンダと X 軸成分で重なりがある、１つ下のレスポンダにフォーカスが移動します。

	「可視かつ応答可能」
	詳細情報 : 振る舞い

SFRHandler::RegisterHandler 関数で下矢印キーイベントなどのイベントと関連付ける必要があります。

使用例

RegisterHandler(SFEVT_KEY, 
                AVK_DOWN, 
                HANDLER_AFTER, 
                HANDLER_FUNCTION(FocusDownHandler));

参照

SFRResponder::FocusUpHandler | SFRResponder::FocusLeftHandler | SFRResponder::FocusRightHandler | SFRResponder::FocusNextHandler | SFRResponder::FocusPreviousHandler

戻り値

解説

「可視かつ応答可能」なレスポンダがフォーカス移動先の対象となります。

そのレスポンダと Y 軸成分で重なりがある、１つ左のレスポンダにフォーカスが移動します。

	「可視かつ応答可能」
	詳細情報 : 振る舞い

	フォーカスとは
	詳細情報 : フォーカス

参照

SFRResponder::FocusUp | SFRResponder::FocusDown | SFRResponder::FocusRight | SFRResponder::FocusNext | SFRResponder::FocusPrevious

戻り値

解説

「可視かつ応答可能」なレスポンダがフォーカス移動先の対象となります。

そのレスポンダと Y 軸成分で重なりがある、１つ左のレスポンダにフォーカスが移動します。

	「可視かつ応答可能」
	詳細情報 : 振る舞い

SFRHandler::RegisterHandler 関数で左矢印キーイベントなどのイベントと関連付ける必要があります。

使用例

RegisterHandler(SFEVT_KEY, 
                AVK_LEFT, 
                HANDLER_AFTER, 
                HANDLER_FUNCTION(FocusLeftHandler));

参照

SFRResponder::FocusUpHandler | SFRResponder::FocusDownHandler | SFRResponder::FocusRightHandler | SFRResponder::FocusNextHandler | SFRResponder::FocusPreviousHandler

戻り値

解説

「可視かつ応答可能」なレスポンダが兄弟フォーカス移動先の対象となります。

	「可視かつ応答可能」
	詳細情報 : 振る舞い

	フォーカスとは
	詳細情報 : フォーカス

終端まで達した場合は、先頭に戻ってフォーカスします。

参照

SFRResponder::FocusPrevious | SFRResponder::FocusUp | SFRResponder::FocusDown | SFRResponder::FocusLeft | SFRResponder::FocusRight

戻り値

解説

「可視かつ応答可能」な兄弟レスポンダをフォーカス移動の対象とします。

	「可視かつ応答可能」
	詳細情報 : 振る舞い

終端まで達した場合は、先頭に戻ってフォーカスします。

SFRHandler::RegisterHandler 関数で上矢印キーイベントなどのイベントと関連付ける必要があります。

使用例

RegisterHandler(SFEVT_KEY, 
                AVK_UP, 
                HANDLER_AFTER, 
                HANDLER_FUNCTION(FocusNextHandler));

参照

SFRResponder::FocusPreviousHandler | SFRResponder::FocusUpHandler | SFRResponder::FocusDownHandler | SFRResponder::FocusLeftHandler | SFRResponder::FocusRightHandler

戻り値

解説

「可視かつ応答可能」な兄弟レスポンダをフォーカス移動の対象とします。

	「可視かつ応答可能」
	詳細情報 : 振る舞い

	フォーカスとは
	詳細情報 : フォーカス

先頭まで達した場合は、終端に戻ってフォーカスします。

参照

SFRResponder::FocusNext | SFRResponder::FocusUp | SFRResponder::FocusDown | SFRResponder::FocusLeft | SFRResponder::FocusRight

戻り値

解説

「可視かつ応答可能」な兄弟レスポンダをフォーカス移動の対象とします。

	「可視かつ応答可能」
	詳細情報 : 振る舞い

終端まで達した場合は、先頭に戻ってフォーカスします。

SFRHandler::RegisterHandler 関数で下矢印キーイベントなどのイベントと関連付ける必要があります。

使用例

RegisterHandler(SFEVT_KEY, 
                AVK_DOWN, 
                HANDLER_AFTER, 
                HANDLER_FUNCTION(FocusPreviousHandler));

参照

SFRResponder::FocusNextHandler | SFRResponder::FocusUpHandler | SFRResponder::FocusDownHandler | SFRResponder::FocusLeftHandler | SFRResponder::FocusRightHandler

戻り値

解説

「可視かつ応答可能」なレスポンダがフォーカス移動先の対象となります。

そのレスポンダと Y 軸成分で重なりがある、１つ右のレスポンダにフォーカスが移動します。

	「可視かつ応答可能」
	詳細情報 : 振る舞い

	フォーカスとは
	詳細情報 : フォーカス

参照

SFRResponder::FocusUp | SFRResponder::FocusDown | SFRResponder::FocusLeft | SFRResponder::FocusNext | SFRResponder::FocusPrevious

戻り値

解説

「可視かつ応答可能」なレスポンダがフォーカス移動先の対象となります。

そのレスポンダと Y 軸成分で重なりがある、１つ右のレスポンダにフォーカスが移動します。

	「可視かつ応答可能」
	詳細情報 : 振る舞い

SFRHandler::RegisterHandler 関数で右矢印キーイベントなどのイベントと関連付ける必要があります。

使用例

RegisterHandler(SFEVT_KEY, 
                AVK_RIGHT, 
                HANDLER_AFTER, 
                HANDLER_FUNCTION(FocusRightHandler));  

参照

SFRResponder::FocusUpHandler | SFRResponder::FocusDownHandler | SFRResponder::FocusLeftHandler | SFRResponder::FocusNextHandler | SFRResponder::FocusPreviousHandler

戻り値

解説

「可視かつ応答可能」なレスポンダがフォーカス移動先の対象となります。

そのレスポンダと X 軸成分で重なりがある、１つ上のレスポンダにフォーカスが移動します。

	「可視かつ応答可能」
	詳細情報 : 振る舞い

	フォーカスとは
	詳細情報 : フォーカス

参照

SFRResponder::FocusDown | SFRResponder::FocusLeft | SFRResponder::FocusRight | SFRResponder::FocusNext | SFRResponder::FocusPrevious

戻り値

解説

「可視かつ応答可能」なレスポンダがフォーカス移動先の対象となります。

そのレスポンダと X 軸成分で重なりがある、１つ上のレスポンダにフォーカスが移動します。

	「可視かつ応答可能」
	詳細情報 : 振る舞い

SFRHandler::RegisterHandler 関数で上矢印キーイベントなどのイベントと関連付ける必要があります。

使用例

RegisterHandler(SFEVT_KEY, 
                AVK_UP, 
                HANDLER_AFTER, 
                HANDLER_FUNCTION(FocusUpHandler));

参照

SFRResponder::FocusDownHandler | SFRResponder::FocusLeftHandler | SFRResponder::FocusRightHandler | SFRResponder::FocusNextHandler | SFRResponder::FocusPreviousHandler

戻り値

解説

SFRResponder::BehaviorEnum の APPEARANCE_TRANSPARENT が設定されているか確認します。

詳細情報 : 振る舞い

参照

SFRResponder::BehaviorEnum

使用例

レスポンダのアトリビュートに応じた分岐処理

// 種類が不明のレスポンダ（ responder ）がある場合

// レスポンダのアトリビュートに応じて処理を分岐する
switch (responder->GetAttribute()) {
    case ATTRIBUTE_SFRTITLEWINDOW:        // ウィンドウ
        ...
    case ATTRIBUTE_SFRBUTTONCONTROL:      // ボタン
        ...
    case ATTRIBUTE_SFRRADIOBUTTONCONTROL: // ラジオボタン
        ...
}

参照

SFRResponder::GetType

引数

戻り値

検索は所有関係の子階層の終端から開始して一周します。 見つからなければ null を返します。

解説

	レスポンダの検索
	詳細情報 : 検索

使用例

responder>GetBack();

responder->GetBack(TYPE_SFRWINDOW);

参照

SFRResponder::GetFront | SFRResponder::GetNthForward | SFRResponder::GetNthBackward | SFRResponder::GetIndexForward | SFRResponder::GetIndexBackward

解説

	レスポンダの描画領域
	詳細情報 : 描画領域

使用例

レスポンダの座標を右下に 10 ピクセル移動させる場合、以下のように記述します。

SFRResponderPtr   r;
SFXRectangle      u;

u = r->GetBaseBound();
u.Offset(10,10);
r->SetBaseBound(u);

参照

SFRResponder::SetBaseBound | SFRResponder::GetContentBound | SFRResponder::GetVirtualBound | SFRResponder::GetBaseWorld

解説

ベース領域の矩形を返します。 左上の点は必ず ( 0, 0 ) になります。

	レスポンダの描画領域
	詳細情報 : 描画領域

参照

SFRResponder::GetContentWorld | SFRResponder::GetVirtualWorld | SFRResponder::SetBaseBound | SFRResponder::GetBaseBound

解説

	レスポンダの描画領域
	詳細情報 : 描画領域

参照

SFRResponder::SetContentBound | SFRResponder::GetBaseBound | SFRResponder::GetVirtualBound | SFRResponder::GetContentWorld

解説

コンテント領域の矩形を返します。 左上の点は必ず ( 0, 0 ) になります。

	レスポンダの描画領域
	詳細情報 : 描画領域

参照

SFRResponder::GetBaseWorld | SFRResponder::GetVirtualWorld | SFRResponder::SetContentBound | SFRResponder::GetContentBound

解説

フォーカスを持つレスポンダが存在しない場合は、null を返します。

使用例

SFRResponderPtr responder(null);

// 所有関係の子階層のレスポンダで
// フォーカスを持つレスポンダを取得できた場合
if (GetFocus()) {

    // 検索条件に一致する、１つ背面にある兄弟レスポンダを取得する
    responder = GetFocus()->GetPrevious(TYPE_WILDCARD, ATTRIBUTE_WILDCARD, STATUS_VISIBLE | STATUS_ENABLE, false);
}

解説

	レスポンダの描画領域
	詳細情報 : 描画領域

参照

SFRResponder::SetFrameMargin

引数

戻り値

検索は所有関係の子階層の最前面から開始して一周します。 見つからなければ null を返します。

解説

	レスポンダの検索
	詳細情報 : 検索

使用例

responder->GetFront();

responder->GetFront(TYPE_SFRWINDOW);

参照

SFRResponder::GetBack | SFRResponder::GetNthForward | SFRResponder::GetNthBackward | SFRResponder::GetIndexForward | SFRResponder::GetIndexBackward

引数

戻り値

背面から数えた自分のインデックスを返します。 インデックスは 0-based で表されます。

参照

SFRResponder::GetIndexForward | SFRResponder::GetNthForward | SFRResponder::GetNthBackward | SFRResponder::GetFront | SFRResponder::GetBack

引数

戻り値

前面から数えた自分のインデックスを返します。 インデックスは 0-based で表されます。

参照

SFRResponder::GetIndexBackward | SFRResponder::GetNthForward | SFRResponder::GetNthBackward | SFRResponder::GetFront | SFRResponder::GetBack

戻り値

解説

親のレスポンダが応答不可能な状態の場合、GetInheritEnable 関数は応答不可能の状態を返します。

	使い方
	GetInheritEnable 関数は親レスポンダを含めたレスポンダの応答状態が取得できるため、レスポンダの描画時などに使います。

使用例

// 親レスポンダも含めた、レスポンダが応答可能な場合
if (GetInheritEnable()) {
    // 何か処理を行う
}

参照

SFRResponder::GroupStatusEnable | SFRResponder::SetStatusEnable | SFRResponder::GetStatusEnable

戻り値

解説

親のレスポンダが非フォーカスの状態の場合、GetInheritFocus 関数は非フォーカスの状態を返します。

	使い方
	GetInheritFocus 関数は親レスポンダを含めたレスポンダのフォーカス状態が取得できるため、レスポンダの描画時などに使います。

使用例

// 親レスポンダも含めた、レスポンダがフォーカス状態の場合
if (GetInheritFocus()) {
    // 何か処理を行う
}

参照

SFRResponder::SetStatusFocus | SFRResponder::GetStatusFocus

戻り値

解説

親のレスポンダが非ターゲットの状態の場合、GetInheritTarget 関数は非ターゲットの状態を返します。

	使い方
	GetInheritTarget 関数は親レスポンダを含めたレスポンダのターゲット状態が取得できるため、レスポンダの描画時などに使います。

使用例

// 親レスポンダも含めた、レスポンダがターゲット状態の場合
if (GetInheritTarget()) {
    // 何か処理を行う
}

参照

SFRResponder::SetStatusTarget | SFRResponder::GetStatusTarget

戻り値

解説

親のレスポンダが不可視の状態の場合、GetInheritVisible 関数は不可視の状態を返します

	使い方
	GetInheritVisible 関数は親レスポンダを含めたレスポンダの可視状態が取得できるため、レスポンダの描画時などに使います。

使用例

// 親レスポンダも含めた、レスポンダが可視状態の場合
if (GetInheritVisible()) {
    // 何か処理を行う
}

参照

SFRResponder::GroupStatusVisible | SFRResponder::SetStatusVisible | SFRResponder::GetStatusVisible

引数

戻り値

検索は自分の位置から開始して一周します。 見つからなければ null を返します。

解説

	レスポンダの検索
	詳細情報 : 検索

使用例

responder->GetLeft();

responder->GetLeft(TYPE_SFRWINDOW);

参照

SFRResponder::GetRight | SFRResponder::Group | SFRResponder::Ungroup

解説

SFRResponder::MoveUpHandler、SFRResponder::MoveDownHandler、SFRResponder::MoveLeftHandler、SFRResponder::MoveRightHandler 関数を呼び出してレスポンダを移動する単位(ピクセル数)を取得します。

上記関数でレスポンダを移動する単位は、SFRResponder::SetMoveInterval 関数で設定できます。

なお、上記関数でレスポンダを移動する単位のデフォルト値は 8 ピクセルです。

参照

SFRResponder::SetMoveInterval | SFRResponder::MoveUpHandler | SFRResponder::MoveDownHandler | SFRResponder::MoveLeftHandler | SFRResponder::MoveRightHandler

解説

このマージンのデフォルト値は 1 ピクセルです。マージンを設定するには、 SFRResponder::SetMoveMargin 関数を使います。

子レスポンダを移動するには SFRResponder::MoveUpHandler、SFRResponder::MoveDownHandler、SFRResponder::MoveLeftHandler、SFRResponder::MoveRightHandler、または SFRResponder::Move 関数を使います。

参照

SFRResponder::SetMoveMargin | SFRResponder::Move | SFRResponder::MoveUpHandler | SFRResponder::MoveDownHandler | SFRResponder::MoveLeftHandler | SFRResponder::MoveRightHandler

引数

戻り値

検索は自分の位置から開始して一周します。 見つからなければ null を返します。

解説

	レスポンダの検索
	詳細情報 : 検索

使用例

responder->GetNext();

responder->GetNext(TYPE_SFRWINDOW);

参照

SFRResponder::GetPrevious | SFRResponder::GetFront | SFRResponder::GetBack

引数

戻り値

検索は子階層の終端から開始して一周します。 見つからなければ null を返します。

使用例

可視かつ応答可能なレスポンダのなかで背面から 3 番目の子レスポンダを取得するには、以下のように記述します。

responder->GetNthBackward(2);

参照

SFRResponder::GetNthForward | SFRResponder::GetIndexForward | SFRResponder::GetIndexBackward | SFRResponder::GetFront | SFRResponder::GetBack

引数

戻り値

検索は子階層の先頭から開始して一周します。 見つからなければ null を返します。

使用例

可視かつ応答可能なレスポンダのなかで前面から 3 番目の子レスポンダを取得するには、以下のように記述します。

responder->GetNthForward(2);

参照

SFRResponder::GetNthBackward | SFRResponder::GetIndexForward | SFRResponder::GetIndexBackward | SFRResponder::GetFront | SFRResponder::GetBack

引数

戻り値

検索は自分の位置から開始して一周します。 見つからなければ null を返します。

解説

	レスポンダの検索
	詳細情報 : 検索

使用例

responder->GetRight();

responder->GetRight(TYPE_SFRWINDOW);

参照

SFRResponder::GetNext | SFRResponder::GetFront | SFRResponder::GetBack

戻り値

解説

SFRResponder::BehaviorEnum の PROPERTY_CLOSABLE が設定されているか確認します。

詳細情報 : 振る舞い

参照

SFRResponder::BehaviorEnum

戻り値

解説

SFRResponder::BehaviorEnum の PROPERTY_DIRECT が設定されているか確認します。

詳細情報 : 振る舞い

参照

SFRResponder::BehaviorEnum

戻り値

解説

SFRResponder::BehaviorEnum の PROPERTY_MOVABLE が設定されているか確認します。

詳細情報 : 振る舞い

参照

SFRResponder::BehaviorEnum

戻り値

解説

SFRResponder::BehaviorEnum の PROPERTY_SCROLLABLE が設定されているか確認します。

詳細情報 : 振る舞い

参照

SFRResponder::BehaviorEnum

戻り値

解説

SFRResponder::BehaviorEnum の PROPERTY_SELECT が設定されているか確認します。

詳細情報 : 振る舞い

参照

SFRResponder::BehaviorEnum

戻り値

解説

SFRResponder::BehaviorEnum の PROPERTY_TRAVEL が設定されているか確認します。

詳細情報 : 振る舞い

参照

SFRResponder::BehaviorEnum

使用例

SFRButtonControlPtr button;
SInt32 i;

// 番号 ( リファレンス値 ) を設定して 10 個のボタンを作成する
for (i = 0; i < 10; ++i) {
    button = new SFRButtonControl(this, SFXRectangle(0, i * 30, 20, 20), ");

    // ボタンに識別のための番号をつける
    button->SetReference(reinterpret_cast<VoidPtr>(i));
}

...

// 番号 ( リファレンス値 ) を取得する
SInt32 number = reinterpret_cast<SInt32>(button->GetReference());

参照

SFRResponder::SetReference

引数

戻り値

検索は自分の位置から開始して一周します。 見つからなければ null を返します。

解説

	レスポンダの検索
	詳細情報 : 検索

使用例

responder->GetRight();

responder->GetRight(TYPE_SFRWINDOW);

参照

SFRResponder::GetLeft | SFRResponder::Group | SFRResponder::Ungroup

解説

SFRResponder::ScrollUpHandler、SFRResponder::ScrollDownHandler、SFRResponder::ScrollLeftHandler、SFRResponder::ScrollRightHandler 関数を呼び出して仮想領域をスクロールする単位(ピクセル数)を取得します。

上記関数で仮想領域をスクロールする単位は、SFRResponder::SetScrollInterval 関数で設定できます。

なお、上記関数で仮想領域をスクロールする単位のデフォルト値は 8 ピクセルです。

詳細情報 : スクロール

参照

SFRResponder::SetScrollInterval | SFRResponder::Scroll | SFRResponder::ScrollUpHandler | SFRResponder::ScrollDownHandler | SFRResponder::ScrollLeftHandler | SFRResponder::ScrollRightHandler

戻り値

解説

	レスポンダの応答可能 / 不可能
	詳細情報 : レスポンダの応答可能 / 不可能

参照

SFRResponder::GroupStatusEnable | SFRResponder::SetStatusEnable | SFRResponder::GetInheritEnable

戻り値

解説

	フォーカスとは
	詳細情報 : フォーカス

使用例

SFRButtonControlPtr button;

...

if (button->GetStatusFocus()) { 
    // ボタンがフォーカスを持つとき
    ...
}

参照

SFRResponder::SetStatusFocus | SFRResponder::GetInheritFocus

戻り値

参照

SFRResponder::SetStatusTarget | SFRResponder::GetInheritTarget

戻り値

解説

	レスポンダの可視 / 不可視
	詳細情報 : レスポンダの可視 / 不可視

参照

SFRResponder::GroupStatusVisible | SFRResponder::SetStatusVisible | SFRResponder::GetInheritVisible

参照

SFRResponder::SetTranslate | SFRResponder::SetVirtualBound | SFRResponder::GetVirtualBound

解説

このマージンのデフォルト値は 4 ピクセルです。マージンを設定するには、 SFRResponder::SetTravelMargin 関数を使います。

コンテント領域外にある仮想領域の矩形をコンテント領域に自動的にスクロールするには SFRResponder::Travel 関数を使いします。

参照

SFRResponder::SetTravelMargin | SFRResponder::Travel

解説

レスポンダのタイプを取得します。 戻り値は以下の値のいずれかになります。

参照

SFRResponder::GetAttribute

使用例

仮想領域を左上に 10 ピクセル移動させる場合、以下のように記述します。

SFRResponderPtr   r;
SFXRectangle      u;

u = r->GetVirtualBound();
u.Offset(-10,-10);
r->SetVirtualBound(u);

参照

SFRResponder::SetVirtualBound | SFRResponder::GetBaseBound | SFRResponder::GetContentBound | SFRResponder::GetVirtualWorld

解説

仮想領域の矩形を返します。 左上の点は必ず ( 0, 0 ) になります。

参照

SFRResponder::GetBaseWorld | SFRResponder::GetContentWorld | SFRResponder::SetVirtualBound | SFRResponder::GetVirtualBound

解説

レスポンダをグループ化すると、特定の処理をグループ化されているレスポンダすべてに適応することが可能になります。

SFRRadiobuttonControl クラスなどの一部のコントロールではグループ化することによって自動的に排他的処理を行うようになります。

使用例

SFRRadiobuttonControl クラスなどをグループ化する場合、以下のように記述します。

SFRRadiobuttonControlPtr   rb0;
SFRRadiobuttonControlPtr   rb1;
SFRRadiobuttonControlPtr   rb2;

rb1->Group(rb0);
rb2->Group(rb0);

参照

SFRResponder::Ungroup | SFRResponder::GetLeft | SFRResponder::GetRight

参照

SFRResponder::Move | SFRResponder::Group | SFRResponder::Ungroup

解説

詳細情報 : スクロール

参照

SFRResponder::Scroll | SFRResponder::Group | SFRResponder::Ungroup

参照

SFRResponder::Select

参照

SFRResponder::SetStatusEnable | SFRResponder::GetStatusEnable | SFRResponder::GetInheritEnable | SFRResponder::Group | SFRResponder::Ungroup

参照

SFRResponder::SetStatusVisible | SFRResponder::GetStatusVisible | SFRResponder::GetInheritVisible | SFRResponder::Group | SFRResponder::Ungroup

使用例

ベース領域をすべて再描画領域にスケジュールする場合、以下のように記述します。

InvalidateBase();

参照

SFRResponder::InvalidateContent | SFRResponder::InvalidateVirtual

使用例

コンテント領域をすべて再描画領域にスケジュールする場合、以下のように記述します。

InvalidateContent();

参照

SFRResponder::InvalidateBase | SFRResponder::InvalidateVirtual

使用例

仮想領域をすべて再描画領域にスケジュールする場合、以下のように記述します。

InvalidateVirtual();

参照

SFRResponder::InvalidateBase | SFRResponder::InvalidateContent

戻り値

解説

オーバーロードすることでイベント送信の方法を変更できます。

参照

SFCInvoker::Invoke

参照

SFRResponder::GroupMove | SFRResponder::SetMoveMargin | SFRResponder::GetMoveMargin

戻り値

解説

[前提条件] PROPERTY_MOVABLE フラグを設定していること。

SFRHandler::RegisterHandler 関数で下矢印キーイベントなどのイベントと関連付ける必要があります。

MoveDownHandler の移動ピクセル数は SFRResponder::SetMoveInterval 関数で設定します。

使用例

以下の 2 つの例は、ウィンドウを 10 ピクセル分下へ移動する同等の内容のコードです。

SFRWindowPtr _window;

// ウィンドウを生成する
// ウィンドウの「振る舞い」は PROPERTY_MOVABLE を設定する
_window = new SFRTitleWindow(this, SFXRectangle(10, 10, 100, 180), "sample", SFRTitleWindow::ALIGN_LEFT, BEHAVIOR_SFRTITLEWINDOW | PROPERTY_MOVABLE);

// MoveDownHandler 関数をイベントハンドラとして登録する
// 下矢印キーのキーイベントを受信したときに、ウィンドウを下に移動する
RegisterHandler(SFEVT_KEY, AVK_DOWN, HANDLER_AFTER, HANDLER_FUNCTION(MoveDownHandler));

// 下へ移動するピクセル数を設定する
SetMoveInterval(10);

SFRWindowPtr _window;

// ウィンドウを生成する
// ウィンドウの「振る舞い」の設定は不要
_window = new SFRTitleWindow(this, SFXRectangle(10, 10, 100, 180), "sample");

// キーハンドラを登録する
RegisterHandler(SFEVT_KEY, HANDLER_AFTER, HANDLER_FUNCTION(OnKey));

// キーハンドラの内容
HANDLER_IMPLEMENT_BOOLEVENT(MoveSample, OnKey, event)
{
    switch (event.GetP16()) {
        case AVK_DOWN:
            // 下矢印キーのキーイベントを受信したときに、ウィンドウを 10 ピクセル分下へ移動する
            _window->Move(SFXSize(0, 10));
            return true;
    }
    return false;
}

参照

SFRResponder::SetMoveInterval | SFRResponder::MoveUpHandler | SFRResponder::MoveLeftHandler | SFRResponder::MoveRightHandler | SFRResponder::BehaviorEnum

戻り値

解説

[前提条件] PROPERTY_MOVABLE フラグを設定していること。

SFRHandler::RegisterHandler 関数で左矢印キーイベントなどのイベントと関連付ける必要があります。

MoveLeftHandler の移動ピクセル数は SFRResponder::SetMoveInterval 関数で設定します。

使用例

以下の 2 つの例は、ウィンドウを 10 ピクセル分左へ移動する同等の内容のコードです。

SFRWindowPtr _window;

// ウィンドウを生成する
// ウィンドウの「振る舞い」は PROPERTY_MOVABLE を設定する
_window = new SFRTitleWindow(this, SFXRectangle(10, 10, 100, 180), "sample", SFRTitleWindow::ALIGN_LEFT, BEHAVIOR_SFRTITLEWINDOW | PROPERTY_MOVABLE);

// MoveLeftHandler 関数をイベントハンドラとして登録する
// 左矢印キーのキーイベントを受信したときに、ウィンドウを左に移動する
RegisterHandler(SFEVT_KEY, AVK_LEFT, HANDLER_AFTER, HANDLER_FUNCTION(MoveLeftHandler));

// 左へ移動するピクセル数を設定する
SetMoveMargin(10);

SFRWindowPtr _window;

// ウィンドウを生成する
// ウィンドウの「振る舞い」の設定は不要
_window = new SFRTitleWindow(this, SFXRectangle(10, 10, 100, 180), "sample");

// キーハンドラを登録する
// ウィンドウの「振る舞い」の設定は不要
RegisterHandler(SFEVT_KEY, HANDLER_AFTER, HANDLER_FUNCTION(OnKey));

// キーハンドラの内容
HANDLER_IMPLEMENT_BOOLEVENT(MoveSample, OnKey, event)
{
    switch (event.GetP16()) {
        case AVK_LEFT:
           // 左矢印キーのキーイベントを受信したときに、ウィンドウを 10 ピクセル分左へ移動する
           _window->Move(SFXSize(-10, 0));
           return true;
    }
    return false;
}

参照

SFRResponder::SetMoveInterval | SFRResponder::MoveUpHandler | SFRResponder::MoveDownHandler | SFRResponder::MoveRightHandler | SFRResponder::BehaviorEnum

戻り値

解説

[前提条件] PROPERTY_MOVABLE フラグを設定していること。

SFRHandler::RegisterHandler 関数で右矢印キーイベントなどのイベントと関連付ける必要があります。

MoveRightHandler の移動ピクセル数は SFRResponder::SetMoveInterval 関数で設定します。

使用例

以下の 2 つの例は、ウィンドウを 10 ピクセル分右へ移動する同等の内容のコードです。

SFRWindowPtr _window;

// ウィンドウを生成する
// ウィンドウの「振る舞い」は PROPERTY_MOVABLE を設定する
_window = new SFRTitleWindow(this, SFXRectangle(10, 10, 100, 180), "sample", SFRTitleWindow::ALIGN_LEFT, BEHAVIOR_SFRTITLEWINDOW | PROPERTY_MOVABLE);

// MoveRightHandler 関数をイベントハンドラとして登録する
// 右矢印キーのキーイベントを受信したときに、ウィンドウを右に移動する
RegisterHandler(SFEVT_KEY, AVK_RIGHT, HANDLER_AFTER, HANDLER_FUNCTION(MoveRightHandler));

// 右へ移動するピクセル数を設定する
SetMoveMargin(10);

SFRWindowPtr _window;

// ウィンドウを生成する
// ウィンドウの「振る舞い」の設定は不要
_window = new SFRTitleWindow(this, SFXRectangle(10, 10, 100, 180), "sample");

// キーハンドラを登録する
RegisterHandler(SFEVT_KEY, HANDLER_AFTER, HANDLER_FUNCTION(OnKey));

// キーハンドラの内容
HANDLER_IMPLEMENT_BOOLEVENT(MoveSample, OnKey, event)
{
    switch (event.GetP16()) {
        case AVK_RIGHT:
            // 右矢印キーのキーイベントを受信したときに、ウィンドウを 10 ピクセル分右へ移動する
            _window->Move(SFXSize(10, 0));
            return true;
    }
    return false;
}

参照

SFRResponder::SetMoveInterval | SFRResponder::MoveUpHandler | SFRResponder::MoveDownHandler | SFRResponder::MoveLeftHandler | SFRResponder::BehaviorEnum

戻り値

解説

[前提条件] PROPERTY_MOVABLE フラグを設定していること。

SFRHandler::RegisterHandler 関数で上矢印キーイベントなどのイベントと関連付ける必要があります。

MoveUpHandler の移動ピクセル数は SFRResponder::SetMoveInterval 関数で設定します。

使用例

以下の 2 つの例は、ウィンドウを 10 ピクセル分上へ移動する同等の内容のコードです。

SFRWindowPtr _window;

// ウィンドウを生成する
// ウィンドウの「振る舞い」は PROPERTY_MOVABLE を設定する
_window = new SFRTitleWindow(this, SFXRectangle(10, 10, 100, 180), "sample", SFRTitleWindow::ALIGN_LEFT, BEHAVIOR_SFRTITLEWINDOW | PROPERTY_MOVABLE);

// MoveUpHandler 関数をイベントハンドラとして登録する
// 上矢印キーのキーイベントを受信したときに、ウィンドウを上に移動する
RegisterHandler(SFEVT_KEY, AVK_UP, HANDLER_AFTER, HANDLER_FUNCTION(MoveUpHandler));

// 上へ移動するピクセル数を設定する
SetMoveMargin(10);

SFRWindowPtr _window;

// ウィンドウを生成する
// ウィンドウの「振る舞い」の設定は不要
_window = new SFRTitleWindow(this, SFXRectangle(10, 10, 100, 180), "sample");

// キーハンドラを登録する
RegisterHandler(SFEVT_KEY, HANDLER_AFTER, HANDLER_FUNCTION(OnKey));

// キーハンドラの内容
HANDLER_IMPLEMENT_BOOLEVENT(MoveSample, OnKey, event)
{
    switch (event.GetP16()) {
        case AVK_UP:
            // 上矢印キーのキーイベントを受信したときに、ウィンドウを 10 ピクセル分上へ移動する
            _window->Move(SFXSize(0, -10));
            return true;
    }
    return false;
}

参照

SFRResponder::SetMoveInterval | SFRResponder::MoveDownHandler | SFRResponder::MoveLeftHandler | SFRResponder::MoveRightHandler | SFRResponder::BehaviorEnum

解説

詳細情報 : スクロール

参照

SFRResponder::GroupScroll

戻り値

解説

[前提条件] PROPERTY_SCROLLABLE フラグを設定していること。

SFRHandler::RegisterHandler 関数で下矢印キーイベントなどのイベントと関連付ける必要があります。

スクロールする単位(ピクセル数)は SFRResponder::SetScrollInterval 関数で設定します。

詳細情報 : スクロール

使用例

RegisterHandler(SFEVT_KEY, 
                AVK_DOWN, 
                HANDLER_AFTER, 
                HANDLER_FUNCTION(ScrollDownHandler));

参照

SFRHandler::RegisterHandler | SFRResponder::SetScrollInterval | SFRResponder::ScrollUpHandler | SFRResponder::ScrollLeftHandler | SFRResponder::ScrollRightHandler | SFRResponder::BehaviorEnum

戻り値

解説

[前提条件] PROPERTY_SCROLLABLE を設定していること。

SFRHandler::RegisterHandler 関数で左矢印キーイベントなどのイベントと関連付ける必要があります。

スクロールする単位(ピクセル数)は SFRResponder::SetScrollInterval 関数で設定します。

詳細情報 : スクロール

使用例

RegisterHandler(SFEVT_KEY, 
                AVK_LEFT, 
                HANDLER_AFTER, 
                HANDLER_FUNCTION(ScrollLeftHandler));

参照

SFRHandler::RegisterHandler | SFRResponder::SetScrollInterval | SFRResponder::ScrollUpHandler | SFRResponder::ScrollDownHandler | SFRResponder::ScrollRightHandler | SFRResponder::BehaviorEnum

戻り値

解説

[前提条件] PROPERTY_SCROLLABLE を設定していること。

SFRHandler::RegisterHandler 関数で右矢印キーイベントなどのイベントと関連付ける必要があります。

スクロールする単位(ピクセル数)は SFRResponder::SetScrollInterval 関数で設定します。

詳細情報 : スクロール

使用例

RegisterHandler(SFEVT_KEY, 
                AVK_RIGHT, 
                HANDLER_AFTER, 
                HANDLER_FUNCTION(ScrollRightHandler));

参照

SFRHandler::RegisterHandler | SFRResponder::SetScrollInterval | SFRResponder::ScrollUpHandler | SFRResponder::ScrollDownHandler | SFRResponder::ScrollLeftHandler | SFRResponder::BehaviorEnum

戻り値

解説

[前提条件] PROPERTY_SCROLLABLE を設定していること。

SFRHandler::RegisterHandler 関数で上矢印キーイベントなどのイベントと関連付ける必要があります。

スクロールする単位(ピクセル数)は SFRResponder::SetScrollInterval 関数で設定します。

詳細情報 : スクロール

使用例

RegisterHandler(SFEVT_KEY, 
                AVK_UP, 
                HANDLER_AFTER, 
                HANDLER_FUNCTION(ScrollUpHandler));

参照

SFRHandler::RegisterHandler | SFRResponder::SetScrollInterval | SFRResponder::ScrollDownHandler | SFRResponder::ScrollLeftHandler | SFRResponder::ScrollRightHandler | SFRResponder::BehaviorEnum

参照

SFRResponder::GroupSelect

戻り値

解説

[前提条件] ターゲット状態になるためには、レスポンダがフォーカスを持つことが前提条件です。さもなければ、最前面のレスポンダをフォーカスします。

詳細情報 : 振る舞い

SFRHandler::RegisterHandler 関数でセレクトキーイベントなどのイベントと関連付ける必要があります。

使用例

RegisterHandler(SFEVT_KEY, 
                AVK_SELECT, 
                HANDLER_AFTER, 
                HANDLER_FUNCTION(SelectHandler));

参照

SFRResponder::ClearHandler

使用例

レスポンダの座標を右下に 10 ピクセル移動させる場合、以下のように記述します。

SFRResponderPtr   r;
SFXRectangle      u;

u = r->GetBaseBound();
u.Offset(10,10);
r->SetBaseBound(u);

参照

SFRResponder::GetBaseBound | SFRResponder::SetContentBound | SFRResponder::SetVirtualBound | SFRResponder::GetBaseWorld

参照

SFRResponder::GetContentBound | SFRResponder::SetBaseBound | SFRResponder::SetVirtualBound | SFRResponder::GetContentWorld

参照

SFRResponder::GetFrameMargin

解説

SFRResponder::MoveUpHandler、SFRResponder::MoveDownHandler、SFRResponder::MoveLeftHandler、SFRResponder::MoveRightHandler 関数を呼び出してレスポンダを移動する単位(ピクセル数)を設定します。

上記関数でレスポンダを移動する単位は、SFRResponder::GetMoveInterval 関数で取得できます。

なお、上記関数でレスポンダを移動する単位のデフォルト値は 8 ピクセルです。

参照

SFRResponder::GetMoveInterval | SFRResponder::MoveUpHandler | SFRResponder::MoveDownHandler | SFRResponder::MoveLeftHandler | SFRResponder::MoveRightHandler

解説

このマージンのデフォルト値は 1 ピクセルです。マージンを取得するには、 SFRResponder::GetMoveMargin 関数を使います。

レスポンダを移動するには SFRResponder::MoveUpHandler、SFRResponder::MoveDownHandler、SFRResponder::MoveLeftHandler、SFRResponder::MoveRightHandler、または SFRResponder::Move 関数を使います。

参照

SFRResponder::GetMoveMargin | SFRResponder::Move | SFRResponder::MoveUpHandler | SFRResponder::MoveDownHandler | SFRResponder::MoveLeftHandler | SFRResponder::MoveRightHandler

参照

SFRResponder::GetReference

解説

SFRResponder::ScrollUpHandler、SFRResponder::ScrollDownHandler、SFRResponder::ScrollLeftHandler、SFRResponder::ScrollRightHandler 関数を呼び出して仮想領域をスクロールする単位(ピクセル数)を設定します。

上記関数で仮想領域をスクロールする単位は、SFRResponder::GetScrollInterval 関数で取得できます。

なお、上記関数で仮想領域をスクロールする単位のデフォルト値は 8 ピクセルです。

詳細情報 : スクロール

参照

SFRResponder::GetScrollInterval | SFRResponder::ScrollUpHandler | SFRResponder::ScrollDownHandler | SFRResponder::ScrollLeftHandler | SFRResponder::ScrollRightHandler

参照

SFRResponder::GroupStatusEnable | SFRResponder::GetStatusEnable | SFRResponder::GetInheritEnable

参照

SFRResponder::GetStatusFocus | SFRResponder::GetInheritFocus

参照

SFRResponder::GetStatusTarget | SFRResponder::GetInheritTarget

参照

SFRResponder::GroupStatusVisible | SFRResponder::GetStatusVisible | SFRResponder::GetInheritVisible

参照

SFRResponder::GetTranslate | SFRResponder::SetVirtualBound | SFRResponder::GetVirtualBound

解説

このマージンのデフォルト値は 4 ピクセルです。マージンを取得するには、 SFRResponder::GetTravelMargin 関数を使います。

コンテント領域外にある仮想領域の矩形をコンテント領域に自動的にスクロールするには SFRResponder::Travel 関数を使います。

参照

SFRResponder::GetTravelMargin | SFRResponder::Travel

使用例

仮想領域を左上に 10 ピクセル移動させる場合、以下のように記述します。

SFRResponderPtr   r;
SFXRectangle      u;

u = r->GetVirtualBound();
u.Offset(-10,-10);
r->SetVirtualBound(u);

参照

SFRResponder::GetVirtualBound | SFRResponder::SetBaseBound | SFRResponder::SetContentBound | SFRResponder::GetVirtualWorld

解説

指定した矩形がコンテント領域内にあるときは、仮想領域をスクロールしません。

参照

SFRResponder::SetTravelMargin | SFRResponder::GetTravelMargin

参照

SFRResponder::Group | SFRResponder::GetLeft | SFRResponder::GetRight

解説

レスポンダの振る舞いを表す定数です。 以下に一覧を示します。

参照

SFRResponder::SFRResponder | SFRResponder::GetStatusVisible | SFRResponder::GetStatusEnable | SFRResponder::GetStatusFocus | SFRResponder::GetStatusTarget | SFRResponder::GetAppearanceTransparent | SFRResponder::GetPropertyDirect | SFRResponder::GetPropertySelect | SFRResponder::GetPropertyTravel | SFRResponder::GetPropertyClosable | SFRResponder::GetPropertyMovable | SFRResponder::GetPropertyScrollable | SFRTracer::RegisterTracer