「ポップアップメニューを手軽に扱う」の版間の差分

マクロではないのですが、Meryのポップアップメニューを手軽に扱える関数を書いてみました。

function ShowPopupMenu(menu_obj, position, separator, esc){

     var MAX_NEST = 5;//ネストの最大深度

     }

}

== 簡単な使い方 ==

var x = ShowPopupMenu(["Spring","Summer","Autumn","Winter"] );

Document.Write(x);

選択された文字列が挿入されます。

== リファレンス ==

function ShowPopupMenu(

     menu_obj : Object | Array,

     esc : Anything

)

'''返り値''' : 選択されたメニューに対応する値。後述。

第1引数に配列を指定するとその配列内の要素をメニューに表示します。

var list = ["メニュー1","メニュー2","メニュー3","メニュー4"]

SowPopupMenu関数の返り値は選択された要素になります。

オブジェクトのキーがメニューに表示ます。キーに対応する値が返り値になります。（値が関数オブジェクトの時は後述。）

var menu = {};

menu["メニュー1"] = "メニュー1";

menu["メニュー2"] = 2;

こうするとサブメニューを作れます。

menu["グループ1"] = {};

menu["グループ1"]["サブメニュー1"] = "SubMenu1";

連続したハイフン4つ（----）をキー内に含む場合セパレータになります。

menu["----"] = 0; //何らかの値を入れておく。

list = ["menu1","menu----2","menu3"] //配列でも可能。

=== 使用例 ===

var menu = {};

menu["グループ1"]["----"] = 0;

menu["グループ1"]["サブメニュー2"] = "Submenu2";

このように指定することも可能です。

var menu = {

     "メニュー1" : "メニュー1",

     }

}

=== 返り値 ===

オブジェクトでメニューを定義するする場合、値が関数オブジェクトかそれ以外かで返り値が変わります。

関数オブジェクトを指定するとその関数を実行して、その関数の返り値がShowPopupMenu関数の返り値になります。

function func1(){

     Document.Write("func1");

var menu = {};

menu["func1"] = func1; // func1() 、ではない。（括弧は付けない）

「func1」がエディターのキャレット位置に挿入され、0が返ります。

もちろんfunctionリテラルで直接書いてもかまいません。

menu["func2"] = function(){Alert("func2");};

関数オブジェクト以外を値とした場合はその値がそのまま返ります。

第2引数にmePosMouseを指定するとマウスカーソルの位置にメニューが表示されます。

ShowPopupMenu(menu, mePosMouse)

それ以外の値の時はキャレット位置に表示します。

第3引数にfalseを指定するとセパレーターを挿入しなくなります。また文字列を指定するとその文字列が含まれるメニューをセパレータにします。それ以外の値は無視します。

ShowPopupMenu(menu,0,false) // セパレーターを挿入しない

ShowPopupMenu(menu,0,"ああああ") // 「ああああ」が含まれるメニューをセパレータにします。

第4引数でメニューをESCキーで閉じた時の挙動を変更できます。デフォルトではそこでスクリプトの実行が終了します。

関数オブジェクトを指定するとその関数を実行し、それ以外の値（undefinedを除く）の場合はその値を返します。

ShowPopupMenu(menu,0,0,-1)

上の例ではESCキーを押してもスクリプトは終了せず、関数は-1を返します。

デフォルトではメニューの最大階層は5（2行目のMAX_NESTの値を書き換えることで変更可能）になっています。これは

var menu = {};

menu["メニュー1"] = 1;

menu["グループ1"] = menu;

といった再帰定義で無限ループになるのを防ぐためです。

=== Tips ===

menu["Now?"] = new Date();

こう書くとマクロを実行したとき（正確にはオブジェクトに代入した瞬間）の時間になります。これをメニューが選択された時の時間にするときは

menu["Now!!"] = function(){return new Date();};

こうやってfunctionでくるんでください。

== おまけ ==

サブメニューとかいいから簡単に使いたいという人向け。

function ShowMenuMini(list){

     var pos = 0;

     }

}

=== リファレンス ===

function ShowMenuMini(

     list : Array

)

引数には配列を指定する。選択された要素のインデックスが返り値になる。

=== 使い方 ===

var menu = ["Morning","Afternoon","Evening"];

var value = ["あんぱん","ジャムパン","カレーパン"];

Document.Write(value[ShowMenuMini(menu) ] );

なお、セパレーターを挿入する機能はオフにしてあります。セパレータを使いたい場合は8行目のコメントアウトを外してください。その場合はメニュの表示と返り値がずれることに注意してください。

var menu = ["Morning","Afternoon","----","Evening"];

var value = ["あんぱん","ジャムパン","ここが選ばれることはない","カレーパン"];

Document.Write(value[ShowMemuMini(menu) ] );