メニュー項目を挿入関数

メニュータグには、項目を挿入するサブメニューを指定します。

メニュータグを指定しない場合、項目はメニューのトップレベルに挿入されます。

メニューリファレンスは、VIのメニューバーのリファレンスまたは制御器のショートカットメニューです。このrefnumは、「現在のVIのメニューバー」関数、またはメニューイベントのメニューRefイベントデータフィールドで取得できます。

項目名は、メニューに挿入する項目を識別します。項目名は、メニューに表示される文字列です。項目名または項目タグのいずれかに配線できます。この場合、名前とタグは同じ値を含みます。1つの項目のみを挿入する場合、項目名に文字列を配線します。

項目タグは、メニューに挿入する項目を識別します。項目タグは、メニュー項目が選択されている場合に返される文字列です。項目名または項目タグのいずれかに配線できます。この場合、名前とタグは同じ値を含みます。1つの項目のみ挿入する場合、項目タグに文字列を配線します。

アプリケーション項目タグを使用して、アプリケーションメニュー項目を挿入します。

エラー入力は、このノードを実行する前に発生したエラーの状態を示します。この入力は、標準エラー入力として機能します。

項目の後は、項目を挿入する位置を指定します。項目の後には、既存の項目のタグ (文字列) またはメニューの位置指標 (ゼロベースの整数) を指定できます。メニューの最初に挿入するには、項目の後に0より小さい数字を配線します。メニューの終わりに挿入するには、メニューの項目数より大きい数値を配線します。アプリケーションタグを使用して、アプリケーション項目を挿入できます。アプリケーションタグAPP_SEPARATORを使用して、区切り線を挿入できます。関数は、必要に応じて提供されたタグに番号を追加することで、すべての挿入されたメニュー項目がメニュー階層に対して固有であることを確実にします。

メニューリファレンス出力は変更のないメニューリファレンスを返します。

項目タグ出力は、挿入された項目の実際のタグを返します。関数がメニュータグまたは項目の後 (タグ) を検出しない場合、関数はエラーを返します。

エラー出力には、エラー情報が含まれます。この出力は、標準エラー出力として機能します。