このドキュメントでは、次のトピックについて説明します。
入力フィールドコントロールは、データを単一行に入力するために使用されます。 このコントロールは Natural プログラムの INPUT ステートメントのフィールドに対応しています。 リンクされた変数によって、データベースフィールドまたは他のプログラム変数を、入力フィールドコントロールにマップすることができます。 属性ウィンドウの［Source］ダイアログボックスで［Linked Variable］オプションを選択し、リンクされた変数、例えばデータベースフィールドの名前を入力すると、入力はリンクされた変数に自動的にコピーされます。 エンドユーザーがデータの入力を終了し、入力フィールドコントロールがフォーカスを失うと、入力されたデータは検証されます。
EDIT-MASK 属性を（リンク変数の）入力フィールドコントロールに割り当てて入力データを検証することもできます。検証は、入力フィールドコントロールがフォーカスを失うときに実行されます。
リンク変数がコードによって変更されたため、新しい値を表示する場合は、PROCESS GUI ステートメントアクション REFRESH-LINKS を使用します。
例えば、リンク変数が別の Natural データタイプを保持していた、EDIT-MASK が一致しなかったなどの理由から入力が拒否された場合、エンドユーザーに［Retry］または［Cancel］の実行を促すメッセージボックスが表示されます。 入力フィールドコントロールの現在の内容を保持して変更するには、エンドユーザーが［Retry］を押す必要があります。 入力フィールドコントロールを最新の有効な内容にリセットするには、エンドユーザーが［キャンセル］を押す必要があります。
注意:
注意：入力フィールドコントロールを作成し、STYLE 値に "センタリング（c）" または "右詰（r）" を指定した場合、入力フィールドコントロールの高さをシステムフォントの高さより高くする必要があります。 そうしなければ、STRING は表示されません。 入力フィールドコントロールへの入力は 253 文字に制限されます。
| 属性名 | 照会 | 設定／変更 | 属性 ウィンドウ |
|---|---|---|---|
| BACKGROUND-COLOUR-NAME | X | X/X | X |
| BACKGROUND-COLOUR-VALUE | X | X/X | X |
| CLIENT-DATA | X | X/X | |
| CLIENT-HANDLE | X | X/X | |
| CLIENT-KEY | X | X/X | |
| CLIENT-VALUE | X | X/X | |
| CONTEXT-MENU | X | X/X | X |
| DIL-TEXT | X | X/X | X |
| EDIT-MASK | X | X/X | X |
| ENABLED | X | X/X | X |
| FIRST-CHILD | X | -/- | |
| FOLLOWS | X | X/X | |
| FONT-HANDLE | X | X/X | X |
| FOREGROUND-COLOUR-NAME | X | X/X | X |
| FOREGROUND-COLOUR-VALUE | X | X/X | X |
| HELP-ID | X | X/X | X |
| LAST-CHILD | X | -/- | |
| LENGTH | X | X/X | X |
| LINKED | X | X/- | X |
| MODIFIABLE | X | X/X | X |
| MODIFIED | X | -/X | |
| MODIFIED-SUCCESSOR | X | -/- | |
| OWNER | X | X/- | |
| PARENT | X | X/- | |
| PREDECESSOR | X | -/- | |
| RECTANGLE-H | X | X/X | X |
| RECTANGLE-W | X | X/X | X |
| RECTANGLE-X | X | X/X | X |
| RECTANGLE-Y | X | X/X | X |
| RTL | X | -/- | X |
| STRING | X | X/X | X |
| STYLE | X | X/- | X |
| SUCCESSOR | X | -/- | |
| SUPPRESS-CHANGE-EVENT | X | -/- | |
| SUPPRESS-ENTER-EVENT | X | X/X | |
| SUPPRESS-LEAVE-EVENT | X | X/X | |
| TOOLTIP | X | X/X | |
| TYPE | X | X/- | |
| VARIABLE | - | X/X | X |
| VISIBLE | X | X/X | X |
Change イベント、Enter イベント、Leave イベント（どのイベントも抑制される場合あり）。
注意:
エンドユーザーまたはコードが内容を変更すると、入力フィールドコントロールに対して Change イベントが発生します。 このイベントは、入力フィールドコントロールの初期設定では発生しません。 変更イベントハンドラ内部からシステムフォーカスを操作することはお勧めしません。
さらに、リンクされた変数の内容は、Change イベントでは更新されません。
