グラフィックの表示
- Last UpdatedApr 28, 2026
- 3 minute read
ポップアップ ウィンドウ内にグラフィックを表示します。ShowGraphic() 関数は InTouch HMI ウィンドウを呼び出すために拡張されています。この関数は、産業用グラフィック クライアント スクリプト内で使用できます。
注意: ShowGraphic() 関数はレイアウト表示には使用しないでください。場合によっては機能する可能性がありますが、結果に一貫性がなく、推奨されません。代わりに、 ShowContent() 関数を使用します。
カテゴリ
グラフィック クライアント
構文
ポップアップウィンドウ内にグラフィックを表示する
暗いグラフィックInfoasaaGraphic.GraphicInfo;
graphicInfo.Identity = "<Identity>";
graphicInfo.GraphicName="symbol01"。
ShowGraphic( graphicInfo );
HMIウィンドウを呼び出す
暗いグラフィックInfoasaaGraphic.GraphicInfo;
graphicInfo0.Identity = "<<HMIName>:WindowName>";
ShowGraphic( graphicInfo );
パラメータ
グラフィック情報
データ型
aaGraphic.GraphicInfoのプロパティ
aaGraphic.GraphicInfoのプロパティ
ContentInfoは事前定義された構造体で、以下のデータ要素を含みます。
|
ID |
グラフィックを開いたインスタンスを識別する一意の名前。 IDには329文字以上を含めず、1文字以上を含む必要があります。有効な文字は、英数字および特殊文字($、#、_)です。 これは、文字列の必須プロパティデータタイプ。 デフォルト値なし 例: graphicInfo.Identity = "<Identity>"; |
|
グラフィック名 |
表示するグラフィックの名前。 GraphicNameには329文字以上を含めず、1文字以上を含む必要があります。有効な文字は、英数字および特殊文字($、#、_)です。 これは、文字列の必須プロパティデータタイプ。 デフォルト値なし HMI/SCADA アプリケーション ブラウザ([Galaxy ブラウザを表示]または HMI/SCADA ソフトウェア内の同等機能)を使用して参照するか、グラフィック名を直接入力します。アプリケーション名は以下から派生することがあります。
|
|
所有オブジェクト |
ShowGraphic()スクリプト関数によって表示されるグラフィックの所有オブジェクト。 OwningObjectプロパティこれは定数文字列および参照文字列の連結である場合があります。[オートメーションオブジェクトブラウザを表示]を使用して参照するか、所有オブジェクトの名前を入力することができます。 OwningObject プロパティはグラフィックの参照を設定しますが、グラフィックがオブジェクト ウィザードの一部である場合、GraphicName プロパティに関連付けられません。したがって、所有オブジェクトを使用してグラフィックのスクリプトを記述する場合、所有オブジェクトの名前をGraphicNameプロパティの一部として指定します(UserDefined_001.Pump_001など)。 UserDefined_001.Pump_001を選択してください。 これは、データタイプ文字列の任意のプロパティです。 既定値:空 例: 例:graphicInfo.OwningObject="UserDefined_001"; |
|
HasTitleBar |
タイトルバー付きでグラフィックを表示するかどうかを決定します。 これは、データタイプBooleanの任意のプロパティです。 デフォルト値:True 例: graphicInfo.HasTitleBar=false。 |
|
WindowTitle |
ウィンドウのタイトルバーに表示するタイトルを指定します。 これは、データタイプ文字列の任意のプロパティです。 既定値:空 有効な範囲:1024文字を制限します。 定数文字列、参照、または式です。オートメーションオブジェクトグラフィックの所有オブジェクトを変更した場合、ウィンドウタイトルも更新されます。WindowTitleパラメータが空の場合、Identityパラメータの値がタイトルバーに表示されます。 例: これは、データタイプBooleanの任意のプロパティです。 graphicInfo.WindowTitle = "Graphic01"; |
|
WindowType |
ウィンドウタイプ(ModalまたはModeless)を指定します。 これは、データタイプ列挙の任意のプロパティです。 既定値:モードレス 有効な範囲:0または1ここで
例: graphicInfo.WindowType = aaGraphic.WindowType.<windowtype>; graphicInfo.WindowType=1。 |
|
[HasCloseButton] |
ポップアップウィンドウに[閉じる]ボタンを表示するかどうかを決定します。 これは、データタイプBooleanの任意のプロパティです。 デフォルト値:True 例: graphicInfo.HasCloseButton=false。 |
|
サイズ変更可能 |
ポップアップウィンドウのサイズを変更できるかどうかを決定します。 これは、データタイプBooleanの任意のプロパティです。 初期値は「False」になっています。 例: graphicInfo.Resizable=true。 |
|
WindowLocation |
ポップアップウィンドウを表示する位置を指定します。 これは、データタイプ列挙の任意のプロパティです。 既定値:0(中央) 有効な範囲は0~12で、ウィンドウの場所は対応する列挙値で設定されます。 0=中央 ウィンドウの相対位置(WindowRelativePosition)としてDesktopを選択した場合、Above、LeftOf、RightOf、およびBelowは無効です。WindowLocationパラメータの動作の詳細については、『産業用グラフィックの作成および管理ユーザーガイド』の「グラフィックの表示/非表示スクリプト関数の操作」を参照してください。 例: graphicInfo.WindowLocation=aaGraphic.WindowLocation.Bottom; graphicInfo.WindowLocation=1。 |
|
WindowRelative |
ポップアップウィンドウの相対位置を指定します。 これは、データタイプ列挙の任意のプロパティです。 既定値:0(デスクトップ) 有効な範囲は0~8で、ウィンドウの相対位置は対応する列挙によって設定されます。 0=デスクトップ 例: graphicInfo.WindowRelativeCanonical=aaGraphic.WindowRelativeCanonical.<WindowRelativeドラッグアンドドロップ>; graphicInfo.WindowRelativeAjax=1。 |
|
RelativeTo(相対値) |
グラフィック、デスクトップ、またはカスタム幅と高さに相対的なポップアップウィンドウのサイズを指定します。 これは、データタイプ列挙の任意のプロパティです。 既定値:0(画像) 有効な範囲:0、1、2。 0=グラフィック aaGraphic.RelativeTo.CustomizedWidthHeightを入力した場合、高さと幅の値をスクリプトに含めることができます。それ以外の場合は、デフォルト値が使用されます。 例: graphicInfo.RelativeTo = aaGraphic.RelativeTo.Desktop; graphicInfo.RelativeTo=1。 |
|
XX |
ポップアップウィンドウの水平位置。 これは、整数の任意指定データタイププロパティです。 初期値は0になっています。 -2,147,483,648~2,147,483,647 Xが整数の範囲外である場合、ランタイム時にオーバーフローメッセージがロガーに表示されます。 このパラメータは、WindowRelativePositionパラメータの値がDesktopXY、WindowXY、またはClientAreaXYの場合にのみ適用されます。ShowSymbol アニメーションとは異なり、この値に制限はありません。 例: graphicInfo.X=100; |
|
Y |
ポップアップウィンドウの垂直位置を指定します。 これは、整数の任意指定データタイププロパティです。 初期値は0になっています。 -2,147,483,648~2,147,483,647 Y整数の範囲外である場合、ランタイム時に適切なオーバーフローメッセージがロガーに表示されます。この値は、WindowRelativePositionパラメータがDesktopXY、WindowXY、またはClientAreaXYの場合にのみ適用されます。ShowSymbol アニメーションとは異なり、この値に制限はありません。 例: graphicInfo.Y=100; |
|
幅 |
ポップアップウィンドウの幅を指定します。 これは、整数の任意指定データタイププロパティです。 既定値:100 有効な範囲:0~10000 RelativeToが[CustomizedWidthHeight]の場合にのみ適用されます。ポップアップウィンドウの高さまたは幅を指定できます。もう一方の値は、グラフィックのアスペクト比に基づいて計算されます。範囲外の値を入力した場合、ランタイム時に「範囲外です」メッセージが表示されます。10000 よりも大きい値は 10000 に設定されます。0 よりも小さい値は 0 に設定されます。 例: graphicInfo.width=500; |
|
高さ |
ポップアップウィンドウの高さを指定します。 これは、整数の任意指定データタイププロパティです。 既定値:100 有効な範囲:0~10000 RelativeToがCustomizedWidthHeightパラメータの値である場合にのみ適用されます。ポップアップ ウィンドウの高さまたは幅のいずれかを指定できます。もう一方の値は、グラフィックのアスペクト比に基づいて計算されます。範囲外の値を入力した場合、ランタイム時に「範囲外です」メッセージが表示されます。10000 よりも大きい値は 10000 に設定されます。0 よりも小さい値は 0 に設定されます。 例: graphicInfo.height=500; |
|
最上位 |
ShowGraphicをz順序ウィンドウのTopmost(最上部)に表示するかどうかを指定する値を設定します。TopmostプロパティがTrueに設定されたShowGraphicは、TopMostプロパティがFalse(Windowsタスクマネージャと同じ)に設定されたすべてのウィンドウの上に表示されます。 これは、データタイプBooleanの任意のプロパティです。 初期値は「False」になっています。 TopmostプロパティがTrueに設定されたウィンドウのグループでは、アクティブなウィンドウが一番上のウィンドウになります。TopMost ダイアログから非 TopMost のモーダル ダイアログを起動するスクリプトを作成しないでください。TopMost ウィンドウによってモーダル ダイアログが完全に非表示にされている場合、ユーザーはビューを操作できません。 例: graphicInfo.TopMost=true; |
|
スケールのPercentage |
ポップアップウィンドウおよびそれを含むグラフィックのスケーリングパーセンテージを設定します。 これは、整数の任意指定データタイププロパティです。 既定値:100 有効な範囲:0~1000 範囲外の値を入力した場合、ランタイム時に「範囲外です」メッセージが表示されます。値が1000>場合、1000に設定されます。0 よりも小さい値は 0 に設定されます。 例: graphicInfo.ScalePercentage=150; |
|
KeepOnMonitor |
ポップアップウインドウをアプリケーションウィンドウの境界内全体に表示します。 これは、データタイプBooleanの任意のプロパティです。 デフォルト値:True 例: graphicInfo.KeepOnMonitor=true; |
|
StretchGraphicToFit |
グラフィックがポップアップウィンドウの現在のサイズまで拡大するかどうかを決定します。 これは、データタイプBooleanの任意のプロパティです。 デフォルト値:True ScalePercentageパラメータの値が100よりも大きい場合にのみ適用されます。 例: graphicInfo.StretchGraphicToFitWindowSize=false。 |
|
HeightStretchWindow
|
ポップアップウィンドウを画面と同じ幅まで拡大するかどうかを決定します。 これは、データタイプBooleanの任意のプロパティです。 初期値は「False」になっています。 WindowRelativePosition パラメータが Desktop、Window、ClientArea、ParentGraphic、または ParentElement の場合にのみ適用されます。 例: graphicInfo.StretchWindowToScreenWidth=true; |
|
HeightStretchWindow
|
ポップアップウィンドウを画面と同じ高さまで拡大するかどうかを決定します。 これは、データタイプBooleanの任意のプロパティです。 初期値は「False」になっています。 WindowRelativePositionパラメータがDesktop、Window、ClientArea、ParentGraphic、またはParentElementの場合にのみ適用されます。 例: graphicInfo.StretchWindowToScreenHeight=true; |
|
CustomProperties<1/>CustomProperties |
CustomPropertiesは、表示されるグラフィックのカスタムプロパティを設定するために使用されるValuePair[]配列です。 これは、データタイプValuePair[]の任意指定プロパティです。 最初の3つのパラメーターは次のとおりです。
|
GraphicInfoプロパティの概要
|
プロパティ名 |
必須 |
データ型 |
デフォルト値 |
|---|---|---|---|
|
ID |
可 |
文字列 |
なし |
|
グラフィック名 |
可 |
文字列 |
なし |
|
所有オブジェクト |
不可 |
文字列 |
なし |
|
HasTitleBar |
不可 |
ブール型 |
空 |
|
WindowTitle |
不可 |
文字列 |
空 |
|
WindowType |
不可 |
列挙型 |
モードレス |
|
[HasCloseButton] |
不可 |
ブール型 |
True |
|
サイズ変更可能 |
不可 |
ブール型 |
False |
|
WindowLocation |
不可 |
列挙型 |
中央 |
|
WindowRelative取り下げ |
不可 |
列挙型 |
デスクトップ |
|
RelativeTo(相対値) |
不可 |
列挙型 |
グラフィック |
|
XX |
不可 |
整数型 |
0 |
|
Y |
不可 |
整数型 |
0 |
|
幅 |
不可 |
整数型 |
100 |
|
高さ |
不可 |
整数型 |
100 |
|
最上位 |
不可 |
ブール型 |
False |
|
スケールのPercentage |
不可 |
整数型 |
100 |
|
KeepOnMonitor |
不可 |
ブール型 |
True |
|
[StretchGraphicToFitWindowSize] |
不可 |
ブール型 |
True |
|
HeightStretchWindow ToScreenWidth |
不可 |
ブール型 |
False |
|
[StretchWindowToScreenHeight] |
不可 |
ブール型 |
False |
|
CustomProperties<1/>CustomProperties |
不可 |
ValuePair[]配列 |
空 |
備考
-
GraphicInfo 内のデフォルト値のあるパラメータはすべてオプションです。パラメータに入力値が指定されていない場合は、ランタイム時にデフォルト値が使用されます。
-
列挙データ型を除くすべてのパラメータは、定数、参照、または式です。
-
任意の文字列プロパティは、文字列やカスタムプロパティの連結です。
-
詳細については、『産業用グラフィック エディタ ユーザー ガイド』の「グラフィックの表示/非表示スクリプト関数の操作」を参照してください。
ShowGraphic の例
基本的なスクリプト例:
暗いグラフィックInfoasaaGraphic.GraphicInfo;
graphicInfo.Identity="showpump_script001";
graphicInfo.GraphicName="symbol001";
ShowGraphic( graphicInfo );
高度なスクリプト例:
暗いグラフィックInfoasaaGraphic.GraphicInfo;
Dim cpValues [2] as aaGraphic.CustomPropertyValuePair;
cpValues[1]=新しいaaGraphic.CustomPropertyValuePair("CP1",20,true);
cpValues[2]=新しいaaGraphic.CustomPropertyValuePair("CP2","Pump.PV.TagName",false);
graphicInfo.Identity = "<Identity>";
graphicInfo.GraphicName = "S1";
例:graphicInfo.OwningObject="UserDefined_001";
graphicInfo.WindowTitle = "Graphic01";
graphicInfo.Resizable=false;
graphicInfo.CustomProperties=cpValues;
ShowGraphic( graphicInfo );
ここで "i1" は文字列 ID であり、グラフィック "S1" にはカスタム プロパティ CP1 と CP2 が含まれています。
ポップアップ ウィンドウ内にグラフィックを表示する
ShowGraphic( graphicInfo );
HMI ウィンドウを表示する
暗いgraphicInfo0asaaGraphic.GraphicInfo;
graphicInfo0.Identity = "<<HMIName>:WindowName>";
ShowGraphic( graphicInfo );
次もご確認ください。
ShowContent()