メニュー項目を挿入関数

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

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

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

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

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

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

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

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

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

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

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