力控组态软件ForceControl V7.0获取后台组件配方信息的控件方法
GetForceValeState(“RecipeName”)
描述: 获得配方使用强制值的状态。
返回值: int 0- 不使用强制值,1- 使用强制值
参数: RecipeName – 字符串,配方名称,为字符串
说明: 获得配方使用强制值的状态
示例: bForceVale = #pRecipe.GetForceValeState(“Beer”)// 获得配方 Beer 的强制值状态赋给 bForceVale。0 为不允许使用
GetMaterialCount(string RecipeName)
描述: 获得配方 RecipeName 的原料数
返回值: int- 配方原料数量
参数: RecipeName – 配方名称字符串
说明: 该函数获得给定配方的原料数目。如果返回失败则返回 -1
示例: nCount= #pRecipe.GetMaterialCount(“Beer”) // 获得配方 Beer 的原料数目,并赋给nCount
GetMaterialDescription(string RecipeName,string MaterialName)
描述: 获得配方中某一个原料的描述信息
返回值: string
参数: RecipeName – 字符串,配方名称
MaterialName – 字符串,原料名称
说明: 获得配方中某一个原料的描述信息
示例: tag1.desc = #pRecipe.GetMaterialDescription(“Beer”,”tag.pv”)
// 获得配方 Beer 的 tag.pv 原料的描述信息并赋给变量 tag1.desc
GetMaterialExpression(string RecipeName,string MaterialVarName)
描述: 获得配方中一原料的表达式
返回值: string
参数: RecipeName – 字符串,配方名称
MaterialVarName – 字符串,原料变量名称
说明: 获得给定配方某一原料的表达式,失败则返回空
示例: strVar = #pRecipe.GetMaterialExpression(“Beer”,”Tag1.pv”)// 得到配方 Beer 中Tag1.pv 原料的表达式值,并赋给 strVar
GetMaterialForceValue(string RecipeName,string MaterialName)
描述: 获得配方中某一原料的强制值
返回值: float
参数: RecipeName – 字符串,配方名称
MaterialName – 字符串,原料名称
说明: 获得配方中某一项原料的强制值,失败返回 -2, 没有强制值返回 -1
示例: fVar = #pRecipe.GetMaterialForceValue(“Beer”,”Tag1.pv”)// 获得配方 Beer 中 Tag1.pv原料的强制值赋给 fVar,失败返回 -2, 没有强制值返回 -1
GetMaterialName(string RecipeName,int index)
描述: 获得配方中某个序号的原料名称
返回值: string
参数: RecipeName – 字符串,需要编辑的配方名称
index – int,序号
说明: 执行本函数将获得某个配方的第 index 项原料的名称
示例: strRecipeName = #pRecipe.GetMaterialName(“Recipe1”,index)
// 获得配方 Recipe1 第 index 项的名称,并赋给 strRecipeName
GetMaterialReferVar(string RecipeName,string MaterialName)
描述: 获得配方中某一个原料的参考变量
返回值: string
参数: RecipeName – 字符串,配方名称,为字符串
MaterialName – 字符串,原料名称
说明: 获得配方中某一个原料的参考变量
示例: Referencevar = #pRecipe.GetMaterialReferVar(“Beer”,”tag.pv”)
// 获得配方 Beer 的 tag.pv 原料的参考变量赋给变量 Referencevar
GetMaterialUnit(string RecipeName,string MaterialName)
描述: 获得配方中某一原料的单位
返回值: string
参数: RecipeName – 字符串,配方名称
MaterialName – 字符串,原料名称
说明: 获得配方中某一项原料的单位
示例: strVar = #pRecipe.GetMaterialUnit(“Beer”,”Tag1.pv”)
// 获得配方 Beer 中 Tag1.pv 原料的单位赋给 strVar
GetMaterialValue(string RecipeName,string MaterialVarName)
描述: 获得给定配方某一原料的值
返回值: float- 原料项对应的值
参数: RecipeName – 字符串,配方名称
MaterialVraName – 字符串,原料名称
说明: 获得给定配方某一原料的值,失败则返回 -1
示例: fVar = #pRecipe.GetMaterialValue(“Beer”,”Tag1.pv”)// 得到配方 Beer 中 Tag1.pv原料的值
GetProductNO(string RecipeName)
描述: 获得配方对应的产品编号
返回值: string- 产品编号
参数: Recipename- 配方名称字符串
说明: 该函数获得配方对应的产品编号
示例: StrProNO = #pRecipe.GetProductNO(“Beer”)// 获得 Beer 配方对应产品编号并且赋给 StrProNo
GetRcpCount()
描述: 获得该配方组中包含的配方数。
返回值: int 配方组中的配方数
参数: 无
说明: 执行本函数将获得某个配方组中包含配方数。
示例: int nRcpCount = #pRecipe.GetRcpCount();;
// 获得该配方组 pRecipe 中包含的配方数 , 并赋给 nRcpCount。
GetRcpNameByIndex(int n)
描述: 通过索引号获得配方的名字
返回值: 字符串 配方名字字符串
参数: int- 索引号,以 0 开始
说明: 通过索引号获得配方的名字,该方法一般与 GetRcpCount 配合使用
示例: string strRcpName = #pRecipe.GetRcpNameByIndex(5);
// 获得配方组 pRecipe 中索引号为 5 的配方的名字,赋给 strRcpName
LoadFile(string Path, string FileName)
描述: 将配方组装载到系统中
返回值:i nt 0- 失败,1- 成功
参数: Path – 字符串,文件的存储路径
FileName – 字符串,装载文件名称
说明: 将文件 FileName 装载进当前的配方组中,装载的文件必须是本配方组件生成的 xml 和rcp 格式的文件,如果路径为空则默认去工程目录下查找。
示例: #pRecipe.LoadFile(“C:\Program Files\PCAuto6″,”abc.xml”)
// 将力控目录下的 abc.xml 文件中保存的配方装载到 pRecipe 配方组中