AddTrace 方法（XY 图对象）

向运行时图表添加新轨迹。如果轨迹已成功添加到 XY 图中，则此方法返回
True
；如果未添加轨迹，则返回
False
。
语法
XYPlot1
.
AddTrace
(
String xTagName
,
String yTagName
, [
xModelName
], [
yModelName
], [
Integer xTraceType
], [
Integer yTraceType
]) As
Boolean
其中
XYPlot1
 - 是 XY 图对象的名称，或是对 XY 图对象求值的表达式。
xTagName
 - 是字符串类型的参数，指定要添加到 XY 图中的 x 标签的名称。
yTagName
 - 是字符串类型的参数，指定要添加到 XY 图中的 y 标签的名称。
xModelName
 - 是字符串类型的可选参数，用于为 x 标签指定数据记录模型名称、DataLogPro 组名称、FactoryTalk Historian 连接名称、Asset Framework 连接名称或 PI Server 名称。
yModelName
 - 是字符串类型的可选参数，用于为 y 标签指定数据记录模型名称、DataLogPro 组名称、FactoryTalk Historian 连接名称、Asset Framework 连接名称或 PI Server 名称。
xTraceType
 - 是
XYTraceType
 常量的参数，指定 x 标签的轨迹类型。
yTraceType
 - 是
XYTraceType
 常量的参数，指定 y 标签的轨迹类型。使用以下类型指定
xTraceType
 或
yTraceType
 的数据源：
  • XYTraceTypeEmpty
     （0）：使用默认轨迹类型，即实时数据。
  • XYTraceTypeLiveData
     （1）：FactoryTalk Live Data 标签。
  • XYTraceTypeDataLog
     （2）：FactoryTalk View SE 数据记录模型标签。
  • XYTraceTypeHistorian
     （3）：FactoryTalk Historian 标签（或点）。
  • XYTraceTypePIServer
     （6）：PI Server 标签（或点）。
  • XYTraceTypeDataLogProPlus
     （7）：FactoryTalk View SE DataLogPro 标签。
  • XYTraceTypeAF
     （8）：FactoryTalk Historian Asset Framework 标签（或属性）。
返回值
 - 如果为
True
，则为有效的联机标签。如果为
False
，则为无效或脱机标签。请注意，如果数据记录或 Historian 标签必须后退到 Live Data 标签，则返回
True
，因为它仍然是有效的联机标签。
如果提供了数据记录或 Historian 名称，并且未找到该标签，则 XY 图将后退以确定它是否为 Live Data 标签，如果是，则会将轨迹作为 Live Data 标签进行添加。
示例
Private Sub btnAddTrace()
Dim result As Boolean
'Add a trace for the Live Data tags system\Second and system\Minute.
result = XYPlot1.AddTrace("system\Second", "system\Minute")
'Add a trace for TagX from the Data Log Datalog1 and TagY from the Data Log Datalog2.
result = XYPlot1.AddTrace("TagX", "TagY", "Datalog1", "Datalog2", XYTraceTypeDataLog, XYTraceTypeDataLog)
'Add a trace for Tag1X from the historian server Historian1 and Tag1Y from the historian server Historian2.
result = XYPlot1.AddTrace("Tag1X", "Tag1Y", "Historian1", "Historian2", XYTraceTypeHistorian, XYTraceTypeHistorian)
'Add a trace for Tag2X from the PI Server connection PIServer1 and Tag2Y from the PI Server connection PIServer2.
result = XYPlot1.AddTrace("Tag2X", "Tag2Y", "PIServer1", "PIServer2", XYTraceTypePIServer, XYTraceTypePIServer)
'Add a trace for LogX and LogY from DataLogPro.
result = XYPlot1.AddTrace("LogX", "LogY", "DataLogPro", "DataLogPro", XYTraceTypeDataLogProPlus, XYTraceTypeDataLogProPlus)
'Add a trace for motor speed from the Asset Framework connections AssetFramework1 and AssetFramework2.
result = XYPlot1.AddTrace("Motor.X", "Motor.Y", "AssetFramework1", "AssetFramework2", XYTraceTypeAF, XYTraceTypeAF)
End Sub
提供反馈
对本文档有问题或反馈吗？ 请在这里提交您的反馈 。
Normal