API version 4

Object.FindObjectメソッド

iOSAndroidWindows

説明

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

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;
}