バージョン 6.3.3
 —  ダイアログコンポーネントリファレンス  —

入力フィールドコントロール

このドキュメントでは、次のトピックについて説明します。


説明

入力フィールドコントロールは、データを単一行に入力するために使用されます。 このコントロールは Natural プログラムの INPUT ステートメントのフィールドに対応しています。 リンクされた変数によって、データベースフィールドまたは他のプログラム変数を、入力フィールドコントロールにマップすることができます。 属性ウィンドウの[Source]ダイアログボックスで[Linked Variable]オプションを選択し、リンクされた変数、例えばデータベースフィールドの名前を入力すると、入力はリンクされた変数に自動的にコピーされます。 エンドユーザーがデータの入力を終了し、入力フィールドコントロールがフォーカスを失うと、入力されたデータは検証されます。

EDIT-MASK 属性を(リンク変数の)入力フィールドコントロールに割り当てて入力データを検証することもできます。検証は、入力フィールドコントロールがフォーカスを失うときに実行されます。

リンク変数がコードによって変更されたため、新しい値を表示する場合は、PROCESS GUI ステートメントアクション REFRESH-LINKS を使用します。

例えば、リンク変数が別の Natural データタイプを保持していた、EDIT-MASK が一致しなかったなどの理由から入力が拒否された場合、エンドユーザーに[Retry]または[Cancel]の実行を促すメッセージボックスが表示されます。 入力フィールドコントロールの現在の内容を保持して変更するには、エンドユーザーが[Retry]を押す必要があります。 入力フィールドコントロールを最新の有効な内容にリセットするには、エンドユーザーが[キャンセル]を押す必要があります。

注意:
注意:入力フィールドコントロールを作成し、STYLE 値に "センタリング(c)" または "右詰(r)" を指定した場合、入力フィールドコントロールの高さをシステムフォントの高さより高くする必要があります。 そうしなければ、STRING は表示されません。 入力フィールドコントロールへの入力は 253 文字に制限されます。

Top of page

入力フィールドコントロールの属性

属性名 照会 設定/変更 属性 ウィンドウ
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

Top of page

イベント

Change イベントEnter イベントLeave イベント(どのイベントも抑制される場合あり)。

注意:
エンドユーザーまたはコードが内容を変更すると、入力フィールドコントロールに対して Change イベントが発生します。 このイベントは、入力フィールドコントロールの初期設定では発生しません。 変更イベントハンドラ内部からシステムフォーカスを操作することはお勧めしません。 さらに、リンクされた変数の内容は、Change イベントでは更新されません。

Top of page