MCGS昆仑通态脚本函数.pdf

!ChangeLoopStgy(StgyName,n)!ChangeLoopStgy(StgyName,n)!ChangeLoopStgy(StgyName,n)!ChangeLoopStgy(StgyName,n)函数意义函数意义：改变循环策略的循环时间。返返 回回 值值：数值型。返回值=0：调用正常，0：调用不正常。参数参数：，策略名；，数值型，以毫秒数表示循环策略的循环时间。实例实例：报警策略，将报警策略的循环时间改为5秒。!CloseAllWindow(WndName)!CloseAllWindow(WndName)!CloseAllWindow(WndName)!CloseAllWindow(WndName)函数意义函数意义：关闭所有窗口，如果在字符串中指定了一个窗口，则打开这个窗口，关闭其他窗口。如果为空串，则关闭所有窗口。返返 回回 值值：数值型。返回值：=0：调用正常。0：调用不正常。参数参数：，用户窗口名，字符型。实例实例：工况图，关闭除了用户窗口“工况图”以外的其他窗口，若“工况图”参数参数：SstgyName，策略名；n，数值型，为1时表示打开此策略，为0时表示关闭此策略。实例实例：报警策略，打开报警策略；报警策略，关闭报警策略，使报警策略无效。!GetDeviceName(Index)!GetDeviceName(Index)!GetDeviceName(Index)!GetDeviceName(Index)函数意义函数意义：按设备顺序取到设备的名字。返返 回回 值值：字符型。调用成功返回设备名，调用失败时返回空字符串。参数参数：，数值型。实例实例：，取0号设备构件的名称。!GetDeviceState(DevName)!GetDeviceState(DevName)!GetDeviceState(DevName)!GetDeviceState(DevName)函数意义函数意义：按设备名查询设备的状态。返返 回回 值值：数值型。=-1调用不正常。=1 设备处于正常的工作状态。=2 设备正在工作，但设备不正常。=3 设备处于停止工作状态，且设备正常。=4 设备处于停止状态，且设备有错。参数参数：，设备名，字符型。实例实例：，读取设备构件的当前工作状态。注意注意：设备名称是在设备构件基本属性页中设置的。!GetLastMouseActionTime()!GetLastMouseActionTime()!GetLastMouseActionTime()!GetLastMouseActionTime()函数意义函数意义：获取最后一次鼠标的动作发生的时间。返返 回回 值值：开关型。返回为类型的时间值，可以在时间操作脚本函数中使用。参数参数：无。实例实例：在画面，系统对话框上的鼠标事件中添加，获取鼠标最后动作时间。!GetStgyName(Index)!GetStgyName(Index)!GetStgyName(Index)!GetStgyName(Index)函数意义函数意义：按运行策略的顺序获得各策略块的名字。www.PLC返返 回回 值值：字符型。参数参数：，数值型。实例实例：，取0号运行策略的名称。!GetWindowName(Index)!GetWindowName(Index)!GetWindowName(Index)!GetWindowName(Index)函数意义函数意义：按用户窗口的顺序获得用户窗口的名字。返返 回回 值值：字符型。参数参数：，数值型。实例实例：，读取0号用户窗口的名称。!GetWindowState(WndName)!GetWindowState(WndName)!GetWindowState(WndName)!GetWindowState(WndName)函数意义函数意义：按照名字取得用户窗口的状态。返返 回回 值值：数值型。返回0：用户窗口处于关闭状态。返回1：用户窗口处于打开状态。返回2：用户窗口处于隐藏状态。参数参数：，用户窗口名称，字符型。实例实例：工况图，获得用户窗口“工况图”的状态。!OpenSubWnd!OpenSubWnd!OpenSubWnd!OpenSubWnd（参数（参数1,1,1,1,参数参数2 2 2 2，参数，参数3 3 3 3，参数，参数4 4 4 4，参数，参数5 5 5 5，参数，参数6 6 6 6）函数意义：函数意义：显示子窗口。返回值：返回值：字符型，如成功就返回子窗口，表示打开的第个子窗口。参数值：参数值：参数：要打开的子窗口名。参数：整型，打开子窗口相对于本窗口的坐标。参数：整型，打开子窗口相对于本窗口的坐标。参数：整型，打开子窗口的宽度。参数：整型，打开子窗口的高度。参数：整型，打开子窗口的类型。0位：是否模式打开，使用此功能，必须在此窗口中使用来关闭本子窗口，子窗口外别的构件对鼠标操作不响应1位：是否菜单模式，使用此功能，一旦在子窗口之外按下按钮，则子窗口关闭。2位：是否显示水平滚动条，使用此功能，可以显示水平滚动条www.PLC3位：是否垂直显示滚动条，使用此功能，可以显示垂直滚动条4位：是否显示边框，选择此功能，在子窗口周围显示细黑线边框5位：是否自动跟踪显示子窗口，选择此功能，在当前鼠标位置上显示子窗口。此功能用于鼠标打开的子窗口，选用此功能则忽略的值，如果此时鼠标位于窗口之外，则在窗口对中显示子窗口6位：是否自动调整子窗口的宽度和高度为缺省值，使用此功能则忽略和的值。子窗口的关闭办法：子窗口的关闭办法：使用关闭窗口直接关闭，则把整个系统中使用到的此子窗口完全关闭使用指定窗口的关闭，可以使用返回的控件名，也可以直接指定子窗口关闭，此时只能关闭此窗口下的子窗口。!SetActiveX()!SetActiveX()!SetActiveX()!SetActiveX()函数说明函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!CallBackSvr()!CallBackSvr()!CallBackSvr()!CallBackSvr()函数说明函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!SetDevice(DevName,DevOp,CmdStr)!SetDevice(DevName,DevOp,CmdStr)!SetDevice(DevName,DevOp,CmdStr)!SetDevice(DevName,DevOp,CmdStr)函数意义函数意义：按照设备名字对设备进行操作。返返 回回 值值：数值型。返回值：=0：调用正常。0：调用不正常。参数参数：e，设备名，字符型；，设备操作码，数值型；，设备命令字符串，只有当时才有意义。取值范围及相应含义：1：启动设备开始工作。2：停止设备的工作使其处于停止状态。3：测试设备的工作状态。4：启动设备工作一次。5：改变设备的工作周期，中包含新的工作周期，单位为。6：执行指定的设备命令，中包含指定命令的格式。实例实例：，启动设备构件开始工作。www.PLC函数意义函数意义：按照名字操作用户窗口，如打开、关闭、打印。返返 回回 值值：数值型。返回值：=0：调用正常。0：调用不正常。参数参数：，用户窗口名，字符型。:操作用户窗口的方法，数值型。：打开窗口并使其可见。：打开窗口并使其不可见。：关闭窗口。：打印窗口。：刷新窗口。实实 例例：工况图，打开用户窗口“工况图”，并使其可见。!SysWindow()!SysWindow()!SysWindow()!SysWindow()函数意义函数意义：执行该函数后，打开用户窗口管理窗口，在管理窗口中可以选择打开或关闭指定的用户窗口。返返 回回 值值：数值型。返回值=0：调用成功；0：调用失败。参数参数：无。实例实例：。!SetStyMode(!SetStyMode(!SetStyMode(!SetStyMode(StgyNameStgyNameStgyNameStgyName)函数意义函数意义：通过脚本函数（位于系统函数-运行环境类）实现函数调用方式的策略调用。返回返回 值值：开关型，返回值恒为0。参数参数：，策略名，字符型。实例实例：阀门关闭，执行一次运行策略“阀门关闭”，“阀门关闭”策略执行完毕后，才返回调用者，调用者继续执行以下程序。!GetCurrentLanguageIndex(!GetCurrentLanguageIndex(!GetCurrentLanguageIndex(!GetCurrentLanguageIndex()函数意义：函数意义：用于获取当前使用的语言的索引值。返返 回回 值：值：开关型。返回值为语言项索引值。索引值按照组态下拉框依次排序0，1，2参数：参数：无。实例：实例：N=!GetCurrentLanguageIndex()，其中 N 为开关型变量。www.PLC!SetCurrentLanguageIndex(!SetCurrentLanguageIndex(!SetCurrentLanguageIndex(!SetCurrentLanguageIndex(开关型开关型)函数意义：函数意义：通过索引项设定当前语言环境返返 回回 值：值：开关型。返回值为0表示执行成功，否则表示失败。参数参数：开关型。语言索引值。如果索引参数值超出当前选择语言范围，那么函数不生效。实例实例：!SetCurrentLanguageIndex(1)，表示设置当前语言为英文（选择语言为 CH，EN）。!GetLocalLanguageStr(!GetLocalLanguageStr(!GetLocalLanguageStr(!GetLocalLanguageStr(开关型开关型)函数意义：函数意义：获得指定自定义 ID 对应的当前语言的内容。返返 回回 值：值：字符型。参数：参数：开关型。自定义 ID 索引值。如果无当前 ID 对应自定义文本，则返回空值。实例实例：!GetLocalLanguageStr（2），前提是有 ID 为2的自定义文本内容，如果当前语言为英文，则返回 ID 为2的自定义文本记录的英文内容。!GetLanguageNameByIndex(!GetLanguageNameByIndex(!GetLanguageNameByIndex(!GetLanguageNameByIndex(开关型开关型)函数意义：函数意义：根据语言索引值返回语言名称，返回值为字符型。返返 回回 值：值：字符型，当前语言的名称。参数：参数：开关型。语言的索引值。如果当前索引值无对应语言，则返回空值。实例：实例：!GetLanguageNameByIndex(1)，假如当前语言为中文、英文，则返回值为English。www.PLC!AnswerAlm(DatName)!AnswerAlm(DatName)!AnswerAlm(DatName)!AnswerAlm(DatName)函数意义函数意义：应答数据对象所产生的报警。如对应的数据对象没有报警产生或已经应答，则本函数无效。返回值返回值：数值型，为操作成功，为操作失败。参数参数：，数据对象名。实例实例：电机温度，应答数据对象 电机温度 所产生的报警。!ChangeDataSave(Datname,n)!ChangeDataSave(Datname,n)!ChangeDataSave(Datname,n)!ChangeDataSave(Datname,n)函数意义函数意义：改变数据对象存盘的周期。返回值返回值：数值型，为操作成功，为操作失败。参数参数：，数据对象名；，数值型，以秒表示的存盘间隔时间。实例实例：温度，温度的存盘间隔时间为 秒。!ChangeSaveData(DatName!ChangeSaveData(DatName!ChangeSaveData(DatName!ChangeSaveData(DatName,Num1,Num2),Num1,Num2),Num1,Num2),Num1,Num2)该函数在通用版中可以使用，在嵌入版中不能使用！函数意义函数意义：改变数据对象所对应存盘数据的存盘间隔，把小时以前的存盘数据（以当前时间为 点）的存盘间隔改为秒。本操作只对组对象有效，对单个的数据对象无效。当空字符，或或时，本操作无效。返回值返回值：数值型，返回值：调用正常，：调用不正常。参数参数：数据对象名。：数值型时间量，单位：小时。本函数用的一些数值来表示一些特殊意义的操作：改变当天对应数据对象所有存盘数据的存盘间隔；改变昨天对应数据对象所有存盘数据的存盘间隔；改变本星期对应数据对象所有存盘数据的存盘间隔；改变上星期对应数据对象所有存盘数据的存盘间隔；改变本月对应数据对象所有存盘数据的存盘间隔；改变上个月对应数据对象所有存盘数据的存盘间隔；www.PLC!EnableDataSave(name,n)!EnableDataSave(name,n)!EnableDataSave(name,n)!EnableDataSave(name,n)函数意义函数意义：打开 关闭数据对象的定时存盘功能。返回值返回值：数值型，返回值：调用正常，：调用不正常。参数参数：，数据对象名；，数值型，表示打开定时存盘，表示关闭定时存盘。实例实例：温度，打开温度的定时存盘。!ExportHisDataToCSV(!ExportHisDataToCSV(!ExportHisDataToCSV(!ExportHisDataToCSV(文件名文件名,组对象名组对象名,字段名字段名,开始时间开始时间,结束时间结束时间,最大记录数最大记录数,导出模式导出模式,导出参数导出参数,进度指示数据对象名进度指示数据对象名,取消控制数据对象名取消控制数据对象名)函数意义：函数意义：导出指定组对象存盘数据，导出的条件包括：开始时间 结束时间，最大导出总条数导出字段列表，组对象为则表示导出报警历史数据；可指定导出文件名和路径，主要是盘导出，可以追加方式也可覆盖方式导出；可显示导出过程进度情况；可取消和中止长时间的导出过程；导出格式为文件，导出的第一行为字段名字。返回值：返回值：开关型。返回指定组对象错误，可能组对象没有保存历史数据或者没有该组对象返回指定的时间格式错误返回指定的无效的数据对象名返回无效的导出模式返回同时只能支持一个导出参数：参数：文件名：字符型，指定导出的文件绝对路径名，指定的第一级目录不能创建，其子目录如果不存在则可以创建。这样避免盘不存在时创建盘目录。注意注意：第一级目录不能自动创建用户必须保证其存在；组对象名：导出的组对象名字。www.PLC字段名：字符型，用逗号分隔的要导出的字段名，不需要指定时间字段，默认第一二个字段就为记录时间字段。如果为空字符串则导出所有字段。开始时间，结束时间：用表示的时间字符串：；最大记录数：希望导出的最大记录数，超过该记录数就返回，停止导出；导出模式：表示覆盖现有文件，表示追加到文件最后；导出参数：暂时为空，保留以后使用；进度指示数据对象名：开关型数据对象，导出过程中该对象值反映出当前已导出记录条数，如果导出过程中其他异常结束则通过该对象返回同函数返回错误码；进度指示错误码：返回文件不能打开返回没有可导出的数据返回文件操作出现错误控制数据对象名：指定一个开关型数据对象 该对象控制导出执行，启动导出时会自动设置该变量为，用户在导出过程中想取消导出则可以设置该值为的任何值，导出函数运行结束后会自动设置对象值为；进度指示错误码：返回导出成功返回导出路径不存在返回指定组对象错误，可能组对象没有保存历史数据或者没有该组对象返回指定的时间格式错误返回指定的无效的数据对象名返回无效的导出模式返回同时只能支持一个导出实实例例进度 控制!GetAlmValue(DatName,Value,Flag)!GetAlmValue(DatName,Value,Flag)!GetAlmValue(DatName,Value,Flag)!GetAlmValue(DatName,Value,Flag)www.PLC函数意义函数意义：读取数据对象报警限值，只有在数据对象的 允许进行报警处理 属性选项被选中后，本函数的操作才有意义。对组对象、字符型数据对象、事件型数据对象本函数无效。对数值型数据对象，用来标识读取何种报警限值。返回值返回值：数值型，返回值：调用正常，：调用不正常。参数参数：数据对象名。：的当前的报警限值，数值型。：数值型，标志要读取何种限值，具体意义如下：下下限报警值；下限报警值；上限报警值；上上限报警值；下偏差报警限值；上偏差报警限值；偏差报警基准值；实例实例电机温度，读取数据对象 电机温度 的报警上限值，放入数值型数据对象中。!GetEventDT()!GetEventDT()!GetEventDT()!GetEventDT()函数说明函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!GetEventP()!GetEventP()!GetEventP()!GetEventP()函数说明函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!GetEventT()!GetEventT()!GetEventT()!GetEventT()函数说明函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!MoveSaveDat()!MoveSaveDat()!MoveSaveDat()!MoveSaveDat()函数说明函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!SaveData(DatName)!SaveData(DatName)!SaveData(DatName)!SaveData(DatName)www.PLC参数参数：，数据对象名。实例实例：温度，把温度的当前值设置成初始值。!SetAlmValue(DatName,Value,Flag)!SetAlmValue(DatName,Value,Flag)!SetAlmValue(DatName,Value,Flag)!SetAlmValue(DatName,Value,Flag)函数意义函数意义：设置数据对象对应的报警限值，只有在数据对象允许进行报警处理 的属性被选中后，本函数的操作才有意义。对组对象、字符型数据对象、事件型数据对象本函数无效。对数值型数据对象，用来标识改变何种报警限值。返回值返回值：数值型，返回值：调用正常，：调用不正常。参数参数：数据对象名。：新的报警值，数值型。：数值型，标志要操作何种限值，具体意义如下：下下限报警值；下限报警值；上限报警值；上上限报警值；下偏差报警限值；上偏差报警限值；偏差报警基准值；实例实例：电机温度，把数据对象 电机温度 的报警上限值设为!TransToUSB(!TransToUSB(!TransToUSB(!TransToUSB(组对象名组对象名,起始时间起始时间,结束时间结束时间,导出状态导出状态,进度指示进度指示,转出模式转出模式,保留参数保留参数)函数意义：函数意义：将组对象的存盘数据导出到目录下，保存为文件，模拟环境则是保存到与可执行文件相同路径下。返回值返回值：开关型。：参数没有错误。：第一个参数错误。（请检查是否组对象名称，或）时间参数格式错误。：状态变量的类型错误。（两个变量都必须是开关量）：同时只能支持一个导出。参数参数：组对象名：字符型，要导出的组对象名称（或）。起始时间：字符型，要导出的历史数据的开始时间，格式：。www.PLC结束时间：字符型，要导出的历史数据的结束时间，格式：。导出状态：开关型，进度指示数据对象名（开关量），输出导出状态。正常导出存盘后输出当前已经导出的记录条数。当创建导出文件失败时输出。（请检查下位机是否正常插入了盘）当前没有记录可导出时输出。（请检查对应的组对象是否有存盘信息，或者开始时间结束时间是否设置正确）导出过程中出现未知数据类型时输出。（不应该出现）导出过程中出现文件操作异常时输出。（请检查盘容量是否足够）进度指示：开关量，指定一个数字型或开关型对象 该对象控制导出执行，启动导出时会自动设置该变量为，用户在导出过程中想取消导出可设置该变量为的任何值，导出函数运行结束后会自动设置对象值为。注注：（）之前的版本，此参数为原导出状态变量，显示的是导出数据总条数。转出模式：开关型，保留，设置为。保留参数：字符型，保留 设置为空字符串。实实例例：。注意事项注意事项：该函数最多只能导出条记录。当满足导出时间条件的记录数大于时，只导出前条记录。!CopyDateFileToDisk(pathName,dataType,copyState)!CopyDateFileToDisk(pathName,dataType,copyState)!CopyDateFileToDisk(pathName,dataType,copyState)!CopyDateFileToDisk(pathName,dataType,copyState)函数意义函数意义 拷贝当前运行工程的数据到指定的目录中。返回值返回值:：在拷贝的过程中 数据对象由 转变为非 表示用户不想继续拷贝。：表示拷贝成功。：当前工程中 当前运行工程中没有组对象要存盘。：创建目录失败。www.PLC：创佳索引文件失败或者对此文件进行写操作失败。：参数的值 不正确 目前只支持值为。：磁盘空间不足。：参数不是数据对象类型。：参数是数据对象类型 但不是开关型数据对象。：参数在一开始调用此脚本时 就为非。参数说明参数说明:：字符串型 要拷贝数据到此的路径名 例如 在模拟环境可以写在运行环境可写。：开关型 拷贝数据的类型 表示历史数据表示报警数据 目前只支持拷贝历史数据 报警数据还没有处理。：数据对象型 是否拷贝的标志 当为 表示可以拷贝 为非 表示取消当前的拷贝。实例实例：把当前工程中历史数据拷贝到目录中 如为 表示拷贝 为非表示取消。说明说明：一般此脚本要配合组态环境中的一个小程序来一起操作 把拷贝的数据目录 通过盘或其他方式 导到上位机通过用程序来进行数据的转换。www.PLC参数参数：n，数值型，为1时表示在退出时弹出提示信息对话框。为0则退出时不出现信息对话框。实例实例：(1)，在退出时弹出提示信息对话框。!GetCurrentGroup()!GetCurrentGroup()!GetCurrentGroup()!GetCurrentGroup()函数意义函数意义：读取当前登录用户的所在用户组名。返返 回回 值值：字符型，当前登录用户组名，如没有登录返回空。参数参数：无。实例实例：()。!GetCurrentUser()!GetCurrentUser()!GetCurrentUser()!GetCurrentUser()函数意义函数意义：读取当前登录用户的用户名。返返 回回 值值：字符型，当前登录用户的用户名，如没有登录返回空。参数参数：无。实例实例：()。!LogOff()!LogOff()!LogOff()!LogOff()函数意义函数意义：注销当前用户。返返 回回 值值：数值型。返回值=0：调用成功；0：调用失败。参数参数：无。实例实例：()。!LogOn()!LogOn()!LogOn()!LogOn()函数意义函数意义：弹出登录对话框。返返 回回 值值：数值型。返回值=0：调用成功；0：调用失败。参数参数：无。实例实例：。www.PLC!Ascii2I(s)!Ascii2I(s)!Ascii2I(s)!Ascii2I(s)函数意义函数意义：返回字符串 s 的首字母的 Ascii 值。返返 回回 值值：开关型。参数：参数：s，字符型。实例实例：。!Bin2I(s)!Bin2I(s)!Bin2I(s)!Bin2I(s)函数意义函数意义：把二进制字符串转换为数值。返返 回回 值：值：开关型。参数参数：s，字符型。实例实例：。!Format(n,str)!Format(n,str)!Format(n,str)!Format(n,str)函数意义函数意义：格式化数值型数据对象。返返 回回 值值：字符型。参数参数：n，数值型，要格式化的数值；str，字符型，格式化数值的格式。表示为0.00样式。小数点后的0的个数表示需要格式化出的小数位数。小数点前的0为一个时，表示小数点前根据实际数值显示。当小数点前没有0时，表示为.xx 式样，当小数点前的0不止一个时，使用0来填充不够的位数。实例实例：；。!Hex2I(s)!Hex2I(s)!Hex2I(s)!Hex2I(s)函数意义函数意义：把16进制字符串转换为数值。返返 回回 值值：开关型。参数参数：s，字符型。实例实例：。www.PLC!I2Ascii(s)!I2Ascii(s)!I2Ascii(s)!I2Ascii(s)函数意义函数意义：返回指定 Ascii 值的字符。返返 回回 值值：字符型。参数参数：s，开关型。实例实例：。!I2Bin(s)!I2Bin(s)!I2Bin(s)!I2Bin(s)函数意义函数意义：把数值转换为二进制字符串。返返 回回 值值：字符型。参数参数：s，开关型。实例实例：!I2Hex(s)!I2Hex(s)!I2Hex(s)!I2Hex(s)函数意义函数意义：把数值转换为16进制字符串。返返 回回 值值：字符型。参数参数：s，开关型。实例实例：。!I2Oct(s)!I2Oct(s)!I2Oct(s)!I2Oct(s)函数意义函数意义：把数值转换为8进制字符串。返返 回回 值值：字符型。参数参数：s，开关型。实例实例：。!InStr(n!InStr(n!InStr(n!InStr(n，str1str1str1str1，str2)str2)str2)str2)函数意义函数意义：查找一字符串在另一字符串中最先出现的位置。返返 回回 值值：数值型。参数参数：，数值型，开始搜索的位置；，字符串，被搜索的字符串；，字符串，要搜索的字符串。实例实例：。www.PLC!Mid(str!Mid(str!Mid(str!Mid(str,n,k,n,k,n,k,n,k)函数意义函数意义：从字符型数据对象左边第个字符起，取个字符。数字字符时，从零开始算起。返返 回回 值值：字符型。参数参数：，字符型，源字符串；，数值型，起始位置；，数值型，取字符数。实例实例：，。!Oct2I(s)!Oct2I(s)!Oct2I(s)!Oct2I(s)函数意义函数意义：把8进制字符串转换为数值。返返 回回 值值：开关型。参数参数：，字符型。实例实例：。!Right(str,n)!Right(str,n)!Right(str,n)!Right(str,n)函数意义函数意义：从字符型数据对象右边起，取个字符。返返 回回 值值：字符型。参数参数：，字符型，源字符串；，数值型，取字符个数。实例实例：。!Rtrim(str)!Rtrim(str)!Rtrim(str)!Rtrim(str)函数意义函数意义：把字符型数据对象中最右边的空格剔除。返返 回回 值值：字符型。参数参数：，字符型。实例实例：。!Str(x)!Str(x)!Str(x)!Str(x)函数意义函数意义：将数值型数据对象的值转换成字符串。www.PLC返返 回回 值值：字符型。参数参数：，数值型。实例实例：。!StrComp(str1,str2)!StrComp(str1,str2)!StrComp(str1,str2)!StrComp(str1,str2)函数意义函数意义：比较字符型数据对象和是否相等，返回值为0时相等，否则不相等。不区分大小写字母。返返 回回 值值：数值型。参数参数：，字符型；，字符型。实例实例：。!StrFormat(FormatStr,!StrFormat(FormatStr,!StrFormat(FormatStr,!StrFormat(FormatStr,任意个数变量任意个数变量)函数意义函数意义：格式化字符串，可以格式化任意多个数值。使用方法为，或等，类似 C 语言中的的语法。返返 回回 值值：字符型。参数参数：，字符型，格式化字符串。后面的参数可以任意多个。实例实例：。!Trim(str)!Trim(str)!Trim(str)!Trim(str)函数意义函数意义：把字符型数据对象中左右两端的空格剔除。返返 回回 值值：字符型。参数参数：，字符型。实例实例：。!Ucase(str)!Ucase(str)!Ucase(str)!Ucase(str)函数意义函数意义：把字符型数据对象的所有字符转换成大写。返返 回回 值值：字符型。参数参数：，字符型。实例实例：。www.PLC!Val(str)!Val(str)!Val(str)!Val(str)函数意义函数意义：把字符型数据对象的值转换成数值。返返 回回 值值：数值型。参数参数：，字符型。实例实例：。www.PLC!TimerReset(!TimerReset(!TimerReset(!TimerReset(定时器号定时器号,数值数值)函数意义函数意义：设置定时器的当前值，由第二个参数设定，第二个参数可以是 MCGS 嵌入版变量。返返 回回 值值：数值型。返回值=0：调用成功；0：调用失败。参数参数：定时器号；数值。实例实例：，设置1号定时器的值为12。!TimerValue(!TimerValue(!TimerValue(!TimerValue(定时器号定时器号,0),0),0),0)函数意义函数意义：取定时器的当前值。返返 回回 值值：将定时器的值以数值型的方式输出（数值格式）。参数参数函数意义函数意义：设置定时器的值输出连接的变量。返返 回回 值值：数值型。返回值=0：调用成功；0：调用失败。参数参数：定时器号；变量，定时器的值输出连接的变量。实例实例：，将定时器数据连接到。!TimerWaitFor(!TimerWaitFor(!TimerWaitFor(!TimerWaitFor(定时器号定时器号,数值数值)函数意义函数意义：等待定时器工作到“数值”指定的值后，脚本程序才向下执行。返返 回回 值值：数值型。返回值=0：调用成功；0：调用失败。参数参数：定时器号(1-255)；数值，等待定时器工作到指定的值。实例实例：，等定时器工作到55秒后再执行其他操作。www.PLC!AppActive()!AppActive()!AppActive()!AppActive()函数说明函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!Beep()!Beep()!Beep()!Beep()函数意义函数意义：发出嗡鸣声。返返 回回 值值：数值型。返回值=0：调用成功；0：调用失败。参数参数：无。实例实例：。!EnableDDEConnection()!EnableDDEConnection()!EnableDDEConnection()!EnableDDEConnection()函数说明函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!EnableDDEInput()!EnableDDEInput()!EnableDDEInput()!EnableDDEInput()函数说明函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!LinePrtOutput()!LinePrtOutput()!LinePrtOutput()!LinePrtOutput()函数说明函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!PlaySound()!PlaySound()!PlaySound()!PlaySound()函数说明函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!SendKeys(string)!SendKeys(string)!SendKeys(string)!SendKeys(string)函数意义函数意义：将一个或多个按键消息发送到活动窗口，就如同在键盘上进行输入一样。返返 回回 值值：数值型。返回值=0：调用成功；0：调用失败。参数参数：，字符串表达式，指定要发送的按键消息。实例实例：，切换窗口。www.PLC为了指定那些与 SHIFT、CTRL 及 ALT 等按键结合的组合键，可在这些按键码的前面放置一个或多个代码，这些代码列举如下：按键代码+%为了说明在按下其它按键时应同时按下、及的任意组合键，请把那些按键的码放在括号当中。例如，为了说明按下 E与 C 的时候同时按下键，请使用+(EC)。为了说明在按下E 的时候同时按下键，但接着按 C 而不按，则使用+EC。注注 意意：不能用将按键消息发送到这样一个应用程序，参数参数：，数值型，设定年数，小于1000和大于9999时不变；，数值型，设定月数，大于12和小于1时不变；，数值型，设定天数，大于31和小于1时不变；，数值型，设定小时数，大于23和小于0时不变；，数值型，设定分钟数，大于59和小于0时不变；，数值型，设定秒数，大于59和小于0时不变。实例实例：，设置当前系统时间为2000年1月1日1时1分1秒。!Shell()!Shell()!Shell()!Shell()函数说明函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!Sleep(mTime)!Sleep(mTime)!Sleep(mTime)!Sleep(mTime)函数意义函数意义：在脚本程序中等待毫秒，然后再执行下条语句。只能在策略中使用，否则会造成系统响应缓慢。返返 回回 值值：数值型。返回值=0：调用成功；0：调用失败。参数参数：，数值型，要等待的毫秒数。实例实例：。!TerminateApplication()!TerminateApplication()!TerminateApplication()!TerminateApplication()函数说明函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。!WaitFor(Dat1,Dat2)!WaitFor(Dat1,Dat2)!WaitFor(Dat1,Dat2)!WaitFor(Dat1,Dat2)函数意义函数意义：在脚本程序中等待设置的条件满足，脚本程序再向下执行。只能在策略中使用，否则造成系统响应缓慢。返返 回回 值值：数值型。返回值=0：调用成功；0：调用失败。参数参数：，数值型，条件表达式，如：D=15。，数值型，等待条件满足的超时时间，单位：ms。为0则无限等待。实例实例：（），等变量 D 的值等于15后，程序再继续执行，如果在12秒后条件仍然没有满足，也自动继续执行。此函数通常用于做实验时，等待某个条件满足，然后再接着执行实验流程。他与函数以及循环语句、其他循环策略配合，能够实现复杂的流程调度。注意注意：只能用于策略中，而不能直接在窗口控件的脚本程序中使用。www.PLC!WinHelp()!WinHelp()!WinHelp()!WinHelp()函数说明函数说明：此函数在嵌入版中无效，考虑兼容性问题，故保留。www.PLC!Atn(x)!Atn(x)!Atn(x)!Atn(x)函数意义函数意义：反正切函数。返返 回回 值值：数值型，用弧度表示。参数参数：，数值型。实例实例：。!Cos(x)!Cos(x)!Cos(x)!Cos(x)函数意义函数意义：余弦函数。返返 回回 值值：数值型。参数参数：，数值型，用弧度表示。实例实例：。!Sin(x)!Sin(x)!Sin(x)!Sin(x)函数意义函数意义：正弦函数。返返 回回 值值：数值型。参数参数：，数值型，用弧度表示。实例实例：。!Tan(x)!Tan(x)!Tan(x)!Tan(x)函数意义函数意义：正切函数。返返 回回 值值：数值型。参数参数：，数值型，用弧度表示。实例实例：。!Exp(x)!Exp(x)!Exp(x)!Exp(x)函数意义函数意义：指数函数。返返 回回 值值：数值型。参数参数：，数值型。www.PLC!BitOr(x,y)!BitOr(x,y)!BitOr(x,y)!BitOr(x,y)函数意义函数意义：按位或。返返 回回 值值：开关型。参数参数：，开关型。,开关型。实例实例：。!BitXor(x,y)!BitXor(x,y)!BitXor(x,y)!BitXor(x,y)函数意义函数意义：按位异或。返返 回回 值值：开关型。参