ターゲット内で特定のタイプのオブジェクトを検索して、それらのオブジェクトへのリファレンスの配列を返します。ターゲットには、フロントパネル、ブロックダイアグラム、他のオブジェクトを含むオブジェクト (Forループ、クラスタ、ユーザ定義制御器など) を指定できます。また、再帰的に他のコンテナオブジェクト内にネストされたオブジェクトも検索できます。


icon

入力/出力

  • cgnrn.png その他のRefnum

    その他のRefnumは、走査ターゲットOtherとして指定した場合に検索するコンテナオブジェクトへのリファレンスです。参照は、GObject、FlatSequenceFrame、またはPageから継承するVIサーバクラスでなければなりません。この入力は、走査ターゲットFPまたはBDの場合は無視されます。

  • cenum.png 走査ターゲット

    走査ターゲットは走査するコンテナオブジェクトのタイプを示します。この入力には、以下の表のような値が使用されます。

    0FP―フロントパネル
    1BD―ブロックダイアグラム
    2Other―フロントパネルまたはブロックダイアグラム以外のオブジェクトコンテナ。たとえば、ストラクチャダイアグラムやクラスタなどが含まれます。
  • cvirn.png VI Refnum

    VI refnumは走査するVIへのリファレンスです。この入力は、走査ターゲットFPまたはBDの場合に使用されます。特定のコンテナオブジェクトへのリファレンスをその他のRefnumに配線すると、この入力は無視されます。

  • cstr.png クラス名

    クラス名は、検索するオブジェクトのVIサーバクラス名です。

  • cerrcodeclst.png エラー入力 (エラーなし)

    エラー入力は、このノードを実行する前に発生したエラーの状態を示します。この入力は、標準エラー入力として機能します。

  • cbool.png 生成されたコードを走査 (F)

    生成されたコードを走査は、特定の関数実装プロセス中に生成されるコードを走査するかどうかを指定します。デフォルトはFALSEです。

  • ivirn.png 複製VI refnum

    複製VI refnumVI refnumを変更せずに返します。

  • i1dgobrn.png リファレンス

    リファレンスはこのVIが検出するGオブジェクトへのリファレンスの配列です。必要に応じて、「より特定のクラスに変換」関数で各リファレンスをダウンキャストします。

  • ii32.png リファレンス数

    リファレンス数リファレンス配列内のリファレンスの数です。

  • ierrcodeclst.png エラー出力

    エラー出力には、エラー情報が含まれます。この出力は、標準エラー出力として機能します。

  • このVIを使用するには、ブロックダイアグラムではBDまたはフロントパネルではFP走査ターゲットおよび検索するオブジェクトのクラス名を指定します。フロントパネルまたはブロックダイアグラムではなく特定のコンテナオブジェクトを走査するには、ターゲットをOtherに指定し、特定のオブジェクトのリファレンスをその他のRefnum入力に渡します。

    サンプルプログラム

    LabVIEWに含まれている以下のサンプルファイルを参照してください。

    • labview\examples\Application Control\VI Scripting\Finding and Modifying Objects\Using Traverse.vi