参数
概览
- 了解哪些参数查询关键字适用于元件、封装或一般 PCB 对象，以及如何在筛选器或查询中使用各个关键字。
- 查看查询示例，了解如何按参数名称查找对象、精确或部分匹配参数值，以及排除不满足条件的对象。
- 了解如何使用 'StrToNumber' 和 'StrToNumberDef' 等关键字，将字符串形式的参数值转换为数值，以进行范围比较。
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 伏的所有元件及其关联的子对象。支持单位识别的 StrToNumber 函数会将 CompParameterValue 返回的字符串值转换为数值以进行比较。
FootprintParameterValue
概述
返回 PCB 封装参数的字符串值，可通过测试该值来返回符合查询条件的 PCB 元件。
语法
FootprintParameterValue(ParameterName : String) : String
用法示例
FootprintParameterValue('Mounting Type') Like 'SMD'
返回 Mounting Type 封装参数的值字符串包含 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
概述
返回包含指定名称封装参数的 PCB 元件。
语法
HasFootprintParameter(ParameterName : String) : Boolean
用法示例
HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = True
返回所有具有名为 IPC Density 的封装参数的元件父对象。同时也会返回符合条件的元件对象所关联的子对象，例如走线、圆弧、焊盘、文本等。
Not HasFootprintParameter('IPC Density')
HasFootprintParameter('IPC Density') = False
返回所有元件及其关联的子对象，except具有 IPC Density 封装参数的元件父对象。
HasFootprintParameterValue
概述
返回包含指定名称封装参数且该参数值符合查询条件的 PCB 元件。
语法
HasFootprintParameterValue(ParameterName : String , ParameterValue : String) : Boolean
用法示例
HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = True
返回所有具有名为 Mounting Method 的封装参数且其值属性与 Press Fit. 匹配的元件父对象。同时也会返回符合条件的元件对象所关联的子对象，例如走线、圆弧、焊盘、文本等。
Not HasFootprintParameterValue('Mounting Method','Press Fit')
HasFootprintParameterValue('Mounting Method','Press Fit') = False
返回所有不具有 Mounting Method 封装参数或该参数值不为 Press Fit.
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 伏的对象。支持单位识别的 StrToNumber 函数会将 ParameterValue 返回的字符串值转换为数值以进行比较。
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 – 时间
该转换函数接受标准数值倍率（微、千、兆等），因此支持包含 mV、uA、kHz, 等前缀缩写的参数字符串。
该函数还支持多种数值表示形式。例如，同一个电阻值可以表示为：
- 2k2
- 2.2k
- 2200
- 2,200
StrToNumberDef
概述
使用指定的单位类型，将指定参数的值字符串转换为数字；若无法转换，则返回默认数字。
语法
StrToNumber(Value : String , Unit : String , Default : Number) : Number
用法示例
StrToNumberDef(ParameterValue('VoltageRating'),V,10) > 50
以电压 (V) 为单位，将 VoltageRating 参数返回的值字符串转换为数字，然后返回所有值大于 50V 的对象。如果无法识别参数字符串或单位（即无法转换），则返回默认值 10。
StrToNumberDef(ParameterValue('VoltageRating'),'V',6) Between 10 And 50
以电压 (V) 为单位，将 VoltageRating 参数返回的值字符串转换为数字，然后返回所有额定值介于 10V 和 50V 之间的对象。如果无法读取该值，则假定电压为 6V（定义的默认值）。
注意事项
支持单位识别的字符串转数字函数接受多种单位类型定义，包括：
- V – 电压
- A – 电流
- Ohm – 电阻
- Z – 阻抗
- F – 电容
- H – 电感
- G – 电导
- W – 功率
- Hz – 频率
- Q – 电荷
- C – 温度
- dB – 分贝
- % – 百分比
- m – 长度
- Kg – 质量
- s – 时间
该转换函数接受标准数值倍率（微、千、兆等），因此支持包含 mV、uA、kHz, 等前缀缩写的参数字符串。
该函数还支持多种数值表示形式。例如，同一个电阻值可以表示为：
- 2k2
- 2.2k
- 2200
- 2,200
AI 翻译