オブジェクトの階層構造

オブジェクトは階層構造を持っています。階層構造とはオブジェクトの親子の関係のことです。例えば、フォームは複数のコントロールを持ちますが、フォームはコントロールの親オブジェクトであり、コントロールはフォームの子オブジェクトです。すべてのオブジェクトはプロパティ、メソッド、イベントを持っています。

ここで、第１階層にある「root」（ルート。日本語では"根っこ"）オブジェクトとは、システム全体にかかわるプロパティやメソッドを持つ、最も重要なオブジェクトです。例えば、Panel Serverとの接続情報など、システム全体に関わる設定はルートオブジェクトに対して行います。ルートオブジェクトが持つプロパティやメソッドにはシステム全体からアクセスすることができます。また、ルートオブジェクトにユーザーがスクリプトで関数（ユーザー定義関数）を記述した場合、その関数はシステム全体から自由に呼び出すことができる汎用ユーザー定義関数として利用できるようになります。

続いて、第２階層にはフォームオブジェクトとMathオブジェクトがあります。

フォームオブジェクトとは、コントロールを貼り付ける画面そのものであり、通常の画面としての表示のほか、画面上にダイアログ（ポップアップ）として重ねて開くこともできます。フォームオブジェクトにアクセスするには、ルートを表す「::」の後にフォーム名を指定し、「.」（ピリオド）で区切ってメソッド名やプロパティ名を指定します。

event OnMouseUp(button)
{
	::Form01.FillColor = "#FF0000";	// Form01のFillColor（背景色）プロパティを赤にする
	::Form02.FillColor = "#00FF00";	// Form02のFillColor（背景色）プロパティを緑にする
}

Mathオブジェクトとは、平均値、合計値などの算術演算を行うためのメソッドが集められた特別なオブジェクトです。Mathオブジェクトの利用にあたっては、以下のように「::Math.」のあとにメソッド名をつなげて記述することで、いつでもMathのメソッドを呼び出すことができます。

event OnMouseUp(button)
{
	var a = 12.34; 
	var b = ::Math.Abs(a);	// 12.34の絶対値を求める
}

また、第３階層のコントロールオブジェクトとは、フォーム上にあるエディットコントロールやラベルコントロールなど、フォームに貼り付けたコントロールそのものです。「::」のあとにフォーム名及びコントロール名を付加して、「.」（ピリオド）区切りでメソッド名やプロパティ名を指定します。

event OnMouseUp(button)
{
	::Form01.Control1.FillColor = "#FF0000";  // Control1のFillColor（背景色）プロパティを赤にする
	::Form01.Control2.FillColor = "#00FF00";  // Control2のFillColor（背景色）プロパティを緑にする
}

絶対パスと相対パス

オブジェクトの階層構造の解説では、ルート（「::」）から順に下位オブジェクトをたどっていく方法について述べました。この参照方法のことを「絶対パス参照」と呼びます。

//絶対パス参照
event OnMouseUp(button)
{
	::Form01.Control1.FillColor = "#FF0000";  // Control1のFillColor（背景色）プロパティを赤にする
	::Form01.Control2.FillColor = "#00FF00";  // Control2のFillColor（背景色）プロパティを緑にする
}

これに対して、現在スクリプトが書かれているオブジェクト自身を参照の基点として、相対的に階層をたどっていく参照方法のことを「相対パス参照」と呼びます。以下は、Form01内のControl1コントロールのOnMouseUpイベントにスクリプトを記述した場合の相対パス参照の例です。

// 相対パス参照
event OnMouseUp(button)
{
	this.FillColor = "#FF0000"; 	// Control1のFillColor（背景色）プロパティを赤にする
	parent.Control2.FillColor = "#00FF00";	// Control2のFillColor（背景色）プロパティを緑にする
}

相対パスでは「this」及び「parent」キーワードが重要な役割を担います。

「this」とは自分自身のオブジェクトのことを指します。上例の場合、Control1自身を表します。この方法はコントロールオブジェクト自身のプロパティやメソッドにアクセスしたい場合の最もスマートな方法です。尚、絶対パス参照の場合はコントロールオブジェクト自身に名前をつける必要がありましたが、thisを使う場合には必ずしもコントロールオブジェクトに名前をつける必要はありません。

「parent」とは親オブジェクトのことを指します。上例の場合、フォームオブジェクトForm01を指します。従って「parent.Control2」とは、Form01内のControl2オブジェクトを指すことになります。尚、フォームオブジェクトは、開いた直後から（つまり、画面やダイアログとして表示した直後から）パス参照が行えるようになります。

オブジェクトのグループ化と階層

オブジェクトはグループ化することができます。グループ化を行うと、グループコントロールとしてオブジェクトが１つ作成されます。グループ化された複数のコントロールは、そのグループコントロールの子オブジェクトとして１つ下の階層に移動します。

グループ化によって生成されたグループオブジェクトには、スクリプトを記述することも可能です。また、グループの構成要素である各子オブジェクトについても、同様にスクリプトの記述が可能です。

オブジェクトのパス参照

FA-Panelのオブジェクト構造はrootを起点とした階層構造となっており、スクリプトから階層構造のオブジェクトを参照するためのキーワードがいくつか用意されています。参照方法には、階層の頂点から参照する「絶対パス参照」と、自分自身のオブジェクトを基準として相対的に参照する「相対パス参照」があります。

if ( ::PSUserLevel == 10 ) {
  　   ・ ・ ・
}

::OpenForm(“Form01”);

::Form01.Btn01.Enabled = T;

this.Text = “ボタン１”;

parent.Btn02.Enabled = F;

var vData = "ABCDEFG";

event OnMouseUp(button)
{
	// 直接指定では変数へのアクセス可能
	::MsgBox(parent.vData);

	// 一度変数にオブジェクトを入れた場合はアクセス不可
	var vFormObj = parent;
	::MsgBox(vFormObj.vData); // ← 実行時にエラー発生
}

var vData = "ABCDEFG";

function fGetData()
{
	return vData;
}
function fSetData(data)
{
	vData = data; 
}

event OnMouseUp(button)
{
	var vFormObj = parent;
	::MsgBox(vFormObj.fGetData());
}

オブジェクトの親取得/子取得

FA-Panelのオブジェクトの親子関係から相対パスでオブジェクトを取得する方法以外に、「GetParentObj」「GetChildObj」によってオブジェクトを取得する方法があります。

var vFormObj = this.GetParentObj();

var vBtnObj = this.GetChildObj("Btn01");