5.9　システムボタンプラグイン（その２）

＜setOptions メソッドの引数 elm に指定できる要素（sysbtopt マクロに指定できる属性）＞

要素（属性）名	設定項目	値
forevisible	表画面のボタンの表示・非表示	true：表示、false：非表示
backvisible	裏画面のボタンの表示・非表示	true：表示、false：非表示
left	１番目のボタン（セーブ用ボタン）の左端位置	数値
top	１番目のボタン（セーブ用ボタン）の上端位置	数値

	確かに dateopt マクロに似てるね。
	まぁ sysbtopt マクロの方がオリジナルなんだけどね。じゃ setOptions メソッドを見ていくね。
	はーい。
	まず最初に setObjProp メソッドを使って表画面と裏画面のボタンの表示状態を設定してるよね。
	ねぇ、なんか if がヘンな位置にあるんだけど…？
	あぁ、これは if 演算子だよ。
	if 演算子？それって普通の if と何か違うの？
	今まで使ってた if は演算子じゃなくて制御構文を作るためのキーワードだから、厳密に言うと違うものなんだけど…まぁ直感的には今まで使ってきた if も if 演算子もほぼ同じって考えてもいいかな。
	えっと…結局どういうことなの？
	if 演算子の後ろに条件が書いてあるでしょ？
	うん。 elm.forevisible !== void って書いてあるよね。
	この条件が成立してれば、setObjProp メソッドが呼び出されるの。
	それってつまり…

	…ってこと？
	そ。こう書いても同じ意味になるよ。
	じゃあ if 演算子って普通の if と同じ使い方ができるってこと？
	ううん、そうじゃないよ。まず if 演算子はブロックが作れないんだ。だから条件が成立した時に実行されるのは条件の左側に書いてある１文だけ。つまりこんな使い方はできないってこと。

	あ、そうなんだ。
	あと if 演算子はあっても else 演算子とかはないから、条件が成立しなかった時に実行したいスクリプトがある場合にも使えないよ。まぁ else が要らない単純な条件分岐の時には if 演算子を使うとちょっと簡単に書けるよね。
	ふぅん…なるほどねぇ。
	じゃ setOptions メソッドに戻るね。 setObjProp メソッドを呼び出してる部分はわかるよね？
	えっと… elm に forevisible 要素が指定されてたら、表画面のボタンの visible プロパティを forevisible 要素に指定されてる値にして、 backvisible 要素が指定されてたら、裏画面のボタンの visible プロパティを backvisible 要素に指定されてる値にするんだよね？
	ん、そう。あと setObjProp メソッドを呼び出す時に foreSeen と backSeen メンバ変数の値も設定してるよね。
	このメンバ変数って onMessageHiddenStateChanged メソッドで使うんだよね。
	うん、§4.10 の時と同じ使い方だよ。で、その後は位置の設定だね。
	えっと、さっき if 演算子はブロックが使えないって言ってたよね？
	うん、そうだけど？
	elm.left !== void が条件になってる所って、if 演算子の左側で x と poschanged を設定してるけど、これってブロックになってるんじゃないの？
	ううん、これはブロックじゃないよ。
	えっ、そうなの？
	ブロックは { と } で囲まれた部分のこと。 if 演算子の左側は ( と ) で囲まれてるでしょ？
	あ、ホントだ。でも x = +elm.left と poschanged = true って別々の文でしょ？
	普通はそうなんだけど、順次演算子が使われてるから、これは２つで１つの文とみなされるの。
	順次演算子？
	x = +elm.left と poschanged = true が , （カンマ）でつないであるでしょ。この , が順次演算子で、これで複数の文をつなげると、全体として１つの文とみなされるんだ。ちなみに実行順序は左から右だから、x = +elm.left が実行された後に poschanged = true が実行されるよ。
	う～ん…なんかすごくややこしいね…
	まぁ、こうすれば１行で条件文が書けるんだけど、もちろん普通の if を使って…

	…って書いてもいいよ。
	そうだね。こっちのが分かりやすいかも。
	じゃ、このスクリプトが何してるか説明してみて。
	えっとね… elm に left 要素が指定されてる時は x に elm.left を数値にした値を代入して、 top 要素が指定されてる時は y に elm.top を数値にした値を代入するんだよね。あと、left か top のどっちかが指定されてると、 poschanged が true になるよね。
	ん。じゃあ、poschanged って何のための変数かわかる？
	これって left か top が指定してある時だけ realign メソッドを呼び出してボタンの位置を設定するための変数だよね。
	そ。§4.9 でも dateChanged っていう変数を使って同じようなことをやったよね。
	うん。
	んじゃこれで setOptions メソッドは OK だから、次はイベントハンドラの方を見ていくね。まずは onStore メソッドから。

	これって f の systemButtons っていう要素に辞書配列を作って、 foreSeen と backSeen と x と y の値をそれぞれ foreVisible と backVisible と left と top っていう要素に書き込んでるんだよね。
	そうそう。だからボタンの表示状態と表示位置が記録されてる systemButtons の中身がセーブデータに保存されるってわけだね。
	これも４章でやったのと似てるね。
	※§4.11参照。
	うん。DatePlugin クラスのイベントハンドラも大体 SystemButtonPlugin クラスのに似せて作ったからね。じゃ次は onRestore メソッド。

	これも４章で作ったのと似てると思うから、どうなってるか説明してみて。
	※§4.12参照。
	うん、おっけー。 …あっ、その前にちょっと聞きたいんだけど。
	ん、なに？
	setOptions メソッドの引数の辞書配列の初期化の仕方がいつもと違うんだけど、これって何か特別な初期化とかしてるの？
	ううん、別に特別な初期化とかじゃないよ。辞書配列の初期化のやり方には今まで使ってた %["要素名" => 値] っていう形式の他に、ここで使われてる %[要素名 : 値] っていう形式があるんだ。
	えっと、それってつまり、

って書くのと…

	って書くのは同じってこと？
	そ。そういうこと。あとはわかる？
	最初に条件分岐のところでセーブデータがあるかどうかチェックして、セーブデータがなかったら dic が void になるから if の方のブロックの中身が実行されて、セーブデータがあったら else の方のブロックの中身が実行されるんだよね。
	うんうん。
	それで、セーブデータがなかったら setObjProp メソッドを呼び出して、表画面と裏画面のボタンの visible を false にして、セーブデータがあったら setOptions メソッドを呼び出して、セーブデータに保存されてる値を使ってボタンの表示状態と表示位置の設定をしてるんだよね。
	うん、バッチリ。
	でしょ～。
	それじゃ次は onStableStateChanged メソッドね。

	このメソッドって４章で出てこなかったよね？
	うん、DatePlugin クラスには必要なかったからね。 onStableStateChanged メソッドは、安定状態から走行状態に切り替わった時と、走行状態から安定状態に切り替わった時に呼び出されるメソッドなんだ。
	安定状態とか走行状態って？
	安定状態っていうのは s タグ、l タグ、 p タグでシナリオの進行が停止してる状態のこと。走行状態っていうのはそれ以外の状態のことね。
	へぇ、そういうのを安定状態とか走行状態って呼ぶんだ。えっと、このメソッドって何のために使ってるの？
	安定状態の時だけボタンが使えるようにするために使ってるの。 setObjProp メソッドでボタンの enabled を設定してるでしょ。
	ほんとだ。あ、第３引数の stable っていうのは？
	stable は onStableStateChanged メソッドの引数で、安定状態になった時には true になってて、走行状態になった時には false になってるんだ。
	そっか。だから安定状態の時だけ enabled が true に設定されてボタンが使えるようになるんだね。
	そういうこと。じゃ次は onMessageHiddenStateChanged メソッド。

	これって DatePlugin クラスの onMessageHiddenStateChanged メソッドと同じようにボタンの visible を設定してるよね？
	うん。メッセージレイヤが非表示になった時はボタンの visible を false にして、メッセージレイヤが表示された時は、表画面のボタンと裏画面のボタンの visible をそれぞれ foreSeen と backSeen に設定することで、非表示になる前の状態に戻してるわけだね。じゃあ次は onCopyLayer メソッド。

	コピーしてるのって visible 関係だけだね。
	DatePlugin クラスの onCopyLayer メソッドだと画像と位置とかもコピーしてたけど、システムボタンの場合は表画面と裏画面の画像と位置はいつも同じだから、表示状態をコピーするだけで OK なんだ。
	そっか、なるほどね。
	じゃ、最後は onExchangeForeBack メソッド。

function onExchangeForeBack()
{
    // 裏と表の管理情報を交換

    // children = true のトランジションでは、トランジション終了時に
    // 表画面と裏画面のレイヤ構造がそっくり入れ替わるので、
    // それまで表画面だと思っていたものが裏画面に、裏画面だと思って
    // いたものが表画面になってしまう。ここのタイミングでその情報を
    // 入れ替えれば、矛盾は生じないで済む。

    // ここで表画面、裏画面のレイヤに関して管理すべきなのは
    // foreButtons と backButton 、foreSeen と backSeen の変数だけ
    var tmp;

    tmp = backButtons;
    backButtons = foreButtons;
    foreButtons = tmp;

    tmp = backSeen;
    backSeen = foreSeen;
    foreSeen = tmp;
}

	まぁこれも基本的に DatePlugin クラスの onExchangeForeBack メソッドとやってることは同じだね。
	でもなんかこっちの方が複雑だよ？
	こっちの onExchangeForeBack メソッドは入れ替えの演算子(<->)を使わずに、 tmp っていう変数を使って値を入れ替えてるだけで、やってることは同じだよ。ちなみに、<-> 演算子を使うとこうなるよ。

	あ、ホントだ。 DatePlugin クラスの時みたいになってるね。
	さてと、これで SystemButtonPlugin クラスを一通り見終わったから、次回はこれをカスタマイズして、§5.1 のメッセージウィンドウを作っていくね。
	セーブとロードの他にもメッセージスキップとかオートモードとかのボタンもつけるんだよね？
	そ。あとボタンは §5.6 と §5.7 で作ったクラスを使って作るから。
	うん、りょ～かい！
	それじゃ、また次回ね！

	今回は SystemButtonPlugin クラスの残りのメソッドを見ていくね。
	残ってるのってイベントハンドラだよね？
	ん、大体はね。でもその前にまず setOptions メソッドから。

	setOptions メソッドって、４章で作った DatePlugin クラスにもあったよね？ってことは、これってマクロから呼び出すメソッドなの？
	※§4.9参照。
	うん。DatePlugin クラスのその辺の仕様は SystemButtonPlugin クラスに合わせて作ったからね。だからマクロ定義もほぼ同じ。

Section 5.9 システムボタンプラグイン（その２）

Section 5.9　システムボタンプラグイン（その２）