インターフェイスを使用したダイアログの呼び出し

ダイアログと呼ばれる視覚化のインターフェースを定義できます。

視覚化タイプを使用して、このための視覚化を作成しますダイアログダイアログのインターフェースを宣言します。ユーザー入力を使用してプライマリビジュアライゼーションのビジュアライゼーションを参照し、パラメータをインターフェイスに転送します。

ビジュアライゼーションを統合ビジュアライゼーションと呼ぶ場合、転送されるパラメータは基本データ型の変数である必要があります。ビジュアライゼーションが次のように呼び出される場合 CODESYS TargetVisu また CODESYS WebVisuの場合、パラメータにはユーザー定義のデータ型も含めることができます。

主な手順

ビジュアライゼーションのビジュアライゼーションタイプをダイアログに設定します。
ダイアログのインターフェイスエディタで変数を宣言します。
ダイアログにはインターフェースがあります。ダイアログを呼び出すときにパラメータを転送できます。
ダイアログの要素を構成し、インターフェース変数を使用します。
ダイアログの開き方を構成するために、別のビジュアライゼーション（通常はメインビジュアライゼーション）の要素を選択します。
の中に入力設定→OnMouseDown プロパティをクリックします構成、設定。
The 入力構成ダイアログが開きます。
選択するダイアログを開く選択した入力アクションのリスト。
から1つを選択しますダイアログリストボックス。
選択したダイアログにインターフェースがある場合、インターフェース変数は以下のとおりです。
転送パラメータをのインターフェイス変数に割り当てます価値桁。
パラメータが更新された結果を選択しますアップデートと結果の場合のパラメータリスト。
オプションを有効にするダイアログモーダルを開く。クリックわかったダイアログを終了します。
ダイアログオープニングが設定されます。

ヒント

ダイアログを同時に複数回実行するには、ダイアログの複数のインスタンスが必要です。これらは、アプリケーションをダウンロードするときに、視覚化デバイスにすでにダウンロードされている必要があります。この目的のために、Visualization Managerでダウンロードするインスタンスの数を設定します（視覚化タブ）。

例 19. ダイアログ： visChangeUserLevel：

例 20. 主な視覚化： visMain：

表 6. visMainビジュアライゼーションの要素リスト：

タイプ	名前	要素のプロパティ	説明
`#5 Text field`	`Button for change user level`	テキスト→テキスト： `%s`	プレースホルダー付きの出力
		テキスト変数→テキスト変数： `PLC_PRG.iLevel`	の割り当て `PLC_PRG.iLevel` プレースホルダーへの変数。レベル番号が含まれています。
`#6 Button`	`Title`	テキスト→テキスト： `Change user level`
		入力設定→OnMouseDown→ダイアログを開く： `Open Dialog: visChangeUserLevel`	ユーザーがクリックすると `Change User Level` ボタン、 `visChangeUserLevel` ここに保存されているパラメータリストでダイアログが開きます。ヒント：クリック構成、設定に保存されている構成を表示するには入力構成ダイアログ（入力アクションダイアログを開く）。

表 7. ダイアログvisChangeUserLevelの呼び出しの構成

パラメータ	タイプ	価値	説明
パラメータリストはに保存されます入力構成ダイアログ（入力アクションダイアログを開く）。
`sItfTitle`	`STRING`	`'ChangeUse user level'`	タイトルの文字列の転送。
`sItfLevel0`	`STRING`	`'pwd0'`	Level0のパスワードとしての文字列の転送。
`sItfLevel1`	`STRING`	`'pwd1'`	Level1のパスワードとしての文字列の転送。
`sItfLevel2`	`STRING`	`'pwd2'`	Level2のパスワードとしての文字列の転送。
`sItfLevel3`	`STRING`	`'pwd3'`	Level3のパスワードとしての文字列の転送。
`sItfLevel4`	`STRING`	`'pwd4'`	Level4のパスワードとしての文字列の転送。
`sItfLevel5`	`STRING`	`'pwd5'`	Level5のパスワードとしての文字列の転送。
`sItfLevel6`	`STRING`	`'pwd6'`	Level6のパスワードとしての文字列の転送。
`sItfLevel7`	`STRING`	`'pwd7'`	Level7のパスワードとしての文字列の転送。
`iItfLevel`	`INT`	`PLC_PRG.iLevel`	ユーザーが指定したレベルの変数の転送。
`sItfPwd`	`STRING`	`PLC_PRG.sPwd`	ユーザーが指定したパスワードの変数の転送。

表 8. 結果の場合のリストの更新とパラメータ

価値	説明
わかった	有効

ダイアログモーダルを開く

有効ダイアログ外への入力はできません。

次のアプリケーションは、ユーザーレベルの変更ダイアログが表示され、レベルを選択してパスワードを指定するようにユーザーに求めます。パスワードが一致する場合は、わかったボタンが有効になります。その後、ユーザーはダイアログを閉じることができます。レベルの入力も適用されます。

ダイアログのインターフェースの宣言 visChangeUserLevel：

VAR_INPUT
    sTitle: STRING; // titel of the dialog box
    sItfLevel0: STRING; //password level 0
    sItfLevel1: STRING; //password level 1
    sItfLevel2: STRING; //password level 2
    sItfLevel3: STRING; //password level 3
    sItfLevel4: STRING; //password level 4
    sItfLevel5: STRING; //password level 5
    sItfLevel6: STRING; //password level 6
    sItfLevel7: STRING; //password level 7
END_VAR
VAR_IN_OUT
    iItfLevel: INT; // user input: level
    sItfPwd: STRING; //user input: password
END_VAR

表 9. visChangeUserLevelダイアログの要素リスト：

タイプ	名前	要素のプロパティ	説明
`#0 Image`	`Background`	静的ID： `VisuDialogs.ImagePoolDialogs.Login`	このプロパティは、背景が灰色で青いタイトルバーが空白の空白のダイアログの画像を要素に割り当てます。画像はに含まれています VisuDialogs 図書館。
`#1 Rectangle`	`Title`	テキスト→テキスト： `%s`	テキスト変数のプレースホルダー付きの出力
		テキスト変数→テキスト変数： `sItfTitle`	インターフェイス変数の割り当て `sItfTitle` 呼び出し時にパラメータが転送される対象。
`#2 Radio button`	`Input level`	変数： `iItfLevel`	インターフェイス変数の割り当て `iItfLevel` 呼び出し時にパラメータが転送される対象。実行時のユーザー入力が含まれます。
		列の数： `4`
		ラジオボタンの注文：左から右へ	画面
		ラジオボタンの設定→ラジオボタン→エリア：[0]ビス[7] [<n>]→テキスト：<n>	0から7までの数字が付いた8つのラジオボタンのラベル
`#3 Text field`	`Input password`	テキスト→テキスト： `%s`	テキスト変数のプレースホルダー付きの出力
		テキスト変数→テキスト変数： `sItfPwd`	インターフェイス変数の割り当て `sItfPwd` 呼び出し時にパラメータが転送される対象。実行時のユーザー入力が含まれます。
		入力設定→OnMouseDown→変数の書き込み： `Variable:,InputType:Edit,Use text output variable: TRUE`	の中に入力構成ダイアログ、テキスト入力に選択されています入力方式リストボックスとオプションテキスト出力変数を使用するがアクティブになります。
`#4 Text field`	`Label for level`	テキスト→テキスト： `Level:`	ラベル
`#5 Text field`	`Label for password`	テキスト→テキスト： `Password`	ラベル
`#6 Button`	`OK`	テキスト→テキスト： `OK`	ラベル
		色→色： `Element base color` 色→アラームの色： `Alarm filling color`	状態に依存する色でのディスプレイの構成。色を切り替えることができます。
		色変数→色の切り替え： `sItfPwd <> MUX(iItfLevel, sItfLevel0, sItfLevel1, sItfLevel2, sItfLevel3, sItfLevel4, sItfLevel5, sItfLevel6, sItfLevel7);`	パスワードとユーザー入力が一致しない場合、式は次のようになります。 `TRUE`。次に、ボタンがアラームカラーで表示されます。
		状態変数→入力の非アクティブ化： `sItfPwd <> MUX(iItfLevel, sItfLevel0, sItfLevel1, sItfLevel2, sItfLevel3, sItfLevel4, sItfLevel5, sItfLevel6, sItfLevel7);`	パスワードとユーザー入力が一致しない場合、式は次のようになります。 `TRUE`。ボタンが無効になります。パスワードが一致すると、ボタンが有効になります。
		入力設定→OnMouseDown→閉じるダイアログ： `Close Dialog: visChangeUserLevel, Result: OK`	ユーザーがクリックした場合わかったボタン、次に `visChangeUserLevel` ダイアログが閉じられ、パラメータが更新されます。
`#7 Button`	`Cancel`	テキスト→テキスト： `Cancel`	ラベル
		色→色： `Element base color`	画面
		入力設定→OnMouseDown→閉じるダイアログ： `Close Dialog: visChangeUserLevel, Result: Cancel`	ユーザーがクリックした場合キャンセルボタン、次に `visChangeUserLevel` ダイアログが閉じます。

例 21. アプリケーションコード PLC_PRG：

PROGRAM PLC_PRG
VAR
    iLevel: INT;
    sPwd : STRING;
END_VAR

例 22. 実行時の視覚化

ボタンをクリックすると、ダイアログが開き、入力が可能になります。指定されたテキストが保存されたテキストと一致する場合、わかった有効になっています：

クリックした後わかった、選択が適用されます。

ヒント

この例は、複数の戻り値の手順を示しています。ただし、ダイアログのローカル変数を使用すると、パスワードをより簡単に返すことができます。

プログラムによるパラメータへのアクセス

ビジュアライゼーションのインターフェースで宣言された変数は、構造変数として自動的に使用できます。それらはによって識別されます <name of visualization>_VISU_STRUCT。したがって、ダイアログとして表示されるビジュアライゼーションのインターフェイス変数にアクセスできます。通常、ユーザー入力によって呼び出される関数のアプリケーションコードで構造を使用します。

パラメータとしてポインタを渡す

複雑なデータ構造を渡すために、タイプのインターフェース変数にフラグを立てることができます VAR_IN_OUT プラグマ属性を使用 VAR_IN_OUT_AS_POINTER ポインタまたはそれへの参照をパラメータとして渡します。

手順. 参照の使用手順

ユーザーデータオブジェクトを宣言します（DUT）。
ダイアログのインターフェイスエディタで、インターフェイス変数を宣言します（VAR_IN_OUT）属性を割り当てることにより、データオブジェクトへの参照として 'VAR_IN_OUT_AS_POINTER' 変数に。
ユーザーインターフェイスをプログラムします。ビジュアライゼーションでダイアログを使用するか、ビジュアライゼーション要素の入力構成でダイアログを割り当てます。その後、参照データへのアクセスが可能になります。

例 23. 例：「VAR_IN_OUT_AS_POINTER」プラグマを使用したインターフェースの使用。

FUNCTION_BLOCK ControlFB
VAR_INPUT
END_VAR
VAR_OUTPUT
END_VAR
VAR
    bOk : BOOL := TRUE;
    nCounter : INT;
    nValue : INT;
END_VAR
nCounter := nCounter + 1;

とのインターフェース変数の宣言 VAR_IN_OUT_AS_POINTER

ユーザーインターフェイス：ダイアログが開きます：

このセクションの内容: