マクロは、基本マクロ形式または拡張マクロ形式で保管することができます。ホスト端末を使用してマクロを記録した場合、そのマクロは基本マクロ形式で保管されます。マクロを編集し、変数と演算式に対するサポートを追加すると、マクロは拡張マクロ形式に切り替えられます。
基本マクロ形式により、整数、倍精度、ブール (true または false)、およびストリングを含むリテラル値を入力できます。
拡張マクロ形式では、基本マクロ形式の機能に加えて、次の追加機能が提供されます。
基本マクロ形式を選択したか、拡張マクロ形式を選択したかに応じて、マクロ内でストリングと 2 つの特殊文字 (単一引用符 (') と円記号 (¥)) の書き込み方法が異なります。 また、基本マクロ形式では通常の文字である一部の文字を、拡張マクロ形式では演算子として使用します。これらの文字には例えば、正符号 (+) や大なり記号 (>) があります。
ただし、これらの規則は、画面 (名前は除く)、画面アクション、および変数とタイプの定義に使用される、エディターのタブ上に配置されている入力フィールドのみに影響します。
その他の入力フィールドの場合は、常に基本マクロ形式の規則を使用してください。
以下のセクションで、こうした規則の違いについて説明します。
基本マクロ形式を選択した場合は、画面 (名前は除く)、画面アクション、および変数とタイプの定義に使用される、エディターのタブ上に配置されている入力フィールドに対しては、次の規則を使用します。
apple banana To be or not to be John Smith
New Year's Day c:¥Documents and Settings¥User
拡張マクロ形式を選択した場合は、画面 (名前は除く)、画面アクション、および変数とタイプの定義に使用される、エディターのタブ上に配置されている入力フィールドに対しては、次の規則を使用します。
'apple' 'banana' 'To be or not to be' 'John Smith'
'New Year¥'s Day' c:¥¥Documents and Settings¥¥User
基本または拡張のどちらかの形式のマクロは、他方の形式に変換することができます。変換プロセスは、基本形式から拡張形式に変換する場合には自動的に行われますが、拡張形式から基本形式に変換する場合には手動で行う必要があります。両方の変換について次に説明します。
マクロ形式は、VME のマクロ・プロパティーの「変数およびタイプ」タブ上にある「変数および演算式のサポート可能」チェック・ボックス、または AME の「マクロ」タブ上にある「マクロで変数と演算式を使用する」チェック・ボックスを選択することにより、簡単に基本マクロ形式から拡張マクロ形式に変換できます。その結果、マクロ・オブジェクトは次のことを行います。
つまり、マクロ・オブジェクトは、マクロ内のすべてのストリングを検出し、それらを単一引用符で囲み、存在するすべての ' と ¥ を、¥' と ¥¥ に変更します。また、すべての演算子文字は演算子として扱われます。
拡張マクロ形式から基本マクロ形式へのマクロの変換は、非常に困難な場合があります。 変数と演算式を使用するためのオプションのチェックマークを外しても、自動変換は行われません。このとき自動的に起こるのは、マクロの拡張機能が使用不可になることだけです。
ストリング表示のすべてと 2 つの特殊文字を、一度に 1 つずつ手動で変更して、元の基本表示に戻す必要があります。 さらにそのマクロ内にある、拡張機能が使用されているインスタンスすべてを削除する必要があります。削除しないと、スクリプトを保管または実行しようとするときに、エラーまたは予期しない結果を検出する場合があります。 残っている拡張マクロ形式の演算子文字は、演算子ではなくリテラル文字として処理されます。
マクロ・オブジェクトは、次の標準データ・タイプをサポートします。
これらのタイプについては、以降のサブセクションで説明します。
ブール値 true と false は、大文字と小文字の任意の組み合わせで書き込むことができます (例えば、True、TRUE、FALSE、falsE など)。
ブール値を必要とするフィールドの例は、マクロ画面定義用の「エントリー画面」、「終了画面」、および「一時画面」フィールドです。条件を true に設定するには true を入力し、false に設定するには false を入力してください。
ブール値はストリングではないため、決して単一引用符で囲まないでください。例えば、基本マクロ形式と拡張マクロ形式のいずれを使用するとしても、ブール値は必ず true および false と記述し、'true' や 'false' とは記述しません。
ただし、ブールのコンテキスト内では、ストリング値がブール値に変換されます (ブールへの変換を参照)。したがって、拡張マクロ形式を使用する場合は、ブール・フィールド内にストリング 'true' を入力できます。これは、マクロ・エディターにより、'true' ストリングがブール値 true に変換されるからです。
整数は、コンマまたはその他の区切り文字なしに書き込まれます。 例えば、次のとおりです。
10000 0 -140
マクロ・エディターには、すべて大文字を使用して書き込まれる複数の整数定数があります。これらの値は、ストリングとしてではなく、整数として扱われます。 例えば、次のとおりです。
倍精度は、コンマまたはその他の区切り文字なしに書き込まれます。 例えば、次のとおりです。
3.1416 4.557e5 -119.0431
ストリングは任意の一連の文字であり、ブランク文字を先行させたり、末尾に付けたり、間に入れたりすることができます。 マクロが使用するように設定されている形式が基本マクロ形式か、拡張マクロ形式かに応じて、一部の入力フィールド内のストリングの表記が異なります。ストリングと非英数字文字の表記を参照してください。
次の例では、拡張マクロ形式表示を使用します。
'apple' 'User4' 'Total number of users' ' This string has 3 leading blanks.' 'This string has 3 trailing blanks. '
次に、基本マクロ形式表示を使用する場合の同じサンプルを示します。
apple User4 Total number of users This string has 3 leading blanks. This string has 3 trailing blanks.
基本マクロ形式では、末尾ブランクを使用できますが、検出が困難であることに注意してください。末尾ブランクがあるかどうか分からない場合は、ソース表示でストリングの表記を確認してください。
フィールド変数を参照してください。
値 null は予約語であり、ストリングではありません。 インポートされた Java クラスに属するオブジェクトの代わりに使用される場合、Java 言語における意味と同じです。
空ストリングを表すために null を使用しないでください。 空ストリングを表すには、拡張マクロ形式では 1 対の単一引用符 ('') を使用し、基本マクロ形式では何も使用しないでください。 (例えば、ストリング変数に割り当てることによって) ストリング・コンテキストで値 null を使用する場合、マクロ・エディター またはマクロ・ランタイムは、値 null をストリング 'null' に変換します。
演算式を使用するには、最初に VME のマクロ・プロパティーの「変数およびタイプ」タブ上にある「変数および演算式のサポート可能」チェック・ボックス選択するか、AME の「マクロ」タブ上にある「マクロで変数と演算式を使用する」チェック・ボックスを選択する必要があります。詳しくは、ストリングと非英数字文字の表記を参照してください。
算術演算子を表 2 に示します。
| 演算子 | 働き |
|---|---|
| + | 加算 |
| - | 減算 |
| * | 乗算 |
| / | 割り算 |
| % | モジュロ |
演算式では、条件は左から右に評価されます。 演算子の優先順位は *、/、%、+、- です。例えば、次の式の結果は 8 です。
4 * 2 + 16 / 8 - 1 * 2
次のように小括弧を使用すると、式が評価される順序を指定できます。
(4 * 2) + (16 / 8) - (1 * 2) は 8 になります。 4 * (( 2 + 16) / (8 - 1)) * 2 は 20.571 になります。
演算式は、算術値を使用できる場所であれば、ほとんどどこでも使用できます。 例えば、次のとおりです。
ストリング連結演算子の正符号 (+) は、マクロ内で変数と演算式を使用する場合にのみ、使用できます。基本マクロ形式と拡張マクロ形式を参照してください。
複数の連結が入っているストリング式を作成することができます。 次の例では、拡張形式に必要なストリング表記を使用します (ストリングと非英数字文字の表記を参照)。
式: 評価結果:
'Hello ' + 'Fred' + '!' 'Hello Fred!'
'Hi' 'There' (エラー。ストリングを連結するには、
1 つの + 演算子が必要です)
'Hi' + 'There' 'HiThere'
条件演算子を表 3 に示します。
| 演算子 | 働き |
|---|---|
| == | 等しい |
| != | 等しくない |
| > | より大 |
| < | より小 |
| >= | より大か等しい |
| <= | より小か等しい |
論理演算子を表 4 に示します。
| 演算子 | 働き |
|---|---|
| && | AND |
| || | OR |
| ! | NOT |
HTML または XML エディターで && と入力する場合は、&& と入力する必要がある場合があります。
条件式では、条件は左から右に評価されます。 演算子の優先順位は、上記の表にリストされている順序と同じです。 次のように小括弧を使用すると、式が評価される順序を指定できます。 例えば、次のとおりです。
式: 評価結果: (4 > 3) true !(4 > 3 ) false (4 > 3) && (8 > 10) false (4 > 3) || (8 > 10) true
条件式には、演算式、変数、およびインポートされた Java クラスのメソッドの呼び出しを含むことができます。
条件演算子と論理演算子は、次の 2 つのコンテキストでしか使用できません。
データの項目が 1 つの標準データ・タイプ (ブール、整数、倍精度、またはストリング) に属しているが、コンテキストが別の標準データ・タイプを必要とする場合、データの評価時 (マクロ・エディター がデータを保存するとき、またはマクロ・ランタイムがマクロを再生するときのいずれか) に、可能な場合は、コンテキストが必要とする標準データ・タイプに自動的に変換されます。
コンテキストの例は次のとおりです。
しかし、データを新しいデータ・タイプに変換できない (例えば、ストリング 123apple を整数に変換できない) 場合は、エラーが発生します。マクロ・エディターがエラー・メッセージを表示します。 マクロ・ランタイムは、マクロの再生を停止し、エラー・メッセージを表示します。
次のサブセクションでは、標準データ・タイプごとの変換について説明します。
ブール・コンテキスト内のストリング 'true' (または 'TRUE'、'True' など) は、ブール true に変換されます。ブール・コンテキスト内のその他のすべてのストリング ('false'、'1'、'apple' など) は、ブール false に変換されます。
'true' (ブール値が必要な入力フィールド内の値) は true に変換されます。 'apple' (ブール値が必要な入力フィールド内の値) は false に変換されます。
整数コンテキスト内の有効な整数形式のストリングは、整数に変換されます。
'4096' は 4096 に変換されます。 '-9' は -9 に変換されます。
倍精度コンテキスト内の有効な倍精度形式のストリングは、倍精度に変換されます。
'148.3' は 148.3 に変換されます。
倍精度と結合された整数は、倍精度になります。
10 + 6.4 は 16.4 に評価されます。
ストリング・コンテキスト内のブール、整数、または倍精度は、ストリングに変換されます。 (ブール値の true および false はストリングではありません。ブール・データを参照。) ストリング値を入力する必要がある入力フィールド (入力アクションの「ストリング」フィールドなど) に次の値が指定された場合、それらの値は指定された結果を評価します。
'The result is ' + true は 'The result is true' に評価されます。 FALSE (in an input field that requires a string) は 'false' に変換されます。 'The answer is ' + 15 は 'The answer is 15' に評価されます。 22 (ストリングが必要な入力フィールド内の値) は '22' に変換されます。 14,52 (ストリングが必要な入力フィールド内の値) は '14,52' に評価されます。
コンテキストに変換が必要であるが、データの形式がその変換に有効でない場合、マクロ・エディターはエラー・メッセージを表示します。例えば、入力アクションの「行」フィールドに「123apple」と入力すると、エラー・メッセージが表示され、前の値に復元されます。
特定の標準データ・タイプの即時値を受け入れるコンテキストはいずれも、同じデータ・タイプの任意のエンティティーも受け入れます。
例えば、入力フィールドがストリング値 (例えば、'Standard Dialog') を受け入れる場合、次のものも受け入れます。
同様に、入力フィールドがブール値 (true または false) を受け入れる場合、次のものも受け入れます。
マクロ機能におけるこうした柔軟性を認識すると、さらに強力なマクロを作成するのに役立ちます。
ストリング記述子や、その他のいくつかの記述子とアクションでは、行または列の負の値は、ホスト端末の最後の行または最後の列からのオフセットを示します。マクロ・ランタイムは、行または列の位置を次のように計算します。
actual row = (number of rows in text area) + 1 + (negative row offset) actual column = (number of columns in text area) + 1 + (negative column offset)
例えば、ホスト画面に 24 行のテキストがある場合、行座標 -1 は、実際の行座標 24 を示します (24 + 1 - 1 として計算)。 同様に、ホスト画面に 80 列のテキストがある場合、列座標 -1 は、実際の列座標 80 を示します (80 + 1 - 1 として計算)。
上記の行の計算では、OIA 行は無視されます。 例えば、ホスト画面が 25 行である場合、24 行のテキストしかありません。
この規則の利点は、ホスト端末の下部で長方形を指定する必要がある場合に、ホスト画面が 25 行、43 行、50 行のいずれであるかに関係なく、ここで示した計算方法を基に意図したとおりの結果が得られることです。同様に、ホスト端末の右側で長方形を指定する必要がある場合にも、ホスト画面が 80 列であるか 132 列であるかに関係なく、ここで示した計算方法を基に意図したとおりの結果が得られます。
| 行の負の値 | 24 行のテキストがあるホスト端末での実際の値 (OIA 行は無視): | 42 行のテキストがあるホスト端末での実際の値 (OIA 行は無視): | 49 行のテキストがあるホスト端末での実際の値 (OIA 行は無視): |
| -1 | 24 | 42 | 49 |
| -2 | 23 | 41 | 48 |
| -3 | 22 | 40 | 47 |
| 列の負の値 | 80 列のホスト端末での実際の値 | 132 列のホスト端末での実際の値 |
|---|---|---|
| -1 | 80 | 132 |
| -2 | 79 | 131 |
| -3 | 78 | 130 |
この規則を使用するかどうかに関係なく、少なくとも座標が (1,1) と (-1,-1) の長方形域は、ホスト端末のテキスト領域全体を意味することを忘れないでください。