参数

在 Query Helper 对话框中显示的 Parameters PCB 查询函数
本参考页面详细介绍了 PCB 和 PCB 库文档中可用的 Parameters 类别的查询语言关键字。要获取某个特定查询关键字的帮助,请使用下面的可折叠章节,或在 Query Helper 或 Filter 面板中高亮(或在其中单击)任意关键字,然后按 F1 以立即跳转到其对应章节。
CompParameterValue
摘要
返回 PCB 元件参数的字符串值,可对其进行测试以返回符合查询条件的 PCB 元件。
语法
CompParameterValue(ParameterName : String) : String
示例用法
CompParameterValue('Mounting Technology') Like 'SM*'
返回所有包含 Mounting Technology 参数且其值字符串以 SM 开头的元件,例如 SMT、SMD 等。符合条件的元件对象的关联子对象(例如走线、圆弧、焊盘、文本等)也会一并返回。
CompParameterValue('Mounting Technology') Like '*SM*'
返回所有元件及其关联子对象,其中 Mounting Technology 参数的值字符串包含 *SM*。
StrToNumber(CompParameterValue('VoltageRating'),V) > 50
返回所有元件及其关联子对象,其中 VoltageRating 参数值大于 50 伏。CompParameterValue 返回的字符串值会通过具备单位识别能力的 StrToNumber 函数转换为数字以进行比较。
FootprintParameterValue
摘要
返回 PCB 封装(Footprint)参数的字符串值,可对其进行测试以返回符合查询条件的 PCB 元件。
语法
FootprintParameterValue(ParameterName : String) : String
示例用法
FootprintParameterValue('Mounting Type') Like 'SMD'
返回所有元件及其关联子对象,其中 Mounting Type 封装(Footprint)参数的值字符串包含 SMD。
HasCompParameter
摘要
返回包含指定参数名的 PCB 元件。
语法
HasCompParameter(ParameterName : String) : Boolean
示例用法
HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = True
返回所有具有 Mounting Technology 参数名的元件父对象。符合条件的元件对象的关联子对象(例如走线、圆弧、焊盘、文本等)也会一并返回。
Not HasCompParameter('Mounting Technology')
HasCompParameter('Mounting Technology') = False
返回所有元件及其关联子对象,except 适用于那些具有 Mounting Technology 参数的元件父对象。
HasCompParameterValue
摘要
返回包含指定参数名且其参数值符合查询条件的 PCB 元件。
语法
HasCompParameterValue(ParameterName : String , ParameterValue : String) : Boolean
示例用法
HasCompParameterValue('Mounting Technology','SMT')
HasCompParameterValue('Mounting Technology','SMT') = True
返回所有具有 Mounting Technology 参数名且其值属性与 SMT 匹配的元件父对象。符合条件的元件对象的关联子对象(例如走线、圆弧、焊盘、文本等)也会一并返回。
Not HasCompParameterValue('Design Item Status','RoHS-Compliant')
HasCompParameterValue('Design Item Status','RoHS-Compliant') = False
返回所有元件及其关联子对象,这些元件不包含值为 RoHS-Compliant 的 Design Item Status 参数。
HasFootprintParameter
摘要
返回包含指定封装(Footprint)参数名的 PCB 元件。
语法
HasFootprintParameter(ParameterName : String) : Boolean
示例用法
HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
返回所有具有 IPC Density 封装(Footprint)参数名的元件父对象。符合条件的元件对象的关联子对象(例如走线、圆弧、焊盘、文本等)也会一并返回。
Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
返回所有元件及其关联子对象,except 适用于那些具有 IPC Density 封装(Footprint)参数的元件父对象。
HasFootprintParameterValue
摘要
返回包含指定封装(Footprint)参数名且其参数值符合查询条件的 PCB 元件。
语法
HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean
示例用法
HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
返回所有 具有 Mounting Method 封装(Footprint)参数名且其值属性与 Press Fit. 匹配的元件父对象。符合条件的元件对象的关联子对象(例如走线、圆弧、焊盘、文本等)也会一并返回。
Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
返回所有元件及其关联子对象,这些元件不包含值为 Press Fit.
Mounting Method 封装(Footprint)参数
HasParameter
摘要
返回包含指定参数名的 PCB 对象。
语法
HasParameter(ParameterName : String) : Boolean
示例用法
HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = True
返回所有具有 Mounting Technology 参数名的对象。
Not HasParameter('Mounting Technology')
HasParameter('Mounting Technology') = False
返回所有对象 except 具有 Mounting Technology 参数的那些对象。
HasParameterValue
摘要
返回包含指定参数名且其参数值符合查询条件的 PCB 对象。
语法
HasParameterValue(ParameterName : String , ParameterValue : String) : Boolean
示例用法
HasParameterValue('Mounting Technology','SMT')
HasParameterValue('Mounting Technology','SMT') = True
返回所有具有 Mounting Technology 参数名且其值属性与 SMT 匹配的对象。
Not HasParameterValue('Design Item Status','RoHS-Compliant')
HasParameterValue('Design Item Status','RoHS-Compliant') = False
返回所有不包含值为 RoHS-Compliant 的 Design Item Status 参数的对象。
ParameterValue
摘要
返回 PCB 对象参数的字符串值,可对其进行测试以返回符合查询条件的 PCB 对象。
语法
ParameterValue(ParameterName : String) : String
示例用法
ParameterValue('Mounting Technology') Like 'SM*'
返回所有具有 Mounting Technology 参数且其值字符串以 SM 开头的对象,例如 SMT、SMD 等。
ParameterValue('Mounting Technology') Like '*SM*'
返回所有具有 Mounting Technology 参数且其值字符串包含 SM 的对象。
StrToNumber(ParameterValue('VoltageRating'),V) > 50
返回所有具有 VoltageRating 参数且其参数值大于 50 伏的对象。ParameterValue 返回的字符串值会通过具备单位识别能力的 StrToNumber 函数转换为数字以进行比较。
StrToNumber
摘要
使用指定的单位类型,将所选参数值字符串转换为数字。
语法
StrToNumber(Value : String , Unit : String) : Number
示例用法
StrToNumber(ParameterValue('VoltageRating'),V) > 50
将 VoltageRating 参数返回的值字符串按伏特(V)作为单位转换为数字,然后返回所有数值大于 50V 的对象。
StrToNumber(ParameterValue('Resistance'),Ohms) Between 1000 And 10000
将 Resistance 参数返回的值字符串按欧姆作为单位转换为数字,然后返回所有数值介于 1kΩ 与 10kΩ 之间的对象。
StrToNumber(ParameterValue('CapacitanceValue'),F) < 2e-9
将 CapacitanceValue 参数返回的值字符串按电容(F)作为单位转换为数字,然后返回所有数值小于 2nF(科学计数法为 2e-9)的对象。
注释
如果值字符串无法转换为数字,将抛出脚本错误。为应对这种情况,请使用 StrToNumber 函数;当转换失败时,该函数会返回指定的默认数值。
该具备单位识别能力的字符串转数字转换函数支持大量单位类型定义,包括:
- V – 电压
- A – 电流
- Ohm – 电阻
- Z – 阻抗
- F – 电容
- H – 电感
- G – 电导
- W – 功率
- Hz – 频率
- Q – 电荷
- C – 温度
- dB – 分贝
- % – 百分比
- m – 长度
- Kg – 质量
- s – 时间
该转换器支持标准数值倍率(micro、kilo、mega 等),因此也支持包含前缀缩写的参数字符串,例如 mV、uA、kHz, 等。
同时也支持多种数值写法。例如,同一个电阻值可以表示为:
- 2k2
- 2.2k
- 2200
- 2,200
StrToNumberDef
摘要
使用指定的单位类型,将所选参数值字符串转换为数字;若无法转换,则返回默认数值。
语法
StrToNumber(Value : String , Unit : String , Default : Number) : Number
示例用法
StrToNumberDef(ParameterValue('VoltageRating'),V,10) > 50
将 VoltageRating 参数返回的值字符串按电压(V)作为单位转换为数字,然后返回所有数值大于 50V 的对象。如果参数字符串或单位无法识别(无法转换),则返回默认值 10。
StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
将 VoltageRating 参数返回的值字符串按电压(V)作为单位转换为数字,然后返回所有额定值介于 10V 与 50V 之间的对象。如果无法读取该值,则假定电压为 6V(定义的默认值)。
注释
该具备单位识别能力的字符串转数字转换函数支持大量单位类型定义,包括:
- V – 电压
- A – 电流
- Ohm – 电阻
- Z – 阻抗
- F – 电容
- H – 电感
- G – 电导
- W – 功率
- Hz – 频率
- Q – 电荷
- C – 温度
- dB – 分贝
- % – 百分比
- m – 长度
- Kg – 质量
- s – 时间
该转换器支持标准数值倍率(micro、kilo、mega 等),因此也支持包含前缀缩写的参数字符串,例如 mV、uA、kHz, 等。
同时也支持多种数值写法。例如,同一个电阻值可以表示为:
- 2k2
- 2.2k
- 2200
- 2,200