このドキュメントでは、次のトピックについて説明します。
入力フィールドコントロールは、データを単一行に入力するために使用されます。 このコントロールは 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 イベントでは更新されません。