15.3.4 プロパティの検索
: h = findobj ()
: h = findobj (prop_name, prop_value, …)
: h = findobj (prop_name, prop_value, "-logical_op", prop_name, prop_value)
: h = findobj ("-property", prop_name)
: h = findobj ("-regexp", prop_name, pattern)
: h = findobj (hlist, …)
: h = findobj (hlist, "flat", …)
: h = findobj (hlist, "-depth", d, …)
指定されたプロパティを持つグラフィック オブジェクトを検索します。
引数なしで呼び出されると、ルート オブジェクト (0) から始まり、そのすべての子孫を含むすべてのグラフィック オブジェクトを返します。
結果を絞り込む最も簡単な方法は
findobj (プロパティ名,プロパティ値)
これは、値prop_valueを持つprop_nameという名前のプロパティを持つすべてのオブジェクトのハンドルを返します 。複数のプロパティ/値のペアが指定されている場合は、すべての条件を満たすオブジェクト ( と同等) のみが返されます。 -and
最初の引数として ハンドルまたはハンドル セットhlistを渡すことにより、検索を特定のオブジェクト セットとその子孫に制限できます。
検索するオブジェクト階層の深さは、 "-depth"引数によって制限できます。3 世代の子だけを検索する例は次のとおりです。
findobj (prop_name, prop_value)
深さdを 0 に指定すると、検索はhlistで渡されたオブジェクトのセットに制限されます。深さ 0 は引数と同等です "flat"。デフォルトの深さ値は で、Infこれにはすべての子孫が含まれます。
prop_name、 prop_value のペアの間には、指定された論理演算子を使用できます。サポートされている論理演算子は "-and"、、、、です。すべての図と軸オブジェクトを検索するサンプルコードは次のとおりです "-or"。"-xor""-not"
findobj (hlist, "-depth", 3, prop_name, prop_value)
正規表現をプロパティ値と比較することによってオブジェクトを一致させることもできます。その場合、一致するプロパティ値が 返されます。 regexp (prop_value, pattern)
最後に、プロパティ名を持つオブジェクトは "-property"オプションで見つけることができます。たとえば、 "meshstyle"プロパティを持つオブジェクトを検索するコードは次のとおりです。
findobj ("type", "figure", "-or", "type", "axes")
実装上の注意: 検索には、表示されているハンドル (HandleVisibility = "on") を持つオブジェクトのみが含まれます。findall非表示のオブジェクトを含むすべてのオブジェクトを検索するには、 を参照してください。
See also: findall, allchild, get, set.
: h = findall ()
: h = findall (prop_name, prop_value, …)
: h = findall (prop_name, prop_value, "-logical_op", prop_name, prop_value)
: h = findall ("-property", prop_name)
: h = findall ("-regexp", prop_name, pattern)
: h = findall (hlist, …)
: h = findall (hlist, "flat", …)
: h = findall (hlist, "-depth", d, …)
指定されたプロパティを持つグラフィック オブジェクト (非表示のものも含む) を検索します。
戻り値hは、見つかったグラフィック オブジェクトへのハンドルのリストです。
findallと同じ検索を実行しますfindobjが、非表示のオブジェクト (HandleVisibility = "off") も対象となります。詳しいドキュメントについては、 を参照してくださいfindobj。
See also: findobj, allchild, get, set.