属性检查

Created: 五月 08, 2023 | Updated: 二月 13, 2025

在Query Helper对话框

中显示的Attribute Checks PCB 查询功能。本参考页面详细介绍了 PCB 和 PCB 库文档中 Attribute Checks 类别下可用的查询语言关键字。若需要查看某个特定查询关键字的帮助，请使用以下可折叠部分；或者在Query Helper、或Filter面板中高亮（或在其中单击）任意关键字，然后按F1即可立即跳转到其对应章节。

BigColumnCount

摘要

返回“big”焊盘列数量符合查询条件的元件对象。在此语境中，每个“big”焊盘列至少包含四个焊盘。

语法

BigColumnCount : Number

示例用法

BigColumnCount = 8
返回所有恰好具有 8 个“big”焊盘列的元件。

BigColumnCount Between 6 And 10
返回所有具有 6 到 10 个“big”焊盘列的元件对象。

BigColumnCount <= 4
返回除焊盘列数大于 4 的元件对象之外的所有对象。

注意

同时也会返回符合条件的元件对象所关联的子对象。

BigRowCount

摘要

返回“big”焊盘行数量符合查询条件的元件对象。在此语境中，每个“big”焊盘行至少包含四个焊盘。

语法

BigRowCount : Number

示例用法

BigRowCount = 8
返回所有恰好具有 8 个“big”焊盘行的元件。

BigRowCount Between 6 And 10
返回所有具有 6 到 10 个“big”焊盘行的元件对象。

BigRowCount <= 4
返回除焊盘行数大于 4 的元件对象之外的所有对象。

注意

同时也会返回符合条件的元件对象所关联的子对象。

ColumnCount

摘要

返回焊盘列数符合查询条件的元件对象。

语法

ColumnCount : Number

示例用法

ColumnCount = 8
返回所有恰好具有 8 列焊盘的元件。

ColumnCount Between 6 And 10
返回所有具有 6 到 10 列焊盘（含边界值）的元件。

ColumnCount < 4
返回所有焊盘列数大于等于 4 的对象except元件。

注意

同时也会返回符合条件的元件对象所关联的子对象。

CompCenterOfPadsX

摘要

当元件焊盘质心的 X 坐标符合查询条件时，返回元件对象。

语法

CompCenterOfPadsX : Number

无论板子的测量单位选择为何，输入的坐标始终以 mil 为单位。1 mil 等于 0.001 英寸。

示例用法

CompCenterOfPadsX = 1200
当元件焊盘质心的 X 坐标等于 1200mil 时，返回所有元件对象。

CompCenterOfPadsX >= 1500
当元件焊盘质心的 X 坐标大于或等于 1500mil 时，返回所有元件对象。

CompCenterOfPadsX Between 1000 And 1400
当元件焊盘质心的 X 坐标大于或等于 1000mil，且小于或等于 1400mil 时，返回所有元件对象。

CompCenterOfPadsX < 800
返回所有对象except元件对象除外：其焊盘质心的 X 坐标大于或等于 800mil。

注意

同时也会返回符合条件的元件对象所关联的子对象。

CompCenterOfPadsY

摘要

当元件焊盘质心的 Y 坐标符合查询条件时，返回元件对象。

语法

CompCenterOfPadsY : Number

无论板子的测量单位选择为何，输入的坐标始终以 mil 为单位。(1 mil = 0.001 inch). 1 mil equals 0.001 inch.

示例用法

CompCenterOfPadsY = 1200
当元件焊盘质心的 Y 坐标等于 1200mil 时，返回所有元件对象。

CompCenterOfPadsY >= 1500
当元件焊盘质心的 Y 坐标大于或等于 1500mil 时，返回所有元件对象。

CompCenterOfPadsY Between 1000 And 1400
当元件焊盘质心的 Y 坐标大于或等于 1000mil，且小于或等于 1400mil 时，返回所有元件对象。

CompCenterOfPadsY < 800
返回所有对象except元件对象除外：其焊盘质心的 Y 坐标大于或等于 800mil。

注意

同时也会返回符合条件的元件对象所关联的子对象。

CompCenterX

摘要

当元件所有子对象的质心 X 坐标符合查询条件时，返回元件对象。

语法

CompCenterX : Number

无论板子的测量单位选择为何，输入的坐标始终以 mil 为单位。(1 mil = 0.001 inch). 1 mil equals 0.001 inch.

示例用法

CompCenterX = 1200
当元件所有子对象的质心 X 坐标等于 1200mil 时，返回所有元件对象。

CompCenterX >= 1500
当元件所有子对象的质心 X 坐标大于或等于 1500mil 时，返回所有元件对象。

CompCenterX Between 1000 And 1400
当元件所有子对象的质心 X 坐标大于或等于 1000mil，且小于或等于 1400mil 时，返回所有元件对象。

CompCenterX < 800
返回所有对象except元件对象除外：其所有子对象的质心 X 坐标大于或等于 800mil。

注意

同时也会返回符合条件的元件对象所关联的子对象。

CompCenterY

摘要

当元件所有子对象的质心 Y 坐标符合查询条件时，返回元件对象。

语法

CompCenterY : Number

无论板子的测量单位选择为何，输入的坐标始终以 mil 为单位。(1 mil = 0.001 inch). 1 mil equals 0.001 inch.

示例用法

CompCenterY = 1200
当元件所有子对象的质心 Y 坐标等于 1200mil 时，返回所有元件对象。

CompCenterY >= 1500
当元件所有子对象的质心 Y 坐标大于或等于 1500mil 时，返回所有元件对象。

CompCenterY Between 1000 And 1400
当元件所有子对象的质心 Y 坐标大于或等于 1000mil，且小于或等于 1400mil 时，返回所有元件对象。

CompCenterY < 800
返回所有对象except元件对象除外：其所有子对象的质心 Y 坐标大于或等于 800mil。

注意

同时也会返回符合条件的元件对象所关联的子对象。

CompPinCount

摘要

返回焊盘数量符合查询条件的元件对象。

语法

CompPinCount : Number

示例用法

CompPinCount = 10
返回焊盘数量等于 10 的所有元件对象。

CompPinCount Between 20 And 30
返回焊盘数量大于或等于 20，且小于或等于 30 的所有元件对象。

CompPinCount <= 8
返回所有对象except元件对象除外：其焊盘数量大于 8。

注意

同时也会返回符合条件的元件对象所关联的子对象。

CompPinCount_Bottom

摘要

返回底层（Bottom Layer）上焊盘数量符合查询条件的元件对象。

语法

CompPinCount_Bottom : Number

示例用法

CompPinCount_Bottom = 10
返回底层（Bottom Layer）上焊盘数量等于 10 的所有元件对象。

CompPinCount_Bottom Between 20 And 30
返回底层（Bottom Layer）上焊盘数量大于或等于 20，且小于或等于 30 的所有元件对象。

CompPinCount_Bottom <= 8
返回所有对象except元件对象除外：其底层（Bottom Layer）上焊盘数量大于 8。

注意

同时也会返回符合条件的元件对象所关联的子对象。

CompPinCount_Internal

摘要

返回内部信号层上焊盘数量符合查询条件的元件对象。

语法

CompPinCount_Internal : Number

示例用法

CompPinCount_Internal = 10
返回内部信号层上焊盘数量等于 10 的所有元件对象。

CompPinCount_Internal Between 20 And 30
返回内部信号层上焊盘数量大于或等于 20，且小于或等于 30 的所有元件对象。

CompPinCount_Internal <= 8
返回所有对象except元件对象除外：其内部信号层上焊盘数量大于 8。

注意

同时也会返回符合条件的元件对象所关联的子对象。

CompPinCount_Surface

摘要

返回顶层与底层信号层上焊盘数量符合查询条件的元件对象。

语法

CompPinCount_Surface : Number

示例用法

CompPinCount_Surface = 10
返回所有在顶层与底层信号层上的焊盘数量等于 10 的元件对象。

CompPinCount_Surface Between 20 And 30
返回所有在顶层与底层信号层上的焊盘数量大于或等于 20，且小于或等于 30 的元件对象。

CompPinCount_Surface <= 8
返回所有对象 except 在顶层与底层信号层上的焊盘数量大于 8 的元件对象。

注释

同时也会返回符合条件的元件对象所关联的子对象。

CompPinCount_ThruHole

摘要

返回在多层（Multi-Layer）上的焊盘数量符合该查询的元件对象。

语法

CompPinCount_ThruHole : Number

示例用法

CompPinCount_ThruHole = 10
返回所有在多层（Multi-Layer）上的焊盘数量等于 10 的元件对象。

CompPinCount_ThruHole Between 20 And 30
返回所有在多层（Multi-Layer）上的焊盘数量大于或等于 20，且小于或等于 30 的元件对象。

CompPinCount_ThruHole <= 8
返回所有对象 except 在多层（Multi-Layer）上的焊盘数量大于 8 的元件对象。

注释

同时也会返回符合条件的元件对象所关联的子对象。

CompPinCount_Top

摘要

返回在顶层（Top Layer）上的焊盘数量符合该查询的元件对象。

语法

CompPinCount_Top : Number

示例用法

CompPinCount_Top = 10
返回所有在顶层（Top Layer）上的焊盘数量等于 10 的元件对象。

CompPinCount_Top Between 20 And 30
返回所有在顶层（Top Layer）上的焊盘数量大于或等于 20，且小于或等于 30 的元件对象。

CompPinCount_Top <= 8
返回所有对象 except 在顶层（Top Layer）上的焊盘数量大于 8 的元件对象。

注释

同时也会返回符合条件的元件对象所关联的子对象。

HasViolations

摘要

返回违规状态为 True 的对象。当检测到涉及该对象的一条或多条设计规则违规时，就会出现这种情况。

语法

HasViolations : Boolean/Boolean_String

示例用法

HasViolations HasViolations = True HasViolations = 'True'
返回当前违反已定义设计规则的所有对象。

Not HasViolations HasViolations = False HasViolations = 'False'
返回所有对象 except 当前违反已定义设计规则的对象。

摘要

返回由该查询指定的对象。

语法

Id = ObjectIdentifying_String

ObjectIdentifying_String 必须是 Query Helper 对话框中各个 PCB Object Lists 内列出的字符串之一，并且需要在前后加上单引号字符（'）。所列出的字符串取决于当前正在编辑的 PCB/PCBLIB 文档中存在的对象。将显示以下对象列表：

通道类
坐标
元件
元件类
差分对
差分对类
尺寸标注
From-To
From-To 类
层类
网络类
网络
焊盘类
焊盘
多边形类
多边形
规则
文本
违规

尽管这些对象中的每一个都列出了一个字符串，但这些字符串并不一定能标识某一个特定对象。例如，为每个设计规则对象提供的字符串由字符 'Rule0mil,0mil' 组成，因此指定该字符串将导致返回 all 个规则对象。

示例用法

Id = 'GND'
返回 Net 属性为 GND 的网络（Net）对象。

Id = 'C3-1'
返回完整 Name 属性为 C3-1 的焊盘对象。

Id = 'Text[3510mil,3800mil]'
返回点位于 3510mil,3800mil 的文本对象。

Id = 'D3'
返回 Designator 属性为 D3 的元件对象。

Id = 'Dimension[4800mil,3800mil]'
返回插入点位于 4800mil,3800mil 的尺寸标注对象。

Id = 'Coordinate[3500mil,3800mil]'
返回插入点位于 3500mil,3800mil 的坐标对象。

Id = 'My Top Side Layers'
返回 Name 属性为 My Top Side Layers 的（层）类对象。

Id = 'Rule[0mil,0mil]'
返回所有设计规则对象（因为它们都被分配了相同的标识字符串）。

Id = 'GND (ZZ4-2 : ZZ3-2)'
返回 from-to 对象，其中 Net 属性为 GND、From Pad 属性为 ZZ4-2，且 To Pad 属性为 ZZ3-2。

Id = 'Violation[0mil,0mil]'
返回所有违规对象（因为它们都被分配了相同的标识字符串）。

InAnyComponent

摘要

使用此关键字可快速返回所有元件及其子图元。

语法

InAnyComponent : Boolean/Boolean_String

示例用法

InAnyComponent InAnyComponent = True InAnyComponent = 'True'
返回所有元件对象及其关联的图元。

Not InAnyComponent InAnyComponent = False InAnyComponent = 'False'
返回所有对象 except 元件对象及其关联的图元。

InAnyDifferentialPair

摘要

使用此关键字可快速返回所有差分对对象及其关联的图元。

语法

InAnyDifferentialPair : Boolean/Boolean_String

示例用法

InAnyDifferentialPair InAnyDifferentialPair = True InAnyDifferentialPair = 'True'
返回所有差分对对象及其关联的图元。

Not InAnyDifferentialPair InAnyDifferentialPair = False InAnyDifferentialPair = 'False'
返回所有对象 except 差分对对象及其关联的图元。

InAnyNet

摘要

使用此关键字可快速返回所有网络及其关联的图元（即具有 Net 属性的设计对象）。

语法

InAnyNet : Boolean/Boolean_String

示例用法

InAnyNet InAnyNet = True InAnyNet = 'True'
返回所有网络及其关联的图元。

Not InAnyNet InAnyNet = False InAnyNet = 'False'
返回所有对象 except 网络及其关联的图元。

InAnyxSignal

摘要

使用此关键字可快速返回与该设计中定义的所有 xSignal 相关联的所有对象。

语法

InAnyxSignal : Boolean/Boolean_String

示例用法

InAnyxSignal InAnyxSignal = True InAnyxSignal = 'True'
返回与该设计中定义的所有 xSignal 相关联的所有对象。

Not InAnyxSignal InAnyxSignal = False InAnyxSignal = 'False'
返回所有对象 except 与该设计中定义的 xSignal 相关联的对象。

InBGA

摘要

返回属于 BGA 类型元件的子对象。此类元件至少包含 10 行焊盘且至少包含 10 列焊盘；焊盘行数与列数之差（绝对值）小于 6。焊盘总数至少为焊盘行数与列数乘积的一半，并且所有焊盘均为贴装（表贴）类型。

语法

InBGA : Boolean/Boolean_String

示例用法

InBGA InBGA = True InBGA = 'True'
返回 BGA 元件的所有关联子图元。

Not InBGA InBGA = False InBGA = 'False'
返回所有对象 except BGA 元件的关联子图元。

注释

此查询不会返回父元件对象。

InDIP

摘要

返回属于 DIP 类型元件的子对象。此类元件至少有一个（通常为全部）焊盘为通孔类型，且焊盘总数等于焊盘行数与列数的乘积。此类元件还满足以下之一：恰好有两行焊盘且至少有三列焊盘；或恰好有两列焊盘且至少有三行焊盘。

语法

InDIP : Boolean/Boolean_String

示例用法

InDIP InDIP = True InDIP = 'True'
返回 DIP 元件的所有关联子图元。

Not InDIP InDIP = False InDIP = 'False'
返回所有对象 except DIP 元件的关联子图元。

注释

此查询不会返回父元件对象。

InEdgeConnector

摘要

返回属于板边连接器（edge connector）类型元件的子对象。此类元件的所有焊盘均为贴装（表贴）类型，并且位于 PCB 的两侧。所有焊盘要么位于同一行，要么位于同一列；PCB 任一侧的焊盘数量小于对侧焊盘数量的三倍，且焊盘总数至少为 4。

语法

InEdgeConnector : Boolean/Boolean_String

示例用法

InEdgeConnector InEdgeConnector = True InEdgeConnector = 'True'
返回板边连接器元件的所有关联子图元。

Not InEdgeConnector InEdgeConnector = False InEdgeConnector = 'False'
返回所有对象 except 板边连接器元件的关联子图元。

注释

此查询不会返回父元件对象。

InLCC

摘要

返回属于表贴 LCC 类型元件的子对象。此类元件包含两行焊盘（每行至少 4 个焊盘）以及两列焊盘（每列至少 4 个焊盘），并且所有焊盘均为贴装（表贴）类型。

语法

InLCC : Boolean/Boolean_String

示例用法

InLCC InLCC = True InLCC = 'True'
返回 LCC 元件的所有关联子图元。

Not InLCC InLCC = False InLCC = 'False'
返回所有对象 except LCC 元件的关联子图元。

注释

此查询不会返回父元件对象。

InPGA

摘要

返回具有 PGA 特性的元件的子对象。此类元件至少包含 6 行焊盘且至少包含 6 列焊盘。焊盘行数与焊盘列数之差的（绝对值）小于 6。焊盘总数至少为焊盘行数与焊盘列数乘积的一半，并且至少有一个（通常为全部）焊盘为通孔类型。

语法

InPGA : Boolean/Boolean_String

使用示例

InPGA InPGA = True InPGA = 'True'
返回 PGA 元件的所有关联子图元。

Not InPGA InPGA = False InPGA = 'False'
返回所有对象 except PGA 元件的关联子图元。

注意

此查询不会返回父元件对象。

InPoly

摘要

使用此关键字可快速返回所有多边形覆铜及其子图元。

语法

InPoly : Boolean/Boolean_String

使用示例

InPoly InPoly = True InPoly = 'True'
返回所有多边形覆铜及其子图元。

Not InPoly InPoly = False InPoly = 'False'
返回所有对象 except 多边形覆铜及其子图元。

注释

此函数是 InPolygon 函数的别名。
仅返回放置在信号层上的多边形覆铜。

InPolygon

摘要

使用此关键字可快速返回所有多边形覆铜及其子图元。

语法

InPolygon : Boolean/Boolean_String

使用示例

InPolygon InPolygon = True InPolygon = 'True'
返回所有多边形覆铜及其子图元。

Not InPolygon InPolygon = False InPolygon = 'False'
返回所有对象 except 多边形覆铜及其子图元。

注释

此函数是 InPoly 函数的别名。
仅返回放置在信号层上的多边形覆铜。

InSIP

摘要

返回具有 SIP 特性的元件的子对象。此类元件至少包含 4 个焊盘，且其所有焊盘都位于同一行或同一列。此外，至少有一个（通常为全部）焊盘为通孔类型。

语法

InSIP : Boolean/Boolean_String

使用示例

InSIP InSIP = True InSIP = 'True'
返回 SIP 元件的所有关联子图元。

Not InSIP InSIP = False InSIP = 'False'
返回所有对象 except SIP 元件的关联子图元。

注意

此查询不会返回父元件对象。

InSMSIP

摘要

返回具有表贴 SIP 特性的元件的子对象。此类元件至少包含 4 个焊盘，且其所有焊盘都位于同一行或同一列。此外，这些焊盘全部为表贴类型。

语法

InSMSIP : Boolean/Boolean_String

使用示例

InSMSIP InSMSIP = True InSMSIP = 'True'
返回 SMSIP 元件的所有关联子图元。

Not InSMSIP InSMSIP = False InSMSIP = 'False'
返回所有对象 except SMSIP 元件的关联子图元。

注意

此查询不会返回父元件对象。

InSMTComponent

摘要

返回具有 SMT 特性的元件的子对象。此类元件的所有焊盘均为表贴类型。

语法

InSMTComponent : Boolean/Boolean_String

使用示例

InSMTComponent InSMTComponent = True InSMTComponent = 'True'
返回 SMT 元件的所有关联子图元。

Not InSMTComponent InSMTComponent = False InSMTComponent = 'False'
返回所有对象 except SMT 元件的关联子图元。

注意

此查询不会返回父元件对象。

InSOIC

摘要

返回具有表贴 DIP（SOIC）特性的元件的子对象。此类元件的所有焊盘均为表贴类型，且焊盘总数等于焊盘行数与焊盘列数的乘积。此类元件还满足以下之一：恰好有 2 行焊盘且至少有 3 列焊盘；或恰好有 2 列焊盘且至少有 3 行焊盘。

语法

InSOIC : Boolean/Boolean_String

使用示例

InSOIC InSOIC = True InSOIC = 'True'
返回 SOIC 元件的所有关联子图元。

Not InSOIC InSOIC = False InSOIC = 'False'
返回所有对象 except SOIC 元件的关联子图元。

注意

此查询不会返回父元件对象。

InThruComponent

摘要

返回具有通孔特性的元件的子对象。此类元件至少有一个（通常为全部）焊盘为通孔类型。

语法

InThruComponent : Boolean/Boolean_String

使用示例

InThruComponent InThruComponent = True InThruComponent = 'True'
返回通孔元件的所有关联子图元。

Not InThruComponent InThruComponent = False InThruComponent = 'False'
返回所有对象 except 通孔元件的关联子图元。

注意

此查询不会返回父元件对象。

IsBGA

摘要

返回具有 BGA 特性的元件。此类元件至少包含 10 行焊盘且至少包含 10 列焊盘，焊盘行数与焊盘列数之差的（绝对值）小于 6。焊盘总数至少为焊盘行数与焊盘列数乘积的一半，并且所有焊盘均为表贴类型。

语法

IsBGA : Boolean/Boolean_String

使用示例

IsBGA IsBGA = True IsBGA = 'True'
返回所有 BGA 元件。

Not IsBGA IsBGA = False IsBGA = 'False'
返回所有对象 except BGA 元件。

注意

此查询不会返回关联的子图元对象。

IsChamferedRectanglePad

摘要

返回所有焊盘形状为倒角矩形的焊盘对象。

包括 Top-Middle-Bottom 和 Full Stack 焊盘：其在至少一个层上的焊盘形状为倒角矩形。

语法

IsChamferedRectanglePad : Boolean/Boolean_String

使用示例

IsChamferedRectanglePad IsChamferedRectanglePad = True IsChamferedRectanglePad = 'True'
返回所有焊盘形状为倒角矩形的焊盘对象。

Not IsChamferedRectanglePad IsChamferedRectanglePad = False IsChamferedRectanglePad = 'False'
返回所有对象 except 焊盘形状为倒角矩形的焊盘对象。

IsChamferedRectangularPadOnLayer

摘要

返回在指定层上焊盘形状为倒角矩形的所有焊盘对象。

语法

IsChamferedRectangularPadOnLayer(Layer : String) : Boolean/Boolean_String

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

使用示例

IsChamferedRectangularPadOnLayer('Top Layer') IsChamferedRectangularPadOnLayer('Top Layer') = True IsChamferedRectangularPadOnLayer('Top Layer') = 'True'
返回在 Top Layer 上焊盘形状为倒角矩形的所有焊盘对象。

Not IsChamferedRectangularPadOnLayer('Bottom Layer') IsChamferedRectangularPadOnLayer('Bottom Layer') = False IsChamferedRectangularPadOnLayer('Bottom Layer') = 'False'
返回所有对象 except 在 Bottom Layer 上焊盘形状为倒角矩形的焊盘对象。

注意

Layer 开头和结尾处的单引号字符 (') 为必需。

IsComponentPrimitive

摘要

返回设计中与元件关联的所有子图元对象。

语法

IsComponentPrimitive : Boolean/Boolean_String

使用示例

IsComponentPrimitive IsComponentPrimitive = True IsComponentPrimitive = 'True'
返回元件对象的所有子图元。

Not IsComponentPrimitive IsComponentPrimitive = False IsComponentPrimitive = 'False'
返回所有对象 except 元件对象的子图元。

IsComponentSelected

摘要

返回设计中与当前选中元件关联的所有子图元对象。

语法

IsComponentSelected : Boolean/Boolean_String

使用示例

IsComponentSelected IsComponentSelected = True IsComponentSelected = 'True'
返回当前选中元件对象的所有子图元。

Not IsComponentSelected IsComponentSelected = False IsComponentSelected = 'False'
返回所有对象 except 当前选中元件对象的子图元。

IsCustomPadShapeOnLayer

摘要

返回在指定层上具有自定义焊盘形状的所有焊盘对象。

语法

IsCustomPadShapeOnLayer(Layer : String) : Boolean/Boolean_String

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

使用示例

IsCustomPadShapeOnLayer('Top Layer') IsCustomPadShapeOnLayer('Top Layer') = True IsCustomPadShapeOnLayer('Top Layer') = 'True'
返回在 Top Layer 上具有自定义焊盘形状的所有焊盘对象。

Not IsCustomPadShapeOnLayer('Bottom Layer') IsCustomPadShapeOnLayer('Bottom Layer') = False IsCustomPadShapeOnLayer('Bottom Layer') = 'False'
返回所有对象 except 在 Bottom Layer 上具有自定义焊盘形状的焊盘对象。

注意

Layer 开头和结尾处的单引号字符 (') 为必需。

IsCustomShapePad

摘要

返回所有具有自定义焊盘形状的焊盘对象。

包括 Top-Middle-Bottom 和 Full Stack 焊盘：其在至少一个层上的焊盘形状为自定义。

语法

IsCustomShapePad : Boolean/Boolean_String

使用示例

IsCustomShapePad IsCustomShapePad = True IsCustomShapePad = 'True'
返回所有具有自定义焊盘形状的焊盘对象。

Not IsCustomShapePad IsCustomShapePad = False IsCustomShapePad = 'False'
返回所有对象 except 具有自定义焊盘形状的焊盘对象。

IsDIP

摘要

返回具有 DIP 特性的元件。此类元件的焊盘中至少有一个（通常是全部）为通孔类型，并且焊盘总数等于焊盘行数与列数的乘积。此类元件还必须满足以下条件之一：恰好有两行焊盘且至少有三列焊盘；或者恰好有两列焊盘且至少有三行焊盘。

语法

IsDIP : Boolean/Boolean_String

示例用法

IsDIP IsDIP = True IsDIP = 'True'
返回所有 DIP 元件。

Not IsDIP IsDIP = False IsDIP = 'False'
返回所有对象 except DIP 元件。

注意

此查询不会返回关联的子图元对象。

IsEdgeConnector

摘要

返回具有板边连接器（Edge Connector）特性的元件。此类元件的所有焊盘均为表贴类型，并且位于 PCB 的两侧。所有焊盘要么都在同一行，要么都在同一列；PCB 任一侧的焊盘数量小于另一侧焊盘数量的三倍；并且焊盘总数至少为 4。

语法

IsEdgeConnector : Boolean/Boolean_String

示例用法

IsEdgeConnector IsEdgeConnector = True IsEdgeConnector = 'True'
返回所有 Edge Connector 元件。

Not IsEdgeConnector IsEdgeConnector = False IsEdgeConnector = 'False'
返回所有对象 except Edge Connector 元件。

注意

此查询不会返回关联的子图元对象。

IsElectrical

摘要

返回所有 Net 属性未设置为 No Net 的网络对象。

语法

IsElectrical : Boolean/Boolean_String

示例用法

IsElectrical IsElectrical = True IsElectrical = 'True'
返回所有 Net 属性未设置为 No Net 的网络对象。

Not IsElectrical IsElectrical = False IsElectrical = 'False'
返回所有对象 except Net 属性未设置为 No Net 的网络对象。

IsFree

摘要

返回所有自由（free）的设计对象。如果一个对象不是元件（或其关联的图元与 3D 实体），或者不是网络对象，则该对象为自由对象。此外，如果某个网络对象的 Net 属性设置为 No Net，则该网络对象也被视为自由对象。

语法

IsFree : Boolean/Boolean_String

示例用法

IsFree IsFree = True IsFree = 'True'
返回所有自由设计对象。

Not IsFree IsFree = False IsFree = 'False'
返回所有对象 except 自由设计对象。

IsGraphicalComponent

摘要

返回 Component Type 属性为 Graphical 的元件对象。这些元件不具备电气属性，不会同步（即必须在两个编辑器中手动放置），并且not包含在 BOM 中。示例：公司 Logo。

语法

IsGraphicalComponent : Boolean/Boolean_String

示例用法

IsGraphicalComponent IsGraphicalComponent = True IsGraphicalComponent = 'True'
返回所有 Component Type 属性设置为 Graphical 的元件对象。

Not IsGraphicalComponent IsGraphicalComponent = False IsGraphicalComponent = 'False'
返回所有对象 except Component Type 属性设置为 Graphical 的元件对象。

注意

此查询不会返回关联的子图元对象。

IsHorizontal

摘要

返回水平走线，即 Y1 与 Y2 属性相同的走线。

语法

IsHorizontal : Boolean/Boolean_String

示例用法

IsHorizontal IsHorizontal = True IsHorizontal = 'True'
返回所有水平走线。

Not IsHorizontal IsHorizontal = False IsHorizontal = 'False'
返回所有对象 except 水平走线。

IsJumperComponent

摘要

返回 Component Type 属性为 Jumper 的元件对象。这些元件用于在 PCB 设计中包含跳线（wire link），例如在无法在单层上完成全部布线的单面 PCB 上。对于此类元件，元件封装与引脚在原理图与 PCB 之间会同步，但网络分配不会同步，并且该元件会包含在 BOM 中。除了在元件级别选择此选项外，元件中的两个焊盘还必须将其 JumperID 设置为相同的非零值。跳线类型元件不需要在原理图上连线；只有在 BOM 需要它们时，才需要将其包含在原理图中。如果 BOM 不需要它们，则可以直接放置在 PCB 中，在那里设置 Component Type、设置 JumperIDs，并为焊盘手动分配 Nets。

语法

IsJumperComponent : Boolean/Boolean_String

示例用法

IsJumperComponent IsJumperComponent = True IsJumperComponent = 'True'
返回所有 Component Type 属性设置为 Jumper 的元件对象。

Not IsJumperComponent IsJumperComponent = False IsJumperComponent = 'False'
返回所有对象 except Component Type 属性设置为 Jumper 的元件对象。

注意

此查询不会返回关联的子图元对象。

IsKeepOut

摘要

返回所有 Keepout - Arc、Keepout - Fill、Keepout - Solid Region 以及 Keepout - Track 对象。

语法

IsKeepOut : Boolean/Boolean_String

示例用法

IsKeepOut IsKeepOut = True IsKeepOut = 'True'
返回所有 Keepout - Arc、Keepout - Fill、Keepout - Solid Region 以及 Keepout - Track 对象。

Not IsKeepOut IsKeepOut = False IsKeepOut = 'False'
返回所有对象 except Keepout - Arc、Keepout - Fill、Keepout - Solid Region 以及 Keepout - Track 对象。

IsLCC

摘要

返回表贴 LCC 类型的元件。此类元件包含两行焊盘（每行至少 4 个焊盘）以及两列焊盘（每列至少 4 个焊盘），并且所有焊盘均为表贴类型。

语法

IsLCC : Boolean/Boolean_String

示例用法

IsLCC IsLCC = True IsLCC = 'True'
返回所有 LCC 元件。

Not IsLCC IsLCC = False IsLCC = 'False'
返回所有对象 except LCC 元件。

注意

此查询不会返回关联的子图元对象。

IsLinkedToAnyPadViaLibrary

摘要

返回链接到任意 Pad Via Library（*.PvLib）的焊盘与过孔对象，即其 Library 属性引用了此类库的对象。

语法

IsLinkedToAnyPadViaLibrary : Boolean/Boolean_String

示例用法

IsLinkedToAnyPadViaLibrary IsLinkedToAnyPadViaLibrary = True IsLinkedToAnyPadViaLibrary = 'True'
返回所有链接到任意 Pad Via Library 的焊盘与过孔对象。

Not IsLinkedToAnyPadViaLibrary IsLinkedToAnyPadViaLibrary = False IsLinkedToAnyPadViaLibrary = 'False'
返回所有对象 except 链接到任意 Pad Via Library 的焊盘与过孔对象。

IsLinkedToPadViaLibrary

摘要

返回链接到查询中指定的 Pad Via Library（*.PvLib）的焊盘与过孔对象，即其 Library 属性引用了该库的对象。

语法

IsLinkedToPadViaLibrary(PadViaLibraryName : String) : Boolean/Boolean_String

示例用法

IsLinkedToPadViaLibrary('ExamplePVLib.PvLib') IsLinkedToPadViaLibrary('ExamplePVLib.PvLib') = True IsLinkedToPadViaLibrary('ExamplePVLib.PvLib') = 'True'
返回所有链接到 Pad Via Library ExamplePVLib.PvLib 的焊盘与过孔对象。

Not IsLinkedToPadViaLibrary('ExamplePVLib.PvLib') IsLinkedToPadViaLibrary('ExamplePVLib.PvLib') = False IsLinkedToPadViaLibrary('ExamplePVLib.PvLib') = 'False'
返回所有对象 except 链接到 Pad Via Library ExamplePVLib.PvLib 的焊盘与过孔对象。

注意

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

IsLinkedToPadViaTemplate

摘要

返回使用查询中指定的焊盘或过孔模板的焊盘或过孔对象，即其 Template 属性引用了该模板的对象。

语法

IsLinkedToPadViaTemplate(TemplateName : String) : Boolean/Boolean_String

示例用法

IsLinkedToPadViaTemplate('c152hn127') IsLinkedToPadViaTemplate('c152hn127') = True IsLinkedToPadViaTemplate('c152hn127') = 'True'
返回所有使用焊盘模板 c152hn127 的焊盘对象。

Not IsLinkedToPadViaTemplate('v127h71') IsLinkedToPadViaTemplate('v127h71') = False IsLinkedToPadViaTemplate('v127h71') = 'False'
返回所有对象 except 使用过孔模板 v127h71 的过孔对象。

注意

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

IsMechanicalComponent

摘要

返回 Component Type 属性为 Mechanical 的元件对象。这些元件不具备电气属性，不会同步（必须在两个编辑器中手动放置），并且会包含在 BOM 中。示例：散热片。

语法

IsMechanicalComponent : Boolean/Boolean_String

示例用法

IsMechanicalComponent IsMechanicalComponent = True IsMechanicalComponent = 'True'
返回所有 Component Type 属性设置为 Mechanical 的元件对象。

Not IsMechanicalComponent IsMechanicalComponent = False IsMechanicalComponent = 'False'
返回所有对象 except Component Type 属性设置为 Mechanical 的元件对象。

注意

此查询不会返回关联的子图元对象。

IsNetSelected

摘要

返回其 Net 属性与当前选中的 Net 对象对应的、具备网络感知的对象（弧线、填充、焊盘、多边形覆铜、实体区域、走线和过孔）。

要先选择特定网络（一个或多个），请应用查询为 IsNet 的过滤器，然后在 List 面板中选择所需的网络。

语法

IsNetSelected : Boolean/Boolean_String

示例用法

IsNetSelected IsNetSelected = True IsNetSelected = 'True'
返回其 Net 属性与当前选中的 Net 对象对应的、具备网络感知的对象（弧线、填充、焊盘、多边形覆铜、实体区域、走线和过孔）。

Not IsNetSelected IsNetSelected = False IsNetSelected = 'False'
返回所有对象 except 其 Net 属性与当前选中的 Net 对象对应的、具备网络感知的对象（弧线、填充、焊盘、多边形覆铜、实体区域、走线和过孔）。

注意

不会返回被选中的 Net 对象；也不会返回所返回的任何多边形覆铜对象的子图元。

IsNetTieComponent

摘要

返回其 Component Type 属性为 Net Tie 或 Net Tie (In BOM) 的元件对象。这些元件用于将两个或多个不同的网络短接在一起。它们始终在原理图与 PCB 之间保持同步（封装、引脚/焊盘以及网络分配都必须一致）。Net Tie (In BOM) 类型的元件会包含在 BOM 中，而 Net Tie 类型的元件不会。它们与标准元件的不同之处在于：不会检查封装内由铜皮形成的连通性——正是这些铜皮使网络能够被短接。

语法

IsNetTieComponent : Boolean/Boolean_String

使用示例

IsNetTieComponent IsNetTieComponent = True IsNetTieComponent = 'True'
返回所有 Component Type 属性设置为 Net Tie 或 Net Tie (In BOM) 的元件对象。

Not IsNetTieComponent IsNetTieComponent = False IsNetTieComponent = 'False'
返回所有对象 except 元件对象，其 Component Type 属性设置为 Net Tie 或 Net Tie (In BOM)。

注意

此查询不会返回关联的子图元对象。

IsNoBOMComponent

摘要

返回其 Component Type 属性为 Standard (No BOM) 的元件对象。这些元件具有标准电气属性，始终在原理图与 PCB 之间保持同步（封装、引脚/焊盘以及网络分配都必须一致），并且 not 包含在 BOM 中。示例：你希望从 BOM 中排除的测试点元件。

语法

IsNoBOMComponent : Boolean/Boolean_String

使用示例

IsNoBOMComponent IsNoBOMComponent = True IsNoBOMComponent = 'True'
返回所有 Component Type 属性设置为 Standard (No BOM) 的元件对象。

Not IsNoBOMComponent IsNoBOMComponent = False IsNoBOMComponent = 'False'
返回所有对象 except 元件对象，其 Component Type 属性设置为 Standard (No BOM)。

注意

此查询不会返回关联的子图元对象。

IsOblique

摘要

返回对角走线（+/- 45 度角），即其 Y1 与 Y2 属性之差的绝对值等于其 X1 与 X2 属性之差的绝对值的那些走线。

语法

IsOblique : Boolean/Boolean_String

使用示例

IsOblique IsOblique = True IsOblique = 'True'
返回所有 +/-45 度走线。

Not IsOblique IsOblique = False IsOblique = 'False'
返回所有对象 except +/-45 度走线。

IsObliqueNegative

摘要

返回 -45 度角走线，即其 Y1 与 Y2 属性之差在符号上与其 X1 与 X2 属性之差相反，但数值相等的那些走线。

语法

IsObliqueNegative : Boolean/Boolean_String

使用示例

IsObliqueNegative IsObliqueNegative = True IsObliqueNegative = 'True'
返回所有 -45 度走线。

Not IsObliqueNegative IsObliqueNegative = False IsObliqueNegative = 'False'
返回所有对象 except -45 度走线。

IsObliquePositive

摘要

返回 +45 度角走线，即其 Y1 与 Y2 属性之差等于（包括符号也相同）其 X1 与 X2 属性之差的那些走线。

语法

IsObliquePositive : Boolean/Boolean_String

使用示例

IsObliquePositive IsObliquePositive = True IsObliquePositive = 'True'
返回所有 +45 度走线。

Not IsObliquePositive IsObliquePositive = False IsObliquePositive = 'False'
返回所有对象 except +45 度走线。

IsOctagonalPad

摘要

返回所有焊盘形状为八边形的焊盘对象。

包括 Top-Middle-Bottom 和 Full Stack 焊盘：只要至少有一个层上的焊盘形状为八边形。

语法

IsOctagonalPad : Boolean/Boolean_String

使用示例

IsOctagonalPad IsOctagonalPad = True IsOctagonalPad = 'True'
返回所有焊盘形状为八边形的焊盘对象。

Not IsOctagonalPad IsOctagonalPad = False IsOctagonalPad = 'False'
返回所有对象 except 焊盘对象，其焊盘形状为八边形。

IsOctagonalPadShapeOnLayer

摘要

返回在指定层上焊盘形状为八边形的所有焊盘对象。

语法

IsOctagonalPadShapeOnLayer(Layer : String) : Boolean/Boolean_String

Layer 是该层的名称，与其在 Layers & ColorsView Configuration panel 的选项卡中显示的名称一致。

使用示例

IsOctagonalPadShapeOnLayer('Top Layer') IsOctagonalPadShapeOnLayer('Top Layer') = True IsOctagonalPadShapeOnLayer('Top Layer') = 'True'
返回在 Top Layer 上焊盘形状为八边形的所有焊盘对象。

Not IsOctagonalPadShapeOnLayer('Bottom Layer') IsOctagonalPadShapeOnLayer('Bottom Layer') = False IsOctagonalPadShapeOnLayer('Bottom Layer') = 'False'
返回所有对象 except 焊盘对象，其在 Bottom Layer 上的焊盘形状为八边形。

注意

Layer 开头和结尾处的单引号字符 (') 为必需。

IsOvalPad

摘要

返回所有焊盘形状为椭圆的焊盘对象。当 X-Size 与 Y-Size 属性设置为不相等时，椭圆焊盘形状由 Round 焊盘形状形成。

包括 Top-Middle-Bottom 和 Full Stack 焊盘：只要至少有一个层上的焊盘形状为椭圆。

语法

IsOvalPad : Boolean/Boolean_String

使用示例

IsOvalPad IsOvalPad = True IsOvalPad = 'True'
返回所有焊盘形状为椭圆的焊盘对象。

Not IsOvalPad IsOvalPad = False IsOvalPad = 'False'
返回所有对象 except 焊盘对象，其焊盘形状为椭圆。

IsOvalPadShapeOnLayer

摘要

返回在指定层上焊盘形状为椭圆的所有焊盘对象。当 X-Size 与 Y-Size 属性设置为不相等时，椭圆焊盘形状由 Round 焊盘形状形成。

语法

IsOvalPadShapeOnLayer(Layer : String) : Boolean/Boolean_String

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

使用示例

IsOvalPadShapeOnLayer('Top Layer') IsOvalPadShapeOnLayer('Top Layer') = True IsOvalPadShapeOnLayer('Top Layer') = 'True'
返回在 Top Layer 上焊盘形状为椭圆的所有焊盘对象。

Not IsOvalPadShapeOnLayer('Bottom Layer') IsOvalPadShapeOnLayer('Bottom Layer') = False IsOvalPadShapeOnLayer('Bottom Layer') = 'False'
返回所有对象 except 焊盘对象，其在 Bottom Layer 上的焊盘形状为椭圆。

注意

Layer 开头和结尾处的单引号字符 (') 为必需。

IsPGA

摘要

返回属于 PGA 类型的元件。此类元件至少包含六行焊盘且至少包含六列焊盘。焊盘行数与列数之差的（绝对值）小于 6。焊盘总数至少为焊盘行数与列数乘积的一半，并且至少有一个（通常为全部）焊盘为通孔类型。

语法

IsPGA : Boolean/Boolean_String

使用示例

IsPGA IsPGA = True IsPGA = 'True'
返回所有 PGA 元件。

Not IsPGA IsPGA = False IsPGA = 'False'
返回所有对象 except PGA 元件。

注意

此查询不会返回关联的子图元对象。

IsRectangularPad

摘要

返回所有焊盘形状为矩形的焊盘对象。

包括 Top-Middle-Bottom 和 Full Stack 焊盘：只要至少有一个层上的焊盘形状为矩形。

语法

IsRectangularPad : Boolean/Boolean_String

使用示例

IsRectangularPad IsRectangularPad = True IsRectangularPad = 'True'
返回所有焊盘形状为矩形的焊盘对象。

Not IsRectangularPad IsRectangularPad = False IsRectangularPad = 'False'
返回所有对象 except 焊盘对象，其焊盘形状为矩形。

IsRectangularPadShapeOnLayer

摘要

返回在指定层上焊盘形状为矩形的所有焊盘对象。

语法

IsRectangularPadShapeOnLayer(Layer : String) : Boolean/Boolean_String

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

使用示例

IsRectangularPadShapeOnLayer('Top Layer') IsRectangularPadShapeOnLayer('Top Layer') = True IsRectangularPadShapeOnLayer('Top Layer') = 'True'
返回在 Top Layer 上焊盘形状为矩形的所有焊盘对象。

Not IsRectangularPadShapeOnLayer('Bottom Layer') IsRectangularPadShapeOnLayer('Bottom Layer') = False IsRectangularPadShapeOnLayer('Bottom Layer') = 'False'
返回所有对象 except 焊盘对象，其在 Bottom Layer 上的焊盘形状为矩形。

注意

Layer 开头和结尾处的单引号字符 (') 为必需。

IsRoundedRectangularPad

摘要

返回所有焊盘形状为圆角矩形的焊盘对象。

包括 Top-Middle-Bottom 和 Full Stack 焊盘：只要至少有一个层上的焊盘形状为圆角矩形。

语法

IsRoundedRectangularPad : Boolean/Boolean_String

使用示例

IsRoundedRectangularPad IsRoundedRectangularPad = True IsRoundedRectangularPad = 'True'
返回所有焊盘形状为圆角矩形的焊盘对象。

Not IsRoundedRectangularPad IsRoundedRectangularPad = False IsRoundedRectangularPad = 'False'
返回所有对象 except 焊盘对象，其焊盘形状为圆角矩形。

IsRoundedRectangularPadShapeOnLayer

摘要

返回在指定层上焊盘形状为圆角矩形的所有焊盘对象。

语法

IsRoundedRectangularPadShapeOnLayer(Layer : String) : Boolean/Boolean_String

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

使用示例

IsRoundedRectangularPadShapeOnLayer('Top Layer') IsRoundedRectangularPadShapeOnLayer('Top Layer') = True IsRoundedRectangularPadShapeOnLayer('Top Layer') = 'True'
返回在 Top Layer 上焊盘形状为圆角矩形的所有焊盘对象。

Not IsRoundedRectangularPadShapeOnLayer('Bottom Layer') IsRoundedRectangularPadShapeOnLayer('Bottom Layer') = False IsRoundedRectangularPadShapeOnLayer('Bottom Layer') = 'False'
返回所有对象 except 焊盘对象，其在 Bottom Layer 上的焊盘形状为圆角矩形。

注意

Layer 开头和结尾处的单引号字符 (') 为必需。

IsRoundPad

摘要

返回所有焊盘形状为圆形的焊盘对象。

包括 Top-Middle-Bottom 和 Full Stack 焊盘：只要至少有一个层上的焊盘形状为圆形。

除了形状为 Round 之外，还必须将 X-Size 和 Y-Size 属性设置为相等，否则结果将是椭圆形焊盘。

语法

IsRoundPad : Boolean/Boolean_String

使用示例

IsRoundPad IsRoundPad = True IsRoundPad = 'True'
返回所有圆形焊盘形状的焊盘对象。

Not IsRoundPad IsRoundPad = False IsRoundPad = 'False'
返回所有对象 except 圆形焊盘形状的焊盘对象。

IsRoundPadShapeOnLayer

摘要

返回指定层上所有圆形焊盘形状的焊盘对象。

除了形状为 Round 之外，还必须将 X-Size 和 Y-Size 属性设置为相等，否则结果将是椭圆形焊盘。

语法

IsRoundPadShapeOnLayer(Layer : String) : Boolean/Boolean_String

Layer 是该层的名称，与其在 Layers & ColorsView Configuration panel 的选项卡中显示的名称一致。

使用示例

IsRoundPadShapeOnLayer('Top Layer') IsRoundPadShapeOnLayer('Top Layer') = True IsRoundPadShapeOnLayer('Top Layer') = 'True'
返回 Top Layer 上所有圆形焊盘形状的焊盘对象。

Not IsRoundPadShapeOnLayer('Bottom Layer') IsRoundPadShapeOnLayer('Bottom Layer') = False IsRoundPadShapeOnLayer('Bottom Layer') = 'False'
返回 Bottom Layer 上所有对象 except 圆形焊盘形状的焊盘对象。

注意

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

IsSelected

摘要

返回当前在设计工作区中被选中的所有对象。

语法

IsSelected : Boolean/Boolean_String

使用示例

IsSelected IsSelected = True IsSelected = 'True'
返回当前在设计工作区中被选中的所有对象。

Not IsSelected IsSelected = False IsSelected = 'False'
返回所有对象 except 当前在设计工作区中被选中的对象。

IsSIP

摘要

返回 SIP 类型的元件。此类元件至少包含四个焊盘，并且其所有焊盘位于同一行或同一列。此外，这些焊盘中至少有一个（通常是全部）为通孔类型。

语法

IsSIP : Boolean/Boolean_String

使用示例

IsSIP IsSIP = True IsSIP = 'True'
返回所有 SIP 元件。

Not IsSIP IsSIP = False IsSIP = 'False'
返回所有对象 except SIP 元件。

注意

此查询不会返回关联的子图元对象。

IsSMSIP

摘要

返回表贴 SIP 类型的元件。此类元件至少包含四个焊盘，并且其所有焊盘位于同一行或同一列。此外，这些焊盘全部为表贴类型。

语法

IsSMSIP : Boolean/Boolean_String

使用示例

IsSMSIP IsSMSIP = True IsSMSIP = 'True'
返回所有 SMSIP 元件。

Not IsSMSIP IsSMSIP = False IsSMSIP = 'False'
返回所有对象 except SMSIP 元件。

注意

此查询不会返回关联的子图元对象。

IsSMTComponent

摘要

返回 SMT 类型的元件。此类元件的所有焊盘均为表贴类型。

语法

IsSMTComponent : Boolean/Boolean_String

使用示例

IsSMTComponent IsSMTComponent = True IsSMTComponent = 'True'
返回所有 SMT 元件。

Not IsSMTComponent IsSMTComponent = False IsSMTComponent = 'False'
返回所有对象 except SMT 元件。

注意

此查询不会返回关联的子图元对象。

IsSMTPin

摘要

返回所有表贴类型的焊盘对象，即其 Hole Size 属性被设置为 0 的焊盘对象。

表贴焊盘位于信号层上，而不是 Multi-Layer 上。

语法

IsSMTPin : Boolean/Boolean_String

使用示例

IsSMTPin IsSMTPin = True IsSMTPin = 'True'
返回所有表贴焊盘。

Not IsSMTPin IsSMTPin = False IsSMTPin = 'False'
返回所有对象 except 表贴焊盘。

IsSOIC

摘要

返回表贴 DIP（SOIC）类型的元件。此类元件的所有焊盘均为表贴类型，并且焊盘总数等于焊盘行数与焊盘列数的乘积。此类元件还必须满足：要么恰好有两行焊盘且至少有三列焊盘；要么恰好有两列焊盘且至少有三行焊盘。

语法

IsSOIC : Boolean/Boolean_String

使用示例

IsSOIC IsSOIC = True IsSOIC = 'True'
返回所有 SOIC 元件。

Not IsSOIC IsSOIC = False IsSOIC = 'False'
返回所有对象 except SOIC 元件。

注意

此查询不会返回关联的子图元对象。

IsSquarePad

摘要

返回所有方形焊盘形状的焊盘对象。当 X-Size 和 Y-Size 属性被设置为相等时，会由 Rounded Rectangle 焊盘形状形成方形焊盘形状。

包含 Top-Middle-Bottom 和 Full Stack 焊盘：只要至少有一个层上的焊盘形状为方形，即会被包含。

语法

IsSquarePad : Boolean/Boolean_String

使用示例

IsSquarePad IsSquarePad = True IsSquarePad = 'True'
返回所有方形焊盘形状的焊盘对象。

Not IsSquarePad IsSquarePad = False IsSquarePad = 'False'
返回所有对象 except 方形焊盘形状的焊盘对象。

IsSquarePadShapeOnLayer

摘要

返回指定层上所有方形焊盘形状的焊盘对象。当 X-Size 和 Y-Size 属性被设置为相等时，会由 Rounded Rectangle 焊盘形状形成方形焊盘形状。

语法

IsSquarePadShapeOnLayer(Layer : String) : Boolean/Boolean_String

Layer 是该层的名称，与其在 Layers & ColorsView Configuration panel 的选项卡中显示的名称一致。

使用示例

IsSquarePadShapeOnLayer('Top Layer') IsSquarePadShapeOnLayer('Top Layer') = True IsSquarePadShapeOnLayer('Top Layer') = 'True'
返回 Top Layer 上所有方形焊盘形状的焊盘对象。

Not IsSquarePadShapeOnLayer('Bottom Layer') IsSquarePadShapeOnLayer('Bottom Layer') = False IsSquarePadShapeOnLayer('Bottom Layer') = 'False'
返回 Bottom Layer 上所有对象 except 方形焊盘形状的焊盘对象。

注意

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

IsStandardComponent

摘要

返回 Component Type 属性为 Standard 的元件对象。这些元件具有标准电气属性，在原理图与 PCB 之间始终保持同步（封装、引脚/焊盘以及网络分配都必须匹配），并且会被纳入 BOM。示例：标准电气元件，如电阻。

语法

IsStandardComponent : Boolean/Boolean_String

使用示例

IsStandardComponent IsStandardComponent = True IsStandardComponent = 'True'
返回所有 Component Type 属性设置为 Standard 的元件对象。

Not IsStandardComponent IsStandardComponent = False IsStandardComponent = 'False'
返回所有对象 except Component Type 属性设置为 Standard 的元件对象。

注意

此查询不会返回关联的子图元对象。

IsSubnetJumper

摘要

返回所有子网跳线对象。

语法

IsSubnetJumper : Boolean/Boolean_String

使用示例

IsSubnetJumper IsSubnetJumper = True IsSubnetJumper = 'True'
返回所有子网跳线对象。

Not IsSubnetJumper IsSubnetJumper = False IsSubnetJumper = 'False'
返回所有对象 except 子网跳线对象。

IsThruComponent

摘要

返回通孔类型的元件。此类元件的焊盘中至少有一个（通常是全部）为通孔类型。

语法

IsThruComponent : Boolean/Boolean_String

使用示例

IsThruComponent IsThruComponent = True IsThruComponent = 'True'
返回所有通孔元件。

Not IsThruComponent IsThruComponent = False IsThruComponent = 'False'
返回所有对象 except 通孔元件。

注意

此查询不会返回关联的子图元对象。

IsThruPin

摘要

返回所有通孔类型的焊盘对象，即其 Hole Size 属性被设置为非 0 值的焊盘对象。

通孔焊盘位于 Multi-Layer 上。

语法

IsThruPin : Boolean/Boolean_String

使用示例

IsThruPin IsThruPin = True IsThruPin = 'True'
返回所有通孔焊盘。

Not IsThruPin IsThruPin = False IsThruPin = 'False'
返回所有对象 except 通孔焊盘。

IsUserRouted

摘要

返回所有由用户手动放置的设计对象。

语法

IsUserRouted : Boolean/Boolean_String

使用示例

IsUserRouted IsUserRouted = True IsUserRouted = 'True'
返回所有由用户手动放置的设计对象。由自动布线过程放置的所有对象不会被返回。

Not IsUserRouted IsUserRouted = False IsUserRouted = 'False'
返回所有对象 except 由用户手动放置的设计对象。

IsVertical

摘要

返回垂直走线，即 X1 和 X2 属性相同的走线。

语法

IsVertical : Boolean/Boolean_String

使用示例

IsVertical IsVertical = True IsVertical = 'True'
返回所有垂直走线。

Not IsVertical IsVertical = False IsVertical = 'False'
返回所有对象 except 垂直走线。

IsWire

摘要

返回信号层和 Multi-Layer 上的所有圆弧与走线对象。

语法

IsWire : Boolean/Boolean_String

使用示例

IsWire IsWire = True IsWire = 'True'
返回信号层和 Multi-Layer 上的所有圆弧与走线对象。

Not IsWire IsWire = False IsWire = 'False'
返回所有对象 except 信号层和 Multi-Layer 上的圆弧与走线对象。

ManHat

摘要

返回其曼哈顿长度符合查询条件的走线。走线的曼哈顿长度通过将其 X1 与 X2 属性差值的绝对值，加上其 Y1 与 Y2 属性差值的绝对值来确定。该术语源自纽约市的曼哈顿岛，那里的街道以矩形网格方式布局。

语法

ManHat : Number

输入的长度始终以 mil 为单位，与为电路板选择的测量单位无关 (1 mil = 0.001 inch)。

示例用法

ManHat = 300
返回所有曼哈顿长度等于 300mil 的走线。

ManHat >= 500
返回所有曼哈顿长度大于或等于 500mil 的走线。

ManHat > 400
返回所有曼哈顿长度大于 400mil 的走线。

ManHat Between 30 And 40
返回所有曼哈顿长度大于或等于 30mil 且小于或等于 40mil 的走线。

ManHat <> 500
返回所有曼哈顿长度 not 等于 500mil 的走线。

NetLength

摘要

返回网络对象，其中这些网络内弧线与走线的总长度符合查询条件。

每条走线的长度为其端点之间的（勾股）距离，等于 SQRT(SQR(X1 - X2) + SQR(Y1 - Y2))，其中 X1、Y1 是走线一端的坐标，X2、Y2 是走线另一端的坐标。每条弧线的长度为其 Radius 与 End Angle 和 Start Angle 之差的乘积当该差值以弧度为单位测量时 (180 degrees = pi radians)。

语法

NetLength : Number

输入的长度始终以 mil 为单位，与为电路板选择的测量单位无关 (1 mil = 0.001 inch)。

示例用法

NetLength = 30000
返回所有网络对象，其中这些网络内弧线与走线的总长度等于 30000mil。

NetLength >= 15000
返回所有网络对象，其中这些网络内弧线与走线的总长度大于或等于 15000mil。

NetLength <> 5500
返回所有网络对象，其中这些网络内弧线与走线的总长度 not 等于 5500mil。

注释

也会返回符合条件的网络对象所关联的子对象。

NetPinCount

摘要

返回网络对象，其中网络内焊盘的总数量符合查询条件。

语法

NetPinCount : Number

示例用法

NetPinCount Between 12 And 30
返回所有网络对象，其中这些网络内焊盘总数大于或等于 12 且小于或等于 30。

NetPinCount > 10
返回所有网络对象，其中这些网络内焊盘总数大于 10。

注释

也会返回符合条件的网络对象所关联的子对象。

NetViaCount

摘要

返回网络对象，其中这些网络内过孔的总数量符合查询条件。

语法

NetViaCount : Number

示例用法

NetViaCount Between 8 And 20
返回所有网络对象，其中这些网络内过孔总数大于或等于 8 且小于或等于 20。

NetViaCount < 6
返回所有网络对象，其中这些网络内过孔总数小于 6。

注释

也会返回符合条件的网络对象所关联的子对象。

RowCount

摘要

返回元件对象，其中焊盘的行数符合查询条件。

语法

RowCount : Number

示例用法

RowCount = 8
返回所有焊盘行数恰好为 8 的元件。

RowCount Between 6 And 10
返回所有焊盘行数在 6 到 10 之间（含边界）的元件。

RowCount < 4
返回所有对象 except 焊盘行数大于或等于 4 的元件。

注释

也会返回符合条件的元件对象所关联的子对象。

TraceCopperHeight

摘要

返回信号层上所有弧线、填充和走线对象，其中铜厚度符合查询条件。

信号层的铜厚度在 Layer Stack Manager（Design » Layer Stack Manager）中定义。

不会返回 Multi-Layer 上的弧线、填充和走线对象。由于不同信号层可能具有不同的铜厚度属性，因此 Multi-Layer 的铜厚度属性并不总是有意义。

语法

TraceCopperHeight : Number

输入的厚度始终以 mil 为单位，与为电路板选择的测量单位无关 (1 mil = 0.001 inch)。

示例用法

TraceCopperHeight = 1.4
返回信号层上所有铜厚度等于 1.4mil 的弧线、填充和走线对象。

TraceCopperHeight Between 1.1 And 1.5
返回信号层上所有铜厚度大于或等于 1.1mil 且小于或等于 1.5mil 的弧线、填充和走线对象。

TraceCopperHeight >= 1.2
返回信号层上所有铜厚度大于或等于 1.2mil 的弧线、填充和走线对象。

TraceCopperHeight < 1.3
返回所有对象 except 信号层上所有铜厚度大于或等于 1.3mil 的弧线、填充和走线对象。

TraceCopperHeight = 2.8 || (IsArc Or IsFill Or IsTrack && OnMultiLayer)
返回信号层上所有铜厚度等于 2.8mil 的弧线、填充和走线对象，以及 Multi-Layer 上所有弧线、填充和走线对象。

注释

此函数是 TraceHeight 函数的别名。

TraceHeight

摘要

返回信号层上所有弧线、填充和走线对象，其中铜厚度符合查询条件。

信号层的铜厚度在 Layer Stack Manager（Design » Layer Stack Manager）中定义。

不会返回 Multi-Layer 上的弧线、填充和走线对象。由于不同信号层可能具有不同的铜厚度属性，因此 Multi-Layer 的铜厚度属性并不总是有意义。

语法

TraceHeight : Number

输入的厚度始终以 mil 为单位与为电路板选择的测量单位无关 (1 mil = 0.001 inch)。

示例用法

TraceHeight = 1.4
返回信号层上所有铜厚度等于 1.4mil 的弧线、填充和走线对象。

TraceHeight Between 1.1 And 1.5
返回信号层上所有铜厚度大于或等于 1.1mil 且小于或等于 1.5mil 的弧线、填充和走线对象。

TraceHeight >= 1.2
返回信号层上所有铜厚度大于或等于 1.2mil 的弧线、填充和走线对象。

TraceHeight < 1.3
返回所有对象 except 信号层上所有铜厚度大于或等于 1.3mil 的弧线、填充和走线对象。

TraceHeight = 2.8 || (IsArc Or IsFill Or IsTrack && OnMultiLayer)
返回信号层上所有铜厚度等于 2.8mil 的弧线、填充和走线对象，以及 Multi-Layer 上所有弧线、填充和走线对象。

注释

此函数是 TraceCopperHeight 函数的别名。

TraceLength

摘要

返回信号层上长度符合查询条件的弧线和走线对象。

每条走线的长度为其端点之间的（勾股）距离，等于 SQRT(SQR(X1 - X2) + SQR(Y1 - Y2))，其中 X1, Y1 是走线一端的坐标，X2, Y2 是走线另一端的坐标。每条弧线的长度为其 Radius 与 End Angle 和 Start Angle 之差的乘积当该差值以弧度为单位测量时。（180 degrees = pi radians。）

语法

TraceLength : Number

输入的长度始终以 mil 为单位，与为电路板选择的测量单位无关 (1 mil = 0.001 inch)。要使用公制测量来定位对象，请使用 AsMM 查询关键字，例如， AsMM(Width) < 1.5 或 AsMM(Width) Between 1 And 1.2。了解更多关于 AsMM。

示例用法

TraceLength Between 400 And 1800
返回长度在 400mil 到 1800mil 之间（含边界）的所有弧线和走线对象。

TraceLength > 300
返回长度大于 300mil 的所有弧线和走线对象。

IsTrack AND OnTopLayer AND (AsMM(TraceLength) < 1)
返回位于 Top Layer 且长度小于 1mm 的所有走线对象。

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

适合打印版本

AI 翻译

如您发现任何问题，请选中相关文本/图片，并按 Ctrl + Enter 键向我们提交反馈。

功能可用性

您可使用的功能取决于您所选择的 Altium 解决方案 —— Altium Develop、Altium Agile（Agile Teams 或 Agile Enterprise 版本），或仍在有效订阅期内的 Altium Designer。

如果您在软件中未找到文中提及的功能，请联系 Altium 销售团队了解更多信息。

旧版文档

Altium Designer 文档不再提供版本区分。如果您需要访问 Altium Designer 旧版本的文档，请前往其他安装程序页面的旧版文档部分。