Skip to main content

視覚化要素: ボタン

シンボル:

_visu_img_button.png

カテゴリ:共通コントロール

要素は変数の設定などのアクションをトリガーします。

要素のプロパティ

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

すべてのプロパティは、高度なオプションまたはすべてのカテゴリーフィルターインプロパティ

要素名

例: Voltage_on

ヒント

要素リスト内で要素がより早く見つかるよう、要素に個別の名前を割り当てます。

要素タイプ

ボタン

位置

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

X

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

例:10

Y

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

例:10

ピクセル単位で指定

例:150

身長

ピクセル単位で指定

例:30

ヒント

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

中心

プロパティには回転点の座標の固定値が含まれています。回転点はエディタ上で次のように表示されます。_visu_icon_center_point.pngシンボルであり、回転と拡大縮小の中心として使用されます。

ヒント

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

X

回転点のX座標

Y

回転点のY座標

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

通常の状態の要素の色

注記

注: アラーム状態は、次の式が有効な場合に有効になります。 カラー変数 → カラーの切り替え プロパティには値があります FALSE

アラームの色

アラーム状態の要素の色

注記

注: アラーム状態は、次の式が有効な場合に有効になります。 カラー変数 → カラーの切り替え プロパティには値があります TRUE

透明性

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

255:色が不透明です。

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

注記

色がスタイル カラーであり、すでに透明度の値がある場合、このプロパティは書き込み保護されます。

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

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

グラデーション設定

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

画像

静的ID

次のスキームに従った画像プールの画像への参照:

<イメージプールの名前>。<イメージID>

例: Imagepool.GreenButton

画像が GlobalImagePool、このプールが最初に自動的に検索されるため、イメージプールの名前を省略できます。

_cds_icon_three_dots.png入力アシスタント ダイアログが開き、プロジェクト全体で使用可能なすべての画像プールと画像が一覧表示されます。

スケールタイプ

. ボタンのサイズを変更するときの画像の動作。
  • 等方性:画像はその比率を保持します。ボタンの高さや幅を個別に変更しても、高さと幅の比率は維持されます。

  • 異方性:画像はボタンのサイズにサイズ変更されます。

  • 修理済み:ボタンのサイズを変更しても、画像は元のサイズのままです。

透明性

ビジュアライゼーションは、で選択された透明色で画像を表示します 透明色

透明色

要件: 透明性 オプションが選択されています。

画像に透明な色

例:

によって参照されている画像の背景の場合 静的ID が白の場合、この背景は透明に表示されます。

クリックする _cds_icon_three_dots.png カラーピッカーダイアログを開きます。

水平方向の配置

. 画像の水平方向の配置
  • 中央揃え

垂直方向の配置

. 画像の垂直方向の配置
  • 中央揃え

テキスト

文章

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

例: 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

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

Y

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

    例: PLC_PRG.iPos_Y

  • コンテナ変数: Container.Height

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

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

回転

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

例: PLC_PRG.iAngle1

要素の中点はで回転します 中心 点。この回転点は、 _visu_icon_center_point.png シンボル。

実行時、要素の配置は、ビジュアライゼーションの座標系に関して同じままです。値を大きくすると、要素が右に回転します。

_visu_img_prp_rotation.png

スケーリング

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

例: PLC_PRG.iScaling

基準点は 中心 財産。

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

ヒント

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

ヒント

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

相対的な動き

プロパティには、要素を移動するための変数が含まれています。基準点は要素の位置です(位置 財産)。要素の形状は変わる可能性があります。

左上の移動

X

  • 数(ピクセル単位)の変数(整数データ型) エッジが水平に移動します

    例: PLC_PRG.iDeltaX

値をインクリメントすると、要素が右に移動します。

Y

  • 数(ピクセル単位)の変数(整数データ型) エッジが垂直に移動します

    例: PLC_PRG.iDeltaY

値をインクリメントすると、要素が下に移動します。

右下の動き

X

  • 数(ピクセル単位)の変数(整数データ型) 正しい エッジが水平に移動します。

    例: PLC_PRG.iDeltaWidth

  • コンテナ変数: Container.Width

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

値をインクリメントすると、要素が右に移動します。

Y

  • 数(ピクセル単位)の変数(整数データ型) エッジが垂直に移動します

    例: PLC_PRG.iDeltaHeight

  • コンテナ変数: Container.Height

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

値をインクリメントすると、要素が下に移動します。

テキスト変数

テキスト変数

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

例: 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;

テキスト配置のフラグ

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

例: PLC_PRG.dwTextAlignment

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

  • 1:水平中央

  • 2: 右

  • 4:垂直中心

  • 8: 下

注記

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

ヒント

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

色変数

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

色を切り替える

変数 (BOOL)カラートグル用

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

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

. プロパティの割り当て:
  • 入力構成のユーザー入力変数のプレースホルダー

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

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

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

    注記

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

    ヒント

    クリック _visu_icon_linked_variable.png 挿入する記号 <トグル/タップ変数> プレースホルダー。

    次に、アクティブ化すると 入力構成FALSEをタップします プロパティ、 <変数を切り替え/タップしない> プレースホルダーが表示されます。

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

    例: PLC_PRG.xColorIsToggeled

    注記

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

フレームの色変数

  • 変数 (DWORD)色について

    例: PLC_PRG.dwColor

  • カラーリテラル

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

要件: フレームを表示 プロパティがアクティブになります。

注記

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

アラームの色

アラーム状態のフレームのカラー変数

  • 変数 (DWORD)アラームの色

    例: PLC_PRG.dwAlarmColor

  • カラーリテラル

    赤と不透明の例: 16#FFFF0000

注記

の式が次の場合、アラーム状態が有効になります。 色変数→色の切り替え プロパティには値があります TRUE

ヒント

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

ヒント

のツールバーで プロパティ、 を選択 高度 オプション。次に、すべての要素のプロパティが表示されます。

点滅

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

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

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

点滅間隔

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

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

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

    例: PLC_PRG.udiBlinking

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

    例: 1000 1秒間

状態変数

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

見えない

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

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

例: bIsVisibleVAR bIsVisible : BOOL := FALSE; END_VAR

入力を無効にする

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

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

ヒント

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

ボタンの状態変数

デジタル変数

実行時に、変数はボタンが押された状態で表示されるかどうかを制御します。

. 値の割り当て:
  • FALSE:ボタンは押されていない状態で表示されます。

  • TRUE:ボタンは押された状態で表示されます。

. 要素プロパティに渡される引数:
  • ボタンの表現を入力変数と結合するためのユーザー入力変数のプレースホルダー。

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

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

    注記

    マウスイベントの変数を指定します タップ また トグル ボタンの入力構成で。その場合にのみ、プレースホルダーが設定されます。

    両方で変数を構成する場合 トグルタップ、次にで指定された変数 タップ 使用されている。

    ヒント

    クリック _visu_icon_linked_variable.png 挿入する記号 <トグル/タップ変数> プレースホルダー。

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

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

    例: prgA.xButtonState

    注記

    ここで指定された変数のコードに値の割り当てを実装します。

画像ID変数

画像ID

変数 (STRING)画像IDの場合

例: PLC_PRG.stImageID

アプリケーションコード: PLC_PRG.stImageID := 'ImagePool_A.Bild3';

変数値は、正式には画像プールの特定の画像を参照し、 静的ID 財産。

アニメーション

ヒント

これらのプロパティは、クライアントアニメーションとネイティブ要素のオーバーレイをサポートオプションのVisualization Manager

アニメーションの長さ

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

  • 変数(整数値)

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

  • 整数リテラル

    例:500

. アニメーション可能なプロパティ
  • 絶対的な動き動き Xはい

  • 絶対的な動き回転

  • 絶対的な動き内部回転

  • 絶対的な動き外側回転

アニメーション化された動きは、アニメーション可能なプロパティの値が少なくとも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 つのグループへのアクセスが制限されています。