API version 1
- ‐
popupMenu¶
ポップアップメニューを表示します。
呼出形式一覧
呼出形式 |
説明 |
|---|---|
integer popupMenu(string menu_1[, string menu_2[, ... menu_N]]) |
階層化されたStringオブジェクトでメニューを指定します。 メニューの選択肢に自動的に割り当てられたID番号が返ります。 IDは、メニューの先頭要素が1となります。階層化されたメニューは、「上位の要素の値 × 100 + n」がサブメニューのID番号となります。 |
integer popupMenu(CRS::Common::Core::XmlDocument xmlData) |
メニュー定義XMLデータでメニューを指定します。 |
integer popupMenu(CRS::Common::Core::JsonDocument jsonData) |
メニュー定義JSONデータでメニューを指定します。 |
戻り値一覧
戻り値 |
説明 |
|---|---|
integer |
メニュー項目に割り当てられたID値 メニューが選択されなかった場合は、0が返ります。 |
引数一覧
引数 |
説明 |
|---|---|
menu_1 |
メニューの選択肢を文字列で指定します。
|
menu_2 |
メニューの2番目の項目 |
menu_N |
メニューのN番目の項目 |
xmlData |
メニュー定義XMLデータ |
jsonData |
メニュー定義JSONデータ |
例外
なし
メニュー定義XMLの書式
メニュー要素
要素名 |
説明 |
親要素 |
属性 |
|---|---|---|---|
menuitem |
メニュー要素です。メニューの各項目、サブメニューの親項目になります。 |
ルート、menuitem |
id、title、checked、grayed |
separator |
セパレータ要素です。メニューに区切り線を挿入します。 |
ルート、menuitem |
なし |
メニュー属性
属性名 |
説明 |
指定できる値 |
|---|---|---|
id |
メニューIDです。選択されたメニューのIDがメソッドの戻り値になります。 |
整数値 |
title |
メニューに表示されるタイトルです。 |
文字列 |
checked |
チェックマークの有無です。"true"を設定するとメニューの左側にチェックマークが表示されます。 |
"true" |
grayed |
メニューの有効／無効を指定します。"true"を設定するとメニューが無効状態になります。 |
"true" |
使用例
例1）文字列での指定
var m1 = new String("menu1"); /* id=1 */
var m2 = new String("menu2"); /* id=2 */
var m3 = new String("-");
var m4 = new String("menu3"); /* id=4 */
var s1 = new String("*sub-menu1"); /* id=201 */
var s2 = new String("sub-menu2"); /* id=202 */
var s3 = new String("~sub-menu3"); /* id=203 */
m2.append(s1);
m2.append(s2);
m2.append(s3);
var id = popupMenu(m1, m2, m3, m4);
例2）XMLでの指定
var x = new XmlDocument();
x << xml <<-
<?xml version="1.0" encoding="UTF-8"?>
<menudefine>
<menuitem id="1" title="menu1" />
<menuitem id="2" title="menu2" checked="true" />
<separator />
<menuitem id="3" title="menu3">
<menuitem id="11" title="menu11" />
<menuitem id="12" title="menu12" grayed="true" />
<separator />
<menuitem id="13" title="menu13" checked="true">
<menuitem id="21" title="menu21" />
<menuitem id="22" title="menu22" />
</menuitem>
</menuitem>
</menudefine>
->>;
var id = popupMenu(x);
例3）JSONでの指定
var j = new JsonDocument;
j << json <<-
{
"menudefine": {
"menuitem": [
{
"@id": "1",
"@title": "menu1"
},
{
"@checked": "true",
"@id": "2",
"@title": "menu2"
},
{
"@id": "3",
"@title": "menu3",
"menuitem": [
{
"@id": "11",
"@title": "menu11"
},
{
"@grayed": "true",
"@id": "12",
"@title": "menu12"
},
{
"@checked": "true",
"@id": "13",
"@title": "menu13",
"menuitem": [
{
"@id": "21",
"@title": "menu21"
},
{
"@id": "22",
"@title": "menu22"
}
]
}
],
"separator": ""
}
],
"separator": ""
}
}
->>;
関連項目
XmlDocument 、 JsonDocument クラス
Object.append メソッド