Skip to main content

視覚化要素:パイ

シンボル:

_visu_img_pie.png

カテゴリー: 基本

要素は任意の角度のパイを描画します。

要素のプロパティ

すべての要素プロパティが利用可能ですか?

すべてのプロパティは、を選択しないと使用できません [詳細] オプションまたは すべてのカテゴリ フィルターイン プロパティ

要素名

例: Error_rate_part_1

ヒント

要素に個別の名前を付けて、要素リストでより早く見つけられるようにします。

要素タイプ

パイ

位置

位置は、視覚化ウィンドウ内の要素の位置とサイズを定義します。これはデカルト座標系に基づいています。原点はウィンドウの左上隅にあります。正の水平 X 軸は右方向に伸びます。正の垂直 Y 軸は下向きです。

X

要素の左上隅の X 座標 (ピクセル単位)

例: 10

Y

要素の左上隅の Y 座標 (ピクセル単位)

例: 10

幅 (ピクセル単位)

例: 150

身長

高さ (ピクセル単位)

例: 30

ヒント

ボックスをドラッグして値を変更することもできます _visu_icon_position_element.png シンボルをエディタ内の他の位置に移動します。

角度

静的回転角度 (度単位)

例: 35

要素はエディター内で回転して表示されます。回転点は要素の中心です。正の値を指定すると時計回りに回転します。

ヒント

ヒント: 要素をハンドルにフォーカスすると、エディターで値を変更できます。カーソルが として表示されている場合 _visu_icon_rotate_statically.png 回転矢印を使用すると、ハンドルとして要素の中心を中心に要素を回転できます。

_visu_img_selected_pie_with_handle.png

(1): ハンドル

注記

動的回転角度も設定されている場合、 絶対移動 → 内旋 プロパティを使用すると、静的および動的回転角度が実行時に追加されます。静的な回転角度はオフセットとして機能します。

Variable

始める

パイの開始角度

開始の変数も定義する場合、開始角度は次の値の合計から計算されます。 始める開始のための変数

. 例:
  • 始める:330

  • 終わり:90

_visu_img_element_pie_example.png

終わり

パイの終了角度

終了の変数も定義する場合、終了角度は、の値の合計から計算されます。 終わり終わりの変数

円は、開始角度から終了角度まで時計回りに描画されます。

開始のための変数

セクターの開始は、変数によって動的に定義されます。

終わりの変数

セクターの終わりは、変数によって動的に定義されます。

円の線のみを表示

standard icon:円は、半径線や塗りつぶしの色なしで描画されます。

中心

X

中心座標の表示。

注記

ここでプロパティでこれらの値を変更することはできません。

円がエディターで選択されている場合、円の中心(およびエンベロープボックスの中心)が次のように表示されます。 _visu_icon_center_point.png シンボル。さらに、要素には、移動可能な位置、開始、および終了ボックスが装飾されています。

_visu_img_selected_pie.png:移動すると中心座標が変化します _visu_icon_center_point.png エディターの中央の記号。これにより、パイのサイズも変更され、 _visu_icon_position_box.png 位置ボックスはその位置を保持し、中心は要素の中央に残ります。

Y

通常の状態

の変数が 色変数→色の切り替え 定義されていないか、値があります FALSE

フレームカラー

変数の対応する状態のフレームと塗りつぶしの色

塗りつぶしの色

透明性

選択した色の透明度を定義するための値(0〜255)

255:色が不透明です。

0:色は完全に透明です

注記

色がスタイルカラーで、透明度の値が既に設定されている場合、このプロパティは書き込み禁止になります。

アラーム状態

の変数が 色変数→色の切り替え 値があります TRUE

グラデーションカラーを使用する

standard icon:要素は2色のグラデーションで表示されます。

グラデーション設定

The グラデーションエディター ダイアログが開きます。

外観

プロパティには、要素の外観を設定するための固定値が含まれています。

線幅

値(ピクセル単位)

例: 2

注記

その価値 01 どちらも1ピクセルの線の太さになります。行を表示しない場合は、 ラインスタイル プロパティをに設定する必要があります 見えない オプション。

属性を塗りつぶす

要素がどのように満たされるか

  • いっぱい:要素はからの色で満たされています 色→塗りつぶしの色 財産。

  • 見えない:塗りつぶしの色は見えません。

ラインスタイル

線表現のタイプ

  • 個体

  • ダッシュ

  • ドット

  • ダッシュドット

  • ダッシュドットドット

  • 見えない

ヒント

で変数を割り当てることができます 外観変数 外観を動的に制御するためのプロパティ。ここでの固定値は上書きされます。

テキスト

文章

文字列(一重引用符なし)

例: Accesses: %i

要素にはこのテキストのラベルが付いています。プレースホルダーの場合 %<format string> テキストで指定されている場合、変数の値は テキスト変数→テキスト プロパティは、プレースホルダーの場所に出力されます。

ツールチップ

文字列(一重引用符なし)

例: Number of valid accesses %n

テキストはツールチップとして出力されます。プレースホルダーの場合 %<format string> テキストで指定されている場合、変数の値は テキスト変数→ツールチップ プロパティは、プレースホルダーの場所に出力されます。

ヒント

使用 Ctrl+入力 改行を追加するためのショートカット。

ヒント

指定されたテキストは自動的にに転送されます GlobalTextList テキストリスト。したがって、これらのテキストはローカライズできます。

テキストプロパティ

プロパティはテキストプロパティの固定値を取得し、で設定されているテキストに基づいて動作します。 テキスト → テキスト または テキスト → ツールチップ

水平配置

エレメント内のテキストの水平配置

垂直配置

エレメント内のテキストの垂直配置

テキストフォーマット

. 長すぎるテキストを表示するための定義
  • デフォルト: 長すぎるテキストは切り捨てられます。

  • ラインブレーク: テキストが行に分割されます。

  • 省略記号: 表示されているテキストは「...」で終わります「」は未完成であることを示します。

フォント

例: デフォルト

_cds_icon_three_dots.png: ザ・ フォント ダイアログが開きます。

_cds_icon_arrow_down.png: スタイルフォント付きリストボックス

フォントの色

標準状態のフォントの色

例: ブラック

_cds_icon_three_dots.png: ザ・ カラー ダイアログが開きます。

_cds_icon_arrow_down.png: スタイルカラーのリストボックス

フォントのアラームカラー

アラーム状態でアクティブなフォントの色

重要

通常の状態のフォントの色とは異なっていなければなりません。

例:

透明性

整数 (以下の値の範囲 0255)

透明度の値は、それぞれの色の透明度を決定します。

255: 色が不透明です。

0: 色は完全に透明です。

注記

色がスタイルカラーで、透明度の値が既に設定されている場合、このプロパティは書き込み禁止になります。

絶対的な動き

プロパティには、要素の位置を動的に制御するためのIEC変数が含まれています。基準点は要素の左上隅です。実行時に、要素全体が移動されます。

動き

X

  • X位置の変数(整数データ型)(ピクセル単位)

    例: PLC_PRG.iPos_X

  • コンテナ変数: Container.Width

    詳細については、次を参照してください。 位置とサイズを最適に調整する

実行時にこの値を増やすと、要素が右に移動します。

Y

  • Y位置の変数(整数データ型)(ピクセル単位)

    例: PLC_PRG.iPos_Y

  • コンテナ変数: Container.Height

    詳細については、次を参照してください。 位置とサイズを最適に調整する

実行時にこの値を増やすと、要素が下に移動します。

スケーリング

中心ストレッチをトリガーする変数(整数データ型)

例: PLC_PRG.iScaling

基準点は 中心 財産。

1 要素を係数で縮小します 0.001。値 1000 要素を元のサイズに戻します。

内部回転

回転角(度単位)の変数(整数データ型)

例: PLC_PRG.iAngle2

実行時に、要素はで指定された回転点を中心に回転します 中心 変数の値に応じて。さらに、要素の配置は、視覚化の座標系に従って回転します。コードの値を大きくすると、時計回りに回転します。

回転点は次のように表示されます _visu_icon_center_point.png シンボル。

静的回転角がで指定されている場合 位置→角度、次に静的回転角と回転角が追加されます。

_visu_img_prp_inner_rotation.png

ヒント

変数を組み合わせて 単位変換

ヒント

The バツY、 と 内部回転 プロパティは、「クライアントアニメーション」機能によってサポートされています。

テキスト変数

テキスト変数

変数( フォーマット仕様) のプレースホルダー プロパティ: テキスト → テキスト

例: PLC_PRG.iAccesses

変数値は、要素のテキストのプレースホルダーを置き換えます。実行時に、要素にはテキストのラベルが付けられ、変数値は常に更新されます。

注記

テキストリストをサポートする列挙型の変数を指定すると、列挙データ型の名前が変数名の後に山括弧で囲まれて自動的に追加されます。例: PLC_PRG.enVar <enumeration name>。次に、テキストが印刷されるときに、数値の代わりに列挙コンポーネントのシンボリック値が印刷されます。列挙型については、ヘルプページを参照してください。

ツールチップ変数

変数(データ型は フォーマット仕様)のプレースホルダーの場合 テキスト→ツールチップ 財産

例: PLC_PRG.iAccessesInTooltip

変数値は、要素のツールチップのプレースホルダーを置き換えます。実行時にツールチップが表示され、変数値は常に更新されます。

動的テキスト

動的テキストは、テキストリストの可変的にインデックス付けされたテキストです。実行時に、変数で現在インデックス付けされているテキストが表示されます。

テキストリスト

. テキストリストの名前
  • 変数として(STRING)

  • 単一引用符付きの固定文字列リテラルとして

    例: 'Errorlist'

_cds_icon_arrow_down.png:テキストリストで使用可能なダイアログを含むリストボックス

注: プロジェクトのテキスト リストをライブラリ内のビジュアライゼーションに転送する場合は、テキスト リストの名前の前にドットを追加する必要があります。

テキストインデックス

. 目的の出力テキストを参照するテキストリストID
  • IDが一重引用符で囲まれた固定文字列として

    例: '1'

  • 変数として(STRING)テキスト出力を動的に制御するため

    例: strTextID

    サンプル割り当て: PLC_PRG.strTextID := '1';

ツールチップインデックス

. 目的の出力テキストを参照するテキストリストID
  • IDが一重引用符で囲まれた固定文字列として

    例: '2'

  • 変数として(STRING)テキスト出力を動的に制御するため

    例: strToolTipID

    サンプル割り当て: PLC_PRG.strToolTipID := '2';

フォント変数

変数を使用すると、テキスト表示を動的に制御できます。

フォント名

変数 (STRING() はテキストのフォント用

例: PLC_PRG.stFontVar := 'Arial';

ヒント

どのフォントが標準で利用できるかを調べることができます フォント ダイアログ。

サイズ

フォントサイズ (ピクセル単位またはポイント単位) の変数 (数値データ型)

適用される単位は、変数名の後の括弧内に指定されます。

  • <pt>: ポイント(デフォルト)

    例: PLC_PRG.iFontHeight <pt>

    コード: iFontHeight : INT := 12;

  • <px>: ピクセル

    例: PLC_PRG.iFontHeight <px>

    コード: iFontHeight : INT := 19;

ヒント

フォントサイズはポイント単位で指定されます (例:Arial 12)。可変フォントサイズがフォントと一致する必要がある場合 (たとえば、にフォントが設定されている場合など) には、ポイントを使用してください テキストプロパティ → フォント プロパティ。

ヒント

値フィールドをクリックすると、 _cds_img_dropdownlist_unit_font_size.png 単位を設定するためのリストボックスが右側に表示されます。

国旗

変数 (DWORD() を使用してフォントの表示を決定するフラグ

. フラグ:
  • 1: イタリック

  • 2: ボールド

  • 4: アンダーライン

  • 8: ストライクスルー

注記

フラグのコーディングを追加することで、フォントの表示を組み合わせることができます。たとえば、太字で下線が引かれたテキスト PLC_PRG.dwFontType := 6;

キャラクターセット

変数 (DWORD() はフォントの文字セット番号を表します。

文字セット番号の選択は、 スクリプト スタンダードの設定 フォント ダイアログ。

[カラー]

変数 (DWORD) はテキストの色を表します

例: PLC_PRG.dwColorFont:= 16#FF000000;

アラームカラー

変数 (DWORD() はアラーム発生時のテキストカラーです。

重要

この色は、静的フォントのアラーム色 (プロパティ内) を上書きします。 テキストプロパティフォントのアラームカラー)

通常の状態のフォントの色とは異なっていなければなりません。

テキスト配置のフラグ

テキスト配置をコーディングするための変数 (整数データ型)

例: PLC_PRG.dwTextAlignment

. コーディング:
  • 0: 左上

  • 1: 水平中心

  • 2: 正しい

  • 4: 垂直中心

  • 8: ボトム

注記

フラグのコーディングを追加することで、テキストの配置を組み合わせることができます。たとえば、縦方向と横方向の中央のテキスト PLC_PRG.dwFontType := 5;

ヒント

テキストを表示するための固定値が設定されています テキストのプロパティ

色変数

Elementプロパティは、実行時に色を動的に制御するためのプロジェクト変数のインターフェイスとして使用されます。

色を切り替える

カラートグルの変数

. 値の割り当て:
  • FALSE:要素は、で指定された色で表示されます 財産。

  • TRUE:要素は、で指定された色で表示されます アラームの色 財産。

. 割り当てオプション:
  • ユーザー入力変数のプレースホルダー

    • <トグル/タップ変数>

    • <変数を切り替え/タップしない>

    色の変化は、それ自体の変数ではなく、ユーザー入力変数によって制御されます。

    注記

    マウスイベントの変数を指定します タップ また トグル 要素の入力構成で。その場合にのみ、プレースホルダーが設定されます。両方で変数を構成する場合 トグルタップ、次にで指定された変数 タップ 使用されている。

    ヒント

    クリック _visu_icon_linked_variable.png 挿入する記号 <トグル/タップ変数> プレースホルダー。アクティベートすると 入力構成FALSEをタップします プロパティ、次に <変数を切り替え/タップしない> プレースホルダーが表示されます。

  • プロジェクト変数のインスタンスパス(BOOL)。

    例: PLC_PRG.xColorIsToggeled

    注記

    コードで、ここで指定された変数を宣言して実装します。その値の割り当てによって、色がいつ変わるかが決まります。

通常の状態

アラーム状態

以下にリストされているプロパティは、状態に応じて色を制御します。の変数が 色変数色を切り替える 定義されていないか、値があります FALSE。の変数が 色変数色を切り替える 値があります TRUE

フレームカラー

. 割り当てオプション:
  • 変数 (DWORD)フレームカラー用

    例: PLC_PRG.dwBorderColor

  • カラーリテラル

    緑と不透明の例: 16#FF00FF00

塗りつぶしの色

. 割り当てオプション:
  • 変数 (DWORD)塗りつぶしの色

    例: PLC_PRG.dwFillColor

  • カラーリテラル

    灰色と不透明の例: 16#FF888888

ヒント

カラー値の透明部分は、次の場合にのみ評価されます。 Visualization Manager半透明の描画をアクティブにします 視覚化マネージャーのオプションが選択されています。

点滅

の値 点滅間隔 要素が通常状態とアラーム状態の間で色を切り替える間隔をミリ秒 (ms) 単位で指定します。

要件: ビジュアライゼーションは次のように実行されます。 WebVisu そしてその クライアントアニメーションとネイティブ要素のオーバーレイをサポート Visualization Manager のオプションが有効になっています。要素はこのコンテキストでのみ点滅できます。

詳細については、以下を参照してください。 グループ: 一般設定

点滅間隔

で定義されている通常色とアラーム色の点滅間隔 (ミリ秒 (ms))。 要素のプロパティ

0 (デフォルト設定) では、要素は点滅しません。要素は単純に通常の色で表示されます。

  • 変数(型) UDINT) プログラム制御による色の変化

    例: PLC_PRG.udiBlinking

  • リテラル (型 UDINT) 一定時間後に色が変化します。

    例: 1000 1秒間

変数を見る

プロパティには、要素の外観を動的に制御するためのIEC変数が含まれています。

線幅

線幅(ピクセル単位)の変数(整数データ型)

属性を塗りつぶす

変数 (DWORD)要素の可視性を切り替えるため

  • 可変値 = 0:いっぱい

  • 可変値 > 0: 見えない;塗りつぶしなし

ラインスタイル

変数 (DWORD)線種を切り替えるため

. コーディング:
  • 0:実線

  • 1: 破線

  • 2: 点線

  • 3:線種「ダッシュドット」

  • 3:線種「ダッシュドットドット」

  • 8: 見えない;行なし

ヒント

固定値を設定できます。 外観 財産。ただし、これらの値は実行時に動的変数によって上書きされます。

状態変数

変数は要素の動作を動的に制御します。

見えない

変数 (BOOL)要素の可視性を切り替えるため

TRUE:要素は実行時に表示されません。

例: bIsVisibleVAR bIsVisible : BOOL := FALSE; END_VAR

入力を無効にする

変数 (BOOL)要素の操作性を切り替えるため

TRUE:ユーザー入力は、実行時にそれ以上効果がありません。要素は非アクティブとして表示されます。

ヒント

The 見えない プロパティは、「クライアントアニメーション」機能によってサポートされています。

アニメーション

ヒント

これらのプロパティは、を選択した場合にのみ使用できます。 クライアントアニメーションとネイティブ要素のオーバーレイをサポートする のオプション Visualization Manager

アニメーションの長さ

要素がアニメーションを実行する期間(ミリ秒単位)の変数

  • 変数(整数値)

    例: Menu.tContentVAR tContent : INT := 500; END_VAR

  • 整数リテラル

    例: 500

. アニメート可能なプロパティ
  • 絶対的な動き動きバツY

  • 絶対的な動き回転

  • 絶対的な動き内部回転

  • 絶対的な動き外旋

アニメーション化された動きは、アニメーション化可能なプロパティの少なくとも1つの値が変更されたときに実行されます。その後実行される動きはぎくしゃくしていませんが、指定されたアニメーション時間内でスムーズです。視覚化要素は、動的に回転しながら指定された位置に移動します。移行はスムーズです。

フォアグラウンドに移動

変数 (BOOL)前景に要素を設定するため

TRUE:実行時に、視覚化要素がフォアグラウンドに表示されます。

FALSE:実行時に、視覚化要素は、視覚化エディターで挿入されたレイヤーに表示されます。

例: bIsInForegroundVAR bIsInForeground : BOOL := FALSE; END_VAR

入力構成

プロパティには、マウスまたはキーボードを使用するときのユーザー入力の構成が含まれています。ユーザー入力は、イベントと、イベントが発生したときに実行される1つ以上のアクションを定義します。

ヒント

The 構成、設定 ボタンを開くと 入力構成 ダイアログ。そこで、ユーザー入力を作成または編集できます。

構成されたユーザー入力は、イベントの下に一覧表示されます。それぞれに、トリガーされるアクションと短い形式の設定が含まれています。

例: STコードを実行する_visu_icon_action.png PLC_PRG.i_x := 0;

OnDialogClosed

入力イベント:ユーザーはダイアログを閉じます。

OnMouseClick

入力イベント:ユーザーが要素領域でマウスボタンを完全にクリックします。マウスボタンをクリックして離します。

OnMouseDown

入力イベント:ユーザーがマウスボタンをクリックします。

OnMouseEnter

入力イベント:ユーザーはマウスポインタを要素にドラッグします。

OnMouseLeave

入力イベント:ユーザーがマウスポインタを要素からドラッグします。

OnMouseMove

入力イベント:ユーザーはマウスポインタを要素領域上に移動します。

OnMouseUp

. 入力イベント:
  • ユーザーは、要素領域内でマウスボタンを離します。ユーザーが以前に要素領域の内側または外側でマウスボタンを押したことがあるかどうかは関係ありません。

  • ユーザーは、要素領域内でマウスボタンを押し、要素領域を離れてから、マウスボタンを離します。

注記

これ CODESYS-特定のトリガー動作により、主要な要素のアクションが確実に完了します。キー要素は、のアクションを開始します OnMouseDown のアクションを終了します OnMouseUp

例:ビジュアライゼーションユーザーは、キー要素の要素領域内でマウスボタンを押してから、要素領域の外側にカーソル位置を移動します。とにかくアクションは終了します OnMouseUp トリガーされます。

OnValueChanged

値の変化によりフォローアップアクションをトリガーするイベント

どのフォローアップアクションがトリガーされるかは、 入力構成 ダイアログ。

定義されたフォローアップアクションと対応する構成は、要素プロパティの下に表示されます。

The OnValueChanged イベントはによって無効にすることができます VISU_NO_VALUECHANGED コンパイラは、アプリケーションのプロパティダイアログで定義します。

タップ

マウスクリックイベントが発生すると、で定義された変数 変数 アプリケーションに記載されています。コーディングは FALSEをタップしますキャプチャされた場合はEnterをタップします オプション。

変数

要件: FALSEをタップします オプションはアクティブ化されていません。

変数 (BOOL)マウスクリックイベントの場合

TRUE:マウスクリックイベントが存在します。ユーザーが要素の上でマウスボタンを押す限り、それは続きます。ボタンを離すと終了します。

FALSE:マウスクリックイベントは存在しません。

例: PLC_PRG.bIsTapped

FALSEをタップします

standard icon:マウスクリックイベントは、の補完的な値につながります 変数

TRUE:マウスクリックイベントは存在しません。

FALSE:マウスクリックイベントが存在する間。

キャプチャされた場合はEnterをタップします

standard icon:ユーザー入力時に、マウスボタンが押されている間にマウスポインタが要素領域内でドラッグされているかどうかも考慮されます。

TRUE:マウスクリックイベントが存在し、マウスポインタが要素領域上に移動している間。

FALSE:マウスクリックイベントは存在しません。または、マウスボタンが押されている間に、ユーザーがマウスポインタを要素領域の外に移動します。

値は TRUE ユーザーがポインターを要素領域に戻すとすぐに再び。次に、マウスがキャプチャされます。

切り替える

マウスクリックイベントが開始されると、変数が設定されます。マウスクリックイベントが完了すると、変数がリセットされます。

変数

変数 (BOOL)マウスクリックイベントの終了時に切り替える場合

これは、マウスポインタが要素領域上にあるときにユーザーがマウスボタンを離したときです。マウスポインタが要素領域の外にあるときにユーザーがマウスボタンを離した場合、マウスクリックイベントは終了せず、値は切り替えられません。

ヒント

ユーザーは、マウスポインターを要素領域の外にドラッグすることにより、開始されたトグル入力をキャンセルできます。

キャプチャされた場合は上に切り替えます

standard icon:マウスボタンを離したときにマウスポインタがどこにあるかに関係なく、値が切り替わります。次に、マウスがキャプチャされます。

ホットキー

特定の入力アクションをトリガーするための要素のショートカット

ホットキーイベントが発生すると、 イベント プロパティがトリガーされます。このように、この入力アクションにつながるのは入力アクション自体ではなく、マウス入力アクションです。

入力アクションのために押されたキー。

例: T

キーを選択すると、次のプロパティが表示されます。

イベント

  • なし

  • マウスダウン:キーを押すと、で設定されている入力アクションがトリガーされます。 OnMouseDown 財産。

  • マウスアップ:キーを離すと、で設定されている入力アクションがトリガーされます OnMouseUp 財産。

  • マウスダウン/アップ:キーを押して放すと、で設定されている入力アクションがトリガーされます。 OnMouseDown プロパティと OnMouseUp 財産。

切り替える

standard icon:「Shift」キーとの組み合わせ

例: シフト+T

コントロール

standard icon:「Ctrl」キーとの組み合わせ

例: Ctrl+T

Alt

standard icon:「Alt」キーとの組み合わせ

例: Alt+T

ヒント

ビジュアライゼーションで構成されているすべてのキーボードショートカットとそのアクションは、 キーボード構成 タブ。

アクセス権

注記

ユーザー管理が視覚化用に設定されている場合にのみ使用できます。

アクセス権 ボタン

を開きます アクセス権 ダイアログ。そこで、要素のアクセス権限を編集できます。

. ステータスメッセージ:
  • 設定されていません。完全な権利。:すべてのユーザーグループのアクセス権: 操作可能

  • 権利が設定されています:制限付き権利:少なくとも1つのグループのアクセスが制限されています。