9.143 MESSAGE_BOX_ADD

メッセージ・ボックスのアセンブリ域に、新しいメッセージ行として、1つまたは複数の項目を追加します。通常、これらの項目は、後でMESSAGE_BOX_SHOW組み込み関数により表示されます。 

引数

戻り値

戻り値はありません。 

技術上の注記

• 項目リストに指定された1番目の項目により、新しいメッセージ行が開始されます。
• リストの2番目以降の項目は、前の項目と1桁のブランクで分けられます。
• 項目は、左揃えの文字列に変換され、後続のブランクは切り捨てられます。完全にブランク/NULLの項目は、1桁のブランクに変換されます。
• 引数が文字列変数で指定されている場合、最大長は256文字です。しかし、文字列リテラルの場合、最大長は48文字です。
• 連続してMESSAGE_BOX_ADDコマンドを呼び出せば、複数のメッセージがメッセージ・ボックス・アセンブリ域に追加されます。メッセージ・ボックスのメッセージ・アセンブリ域には最大で4096文字(自動挿入されたブランクや制御文字を含む)を含めることができます。アセンブリ域がその最大サイズに達すると、処理進行中または以降の追加操作または付加操作はすべて無視されます。このような状況が発生した時に通知またはエラーは表示されません。
• MESSAGE_BOX_SHOWコマンドが完了した時に、メッセージ・アセンブリ域はクリアされます。

例

「9.146 MESSAGE_BOX_SHOW」を参照してください。