QR Get command status
QR Get command status ( area ; command {; value} ) -> 戻り値
| 引数 | 型 | 説明 | |
|---|---|---|---|
| area | Integer | → | エリア参照 |
| command | Integer | → | コマンド番号 |
| value | Integer, Text | ← | 選択されたサブアイテムの値 |
| 戻り値 | Integer | ← | コマンドの状態 |
このコマンドはスレッドセーフではないため、プリエンプティブなコードには使えません。
説明
QR Get command status コマンドは、commandが使用不可であれば0を、使用可能であれば1を返します。
valueは、選択されたサブアイテムがあれば、その値を返します。例えば、選択されたコマンドがフォントメニュー (1000) であり、選択されたフォントが“Arial”である場合、valueには“Arial”が返されます。また、選択されたコマンドがカラーメニュー (1002,、1003、または1004) である場合、valueにはカラー番号が返されます。
このコマンドは、次の2つの状況で使用することができます:
- あるコマンドが使用可であるか使用不可であるかを調べる単純な判定文として。
- QR ON COMMANDコマンドでインストールされたメソッドにおいてこのコマンドを使用すると、選択されたサブアイテムを知ることができます。そのメソッドでは、$1がエリアの参照番号となり、$2がコマンド番号となります。 commandにはには値または定数テーマの定数を渡すことができます。
無効なarea番号を渡した場合、エラー番号-9850が生成されます。
無効なcommand引数を渡した場合、エラー番号-9852が生成されます。