パラメーター・リストのマクロへの引き渡し

通常の言語では、パラメーター・リストは、プログラムが動作するように指示し、エンド・ユーザーがプログラムを起動したときに指定する値の集合です。例えば、copy がファイルを現行ディレクトリーから別のディレクトリーにコピーするプログラムの名前なら、次のコマンド行の呼び出し

copy MyFile.txt c:\temp

により、コピー・プログラムを名前で呼び出して (copy)、コピー対象のファイル名 (MyFile.txt c:\temp)、および宛先ディレクトリー (MyFile.txt) を含むパラメーター・リスト (c:\temp) を指定します。

例えば、マクロ FileDownload がファイルをリモート・ホストからローカル・ワークステーションにダウンロードし、このマクロに変数 strRemoteFile と strLocalFile が含まれる場合、エンド・ユーザーは以下のパラメーター・リストを指定することができます。

strRemoteFile="NewData.123", strLocalFile="MyData.123"

エンド・ユーザーがマクロを再生するとき、マクロ・ランタイムは、パラメーター・ リストで指定された各変数を、パラメーター・リストで指定された値に初期設定します。マクロは、ファイル NewData.123 をリモート・ホストからダウンロードして、そのファイルを MyData.123 に名前変更します。

一般的に、マクロの作成者は以下の条件を満たす必要があります。

• パラメーター・リストで使用される変数を作成する。
• これらの変数内で、マクロの起動時に必要な情報をマクロに検索させる。

また、良いプログラムを書くために、マクロの作成者は以下の動作に注意する必要が あります。

• マクロ記述内 (マクロ・エディターの「マクロ (Macro)」 タブの「記述 (Description)」入力フィールド) でのパラメーター・リストの記述。
• 変数が不適切に初期化された場合のエンド・ユーザーへのメッセージの表示。

詳しくは、マクロ作成者の考慮事項 を参照してください。

エンド・ユーザーは以下の条件を満たす必要があります。

• パラメーター・リストを正しく指定する。

ただし、システム管理者は、パラメーター・リストの指定作業を、以下のいずれかで パラメーター・リストを事前定義することによって処理することができます。

• セッション構成 (セッション開始時にマクロが自動的に開始する場合)、または
• クリック時にパラメーター・リストを使用してマクロを再生するカスタマイズ されたボタン (メイン・ツールバーで作成)。

詳しくは、パラメーター・リストの指定 を参照してください。