会员资格检查

摘要

对于对象的数值属性（例如高度、宽度、半径等），此关键字用于将当前值（以默认工作区单位计量）转换为英制单位 mil（1 mil = 0.001 英寸），然后与表达式中输入的值进行比较测试。

语法

AsMils(Keyword : Number) : Number

示例用法

AsMils(ArcRadius) = 250
返回所有其Radius 属性为250mil的弧线对象。

AsMils(Height) Between 300 And 500
返回所有其Height 属性大于或等于300mil，且小于或等于500mil的元件对象。

AsMils(PolygonGridSize) >= 10
返回所有其Grid Size属性大于或等于10mil的多边形覆铜对象。

AsMils(Width) < 50
返回所有其Width 属性小于50mil的弧线与走线对象。

AsMils(TraceLength) = 10
返回所有其Length 等于10mil的弧线与走线对象。

Note - 由于软件中的一个问题，要使用AsMils关键字正确检测TraceLength，在运行查询之前必须将板单位设置为 mil。

摘要

对于对象的数值属性（例如高度、宽度、半径等），此关键字用于将当前值（以默认工作区单位计量）转换为公制单位 mm（1mm = 0.001 米），然后与表达式中输入的值进行比较测试。

语法

AsMM(Keyword : Number) : Number

示例用法

AsMM(ArcRadius) = 6.35
返回所有其Radius 属性为6.35mm的弧线对象。

AsMM(Height) Between 7.62 And 12.7
返回所有其Height 属性大于或等于7.62mm，且小于或等于12.7mm的元件对象。

AsMM(PolygonGridSize) >= 0.254
返回所有其Grid Size属性大于或等于0.254mm的多边形覆铜对象。

AsMM(Width) < 1.27
返回所有其Width 属性小于1.27mm的弧线与走线对象。

AsMM(TraceLength) = 1
返回所有其Length 等于1mm的弧线与走线对象。

Note - 由于软件中的一个问题，要使用AsMM关键字正确检测TraceLength，在运行查询之前必须将板单位设置为 mil。

摘要

返回所有其Layer 属性与指定 Layer Class 中某个成员层相匹配的元件对象。

语法

ComponentInLayerClass(ClassName : String) : Boolean/Boolean_String

在定义查询表达式时，会弹出一个按名称排序的列表，列出所有现有的用户自定义 Layer Class。

示例用法

ComponentInLayerClass('TopSide')
ComponentInLayerClass('TopSide') = True
ComponentInLayerClass('TopSide') = 'True'
返回所有其Layer 属性与TopSide Layer Class 中某个成员层相匹配的元件对象。

Not ComponentInLayerClass('BottomSide')
ComponentInLayerClass('BottomSide') = False
ComponentInLayerClass('BottomSide') = 'False'
返回所有对象except 元件对象，其Layer 属性与BottomSide Layer Class 中某个成员层相匹配。

注意

ClassName字符串起始与结束处的单引号字符 (') 为必需。

摘要

返回所有存在于指定层上的对象。

语法

ExistsOnLayer(Layer : String) : Boolean/Boolean_String

Layer为层名称 ，其显示名称与Layers & ColorsView Configuration panel的选项卡上一致。

示例用法

ExistsOnLayer('Top Layer')
ExistsOnLayer('Top Layer') = True
ExistsOnLayer('Top Layer') = 'True'
返回所有存在于Top Layer.

Not ExistsOnLayer('Mechanical 3')
ExistsOnLayer('Mechanical 3') = False
ExistsOnLayer('Mechanical 3') = 'False'
上的对象 返回所有对象except对象，这些对象存在于Mechanical 3层上。

注意

Layer起始与结束处的单引号字符 (') 为必需。

摘要

返回所有其Footprint 属性符合该查询的元件对象。

语法

HasFootprint(Footprint : String) : Boolean/Boolean_String

示例用法

HasFootprint('SIP?0')
HasFootprint('SIP?0') = True
HasFootprint('SIP?0') = 'True'
返回所有其Footprint 属性以SIP开头、以0结尾，并且中间还包含一个其他字符的元件对象。符合条件的封装示例包括SIP10、SIP20和SIPQ0。

HasFootprint('DIP*')
HasFootprint('DIP*') = True
HasFootprint('DIP*') = 'True'
返回所有其Footprint 属性以DIP开头的元件对象。符合条件的封装示例包括DIP8、DIP14和DIP24N。

Not HasFootprint('IDC16')
HasFootprint('IDC16') = False
HasFootprint('IDC16') = 'False'
返回所有对象except 元件对象，其Footprint 属性为IDC16。

HasFootprint('*2*')
HasFootprint('*2*') = True
HasFootprint('*2*') = 'True'
返回所有其Footprint 属性包含字符2的元件对象。符合条件的封装示例包括2012、2N5001、IDC20和HDR1X2。

注意事项

• Footprint字符串起始与结束处的单引号字符 (') 为必需。
• 对每个返回的元件对象，其关联的子对象也会一并返回。

摘要

返回所有焊盘对象：这些焊盘对象是具有指定 Footprint 的元件对象的子对象，并且焊盘的Name 属性符合该查询。

语法

HasFootprintPad(Footprint : String,Name : String) : Boolean/Boolean_String

示例用法

Not HasFootprintPad('0805','1')
HasFootprintPad('0805','1') = False
HasFootprintPad('0805','1') = 'False'
返回所有对象except 焊盘对象，其Name 属性为1，并且是Footprint 属性为0805的元件对象的子对象。

HasFootprintPad('SIP?0','1')
HasFootprintPad('SIP?0','1') = True
HasFootprintPad('SIP?0','1') = 'True'
返回所有焊盘对象，其Name 属性为1，并且是元件对象的子对象：该元件对象的Footprint 属性以SIP开头、以0结尾，并且中间还包含一个其他字符。符合条件的封装示例包括SIP10、SIP20、SIPQ0。

HasFootprintPad('DB*','MNT')
HasFootprintPad('DB*','MNT') = True
HasFootprintPad('DB*','MNT') = 'True'
返回所有焊盘对象，其Name 属性为MNT ，并且是元件对象的子对象：该元件对象的Footprint 属性以 DB 开头。符合条件的封装示例包括DB9S、DB15HD、DB25P。

HasFootprintPad('','MN*')
HasFootprintPad('','MN*') = True
HasFootprintPad('','MN*') = 'True'
返回所有焊盘对象，其Name 属性以MN开头，并且是any 元件对象的子对象。

注意事项

• Footprint与Name字符串起始与结束处的单引号字符 (') 为必需。
• 不会返回父级元件对象。

摘要

返回所有在指定层上定义了 Paste Mask Expansion（过孔除外）或 Solder Mask Expansion 数值的弧线、填充、焊盘、区域、走线和过孔对象。数值可以手动定义，也可以取自适用的已定义设计规则。

语法

HasMaskExpansionOnLayer(Layer : String) : Boolean/Boolean_String

Layer为层名称，其显示名称与View Configuration panel的Layers & Colors选项卡中适用的Layers部分一致。

示例用法

HasMaskExpansionOnLayer('Top Layer')
HasMaskExpansionOnLayer('Top Layer') = True
HasMaskExpansionOnLayer('Top Layer') = 'True'
返回所有在Top Layer.

Not HasMaskExpansionOnLayer('Bottom Layer')
HasMaskExpansionOnLayer('Bottom Layer') = False
HasMaskExpansionOnLayer('Bottom Layer') = 'False'
上定义了 Paste Mask Expansion（过孔除外）或 Solder Mask Expansion 数值的弧线、填充、焊盘、区域、走线和过孔对象 返回所有对象except弧线、填充、焊盘、区域、走线和过孔对象，这些对象在Bottom Layer上定义了 Paste Mask Expansion（过孔除外）或 Solder Mask Expansion 数值。

注意

Layer起始与结束处的单引号字符 (') 为必需。

摘要

返回所有其完整名称属性符合该查询的焊盘对象。

语法

HasPad(PadName : String) : Boolean/Boolean_String

PadName字符串用于指定焊盘需要匹配的完整名称。它由两部分组成：首先是一个初始子串，用于指定焊盘父级元件的Name 属性（即元件的 Designator），随后是一个子串，用于指定焊盘自身的Name 属性（即焊盘的 Designator）。因此其格式为'ParentComponentDesignator-PadDesignator'。

示例用法

Not HasPad('C14-1')
HasPad('C14-1') = False
HasPad('C14-1') = 'False'
返回所有对象except 该焊盘对象，其Name 属性为1，并且是Name 属性为C14的元件对象的子对象。

HasPad('U5-11')
HasPad('U5-11') = True
HasPad('U5-11') = 'True'
返回该焊盘对象，其Name 属性为11，并且是Name 属性为U5的元件对象的子对象。

HasPad('U*-11')
HasPad('U*-11') = True
HasPad('U*-11') = 'True'
返回所有焊盘对象，其Name 属性为11，并且是元件对象的子对象：该元件对象的Name 属性以U开头。

HasPad('*-1*')
HasPad('*-1*') = True
HasPad('*-1*') = 'True'
返回所有焊盘对象，其Name 属性以1开头，并且是any 元件对象的子对象。

注意

PadName字符串起始与结束处的单引号字符 (') 为必需。

摘要

返回所有其过孔特征属性符合该查询的过孔对象。

语法

HasViaFeature(ViaFeature : String) : Boolean/Boolean_String

ViaFeature字符串用于指定过孔必须匹配的“过孔特征”(via feature)。它可以是以下之一：

• Capping
• Covering
• Filling
• Plugging
• Tenting

示例用法

Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
返回所有对象 except 过孔对象，其过孔特征属性为 Capping。

HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
返回过孔对象，其过孔特征属性为 Covering。

注意

ViaFeature字符串起始和结束处的单引号字符（'）是必需的。

摘要

返回所有过孔对象，其过孔类型(via type)属性符合该查询。

语法

HasViaType(ViaType : String) : Boolean/Boolean_String

ViaType字符串用于指定过孔必须匹配的IPC 4761 Via Type属性。它可以是以下之一：

• None
• Type 1a
• Type 1b
• Type 2a
• Type 2b
• Type 3a
• Type 3b
• Type 4a
• Type 4b
• Type 5
• Type 6a
• Type 6b
• Type 7

示例用法

Not HasViaFeature('Capping')
HasViaFeature('Capping') = False
HasViaFeature('Capping') = 'False'
返回所有对象 except 过孔对象，其过孔特征属性为 Capping。

HasViaFeature('Covering')
HasViaFeature('Covering') = True
HasViaFeature('Covering') = 'True'
返回过孔对象，其过孔特征属性为 Covering。

注意

ViaFeature字符串起始和结束处的单引号字符（'）是必需的。

摘要

返回与属于指定设计通道类（Design Channel Class）的元件对象相关联的所有对象。

语法

InChannelClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String

在定义查询表达式时，会弹出一个按名称排序的、所有现有用户自定义设计通道类的列表。

示例用法

InChannelClass('Red_LED')
InChannelClass('Red_LED') = True
InChannelClass('Red_LED') = 'True'
返回与属于 Red_LED 设计通道类的元件对象相关联的所有对象。

InChannelClass('Output channel','Input channel')
InChannelClass('Output channel','Input channel') = True
InChannelClass('Output channel','Input channel') = 'True'
返回与属于 Output channel 或 Input channel 设计通道类的元件对象相关联的所有对象。

InChannelClass('Input*')
InChannelClass('Input*') = True
InChannelClass('Input*') = 'True'
返回与属于任意设计通道类且其 Name 属性以 Input 开头的元件对象相关联的所有对象。

注意事项

• 每个 ClassName 字符串起始和结束处的单引号字符（'）是必需的。
• 也会返回其父级元件对象。

摘要

返回所有元件对象，其 Name 属性符合该查询。

语法

InComponent(Name : String) : Boolean/Boolean_String

在定义查询表达式时，会弹出一个按名称排序的、所有现有元件的列表。

示例用法

InComponent('U1')
InComponent('U1') = True
InComponent('U1') = 'True'
返回所有元件对象，其 Name 属性为 U1。

InComponent('U1', 'U2', 'J1')
InComponent('U1', 'U2', 'J1') = True
InComponent('U1', 'U2', 'J1') = 'True'
返回所有元件对象，其 Name 属性为 U1、或 U2、或 J1。

Not InComponent('IDC16')
InComponent('IDC16') = False
InComponent('IDC16') = 'False'
返回所有对象 except 元件对象，其 Name 属性为 IDC16。

InComponent('U*')
InComponent('U*') = True
InComponent('U*') = 'True'
返回所有元件对象，其 Name 属性以 U 开头。

注意事项

• Name字符串起始和结束处的单引号字符（'）是必需的。
• 对于每个返回的元件对象，也会返回其关联的子对象。

摘要

返回属于指定元件类（Component Class）的所有元件对象。

语法

InComponentClass(ClassName : String) : Boolean/Boolean_String

在定义查询表达式时，会弹出一个按名称排序的、所有现有用户自定义元件类的列表。

示例用法

InComponentClass('TopSideSMD')
InComponentClass('TopSideSMD') = True
InComponentClass('TopSideSMD') = 'True'
返回属于 TopSideSMD 元件类的所有元件对象。

Not InComponentClass('BottomSideSMD')
InComponentClass('BottomSideSMD') = False
InComponentClass('BottomSideSMD') = 'False'
返回所有对象 except 元件对象，它们属于 BottomSideSMD 元件类。

注意

ClassName字符串起始和结束处的单引号字符（'）是必需的。

摘要

返回与差分对对象相关联的所有对象，其中差分对对象的 Name 属性符合该查询。

语法

InDifferentialPair(DifferentialPairName1 : String,DifferentialPair2 : String,...,DifferentialPairn : String) : Boolean/Boolean_String

在定义查询表达式时，会弹出一个按名称排序的、所有现有差分对的列表。

示例用法

InDifferentialPair('Red_LED')
InDifferentialPair('Red_LED') = True
InDifferentialPair('Red_LED') = 'True'
返回与差分对对象相关联的所有对象，其中该差分对对象的 Name 属性为 Red_LED。

InDifferentialPair('D0','D1')
InDifferentialPair('D0','D1') = True
InDifferentialPair('D0','D1') = 'True'
返回与差分对对象相关联的所有对象，其中差分对对象的 Name 属性为 D0 或 D1。

InDifferentialPair('Input*')
InDifferentialPair('Input*') = True
InDifferentialPair('Input*') = 'True'
返回与差分对对象相关联的所有对象，其中差分对对象的 Name 属性以 Input 开头。

注意事项

• 每个 DifferentialPairName 字符串起始和结束处的单引号字符（'）是必需的。
• 也会返回其父级差分对对象。

摘要

返回属于指定差分对类（Differential Pair Class）的所有差分对对象。

语法

InDifferentialPairClass(ClassName : String) : Boolean/Boolean_String

在定义查询表达式时，会弹出一个按名称排序的、所有现有差分对的列表。

示例用法

InDifferentialPairClass('TopSide')
InDifferentialPairClass('TopSide') = True
InDifferentialPairClass('TopSide') = 'True'
返回属于 TopSide 差分对类的所有差分对对象。

Not InDifferentialPairClass('BottomSide')
InDifferentialPairClass('BottomSide') = False
InDifferentialPairClass('BottomSide') = 'False'
返回所有对象 except 差分对对象，它们属于 BottomSide 差分对类。

注意

ClassName字符串起始和结束处的单引号字符（'）是必需的。

摘要

返回所有过孔对象，其 Drill Pair 属性与指定的钻孔层对（Drill Layer Pair）匹配。

语法

InDrillLayerPair(LayerPair : String) : Boolean/Boolean_String

示例用法

InDrillLayerPair('Top Layer - Bottom Layer')
InDrillLayerPair('Top Layer - Bottom Layer') = True
InDrillLayerPair('Top Layer - Bottom Layer') = 'True'
返回所有过孔对象，其 Drill Pair 属性与 Top Layer - Bottom Layer 钻孔层对匹配。

Not InDrillLayerPair('Top Layer - Signal Layer 1')
InDrillLayerPair('Top Layer - Signal Layer 1') = False
InDrillLayerPair('Top Layer - Signal Layer 1') = 'False'
返回所有对象 except 过孔对象，其 Drill Pair 属性与 Top Layer - Signal Layer 1 钻孔层对匹配。

注意事项

• Drill Layer Pair 属性仅对过孔对象定义。
• LayerPair字符串起始和结束处的单引号字符（'）是必需的。
• 若要定位特定类型的过孔，请在查询中包含 合适的对象类型检查： IsThruVia、IsBlindVia、IsBuriedVia、IsMicroVia 或 IsSkipVia。
  例如，查询：
  InDrillLayerPair('Top Layer - Signal Layer 1') AND IsMicroVia 
  返回所有过孔对象，其 Drill Pair 属性与 Top Layer - Signal Layer 1 钻孔层对匹配 且其过孔类型为 µVia。

摘要

返回与某个 from-to 对象相关联的所有对象，其中该 from-to 对象的 Net、From Pad 和 To Pad 属性符合该查询。

虽然 from-to 对象会在 PCB List 面板中返回，但要在工作区中看到它们，需要在将 PCB 面板切换到 From-To Editor 模式后再应用过滤查询。

语法

InFromTo('Net_Name (From_Pad : To_Pad)') : Boolean/Boolean_String

在定义查询表达式时，会弹出一个按名称排序的、所有现有 from-to 的列表。

Net_NameFrom_Pad 和 To_Pad 都是字符串；唯一使用的单引号字符（'）就是上面所示的那些（紧贴在最外层括号内侧）。

From_Pad 与 To_Pad 字符串分别指定焊盘必须匹配的完整名称。该名称由两部分组成：起始子串用于指定焊盘父级元件的 Name 属性（即元件的 Designator），随后子串用于指定焊盘自身的 Name 属性（即焊盘的 Designator）。因此格式为 'ParentComponentDesignator-PadDesignator'。

示例用法

InFromTo('VDD_XTAL (C13-2 : U1-8)')
InFromTo('VDD_XTAL (C13-2 : U1-8)') = True
InFromTo('VDD_XTAL (C13-2 : U1-8)') = 'True'
返回与某个 from-to 对象 相关联的所有对象，其中其 Net 属性为 VDD_XTAL、From Pad 属性为 C13-2，且 To Pad 属性为 U1-8。（因此，From Pad 的 Name 属性为 2，其父级元件对象的 Name 属性为 C13。同样，To Pad 的 Name 属性为 8 ，其父级元件对象的 Name 属性为 U1）。

注意

也会返回其父级 from-to 对象。

摘要

返回属于指定 From To 类的所有 from-to 对象。

语法

InFromToClass(ClassName : String) : Boolean/Boolean_String

在定义查询表达式时，会弹出一个按名称显示的、所有现有用户自定义 from to 类的列表。

示例用法

InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = True
InFromToClass('Bus Terminators') = 'True'
返回属于 Bus Terminators From To 类的所有 from-to 对象。

Not InFromToClass('Bus Terminators')
InFromToClass('Bus Terminators') = False
InFromToClass('Bus Terminators') = 'False'
返回所有对象 except from-to 对象，它们属于 Bus Terminators From To 类。

注意

ClassName字符串起始和结束处的单引号字符（'）是必需的。

摘要

返回所有对象，其 Layer 属性匹配属于指定层类（Layer Class）的某个层。

语法

InLayerClass(ClassName : String) : Boolean/Boolean_String

在定义查询表达式时，会弹出一个按名称排序的、所有现有用户自定义层类的列表。

示例用法

InLayerClass('TopSide')
InLayerClass('TopSide') = True
InLayerClass('TopSide') = 'True'
返回所有对象，其 Layer 属性匹配属于 TopSide 层类的某个层。

Not InLayerClass('BottomSide')
InLayerClass('BottomSide') = False
InLayerClass('BottomSide') = 'False'
返回所有对象 except 对象，其 Layer 属性匹配属于 BottomSide 层类的某个层。

注意

ClassName 字符串开头和结尾处的单引号字符 (') 是必需的。

摘要

返回所有参考点位于指定 Board Region 内的对象。

语法

InLayerStackRegion(RegionName1 : String,RegionName2 : String,...,RegionNamen : String) : Boolean/Boolean_String

示例用法

InLayerStackRegion('Region1')
InLayerStackRegion('Region1') = True
InLayerStackRegion('Region1') = 'True'
返回所有参考点位于板框区域（Board Region）内且其 Name 属性为 Region1 的对象。

InLayerStackRegion('Region1','Region2')
InLayerStackRegion('Region1','Region2') = True
InLayerStackRegion('Region1','Region2') = 'True'
返回所有参考点位于板框区域（Board Region）内且其 Name 属性为 Region1 的对象，或参考点位于板框区域（Board Region）内且其 Name 属性为 Region2 的对象。

Not InLayerStackRegion('Region2')
InLayerStackRegion('Region2') = False
InLayerStackRegion('Region2') = 'False'
返回所有对象 except 对象，其参考点位于板框区域（Board Region）内且其 Name 属性为 Region2。

注释

RegionName 字符串开头和结尾处的单引号字符 (') 是必需的。

摘要

返回作为指定多边形覆铜（polygon pour）子对象的所有图元对象。

语法

InNamedPolygon(PolygonName : String) : Boolean/Boolean_String

在定义 Query 表达式时，会弹出一个按名称排序的现有多边形覆铜列表。

示例用法

InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = True
InNamedPolygon('Power3V3') = 'True'
返回作为多边形覆铜子对象的所有图元对象，该多边形覆铜的 Name 属性为 Power3V3。

Not InNamedPolygon('Power3V3')
InNamedPolygon('Power3V3') = False
InNamedPolygon('Power3V3') = 'False'
返回所有对象 except 图元对象，它们是多边形覆铜的子对象，且该多边形覆铜的 Name 属性为 Power3V3。

注释

• PolygonName 字符串开头和结尾处的单引号字符 (') 是必需的。
• 也会返回父多边形覆铜对象。

摘要

返回属于指定联合体（union）的所有对象（父对象和子对象）。

语法

InNamedUnion(UnionName : String) : Boolean/Boolean_String

联合体名称会自动分配，但可在 Unions 模式下通过 PCB 面板进行重命名。在定义 Query 表达式时，会弹出一个按名称排序的现有联合体列表。

示例用法

InNamedUnion('Unions')
InNamedUnion('Unions') = True
InNamedUnion('Unions') = 'True'
返回属于名称为 Unions 的联合体的所有对象（父对象和子对象）。

Not InNamedUnion('Unions 1')
InNamedUnion('Unions 1') = False
InNamedUnion('Unions 1') = 'False'
返回所有对象 except 对象（父对象和子对象），它们属于名称为 Unions 1 的联合体。

注释

UnionName 字符串开头和结尾处的单引号字符 (') 是必需的。

摘要

返回与其 Name 属性符合 Query 的网络（Net）对象相关联的所有对象。

语法

InNet(NetName1 : String,NetName2 : String,...,NetNamen : String) : Boolean/Boolean_String

在定义 Query 表达式时，会弹出一个按名称排序的现有网络列表。

示例用法

InNet('Red_LED')
InNet('Red_LED') = True
InNet('Red_LED') = 'True'
返回与 Name 属性为 Red_LED 的网络（Net）对象相关联的所有对象。

InNet('D0','D1')
InNet('D0','D1') = True
InNet('D0','D1') = 'True'
返回与其 Name 属性为 D0 或 D1 的网络（Net）对象相关联的所有对象。

InNet('V*')
InNet('V*') = True
InNet('V*') = 'True'
返回与其 Name 属性以 V 开头的网络（Net）对象相关联的所有对象。

注释

• 每个 NetName 字符串开头和结尾处的单引号字符 (') 是必需的。
• 也会返回父网络（Net）对象。

摘要

返回属于指定网络类（Net Class）的所有网络（以及与其相关联的对象）。

语法

InNetClass(ClassName : String) : Boolean/Boolean_String

在定义 Query 表达式时，会弹出一个按名称排序的现有用户定义网络类列表。

示例用法

InNetClass('Data Bus Nets')
InNetClass('Data Bus Nets') = True
InNetClass('Data Bus Nets') = 'True'
返回属于 Data Bus Nets 网络类（Net Class）的所有网络（以及与其相关联的对象）。

Not InNetClass('Address Bus Nets')
InNetClass('Address Bus Nets') = False
InNetClass('Address Bus Nets') = 'False'
返回所有对象 except 网络（以及与其相关联的对象），它们属于 Address Bus Nets 网络类（Net Class）。

注释

ClassName 字符串开头和结尾处的单引号字符 (') 是必需的。

摘要

返回属于指定焊盘类（Pad Class）的所有焊盘对象。

语法

InPadClass(ClassName : String) : Boolean/Boolean_String

在定义 Query 表达式时，会弹出一个按名称排序的现有用户定义焊盘类列表。

示例用法

InPadClass('Top Side Probe Pads')
InPadClass('Top Side Probe Pads') = True
InPadClass('Top Side Probe Pads') = 'True'
返回属于 Top Side Probe Pads 焊盘类（Pad Class）的所有焊盘对象。

Not InPadClass('Bottom Side Probe Pads')
InPadClass('Bottom Side Probe Pads') = False
InPadClass('Bottom Side Probe Pads') = 'False'
返回所有对象 except 焊盘对象，它们属于 Bottom Side Probe Pads 焊盘类（Pad Class）。

注释

ClassName 字符串开头和结尾处的单引号字符 (') 是必需的。

摘要

返回属于指定多边形类（Polygon Class）的所有多边形覆铜对象。

语法

InPolygonClass(ClassName : String) : Boolean/Boolean_String

在定义 Query 表达式时，会弹出一个按名称排序的现有用户定义多边形类列表。

示例用法

InPolygonClass('Top Side Polys')
InPolygonClass('Top Side Polys') = True
InPolygonClass('Top Side Polys') = 'True'
返回属于 Top Side Polys 多边形类（Polygon Class）的所有多边形覆铜对象。

Not InPolygonClass('Custom Polys')
InPolygonClass('Custom Polys') = False
InPolygonClass('Custom Polys') = 'False'
返回所有对象 except 多边形覆铜对象，它们属于 Custom Polys 多边形类（Polygon Class）。

注释

ClassName 字符串开头和结尾处的单引号字符 (') 是必需的。

摘要

返回位于 Query 指定区域内的所有对象。

语法

InRegion(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String

X1,Y1 和 X2,Y2 在 PCB（库）文件中指定坐标。区域的左右边界由 X1 和 X2 参数指定，而区域的下上边界由 Y1 和 Y2 参数指定。

所有坐标均以绝对原点为参考（而非用户原点或元件插入点），并且目前始终使用 mil 作为单位（1 mil = 0.001 英寸）。

示例用法

InRegion(12700,4700,13300,5000)
InRegion(12700,4700,13300,5000) = True
InRegion(12700,4700,13300,5000) = 'True'
返回位于矩形区域内的对象：该区域由 X1 = 12700 与 X2 = 13300 以及 Y1 = 4700 与 Y2 = 5000 所限定；这些坐标以绝对原点为参考。

注释

• 不会返回父元件、坐标、尺寸以及网络（Net）对象。
• 该关键字是 InRegionAbsolute 关键字的别名。

摘要

返回位于 Query 指定区域内的所有对象。

语法

InRegionAbsolute(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String

X1,Y1 和 X2,Y2 在 PCB（库）文件中指定坐标。区域的左右边界由 X1 和 X2 参数指定，而区域的下上边界由 Y1 和 Y2 参数指定。

所有坐标均以绝对原点为参考（而非用户原点或元件插入点），并且目前始终使用 mil 作为单位（1 mil = 0.001 英寸）。

示例用法

InRegionAbsolute(12700,4700,13300,5000)
InRegionAbsolute(12700,4700,13300,5000) = True
InRegionAbsolute(12700,4700,13300,5000) = 'True'
返回位于矩形区域内的对象：该区域由 X1 = 12700 与 X2 = 13300 以及 Y1 = 4700 与 Y2 = 5000 所限定；这些坐标以绝对原点为参考。

注释

• 不会返回父元件、坐标、尺寸以及网络（Net）对象。
• 该关键字是 InRegion 关键字的别名。

摘要

返回位于 Query 指定区域内的所有对象。

语法

InRegionRelative(X1 : Number ,Y1 : Number ,X2 : Number ,Y2 : Number) : Boolean/Boolean_String

X1,Y1 和 X2,Y2 在 PCB（库）文件中指定坐标。区域的左右边界由 X1 和 X2 参数指定，而区域的下上边界由 Y1 和 Y2 参数指定。

所有坐标均以用户原点（PCB 文件）或元件插入点（PCB 库文件）为参考，而非绝对原点，并且目前始终使用 mil 作为单位。（1 mil = 0.001 英寸）。

示例用法

InRegionRelative(-700,-400,1300,1600)
InRegionRelative(-700,-400,1300,1600) = True
InRegionRelative(-700,-400,1300,1600) = 'True'
返回位于矩形区域内的对象：该区域由 X1 = -700 与 X2 = 1300 以及 Y1 = -400 与 Y2 = 1600 所限定；这些坐标以用户原点（或元件插入点）为参考。

注释

不会返回父元件、坐标、尺寸以及网络（Net）对象。

摘要

返回属于指定结构类（Structure Class）的元件类（Component Classes）和网络类（Net Classes）的所有父对象与子对象。

语法

InStructureClass(ClassName1 : String,ClassName2 : String,...,ClassNamen : String) : Boolean/Boolean_String

在定义 Query 表达式时，会弹出一个按名称排序的现有用户定义结构类列表。

示例用法

InStructureClass('Red_LED')
InStructureClass('Red_LED') = True
InStructureClass('Red_LED') = 'True'
返回属于 Red_LED 结构类（Structure Class）的元件类和网络类的所有父对象与子对象。

InStructureClass('Output channel','Input channel')
InStructureClass('Output channel','Input channel') = True
InStructureClass('Output channel','Input channel') = 'True'
返回属于 Output channel 或 Input channel 结构类（Structure Classes）的元件类和网络类的所有父对象与子对象。

InStructureClass('Input*')
InStructureClass('Input*') = True
InStructureClass('Input*') = 'True'
返回属于任意结构类（Structure Class）的组件类（Component Classes）和网络类（Net Classes）的所有父对象与子对象，且该结构类的 Name property 以 Input 开头。

注意

每个 ClassName 字符串开头和结尾处的单引号字符（'）是必需的。

摘要

返回属于指定联合（union）的所有对象（父对象与子对象）。

语法

InUnion(Union : Number) : Boolean/Boolean_String

Union 编号会自动分配。在定义查询表达式时，会弹出一个按编号排序的现有 union 列表。

示例用法

InUnion(1)
InUnion(1) = True
InUnion(1) = 'True'
返回属于编号为 1 的 union 的所有对象（父对象与子对象）。

Not InUnion(4)
InUnion(4) = False
InUnion(4) = 'False'
返回属于编号为 4 的 union 的所有对象（父对象与子对象）except objects（父对象与子对象）。

摘要

返回与指定 xSignal 关联的所有对象。

语法

InxSignal(Name : String) : Boolean/Boolean_String

在定义查询表达式时，会弹出一个按名称排序的现有 xSignal 列表。

示例用法

InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = True
InxSignal('DRAM_A0_PP1') = 'True'
返回与 xSignal DRAM_A0_PP1 关联的所有对象。

Not InxSignal('DRAM_A0_PP1')
InxSignal('DRAM_A0_PP1') = False
InxSignal('DRAM_A0_PP1') = 'False'
返回与 xSignal DRAM_A0_PP1 关联的所有对象except objects。

注意

Name 字符串开头和结尾处的单引号字符（'）是必需的。

摘要

返回属于指定 xSignal 类的所有 xSignal 对象。

语法

InxSignalClass(ClassName : String) : Boolean/Boolean_String

在定义查询表达式时，会弹出一个按名称排序的现有用户自定义 xSignal 类列表。

示例用法

InxSignalClass('PCIE')
InxSignalClass('PCIE') = True
InxSignalClass('PCIE') = 'True'
返回属于 PCIE xSignal 类的所有 xSignal 对象。

Not InxSignalClass('PCIE')
InxSignalClass('PCIE') = False
InxSignalClass('PCIE') = 'False'
返回属于 PCIE xSignal 类的所有对象except xSignal 对象。

注意

ClassName 字符串开头和结尾处的单引号字符（'）是必需的。

摘要

返回指定的多边形覆铜（polygon pour）。

语法

IsNamedPolygon(PolygonName : String) : Boolean/Boolean_String

在定义查询表达式时，会弹出一个按名称排序的现有多边形覆铜列表。

示例用法

IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = True
IsNamedPolygon('Power3V3') = 'True'
返回 Name property 为 Power3V3 的多边形覆铜对象。

Not IsNamedPolygon('Power3V3')
IsNamedPolygon('Power3V3') = False
IsNamedPolygon('Power3V3') = 'False'
返回 Name property 为 Power3V3 的多边形覆铜对象except the polygon pour object。

注意事项

• PolygonName 字符串开头和结尾处的单引号字符（'）是必需的。

• 不会返回所返回的多边形覆铜对象的子图元对象。

摘要

返回具有指定名称的 xSignal 对象。

语法

IsxSignal(Name : String) : Boolean/Boolean_String

在定义查询表达式时，会弹出一个按名称排序的现有 xSignal 列表。

示例用法

IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = True
IsxSignal('DRAM_A0_PP1') = 'True'
返回 xSignal DRAM_A0_PP1。

Not IsxSignal('DRAM_A0_PP1')
IsxSignal('DRAM_A0_PP1') = False
IsxSignal('DRAM_A0_PP1') = 'False'
返回所有对象 except xSignal DRAM_A0_PP1。

注意

Name 字符串开头和结尾处的单引号字符（'）是必需的。

摘要

返回其 X1 和 Y1 属性符合查询条件的所有对象。

语法

OnGrid(X1 : Number,Y1 : Number) : Boolean/Boolean_String

Distance_String 的每个实例都是一个数值字符串，用于指定 PCB（库）文件中的距离。要被返回，对象的 X1 属性必须是第一个指定距离的整数倍，并且其 Y1 属性必须是第二个指定距离的整数倍。

X1 和 Y1 用于指定 PCB（库）文件中的坐标。要被返回，对象的 X1 属性必须是第一个指定值的整数倍，并且其 Y1 属性必须是第二个指定值的整数倍。

所有坐标均以绝对原点为参考（而非用户原点或元件插入点），并且目前始终使用 mil 作为单位（1 mil = 0.001 英寸）。

示例用法

OnGrid(25,25)
OnGrid(25,25) = True
OnGrid(25,25) = 'True'
返回 X1 属性为 25mil 的整数倍且 Y1 属性为 25mil 的整数倍的所有对象。

OnGrid(5,100)
OnGrid(5,100) = True
OnGrid(5,100) = 'True'
返回 X1 属性为 5mil 的整数倍且 Y1 属性为 100mil 的整数倍的所有对象。

摘要

返回其 Layer property 符合查询条件的所有对象。

语法

OnLayer(Layer : String) : Boolean/Boolean_String

Layer 是层名称 ，其显示名称与 Layers & Colors 选项卡中的名称一致，该选项卡位于 View Configuration panel 中。

示例用法

OnLayer('Top Layer')
OnLayer('Top Layer') = True
OnLayer('Top Layer') = 'True'
返回所有 Layer property 为 Top Layer.

Not OnLayer('Mechanical 3')
OnLayer('Mechanical 3') = False
OnLayer('Mechanical 3') = 'False'
的对象 返回所有对象 except objects，其 Layer property 为 Mechanical 3 层。

注意事项

• Layer 开头和结尾处的单引号字符（'）是必需的。
• 请注意，放置在 Multi-Layer 层上的对象，只有在指定该特定层时，才会被 OnLayer 查询关键字返回，即使用 OnLayer('Multi-Layer') 查询时。放置在 Multi-Layer 层上的对象，在指定其他层（这些对象的形状存在于该层）时，不会被 OnLayer 查询关键字返回。请使用 ExistsOnLayer(Layer : String) 查询来定位在指定层上具有形状的对象（包括位于 Multi-Layer 层上的对象）。

摘要

返回完全或部分位于任意房间对象（约束限制规则）所占区域内的对象，且该房间对象的 Name property 符合查询条件。

语法

TouchesRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String

在定义查询表达式时，会弹出一个按名称排序的现有房间（room）列表。

示例用法

TouchesRoom('Power')
TouchesRoom('Power') = True
TouchesRoom('Power') = 'True'
返回完全或部分位于任意 Room 所占区域内的对象，且该 Room 的 Name property 为 Power。

TouchesRoom('COUT1','COUT2')
TouchesRoom('COUT1','COUT2') = True
TouchesRoom('COUT1','COUT2') = 'True'
返回完全或部分位于任意 Rooms 所占区域内的对象，且这些 Rooms 的 Name property 为 COUT1 或 COUT2。

TouchesRoom('Monitor','Auxilary','Effects')
TouchesRoom('Monitor','Auxilary','Effects') = True
TouchesRoom('Monitor','Auxilary','Effects') = 'True'
返回完全或部分位于任意 Rooms 所占区域内的对象，且这些 Rooms 的 Name property 为 Monitor，或 Auxilary，或 Effects。

注意事项

• 每个 RoomName 字符串开头和结尾处的单引号字符（'）是必需的。

• 不会返回父级坐标、尺寸以及 Net 对象。

摘要

返回完全位于任意房间对象（约束限制规则）所占区域内的对象，且该房间对象的 Name property 符合查询条件。

对于焊盘和过孔，要被返回，其中心点必须位于指定的房间内。

语法

WithinRoom(RoomName1 : String,RoomName2 : String,...,RoomNamen : String) : Boolean/Boolean_String

在定义查询表达式时，会弹出一个按名称排序的现有房间（room）列表。

示例用法

WithinRoom('Power')
WithinRoom('Power') = True
WithinRoom('Power') = 'True'
返回完全位于任意房间所占区域内的对象，且该房间的 Name property 为 Power。

WithinRoom('COUT1','COUT2')
WithinRoom('COUT1','COUT2') = True
WithinRoom('COUT1','COUT2') = 'True'
返回完全位于任意房间所占区域内的对象，且该房间的 Name property 为 COUT1 或 COUT2。

WithinRoom('Monitor','Auxilary','Effects')
WithinRoom('Monitor','Auxilary','Effects') = True
WithinRoom('Monitor','Auxilary','Effects') = 'True'
返回完全位于任意房间所占区域内的对象，且该房间的 Name property 为 Monitor，或 Auxilary，或 Effects。

注意事项

• 每个 RoomName 字符串开头和结尾处的单引号字符（'）是必需的。
• 不会返回父级坐标、尺寸以及 Net 对象。