継承図

協調図

解説

SFYMenu は、各種メニューを実装するための起点となります。

たとえば、 SFZTextMenu や SFZGridMenu などのメニューは、 SFYMenu クラスを継承して実装しています。

SFYMenu は、 一定時間経過後に自動的にメニューを閉じる機能と、 操作キーや選択キー、ESCAPE キーの管理を実装し、 いくつかの仮想関数（ハンドラ）の動作をデフォルトで実装します。

デフォルトの実装では、 抽象メニュー[SFYMenu]は 下記の結果イベント[SFEVT_RESPONDER_RESULT]を受信します。

開発者は、これらのイベントを受信するハンドラを登録できます。

ハンドラを登録しない場合、上記結果イベントを受信するとデフォルトのハンドラが起動されます。 デフォルトのハンドラは、メニューを閉じる処理だけを行います。

操作キーは、SFYMenu::SetOperateKey 関数を使用して設定します。 デフォルトでは、セレクトキーが操作キーとして割り当てられています。

ESCAPE キーは、SFYMenu::SetEscapeKey 関数を使用して設定します。 デフォルトでは、クリアキーが ESCAPE キーとして割り当てられています。

	タイマーのキャンセル
	SFYMenu::ScheduleTimer 関数で設定したタイマー処理は、 操作キーまたは ESCAPE キーを押したときに自動的にキャンセルされます。 サスペンド時もタイマーはキャンセルされますが、 レジューム時に SFYMenu::ScheduleTimer 関数の引数に指定した時間でタイマー処理は再開されます。 メニューの有効状態が無効になったときもタイマーはキャンセルされます。

選択キーは、 SFYMenu::SetSelectUpKey / SFYMenu::SetSelectDownKey / SFYMenu::SetSelectRightKey / SFYMenu::SetSelectLeftKey 関数を使用して設定します。 デフォルトでは、 それぞれ上矢印キー、下矢印キー、右矢印キー、左矢印キーが選択キーとして割り当てられています。

参照: 結果イベント[SFEVT_RESPONDER_RESULT] | SFYMenu::HandleOperateKey | SFYMenu::HandleEscapeKey | SFYMenu::HandleSelectUpKey | SFYMenu::HandleSelectDownKey | SFYMenu::HandleSelectRightKey | SFYMenu::HandleSelectLeftKey

SFYMenu を継承するレスポンダでは、 SFYMenu::SFYMenu / SFYWidget::SFYWidget コンストラクタで登録されたハンドラの処理により、 下記のイベントを受信すると、対応する下記の仮想関数（ハンドラ）が最初に呼び出されます。 その後、開発者がレスポンダに登録したハンドラが呼び出されることになります。

	注意
	ハンドラの詳細については、 SFYMenu::SFYMenu / SFYWidget::SFYWidget コンストラクタの解説を参照してください。

	Tip
	ハンドラを登録する手間を省略できるので、 通常、これらのイベント処理は仮想関数をオーバーライドして記述します。

※デフォルトの動作にある "−" は何も実装していないことを表す。

注釈

※1. SFYResponder::InvokeForward(SFXEvent(SFEVT_RESPONDER_RESULT, SFP16_RESULT_CANCEL, 0), false) を実行します。 SFYMenu::HandleOperateKey 関数を呼び出す直前に、 SFYMenu::ScheduleTimer 関数で設定したタイマー処理をキャンセルする操作が内部的に行われます。 ※2. SFYResponder::InvokeForward(SFXEvent(SFEVT_RESPONDER_RESULT, SFP16_RESULT_ESCAPE, 0), false) を実行します。 SFYMenu::HandleEscapeKey 関数を呼び出す直前に、 SFYMenu::ScheduleTimer 関数で設定したタイマー処理をキャンセルする操作が内部的に行われます。 ※3. SFYResponder::SetVirtualBound(SFXRectangle(SFXGrid::ZeroInstance(), GetRealBound().GetSize())) を実行します。

以下にユーザー定義メニューを作成するときに最低限必要なコードを示します。

SFMTYPEDEFRESPONDER(USRMenu)
class USRMenu: public SFYMenu {
    SFMSEALRESPONDER(USRMenu)
    SFMRESPONDERINSTANTIATETHREE(USRMenu, SFYMenu, SFYWidget, SFYResponder)
public:

    // レスポンダのタイプを定義する
    // 小文字と記号のみからなるタイプは予約されているので使えない
    enum CodeEnum {
        CODE_TYPE = four_char_code('U', 'M', 'N', 'U')
    };
    SFMTYPEDEFTYPE(CodeEnum)

public:
    static USRMenuSmp NewInstance(SFCErrorPtr exception = null);
protected:
    explicit USRMenu(Void) static_throws;
    virtual ~USRMenu(Void);

    // 親クラスで定義されている仮想関数のうち、実装が推奨される仮想関数
    virtual Void HandleOperateKey(Void);
    virtual Void HandleSelectUpKey(Void);
    virtual Void HandleSelectDownKey(Void);
    virtual Void HandleBoundRequest(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundOptimize(SFXRectanglePtr rectangle) const;
    virtual Void HandleBoundReal(Void);
    virtual Void HandleBoundVirtual(Void);
    virtual Void HandleRenderRequest(SFXGraphicsPtr graphics) const;
};

USRMenu::USRMenu(Void) static_throws
{
    if (static_try()) {

        // レスポンダのタイプを設定する
        SetType(CODE_TYPE);

        // 初期化処理を記述する
    }
}

USRMenu::~USRMenu(Void)
{
    // 終了処理を記述する
}

USRMenuSmp USRMenu::NewInstance(SFCErrorPtr exception)
{
    return static_pointer_cast<USRMenu>(Factory(::new USRMenu, exception));
}

Void USRMenu::HandleOperateKey(Void)
{
    // 操作キー押下時に必要な処理があれば、ここに記述する
    // 通常、以下のようにイベントを送信する
    // _select 変数は選択されている項目の番号を表すものとする
    InvokeForward(SFXEvent(SFEVT_RESPONDER_RESULT, SFP16_RESULT_OK, _select), false);

    return;
}

Void USRMenu::HandleSelectUpKey(Void)
{
    // 上キー押下時に必要な処理があれば、ここに記述する
    // 例：選択されている項目を１つ戻すなど

    return;
}

Void USRMenu::HandleSelectDownKey(Void)
{
    // 下キー押下時に必要な処理があれば、ここに記述する
    // 例：選択されている項目を１つ進めるなど

    return;
}

Void USRMenu::HandleBoundRequest(SFXRectanglePtr rectangle) const
{
    // メニューに最適な大きさを計算して rectangle パラメータに設定する
    // この関数内では、rectangle の原点は変更せず、rectangle のサイズだけを設定する(推奨)

    return;
}

Void USRMenu::HandleBoundOptimize(SFXRectanglePtr rectangle) const
{
    // メニューに最適な大きさを rectangle パラメータ内の大きさに
    // 収まるように計算し、rectangle パラメータに設定する
    // この関数内では、rectangle の原点は変更せず、rectangle のサイズだけを設定する(推奨)

    return;
}

Void USRMenu::HandleBoundReal(Void)
{
    // 実領域が変更された場合に再計算が必要なものがあれば、ここに記述する

    return;
}

Void USRMenu::HandleBoundVirtual(Void)
{
    // 仮想領域が変更された場合に再計算が必要なものがあれば、ここに記述する

    return;
}

Void USRMenu::HandleRenderRequest(SFXGraphicsPtr graphics) const
{
    // メニューを描画する

    return;
}

参照

SFYMenu::SFYMenu | SFYWidget::SFYWidget | SFZTextMenu | SFZGridMenu | SFZFlexListMenu | SFZRoot | キーイベント[SFEVT_KEY] | 領域イベント[SFEVT_RESPONDER_BOUND] | 描画イベント[SFEVT_RESPONDER_RENDER] | メニュー（基礎編）

メンバ

解説

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

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

内部実装

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

/*protected */SFYMenu::SFYMenu(Void) static_throws : _state(STATE_IDLE)
{
    static SFXRGBColor::AtomRecConst            rgb[] = {
        {{{0x00, 0xEE, 0xEE, 0xEE}}}
    };
    static SFXEventRange::AtomRecConst          trange[] = {
        {     SFEVT_APP_RESUME,       SFEVT_APP_RESUME,           SFP16_BEGIN,            SFP16_END},
        {     SFEVT_APP_SUSPEND,      SFEVT_APP_SUSPEND,          SFP16_BEGIN,            SFP16_END},
        #if TARGET_VERSION_GE(3, 0, 0)
        {       SFEVT_KEY_PRESS,      SFEVT_KEY_RELEASE,          SFP16_BEGIN,            SFP16_END},
        #else
        {       SFEVT_KEY_PRESS,         SFEVT_KEY_HELD,          SFP16_BEGIN,            SFP16_END},
        #endif
        {             SFEVT_KEY,              SFEVT_KEY,          SFP16_BEGIN,            SFP16_END},
        {             SFEVT_KEY,              SFEVT_KEY,          SFP16_BEGIN,            SFP16_END},
        { SFEVT_RESPONDER_STATE,  SFEVT_RESPONDER_STATE,    SFP16_STATE_VALID,    SFP16_STATE_VALID},
        {SFEVT_RESPONDER_RESULT, SFEVT_RESPONDER_RESULT,          SFP16_BEGIN,            SFP16_END}
    };
    SFYHandler::RuleRec                         trule[lengthof(trange)];

    if (static_try()) {
        SetType(CODE_TYPE);
        trule[0].spp = XANDLER_FUNCTION(OnAppResume);
        trule[0].reference = this;
        trule[1].spp = XANDLER_FUNCTION(OnAppSuspend);
        trule[1].reference = this;
        trule[2].spp = XANDLER_FUNCTION(OnShield);
        trule[2].reference = this;
        trule[3].spp = XANDLER_FUNCTION(OnKey);
        trule[3].reference = this;
        trule[4].spp = XANDLER_FUNCTION(OnRewind);
        trule[4].reference = this;
        trule[5].spp = XANDLER_FUNCTION(OnStateValid);
        trule[5].reference = this;
        trule[6].spp = XANDLER_FUNCTION(OnMenuResult);
        trule[6].reference = this;
        static_throw(RegisterHandler(atomic_cast(trange), trule, lengthof(trange)));
        if (static_try()) {
            SetBackgroundColor(rgb[0]);
            _timer.Set(XALLBACK_INTERNAL(OnTimer));
            _msec = 0;
            _key.operate = AVK_SELECT;
            _key.escape = AVK_CLR;
            _key.up = AVK_UP;
            _key.down = AVK_DOWN;
            _key.left = AVK_LEFT;
            _key.right = AVK_RIGHT;
        }
    }
}// SFYMenu::SFYMenu //

/*private */XANDLER_IMPLEMENT_VOIDRESUME(SFYMenu, OnAppResume, invoker, environment)
{
    unused(invoker);
    unused(environment);
    if (_state == STATE_FIRE) {
        _timer.Schedule(_msec);
    }
    return;
}// XANDLER_IMPLEMENT_VOIDRESUME(SFYMenu, OnAppResume) //

/*private */XANDLER_IMPLEMENT_VOIDSUSPEND(SFYMenu, OnAppSuspend, invoker, reason, info)
{
    unused(invoker);
    unused(reason);
    unused(info);
    if (_state != STATE_IDLE) {
        _timer.Cancel();
    }
    return;
}// XANDLER_IMPLEMENT_VOIDSUSPEND(SFYMenu, OnAppSuspend) //

/*private */XANDLER_IMPLEMENT_BOOLEVENT(SFYMenu, OnShield, invoker, event)
{
    unused(invoker);
    return (event.GetP16() == _key.operate || event.GetP16() == _key.escape || event.GetP16() == _key.up || event.GetP16() == _key.down || event.GetP16() == _key.left || event.GetP16() == _key.right);
}// XANDLER_IMPLEMENT_BOOLEVENT(SFYMenu, OnShield) //

/*private */XANDLER_IMPLEMENT_BOOLEVENT(SFYMenu, OnKey, invoker, event)
{
    Bool                                        result(false);

    unused(invoker);
    if (event.GetP16() == _key.operate) {
        CancelTimer();
        HandleOperateKey();
        result = true;
    }
    else if (event.GetP16() == _key.escape) {
        CancelTimer();
        HandleEscapeKey();
        result = true;
    }
    else if (event.GetP16() == _key.up) {
        HandleSelectUpKey();
        result = true;
    }
    else if (event.GetP16() == _key.down) {
        HandleSelectDownKey();
        result = true;
    }
    else if (event.GetP16() == _key.left) {
        HandleSelectLeftKey();
        result = true;
    }
    else if (event.GetP16() == _key.right) {
        HandleSelectRightKey();
        result = true;
    }
    return result;
}// XANDLER_IMPLEMENT_BOOLEVENT(SFYMenu, OnKey) //

/*private */XANDLER_IMPLEMENT_BOOLEVENT(SFYMenu, OnRewind, invoker, event)
{
    unused(invoker);
    unused(event);
    RewindTimer();
    return false;
}// XANDLER_IMPLEMENT_BOOLEVENT(SFYMenu, OnRewind) //

/*private */XANDLER_IMPLEMENT_VOIDSTATE(SFYMenu, OnStateValid, invoker, reason, state)
{
    unused(invoker);
    unused(reason);
    if (!state) {
        CancelTimer();
    }
    return;
}// XANDLER_IMPLEMENT_VOIDSTATE(SFYMenu, OnStateValid) //

/*private */XANDLER_IMPLEMENT_VOIDRESULT(SFYMenu, OnMenuResult, invoker, reason, result)
{
    unused(invoker);
    unused(reason);
    unused(result);
    Terminate();
    return;
}// XANDLER_IMPLEMENT_VOIDRESULT(SFYMenu, OnMenuResult) //

/*private */XALLBACK_IMPLEMENT_SFXTIMER(SFYMenu, OnTimer)
{
    SFYResponderSmp                             root;
    SFCError                                    error;

    error = SFERR_NO_ERROR;
    if ((root = GetRoot()) != null) {
        if (_state == STATE_FIRE) {
            _state = STATE_IDLE;
            _msec = 0;
            Invalidate();
            HandleEscapeKey();
            error = root->Render();
        }
    }
    else {
        error = SFERR_FAILED;
    }
    if (error != SFERR_NO_ERROR) {
        // internal fault!
    }
    return;
}// XALLBACK_IMPLEMENT_SFXTIMER(SFYMenu, OnTimer) //

参照

SFYResponder::SetType | SFYMenu::CodeEnum | SFYMenu::SetOperateKey | SFYMenu::HandleOperateKey | SFYMenu::SetEscapeKey | SFYMenu::HandleEscapeKey | SFYMenu::SetSelectUpKey | SFYMenu::HandleSelectUpKey | SFYMenu::SetSelectDownKey | SFYMenu::HandleSelectDownKey | SFYMenu::SetSelectLeftKey | SFYMenu::HandleSelectLeftKey | SFYMenu::SetSelectRightKey | SFYMenu::HandleSelectRightKey | SFYMenu::ScheduleTimer | SFXRGBColor | SFXEvent | タイプ | イベント | キーイベント[SFEVT_KEY] | 結果イベント[SFEVT_RESPONDER_RESULT] | アプリ中断イベント[SFEVT_APP_SUSPEND] | アプリ再開イベント[SFEVT_APP_RESUME]

解説

タイマーをキャンセルします。

内部実装

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

/*protected virtual */SFYMenu::~SFYMenu(Void)
{
    CancelTimer();
}// SFYMenu::~SFYMenu //

参照

SFYMenu::CancelTimer

解説

この関数は、SFYMenu::ScheduleTimer 関数によるタイマーの設定をキャンセルします。

参照

SFYMenu::ScheduleTimer | SFYMenu::RewindTimer

戻り値

メニューの ESCAPE キー。

解説

この関数は、 SFYMenu::SetEscapeKey 関数で設定されたメニューの ESCAPE キーを取得します。

参照

SFYMenu::SetEscapeKey | AVKType

戻り値

メニューの操作キー。

解説

この関数は、 SFYMenu::SetOperateKey 関数で設定されたメニューの操作キーを取得します。

参照

SFYMenu::SetOperateKey | AVKType

戻り値

メニューの DOWN キー。

解説

この関数は、 SFYMenu::SetSelectDownKey 関数で設定されたメニューの DOWN キーを取得します。

参照

SFYMenu::SetSelectDownKey | AVKType

戻り値

メニューの LEFT キー。

解説

この関数は、 SFYMenu::SetSelectLeftKey 関数で設定されたメニューの LEFT キーを取得します。

参照

SFYMenu::SetSelectLeftKey | AVKType

戻り値

メニューの RIGHT キー。

解説

この関数は、 SFYMenu::SetSelectRightKey 関数で設定されたメニューの RIGHT キーを取得します。

参照

SFYMenu::SetSelectRightKey | AVKType

戻り値

メニューの UP キー。

解説

この関数は、 SFYMenu::SetSelectUpKey 関数で設定されたメニューの UP キーを取得します。

参照

SFYMenu::SetSelectUpKey | AVKType

解説

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

開発者は、独自の処理のためにこの関数をオーバーライドできます。

デフォルトの実装は、仮想領域を実領域に一致させます。

	領域イベント[(SFEVT_RESPONDER_BOUND, SFP16_BOUND_REAL) イベント]
	SFYResponder::SetRealBound 関数は、この関数内の処理により実領域が変化すると、 領域イベント [SFXEvent(SFEVT_RESPONDER_BOUND, SFP16_BOUND_REAL, rectangle)] をレスポンダに送信します。 SFYWidget クラスを継承するレスポンダが領域イベントを受信すると、 SFYWidget::SFYWidget コンストラクタで最初に登録した領域イベント専用ハンドラの処理により、 SFYWidget::HandleBoundReal 仮想関数が呼び出されます。 ※ 領域イベントの P32 パラメータ rectangle には変更後の実領域が設定されています。

	実領域が変化した時の処理
	SFYWidget::HandleBoundReal 仮想関数をオーバーライドする以外に、 領域イベント専用ハンドラ[XANDLER_DECLARE_VOIDBOUND]を定義・実装し レスポンダに登録して行うことも可能です。 実領域の変更処理は、最初に SFYWidget::HandleBoundReal 仮想関数を実行し、 次に領域イベント専用ハンドラを登録した順に実行して行われます。 領域イベント専用ハンドラを宣言し登録する手間が省けるので、 通常は SFYWidget::HandleBoundReal 仮想関数をオーバーライドして処理を記述します。

内部実装

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

/*protected virtual */Void SFYMenu::HandleBoundReal(Void)
{
    SetVirtualBound(SFXRectangle(SFXGrid::ZeroInstance(), GetRealBound().GetSize()));
    return;
}// SFYMenu::HandleBoundReal //

参照

SFYResponder::SetRealBound | SFXEvent | 領域イベント[SFEVT_RESPONDER_BOUND]

解説

この関数は、SFYMenu::SetEscapeKey 関数で設定した ESCAPE キーの SFEVT_KEY イベント （キーイベント[SFEVT_KEY]）を受信したとき、 または SFYMenu::ScheduleTimer 関数で指定した時間が経過しても操作キーや ESCAPE キーが押下されなかったときに呼び出されます。

開発者は、独自の処理のためにこの関数をオーバーライドできます。

デフォルトの実装では、 結果イベント [SFXEvent(SFEVT_RESPONDER_RESULT, SFP16_RESULT_ESCAPE, 0)] を送信します。 そして、結果ハンドラが起動されます。

	注意
	デフォルトの結果ハンドラの実装は、メニューを閉じます。

内部実装

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

/*protected virtual */Void SFYMenu::HandleEscapeKey(Void)
{
    InvokeForward(SFXEvent(SFEVT_RESPONDER_RESULT, SFP16_RESULT_ESCAPE, 0), false);
    return;
}// SFYMenu::HandleEscapeKey //

参照

SFYMenu::SetEscapeKey | SFYMenu::ScheduleTimer | SFYMenu::SetOperateKey | SFXEvent | 結果イベント[SFEVT_RESPONDER_RESULT] | キーイベント[SFEVT_KEY]

解説

この関数は、SFYMenu::SetOperateKey 関数で設定した操作キーの SFEVT_KEY イベント （キーイベント[SFEVT_KEY]）を受信したときに呼び出されます。

開発者は、独自の処理のためにこの関数をオーバーライドできます。

デフォルトの実装では、 結果イベント [SFXEvent(SFEVT_RESPONDER_RESULT, SFP16_RESULT_CANCEL, 0)] を送信します。 そして、結果ハンドラが起動されます。

	注意
	デフォルトの結果ハンドラの実装は、メニューを閉じます。

内部実装

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

/*protected virtual */Void SFYMenu::HandleOperateKey(Void)
{
    InvokeForward(SFXEvent(SFEVT_RESPONDER_RESULT, SFP16_RESULT_CANCEL, 0), false);
    return;
}// SFYMenu::HandleOperateKey //

参照

SFYMenu::SetOperateKey | SFXEvent | 結果イベント[SFEVT_RESPONDER_RESULT] | キーイベント[SFEVT_KEY]

解説

この関数は、SFYMenu::SetSelectDownKey 関数によって設定された DOWN キーの SFEVT_KEY イベント （キーイベント[SFEVT_KEY]）を受信したときに呼び出されます。

開発者は、独自の処理のためにこの関数をオーバーライドできます。

デフォルトの実装では、何も処理しません。

内部実装

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

/*protected virtual */Void SFYMenu::HandleSelectDownKey(Void)
{
    return;
}// SFYMenu::HandleSelectDownKey //

参照

SFYMenu::SetSelectDownKey | SFXEvent | キーイベント[SFEVT_KEY]

解説

この関数は、SFYMenu::SetSelectLeftKey 関数によって設定された LEFT キーの SFEVT_KEY イベント （キーイベント[SFEVT_KEY]）を受信したときに呼び出されます。

開発者は、独自の処理のためにこの関数をオーバーライドできます。

デフォルトの実装では、何も処理しません。

内部実装

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

/*protected virtual */Void SFYMenu::HandleSelectLeftKey(Void)
{
    return;
}// SFYMenu::HandleSelectLeftKey //

参照

SFYMenu::SetSelectLeftKey | SFXEvent | キーイベント[SFEVT_KEY]

解説

この関数は、SFYMenu::SetSelectRightKey 関数によって設定された RIGHT キーの SFEVT_KEY イベント （キーイベント[SFEVT_KEY]）を受信したときに呼び出されます。

開発者は、独自の処理のためにこの関数をオーバーライドできます。

デフォルトの実装では、何も処理しません。

内部実装

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

/*protected virtual */Void SFYMenu::HandleSelectRightKey(Void)
{
    return;
}// SFYMenu::HandleSelectRightKey //

参照

SFYMenu::SetSelectRightKey | SFXEvent | キーイベント[SFEVT_KEY]

解説

この関数は、SFYMenu::SetSelectUpKey 関数によって設定された UP キーの SFEVT_KEY イベント （キーイベント[SFEVT_KEY]）を受信したときに呼び出されます。

開発者は、独自の処理のためにこの関数をオーバーライドできます。

デフォルトの実装では、何も処理しません。

内部実装

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

/*protected virtual */Void SFYMenu::HandleSelectUpKey(Void)
{
    return;
}// SFYMenu::HandleSelectUpKey //

参照

SFYMenu::SetSelectUpKey | SFXEvent | キーイベント[SFEVT_KEY]

解説

この関数は、 メニューが自動的に閉じるまでの時間を、前回 SFYMenu::ScheduleTimer 関数で設定された時間に再設定します。

参照

SFYMenu::ScheduleTimer | SFYMenu::CancelTimer

解説

この関数は、 引数に指定した時間が経過しても操作キーまたは ESCAPE キーが押下されなかった場合、 ESCAPE キーを押下したときと同等の処理が行われるようにタイマーをスケジュールします。[単位：ミリ秒]

	タイマー処理コールバックの登録と解除
	指定した時間が経過すると、 SFYMenu::HandleEscapeKey 関数を呼び出し、 画面を再描画するタイマー処理コールバックを登録します。 指定した時間の経過するまでに、 SFYMenu::SetOperateKey 関数で設定する操作キー、または SFYMenu::SetEscapeKey 関数で設定する ESCAPE キーが押下されると、 このタイマー処理コールバックをキャンセルします。 サスペンド時にこのタイマー処理コールバックが登録されていると、 自動的に解除し、レジューム時に再び登録します。 その他、メニューの有効状態が無効になったときにこのタイマー処理コールバックが登録されていると、 自動的に解除します。

参照

SFYMenu::HandleEscapeKey | SFYMenu::CancelTimer | SFYMenu::RewindTimer | SFYMenu::SetOperateKey | SFYMenu::SetEscapeKey | 状態

解説

この関数は、メニューの ESCAPE キーを設定します。

この関数で設定されたキーの SFEVT_KEY イベントが発生すると、 SFYMenu::HandleEscapeKey 関数が実行されます。

デフォルト値: AVK_CLR

参照

SFYMenu::HandleEscapeKey | SFYMenu::GetEscapeKey | AVKType

解説

この関数は、メニューの操作キーを設定します。

この関数で設定されたキーの SFEVT_KEY イベントが発生すると、 SFYMenu::HandleOperateKey 関数が実行されます。

デフォルト値: AVK_SELECT

参照

SFYMenu::HandleOperateKey | SFYMenu::GetOperateKey | AVKType

解説

この関数は、メニューの DOWN キーを設定します。

この関数で設定されたキーの SFEVT_KEY イベントが発生すると、 SFYMenu::HandleSelectDownKey 関数が実行されます。

デフォルト値: AVK_DOWN

参照

SFYMenu::HandleSelectDownKey | SFYMenu::GetSelectDownKey | AVKType

解説

この関数は、メニューの LEFT キーを設定します。

この関数で設定されたキーの SFEVT_KEY イベントが発生すると、 SFYMenu::HandleSelectLeftKey 関数が実行されます。

デフォルト値: AVK_LEFT

参照

SFYMenu::HandleSelectLeftKey | SFYMenu::GetSelectLeftKey | AVKType

解説

この関数は、メニューの RIGHT キーを設定します。

この関数で設定されたキーの SFEVT_KEY イベントが発生すると、 SFYMenu::HandleSelectRightKey 関数が実行されます。

デフォルト値: AVK_RIGHT

参照

SFYMenu::HandleSelectRightKey | SFYMenu::GetSelectRightKey | AVKType

解説

この関数は、メニューの UP キーを設定します。

この関数で設定されたキーの SFEVT_KEY イベントが発生すると、 SFYMenu::HandleSelectUpKey 関数が実行されます。

デフォルト値: AVK_UP

参照

SFYMenu::HandleSelectUpKey | SFYMenu::GetSelectUpKey | AVKType

参照

SFYResponder::GetType | SFYResponder::SetType