ShowGraphic()

身份标识

Identity 属性是标识哪个实例打开了该图形的唯一名称。

Identity 不能包含超过 329 个字符，且必须至少包含一个字母。有效字符为字母数字和特殊字符（$、#、_）。

这是字符串数据类型的必需属性。

默认值：无

示例：

graphicInfo.Identity = "i1";

GraphicName

GraphicName 是要显示的图形的名称。

GraphicName 不能包含超过 329 个字符，且必须至少包含一个字母。有效字符为字母数字和特殊字符（$、#、_）。

这是字符串数据类型的必需属性。

默认值：无

使用 HMI/SCADA 应用程序浏览器进行浏览，如显示 Galaxy 浏览器或 HMI/SCADA 软件中的等效浏览器，或者直接输入图形名称。应用程序名称可以来自：

• “可视化”文件夹，例如：
  "Symbol_001"

• 绝对实例或层次实例的示例如下：
  "Userdefined_001.Symbol1", "Userdefined_001.Pump_001.S1"

• 相对引用，例如：
  "Me.Symbol_001"

  如果您将对象向导与符号向导自定义属性选择一起使用，请使用绝对名称来指定 GraphicName 和 OwningObject。这样才能正确显示实例的图形配置。有关详细信息，请参阅下面的 OwningObject。

  如果输入任意无效字符或超出字符数限制，则系统将在运行时显示警告消息。设计时没有验证。

  图形名称可以是常量字符串和引用字符串的串联。示例：

  "Pump_001" + ".Symbol_001"; cp1 + ".Symbol_001", where the value of cp1 = "Pump_001"; or Obj1.Str1 + ".Symbol_001"，其中 Obj.Str1 的值 = "Pump_001"。

  示例：

  要指定“可视化”文件夹引用：

  graphicInfo.GraphicName = "S1";

  要指定绝对引用：

  graphicInfo.GraphicName = "OwningObjectName.SymbolName";

OwningObject

ShowGraphic() 脚本函数所显示的图形的父对象的名称。

OwningObject 是可选属性。它可以是常量字符串和引用字符串的串联。OwningObject 可以使用显示自动对象浏览器进行浏览，也可以输入父对象的名称。

OwningObject 属性为图形设置引用，但是如果图形属于对象向导的一部分，那么该属性与 GraphicName 属性没有关联。因此，如果使用父对象来编写图形脚本，请指定父对象名称作为 GraphicName 属性的一部分，例如：

UserDefined_001.Pump_001。

这是字符串数据类型的可选属性。

默认值：空

示例：

graphicInfo.OwningObject = "UserDefined_001";

HasTitleBar

HasTitleBar 确定显示图形时有没有标题栏。

这是布尔数据类型的可选属性。

默认值：True

示例：

graphicInfo.HasTitleBar = false;

WindowTitle

WindowTitle 指定窗口标题栏中显示的标题。

这是字符串数据类型的可选属性。

默认值：空

有效范围：限制 1024 个字符。

WindowTitle 可以是常量字符串、引用或表达式。如果更改“自动化对象”图形的父对象，则 WindowTitle 会相应更新。如果 WindowTitle 参数为空，则标题栏会显示 Identity 属性的值。

示例：

这是布尔数据类型的可选属性。

graphicInfo.WindowTitle = "Graphic01";

WindowType

WindowType 指定窗口类型为模式或无模式。

这是枚举数据类型的可选属性。

默认值：无模式

有效范围：0 或 1，其中

• 0 = 模式

• 1 = 无模式。

示例：

graphicInfo.WindowType = aaGraphic.WindowType.<windowtype>;

graphicInfo.WindowType = 1;

HasCloseButton

HasCloseButton 确定弹出窗口是否有关闭按钮。

这是布尔数据类型的可选属性。

默认值：True

示例：

graphicInfo.HasCloseButton = false;

Resizable

Resizable 确定弹出窗口是否可以调整大小。

这是布尔数据类型的可选属性。

默认值：False

示例：

graphicInfo.Resizable = true;

WindowLocation

WindowLocation 指定弹出窗口的位置。

这是枚举数据类型的可选属性。

默认值：0（中心）

有效范围：0 到 12，其中窗口位置由相应的枚举设置：

0 = Center
1 = Above
2 = TopLeftCorner
3 = Top
4 = TopRightCorner
5= LeftOf
6= LeftSide
7= RightSide
8 = RightOf
9 = BottomLeftCorner
10 = Bottom
11 = BottomRightCorner
12 = Below

如果已选择 Desktop 作为 WindowRelativePosition（见下文），那么 Above (1)、LeftOf (6)、RightOf (8) 和 Below (12) 均无效。有关 WindowLocation 参数行为的详细信息，请参阅创建与管理工业图形用户指南中的使用显示/隐藏图形脚本函数。

示例：

graphicInfo.WindowLocation = aaGraphic.WindowLocation.<WindowLocation>;

graphicInfo.WindowLocation = 1;

WindowRelative
Position

WindowRelativePosition 指定弹出窗口的相对位置。

这是枚举数据类型的可选属性。

默认值：0 (desktop)

有效范围：0 到 8，其中窗口相对位置由相应的枚举设置。

0 = Desktop
1 = Window
2 = ClientArea
3 = ParentGraphic
4 = ParentElement
5 = Mouse
6 = DesktopXY
7 = WindowXY
8 = ClientAreaXY

示例：

graphicInfo.WindowRelativePosition = aaGraphic.WindowRelativePosition.<WindowRelativePosition>;

graphicInfo.WindowRelativePosition = 1;

RelativeTo

RelativeTo 指定弹出窗口相对于图形、桌面的大小，或者自定义的宽度和高度。

这是枚举数据类型的可选属性。

默认值：0 (Graphic)

有效范围：0、1、2 ，中

0 = Graphic
1 = Desktop
2 = CustomizedWidthHeight

如果输入 aaGraphic.RelativeTo.CustomizedWidthHeight，则可以在脚本中包含高度和宽度值。否则将使用缺省值。

示例：

graphicInfo.RelativeTo = aaGraphic.RelativeTo.<RelativeTo>;

graphicInfo.RelativeTo = 1;

X

X 指定弹出窗口的水平位置。

这是整型数据类型的可选属性。

默认值：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;

宽度

Width 指定弹出窗口的宽度。

这是整型数据类型的可选属性。

默认值：100

有效范围：0–10000

仅在 RelativeTo 为 CustomizedWidthHeight 时适用。您可以指定弹出窗口的高度或宽度。系统会根据图形的纵横比来计算另一个值。如果输入的值超出边界，则系统会在运行时显示“超出范围”消息。如果值 >10000，则设置为 10000。如果值 <0，则设置为 0。

示例：

graphicInfo.width = 500;

高度

Height 指定弹出窗口的高度。

这是整型数据类型的可选属性。

默认值：100

有效范围：0–10000

Height 仅在 RelativeTo 是 CustomizedWidthHeight 参数的值时才适用。您可以指定弹出窗口的高度或宽度。系统会根据图形的纵横比来计算另一个值。如果输入的值超出边界，则系统会在运行时显示“超出范围”消息。如果值 >10000，则设置为 10000。如果值 <0，则设置为 0。

示例：

graphicInfo.height = 500;

TopMost

TopMost 设置值，用于指示 ShowGraphic 显示在 Z 顺序窗口的最顶端。TopMost 属性设置为 true 的 ShowGraphic 会显示在 TopMost 属性设置为 false 的所有窗口上方（与窗口任务管理器相同）。

这是布尔数据类型的可选属性。

默认值：False

如果有一组窗口的 TopMost 属性设置为 true，则活动的窗口是最上方窗口。请不要创建从 TopMost 对话框中启动非 TopMost 模式对话框的脚本。如果模式对话框被任何 TopMost 窗口完全遮挡，则用户无法与该视图进行交互。

示例：

graphicInfo.TopMost = true;

ScalePercentage

ScalePercentage 设置弹出窗口以及其中包含的图形的缩放百分比。

这是整型数据类型的可选属性。

默认值：100

有效范围：0–1000

如果输入的值超出边界，则系统会在运行时显示“超出范围”消息。如果该值大于 1000，则设置为 1000。如果值 <0，则设置为 0。

示例：

graphicInfo.ScalePercentage = 150;

KeepOnMonitor

KeepOnMonitor 指定弹出窗口完全显示在应用程序窗口的边界之内。

这是布尔数据类型的可选属性。

默认值：True

示例：

graphicInfo.KeepOnMonitor = true;

StretchGraphicToFit
WindowSize

StretchGraphicToFitWindowSize 确定是否将图形缩放至弹出窗口的当前大小。

这是布尔数据类型的可选属性。

默认值：True

仅适用于 ScalePercentage 参数的值大于 100 的情况。

示例：

graphicInfo.StretchGraphicToFitWindowSize = false;

StretchWindowTo
ScreenWidth

StretchWindowToScreenWidth 确定弹出窗口是否缩放至与屏幕的宽度相同。

这是布尔数据类型的可选属性。

默认值：False

仅适用于 WindowRelativePosition 参数为 Desktop、Window、Client Area、ParentGraphic 或 ParentElement 的情况。

示例：

graphicInfo.StretchWindowToScreenWidth = true;

StretchWindowTo
ScreenHeight

StretchWindowToScreenHeight 确定弹出窗口是否缩放至与屏幕的高度相同。

这是布尔数据类型的可选属性。

默认值：False

仅适用于 WindowRelativePosition 参数为 Desktop、Window、Client Area、ParentGraphic 或 ParentElement 的情况。

示例：

graphicInfo.StretchWindowToScreenHeight = true;

CustomProperties

CustomProperties 是一个 ValuePair[] 数组，用于设置所显示图形的自定义属性。

这是 ValuePair[] 数据类型的可选属性。

前三个参数为：

• 自定义属性名称

• 值

• ,IsConstant

  自定义属性和值都可以是常量字符串、引用或字符串的串联。如果参数 IsConstant = True，则将该值视为常量。否则将该值视为引用。数组索引从 1 开始。

  示例：

  Dim cpValues [4] as aaGraphic.CustomPropertyValuePair;

  cpValues[1] = new aaGraphic.CustomPropertyValuePair("CP1", 20, true);

  cpValues[2] = new aaGraphic.CustomPropertyValuePair("CP2", Pump.PV.TagName, true);

  cpValues[3] = new aaGraphic.CustomPropertyValuePair("CP3", "CP"+var1, CP2 + "001" + ".Speed", true);

  cpValues[4] = new aaGraphic.CustomPropertyValuePair("CP3", "<HMIName>:Tag1", false);

  graphicInfo.CustomProperties = cpValues;