GET MENU ITEM PROPERTY
GET MENU ITEM PROPERTY ( menu ; menuItem ; property ; value {; process} )
引数 | 型 | 説明 | |
---|---|---|---|
menu | Integer | → | メニュー参照またはメニュー番号 |
menuItem | Integer | → | メニュー項目番号 または -1: 最後に追加された項目 |
property | Text | → | プロパティタイプ |
value | any | ← | プロパティ値 |
process | Integer | → | プロセス番号 |
このコマンドはスレッドセーフではないため、プリエンプティブなコードには使えません。
説明
GET MENU ITEM PROPERTY コマンドは、menuとmenuItem引数で指定したメニュー項目の、現在のプロパティ値を返します。
menuItemに-1を渡してmenuに最後に追加された項目を指定することもできます。
menuにはメニュー参照 (MenuRef) またはメニュー番号を渡します。メニュー参照を渡す場合、process 引数は必要なく、渡されても無視されます。メニュー番号を渡す場合、コマンドはカレントプロセスのメインメニューバー中の対応するメニューを考慮します。他のプロセスを指定したい場合、オプションのprocess 引数にその番号を渡します。
property 引数には、値を取得したいプロパティを渡します。“Menu Item Properties”テーマの定数またはカスタムプロパティに対応する文字列を使用できます。メニュープロパティとその値に関する詳細はSET MENU ITEM PROPERTY コマンドの説明を参照してください。
互換性に関する注意: デフォルトでは、value引数の変数が明示的にテキスト型として型指定あるいは宣言がされていなければ、コマンドは標準アクションの名前を返します。(廃止予定の)割り当てられた標準アクションの値定数テーマに定義されている数値を取得したい場合には、value引数の変数を倍長整数型で宣言する必要があります。