Forguncy 10 オンラインヘルプ
アプリの開発 / 画面の設計 / セル / データ入力規則(セル)
このトピックで
    データ入力規則(セル)
    このトピックで

    入力規則の検証は、フォーカスアウト時とテーブルのデータ更新時に行われます。
    フォーカスアウト時に行わないようにするにはアプリケーション設定を参照してください。

    値の入力が可能なセル型において、データの入力規則を設定した場合、テーブルデータの更新コマンドの実行時に入力規則の検証が行われます。このとき、大きなページで画面に入りきらないセルで入力検証エラーが見つかった場合、自動的にその箇所へスクロールしフォーカスが設定されます。なお、検証処理が通らない場合には、テーブルデータの更新は行われません。

    以下のセル型にデータの入力規則を設定した場合、既定ではそのセルのフォーカスアウト時に入力規則の検証処理が行われます。リストビューの対する入力規則はデータ入力規則(リストビュー)を参照してください。

    データ入力規則では正常時または入力規則エラー時のスタイルを設定することができます。 詳細は入力セルのセルスタイルを参照してください。

    注意: フォーカス設定コマンドでは入力規則の検証処理は行われません。

    参考:ラジオグループで「その他」項目を選択した場合、入力規則の検証対象は「その他」のテキストボックスになります。

    セルに「データの入力規則」を設定する方法

    1. データ入力用のセルを作成します。

      ここではテキストボックスを例に説明します。

    2. 右ペインから「データの入力規則...」をクリックします。

    3. 「データの入力規則」ダイアログで入力規則やメッセージを設定します。

    4. アプリケーションのデバッグで動作を確認します。

    設定内容

    データ入力規則では、次の内容を設定できます。

    1. 設定タブ

      プロパティ名

      説明

      入力値の種類

      入力できる値の種類を次の中から設定します。

      整数/小数点数/日付/時刻/文字列(長さ指定)/ユーザー設定/正規表現/コマンド

      「正規表現」では、メールアドレス、IPアドレスなど事前に設定された式を選択できる他、独自の正規表現を設定することもできます。なお、Excelは正規表現をサポートしていないため、Excelファイルへとエクスポートした場合には、正規表現の設定は失われます。

      「コマンド」では、コマンドによるカスタム検証を行うことができます。 コマンドによる検証はページ側で実行する場合のみサポートされます。

      未入力を許可する

      未入力を許可します。

      本設定を有効にした場合、どのような条件であっても未入力を許可します。たとえば、「ユーザー設定」でISBLANK関数などを使用して未入力をチェックしていたとしても、その設定は無効となり未入力が許可されます。

      本設定を無効にしており、以下の「入力値の種類」を設定している場合、未入力かどうかのチェックは行われず、「テータ」に設定した条件のみがチェックされます。

      • 文字列(長さ指定)
      • ユーザー設定
      • 正規表現

      データ

      入力できる値の範囲を設定します。

      最小値/最大値

      「データ」で指定した範囲に基づいて値を設定します。

    2. 入力時メッセージタブ

      プロパティ名

      説明

      セル選択時にメッセージを表示する

      セルが選択されると吹き出しメッセージが表示されます。

      タイトル

      吹き出しメッセージのタイトルを設定します。

      メッセージ

      メッセージ本文を設定します。

    3. エラーメッセージタブ

      プロパティ名

      説明

      エラーメッセージ

      無効なデータが入力された際に表示するメッセージを設定します。

      表示方法
      • ツールチップ:ツールチップにエラーメッセージを表示します。

      • セル:対象セルとして指定した位置のセルにエラーメッセージを表示します。

      既定の表示方法は「ツールチップ」です。

      エラーメッセージが設定されていない場合、既定のエラーメッセージが表示されます。

      入力値の種類

      既定のエラーメッセージ

      すべての値

      ([未入力を許可する]のチェックを外した場合)

      必須入力項目です。

      整数

      入力した値は正しくありません。

      小数点数

      日付

      文字列

      入力した文字列の長さは正しくありません。

      正規表現

      入力した値は正しくありません。

      正規表現

      (事前に設定された式を選択した場合)

      入力した値は「***」の値として正しくありません。

      ※選択した式の名称が「***」に表示されます。

    コマンドを使用した入力検証の方法

    コマンドを使用した入力検証を使用すると ある値が既にデータベースに存在しているかどうかを検証することができます。

    使い方

    1. ページのリストビューでテキストボックスを選択し、右側のセル設定で「データの入力規則」をクリックします。

    2. データ入力規則のポップアップダイアログボックスで、条件を「コマンド」に設定する。 このとき、「未入力を許可する」オプションは非表示になります。

    3. [入力規則の検証コマンドを設定する...]をクリックします。 ハイパーリンクをクリックして、コマンドダイアログボックスを開く。

    4. コマンドダイアログボックスのコマンドを以下のように設定する。

      変数の設定コマンドを使い、変数名を 「変数1 」とし、「レコード数 」を選択し、クエリー条件を設定します。

      判定には条件分岐コマンドを使います。 変数1が1以上の場合、「この値はすでに存在します。」というメッセージが返されます。

      データ検証パラメータ「入力値」、すなわち検証される値は、コマンドで使用することができます。

    5. テキストボックスに「ざくろ 」と入力し、他の空白部分をクリックすると、エラーメッセージがポップアップ表示されます。

      「マンゴー」と入力して他の空白をクリックしても、エラーメッセージは表示されません。