Skip to main content

インターフェイスを使用した視覚化のパラメータ化

参照されるビジュアライゼーションのパラメータのインターフェイスを宣言できます。実行時にビジュアライゼーションが呼び出されると、実際のパラメータがインターフェイスに渡されます（関数ブロックの場合と同様）。

この種類の視覚化は、フレームまたはタブ要素を介して上位の視覚化によって参照される視覚化テンプレートとして使用されます。インターフェイス変数は、テンプレート視覚化のインターフェイス エディターで宣言されます。テンプレート視覚化を呼び出す上位の視覚化では、転送パラメーターが参照要素 (フレームまたはタブ) に割り当てられます。

まず、テンプレート視覚化のインターフェースエディターでインターフェース変数を宣言します。次に、データ型に準拠したアプリケーション変数を各インターフェース変数に割り当てて、パラメータを構成します。要素プロパティ（プロパティ ビュー）。

表示バリアントに応じて、ローカル変数のパラメータ転送（ VAR スコープ）は限られています。

注記

統合された視覚化として視覚化を実行する場合、パラメータとして転送できるのは基本データ型を持つローカル変数のみです。視覚化が次のように呼び出される場合、 CODESYS TargetVisu または CODESYS WebVisu、ユーザー定義のデータ型を使用してパラメータを転送することもできます。

フレームパラメータの更新時の支援

視覚化テンプレートでインターフェース変数を変更すると、発生場所の更新が支援されます。

コンパイル中に、有効ではなくなったパラメータ転送のある場所が検出され、メッセージ ビューに表示されます。検出された場所ごとに、次のエラー メッセージが表示されます。 参照された視覚化のインターフェース <視覚化の名前> 現在の構成と一致しません。現在の視覚化のフレーム参照を更新してください。

メッセージをダブルクリックすると、エラーを修正するための支援が表示され、 フレームパラメータを更新する ダイアログが開きます。ここで、関連する場所のパラメータ転送を編集できます。ただし、プロジェクト全体の影響を受けるすべての場所のパラメータ転送を編集することもできます。

詳細については、以下を参照してください。 フレームパラメータの更新、 オプション: 視覚化

インターフェイス（VAR_IN_OUT）を使用したビジュアライゼーションの呼び出し

要件: プロジェクトには、視覚化とメインの視覚化が含まれています。メインの視覚化には、視覚化が参照する要素が含まれています。

  1. ビジュアライゼーションを開きます。

  2. クリック 視覚化→インターフェースエディタ。

  3. インターフェイスエディタで変数を宣言します。

    ビジュアライゼーションにはインターフェースがあり、 フレームパラメータの更新 ダイアログが表示されます。

  4. にアプリケーション変数を入力して、すべての呼び出しでタイプ準拠の転送パラメータをインターフェイス変数に割り当てます。 価値。ダイアログを終了します。

    転送パラメータは、ビジュアライゼーションが参照されるポイントに割り当てられます。これらは、のメインビジュアライゼーションに表示されます。 参考文献 財産。

例 17. 例

The visPie ビジュアライゼーションには、アニメーション化された色付きのパイが含まれています。 The visMain メインの視覚化は、 visPie で複数回の視覚化 タブ。色情報、角度情報、およびラベルは、 pieToDisplay インターフェイス変数。パイは実行時に変化します。

視覚化 visPie：

_visu_img_tab.png
表 3. Pie要素のプロパティ：

開始のための変数

pieToDisplay.iStart

終わりの変数

pieToDisplay.iEnd

テキスト→テキスト

％s

テキスト変数→テキスト変数

pieToDisplay.sLabel

色変数→通常状態

pieToDisplay.dwColor



視覚化のインターフェース visPie：

                            VAR_IN_OUT
                            pieToDisplay : DATAPIE;
                            END_VAR

主な視覚化 visMain：

表 4. 「タブ」要素のプロパティ：

参考文献

visPie

見出し

A

pieToDisplay

PLC_PRG.pieA

visPie

見出し

B

pieToDisplay

PLC_PRG.pieB

visPie

見出し

C

pieToDisplay

PLC_PRG.pieC



DATAPIE (STRUCT)

TYPE DATAPIE : // Parameter type used in visPie
STRUCT
    dwColor : DWORD; // Color data
    iStart : INT; // Angle data
    iEnd : INT;
    sLabel : STRING;
END_STRUCT
END_TYPE

GVL

{attribute 'qualified_only'}
VAR_GLOBAL CONSTANT
    c_dwBLUE : DWORD := 16#FF0000FF; // Highly opaque
    c_dwGREEN : DWORD := 16#FF00FF00; // Highly opaque
    c_dwYELLOW : DWORD := 16#FFFFFF00; // Highly opaque
    c_dwGREY : DWORD :=16#88888888; // Semitransparent
    c_dwBLACK : DWORD := 16#88000000; // Semitransparent
    c_dwRED: DWORD := 16#FFFF0000;  // Highly opaque
END_VAR

PLC_PRG

PROGRAM PLC_PRG
VAR
    iInit: BOOL := TRUE;
    pieA : DATAPIE; // Used as argument when visPie is called
    pieB : DATAPIE;
    pieC : DATAPIE;
    iDegree : INT; // Variable center angle for the pie element used for animation
END_VAR

IF iInit = TRUE THEN
    pieA.dwColor := GVL.c_dwBLUE;
    pieA.iStart := 0;
    pieA.sLabel := 'Blue';

    pieB.dwColor := GVL.c_dwGREEN;
    pieB.iStart := 22;
    pieB.sLabel := 'Green';

    pieC.dwColor := GVL.c_dwYELLOW;
    pieC.iStart := 45;
    pieC.sLabel := 'Yellow';

    iInit := FALSE;
END_IF
iDegree := (iDegree + 1) MOD 360;
pieA.iEnd := iDegree;
pieB.iEnd := iDegree;
pieC.iEnd := iDegree;

主な視覚化 visMain 実行時：

_visu_img_pie_rt.png


転送パラメータのインスタンス名を出力する

転送パラメータのインスタンス名を取得して出力するために、インターフェイス変数（データ型）を実装できます。 STRING）プラグマ付き {attribute 'parameterstringof'} の中に VAR_INPUT 範囲。

プロジェクトには、ビジュアライゼーションとメインビジュアライゼーションが含まれています。メインのビジュアライゼーションには、ビジュアライゼーションが参照する要素が含まれています。

  1. ビジュアライゼーションを開きます。

  2. クリック 視覚化→インターフェースエディタ。

  3. インターフェイス変数を宣言します（VAR_IN_OUT）。

    pieToDisplay : DATAPIE;

  4. インターフェイスエディタで、変数を宣言します（VAR_INPUT）属性付き {attribute 'parameterstringof'}。

    {attribute 'parameterstringof' := 'pieToDisplay'}

    sNameToDisplay : STRING;

  5. 変更を保存します。

    The フレームパラメータの更新 ダイアログが開きません。

  6. を挿入します テキストフィールド エレメント。

  7. の中に テキスト、 文章 プロパティで、出力テキストをテキストフィールドに割り当てます。

    Visualization of %s

  8. の中に テキスト変数テキスト変数 プロパティで、インターフェイス変数をテキストフィールドに割り当てます。

    sNameToDisplay

    visPie 見出しがあります。

例 18. 例

The visPie これまでの視覚化は1つのパイで構成されています。 The visMain 主な視覚化の呼び出し visPie の タブ 異なる転送パラメータで3回。

visPie 視覚化に渡される実際のパラメータの名前を出力するテキストフィールドが拡張されています。さらに、 visPie 指定された転送パラメータのインスタンス名を含む文字列変数で拡張されます。実行時に、各パイは上書きされます。

_visu_img_titled_pie.png
表 5. 「テキストフィールド」要素のプロパティ：

テキスト、 文章

Visualization of %s

テキスト変数、 テキスト変数

sNameToDisplay



のインターフェース visPie 視覚化

VAR_INPUT
    {attribute 'parameterstringof' := 'pieToDisplay'}
    sNameToDisplay : STRING;
END_VAR
VAR_IN_OUT
    pieToDisplay : DATAPIE;
END_VAR

主な視覚化 visMain 実行時：

_visu_img_pie_rt_labeled.png


このセクションの内容: