WinCC_flexible2008系统涵数

WinCCflexible系统涵数简介下列表格显示了按组排列的可用系统函数。在WinCCflexible中，下列名称惯例应用于系统函数：以动词（例如“Start”或“Activate”）开头的系统函数可以用在脚本中。以“Get”开头的系统函数用于读取值，例如从变量中读取。以“Set”或“Write”开头的系统函数用于写入值，例如写入到变量中。以ActiveX控件的名称（例如HTMLBrowser）开头的系统函数不能在脚本中使用。在脚本中使用系统函数请在脚本中使用系统函数的英文名称。如果该系统函数可以在脚本中使用，那么该系统函数的英文名称也可以找到，例如：GetPassword(Tag)报警1、ClearAlarmBuffer应用：删除HMI设备报警缓冲区中的报警。说明：尚未确认的报警也被删除。2、ClearAlarmBufferProtoolLegacy应用：该系统函数用来确保兼容性。它具有与系统函数“ClearAlarmBuffer”相同的功能，但使用旧的ProTool编号方式。参数：Alarmclassnumber将要删除其消息的报警类别号：-1(hmiAllProtoolLegacy)=所有报警/事件0(hmiAlarmsProtoolLegacy)=错误1(hmiEventsProtoolLegacy)=警告2(hmiSystemProtoolLegacy)=系统事件3(hmiS7DiagnosisProtoolLegacy)=S7诊断事件3、SetAlarmReportMode应用：确定是否将报警自动报告到打印机上。4、ShowAlarmWindow应用：隐藏或显示HMI设备上的报警窗口。5、ShowSystemAlarm应用：将已传递参数的值显示为HMI设备上的系统报警。编辑位1、InvertBit应用：对给定的“Bool”型变量的值取反。如果变量具有值1（真），它将被设置为0（假）。如果变量具有值0（假），它将被设置为1（真）。说明：不要使用循环事件或递归事件或具有外部变量的系统函数。在画面中创建一个开关。该开关连接到外部布尔类型变量“Tag1”。将系统函数“InvertBit”分配给“更改”事件。该系统函数连接到外部变量“Tag1”。在运行期间，这会导致无法预料的行为。2、InvertBitInTag应用：对给定变量中的位取反：如果变量中的位为值1（真），它将被设置为0（假）。如果变量中的位为值0（假），它将被设置为1（真）。在改变了给定位之后，系统函数将整个变量传送回PLC。不检查此过程期间变量中是否有其它位发生更改。在变量被传送回PLC之前，操作员和PLC对变量具有只读访问权限。说明：如果PLC支持BOOL型变量，不要使用该系统函数。而是使用“InvertBit”系统函数。不要使用循环事件或递归事件或具有外部变量的系统函数。在画面中创建一个开关。该开关连接到外部布尔类型变量“Tag1”。将系统函数“InvertBitInVariable”分配给“更改”事件。该系统函数连接到外部变量“Tag1”。在运行期间，这会导致无法预料的行为。3、ResetBit应用：将“Bool”型变量的值设置为0（假）。4、ResetBitInTag应用：将给定变量中的一个位设置为0（假）。在改变了给定位之后，系统函数将整个变量传送回PLC。不检查此过程期间变量中是否有其它位发生更改。在指示的变量被传送回PLC之前，操作员和PLC对变量具有只读访问权限。说明：如果PLC支持BOOL型变量，不要使用该系统函数。而使用系统函数“ResetBit”。5、SetBit应用将“Bool”型变量的值设置为1（真）。6、SetBitInTag应用：将给定变量中的一个位设置为1（真）。在改变了给定位之后，系统函数将整个变量传送回PLC。不检查变量中的其它位是否同时发生了改变，在变量传送回PLC之前，操作员和PLC只能读取该变量。说明：如果PLC支持BOOL型变量，不要使用该系统函数。而使用系统函数“SetBit”。7、ShiftAndMask应用：此系统函数将源变量的输入位组合格式转换成目标变量的输出位组合格式。这包括移动位和掩码位。说明：如果源变量为有符号的整型数据类型，即带有符号“-”，则最左侧位为“1”。符号位向右侧移动后，该位将由“0”填充。符号变为“+”。如果源变量和目标变量具有不同的位数，则要确保目标变量中的值未超出值的范围。打印1、PrintReport应用：通过连接到HMI设备的打印机来打印给定的报表。说明：报表将按HMI设备上所设置的语言进行打印。2、PrintScreen应用：通过连接到HMI设备的打印机来打印当前显示在HMI设备上的画面。同时打印已打开的窗口。说明：从Windows操作系统的当前设置中获取打印机设置。3、SetAlarmReportMode应用：确定是否将报警自动报告到打印机上。画面1、ActivateFirstChildScreen应用：将画面切换到位于子层最左侧的画面。如果活动画面没有任何子画面，则不执行画面更改说明：如果要使用该函数，则必须在“画面浏览”编辑器中组态浏览结构。2、ActivateLeftScreen应用：将画面切换到与激活画面同一层级的左侧的画面。如果当前画面的左侧没有其它画面，则不发生画面切换说明：必须已经在“画面浏览”编辑器中组态了一个浏览结构。3、ActivateParentScreen应用：将画面切换到激活画面的父画面。如果活动画面没有任何子画面，则不执行画面更改。说明：如果要使用该函数，则必须在“画面浏览”编辑器中组态浏览结构。4、ActivatePreviousScreen应用：将画面切换到在当前画面之前激活的画面。如果先前没有激活任何画面，则画面切换不执行。最近调用的10个画面被保存。当切换到不再保存的画面时，会输出系统事件。说明：如果要使用该函数，则必须在浏览结构中使用画面更改。5、ActivateRightScreen应用：将画面切换到与激活画面同一层级的右侧的画面。如果当前画面的右侧没有其它画面，则不发生画面切换。说明：必须已经在“画面浏览”编辑器中组态了一个浏览结构。6、ActivateRootScreen应用：将画面切换到定义为起始画面的画面。如果所显示的画面是根画面，则不会发生画面切换。说明：必须已经在“画面浏览”编辑器中组态了一个浏览结构。7、ActivateScreen应用：将画面切换到指定的画面。使用“ActivateScreenByNumber”系统函数可以从根画面切换到永久性窗口，反之亦然。8、ActivateScreenByNumber应用：根据变量值将画面切换到另一画面。画面由其画面号标识计算1、DecreaseValue应用：从变量值中减去给定的值。X=X-a说明：系统函数使用同一变量作为输入和输出值。当该系统函数用于转换数值时，必须使用帮助变量。可使用系统函数“SetValue”将变量值分配给帮助变量。如果在报警事件中组态了函数但变量未在当前画面中使用，则无法确保在PLC中使用实际的变量值。通过设置“连续循环”采集模式可以改善这种情况。2、IncreaseValue应用：将给定值添加到变量值上。X=X+a说明系统函数使用同一变量作为输入和输出值。当该系统函数用于转换数值时，必须使用帮助变量。可使用系统函数“SetValue”将变量值分配给帮助变量。如果在报警事件中组态了函数但变量未在当前画面中使用，则无法确保在PLC中使用实际的变量值。通过设置“连续循环”采集模式可以改善这种情况。3、InverseLinearScaling应用：使用线性函数X=(Y-b)/a，将通过给定变量Y的值计算得出的数值赋给变量X。变量X和Y不能相同。与此函数相反的系统函数是“LinearScaling”。说明：变量X和Y不能相同。如果要将变量转换为其自身，必须使用一个帮助变量。可用系统函数“SetValue”将要转换变量的值分配给帮助变量。4、LinearScaling应用：为变量Y赋值，该变量通过线性函数Y=(a*X)+b利用给定变量X的值计算得出。与此函数相反的系统函数是“InverseLinearScaling”。说明：变量X和Y不能相同。如果要将变量转换为其自身，必须使用一个帮助变量。可用系统函数“SetValue”将要转换变量的值分配给帮助变量。5、SetValue应用：将新值赋给给定的变量。说明：该系统函数可用于根据变量类型分配字符串和数字。记录1、ArchiveLogFile应用：此函数将记录移至或复制到其它存储位置作长期归档。使用AuditTrails时，请始终使用“移动”(hmiMove)模式，否则将在复制存储的数据方面违反FDA准则。在使用此系统函数之前，请始终运行“CloseAllLogs”系统函数请在执行此系统函数后，运行“OpenAllLogs”函数。在“复制记录”模式中，只有在成功复制了记录或在复制过程中发生超时的情况下，才会重新打开记录。在“移动记录”模式中，将重命名要移动的记录，并且会立即打开新记录2、ClearLog应用：删除给定日志中的所有数据记录。3、CloseAllLogs应用：断开WinCCflexible与所有记录之间的连接。说明：在关闭记录前，必须首先在记录中停止记录功能。使用系统函数“StopLogging”。4、CopyLog应用：将日志的内容复制到其它日志中。变量值只能复制到其它数据日志中，而报警只能复制到其它报警日志中。“StopLogging”函数可用来终止记录操作说明：如果使用“CopyLog”系统函数复制记录，则外部应用程序有可能无法读取记录副本的已记录消息文本中的某些特定国家/地区的特殊字符。WinCCflexibleRuntime不会受此影响。WinCCflexibleRuntime可以准确无误地读取复制的记录文件5、LogTag应用：将给定变量的值保存在给定的数据日志中。该系统函数用于归档特定时刻的过程值。6、OpenAllLogs应用：重新建立WinCCflexible和记录之间的连接。可继续记录。说明：运行系统函数“StartLogging”以重新开始记录7、StartLogging应用：在指定记录中启动对数据或报警的记录。可通过使用“StopLogging”系统函数在运行系统时中断记录。8、StartSequenceLog应用：停止对给定记录进行数据或报警的记录。在为指定记录所组态的分段的环形记录的下一个记录中继续进行记录。如果没有为指定记录组态分段的环形记录，则该系统函数无效。9、StopLogging应用：在指定记录中停止对过程值或报警的记录。系统函数“StartLogging”用于在运行系统时恢复记录。说明：当记录停止时，WinCCflexible与记录文件或记录数据库之间的连接仍将存在。使用系统函数“CloseAllLogs”可断开此连接。键盘1、OpenScreenKeyboard应用：隐藏或显示屏幕键盘。屏幕键盘保持打开直到它被明确关闭。这样，屏幕键盘也可用于其它应用程序。参数：Displaymode指定使用屏幕键盘打开的窗口是最小化还是最大化：0(hmiScreenKeyboardMinimized)=最小化1(hmiScreenKeyboardMaximized)=最大化2.、SetScreenKeyboardMode允许或禁止HMI设备上屏幕键盘的自动显示。说明：要在HMI设备而不是触摸面板设备上启用系统函数“SetScreenKeyboardMode”(“SetScreenKeyboardMode”)，请在设备设置的“运行系统设置”对话框中选择“使用画面键盘”复选框。该系统函数也可用于避免显示画面键盘，因为外部键盘已连接到操作员设备。参数Mode确定隐藏还是显示屏幕键盘：0(hmiOff)=关：隐藏屏幕键盘1(hmiOn)=开：显示屏幕键盘-1(hmiToggle)=切换：在两种模式之间切换。3、ShowOperatorNotes应用：显示所选对象已组态的信息文