CHECK_CURRENT_FORMファンクション

RAMPが画面を表示しているかどうかを確認します。

構文

CHECK_CURRENT_FORM(sFormName [, sMessageText1] [, sMessageText2] ...)

パラメータ

sFormName	必須。フォーム名を指定する文字列。
sMessageText1	省略可能。送信する最初のメッセージ文字列。
sMessageText2	任意。最初のメッセージ文字列と連結する文字列(各文字列の間には区切りスペースが自動的に挿入されます)。

戻り値

ブール値。次のいずれかの値を返します。

true	現在表示されているフォームに指定されたフォーム名があります。
false	現在表示されているフォームに指定されたフォーム名がありません。

備考

スクリプトまたはユーザーが特定の画面に進んだかどうか、または前の画面で中止したかどうかを確認するために使用します。

CHECK_CURRENT_FORMは、falseを返した場合、現在のRAMP画面を自動的に非表示にして所定のメッセージを表示します。

予定の画面が到着したこと、および到着していない場合に現在の画面がまだ表示されていることをスクリプトでテストしたい場合は、CHECK_CURRENT_FORMファンクションを使用せずに、代わりに以下を使用する必要があります。

if (CURRENT_FORM() == "My_Form");

画面上の検証エラーを処理するスクリプトを記述する場合は、検証エラーが発生しても現在の画面を表示するのが一般的であり、ユーザーは想定される次の画面に進みません。このため、この状況ではCHECK_CURRENT_FORMを使用するべきではありません。

例

if ( !(CHECK_CURRENT_FORM("uItemMasterBrowse","Unable to navigate to form uItemMasterBrowse")) ) return;