Object.FindObjectメソッド

説明

オブジェクトツリーからオブジェクトを検索します。

FindChildメソッドと似た機能ですが、より柔軟にオブジェクトを検索できます。

より追加されました

ではサポートされていません

呼出形式

obj.FindObject( name [, rule ] )

戻り値

オブジェクトが見つかった場合は、そのオブジェクトのリファレンスを返します。

オブジェクトが見つからなかった場合はnullを返します。

引数

String name

または

クラス識別子

検索するオブジェクトの名前またはクラス識別子

integer rule

検索のルール

どのような規則で検索を行うかを以下から指定します。

定数	説明
Object.FIND_CHILD	子オブジェクトから検索します。FindChildメソッドと同様の動作です。
Object.FIND_ANCESTOR	親または先祖から検索します。
Object.FIND_SCOPEPATH	子、自分、親、先祖の順に検索します。
Object.FIND_EVENTPATH	子、親、親の子、先祖、先祖の子の順に検索します。

省略時にはObject.FIND_CHILDを指定した場合と同じ動作となります。

例外

なし

使用例

/* 親または先祖からFormオブジェクトを検索 */

var form_obj = FindObject(Form, FIND_ANCESTOR);

/* イベントハンドラと同じルールでファンクションを検索 */

var fnc = FindObject("OnTouch", FIND_EVENTPATH);

if (fnc != null) {

    fnc(e);

/* オブジェクトスコープのルールで、txCodeを検索 */

var obj = FindObject("txCode", FIND_SCOPEPATH);

if (obj != null) {

    obj.BgColor = $red;