バージョン 6.3.3
 —  ステートメント  —

ハンドルの定義

DEFINE DATA LOCALDEFINE DATA OBJECTDEFINE DATA PARAMETERDEFINE DATA INDEPENDENT、および DEFINE DATA CONTEXT で使用する handle-definition の構文は、次のとおりです。

handle-name

HANDLE OF

dialog-element-type

CONSTANT

init-definition

   

OBJECT INIT
 
(array-definition) HANDLE OF

dialog-element-type ../graphics/cbc2.gif ../graphics/sbo2.gif../graphics/cbo2.gif CONSTANT

array-init-definition
OBJECT INIT

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

構文図で使用されている記号については、「構文記号」を参照してください。


機能

ハンドルは、コードのダイアログエレメントを特定し、ハンドル変数に格納されます。 詳細については、『プログラミングガイド』の「NaturalX」セクションを参照してください。

DEFINE DATA ステートメントでの HANDLE 定義は、ダイアログエレメントまたはダイアログを作成すると、自動的に生成されます。

ハンドルを定義すると、任意のステートメントでハンドル名を使用して、定義したダイアログエレメントタイプの属性値をクエリ、設定、または変更することができます。

プログラミングガイド』の「イベントドリブンプログラミング手法」も参照してください。

handle-definition の例:

1 #SAVEAS-MENUITEM HANDLE OF MENUITEM
1 #OK-BUTTON (1:10) HANDLE OF PUSHBUTTON

Top of page

構文説明

handle-name ハンドルに割り当てる名前です。ユーザー定義変数の命名規則が適用されます。『Natural スタジオの使用』ドキュメントの「ユーザー定義変数の命名規則」を参照してください。
HANDLE OF dialog-element-type ダイアログエレメントのタイプ。 設定可能値は、TYPE 属性の値です。 詳細については、『ダイアログコンポーネントリファレンス』の「ダイアログエレメント」および「属性」を参照してください。
HANDLE OF OBJECT プログラミングガイド』の「NaturalX」セクションで説明されているように、NaturalX と一緒に使用します。
CONSTANT

変数/配列は、指定された定数として処理されます。 割り当てられた定数値は、変数/配列が参照されるたびに使用されます。 割り当てられた値は、プログラムの実行中には変更できません。

注意:

  1. 内部処理の理由から、1 つのグループ定義内で変数定義と定数定義を混在させることは許可されていません。つまり、1 つのグループに含めることができるのは、変数か定数のいずれかのみです。
  2. CONSTANT 節を DEFINE DATA INDEPENDENT および DEFINE DATA CONTEXT で使用することはできません。
INIT

変数/配列に初期値が割り当てられます。 この値は、変数/配列が RESET INITIAL ステートメントで参照されるときにも使用されます。

注意:
DEFINE DATA INDEPENDENT および DEFINE DATA CONTEXT では、INIT 節は、その節を含む、各実行プログラミングオブジェクトで評価されます(変数を割当てるプログラミングオブジェクト内だけではありません)。 これは、グローバル変数の INIT の動作とは異なります。

init-definition init-definition オプションを使用して、変数の初期値および定数値を定義します。 「初期値の定義」を参照してください。
array-definition array-definition の場合、配列定義の次元の下限と上限を定義します。 「配列の次元の定義」を参照してください。
array-init-definition 配列に初期値が割り当てられます。 この値は、配列が RESET INITIAL ステートメントで参照されるときにも使用されます。

Top of page