在基于文件的库和数据库元件库中进行元件搜索

将 DbLib/SVNDbLib 添加到可用的基于文件的库列表后，即可在 Components 面板中浏览数据库中的元件。虽然只添加了一个 DbLib/SVNDbLib 文件，但链接数据库中的每个表都会显示为一个独立的库。

面板顶部的下拉列表中将填充以下形式的条目 ：

• <LibraryName>.DbLib - <TableName> 或 <LibraryName>.SVNDbLib - <TableName> ----其中，数据库包含多个表
• <LibraryName>.DbLib - <SheetName>$ 或 <LibraryName>.SVNDbLib - <SheetName>$ ----其中，数据库由 Excel 电子表格中的工作表组成。

已加载的 DbLib 示例：一个包含三个表，另一个包含一个表，以及一个包含一个表的 SVNDbLib。

面板中的每个元器件条目都对应数据库中特定表内的一条记录。实际上，在浏览已加载的数据库库时，Components 面板就像一个直接访问数据库的浏览器。符号和模型信息来自数据库相关字段所指向的底层符号库和模型库（同时结合已定义的搜索路径/位置）。

浏览通过数据库库链接的外部数据库中的元器件。

默认情况下，面板的元器件列表区域仅显示 Part Number 和 Library Ref 字段。要显示数据库表中的其他字段，请右键单击该区域，然后从上下文菜单中选择 Select Columns。这将打开 选择列对话框， 您可以在其中启用该表中任意其他字段的显示。

概述

返回所有 Comment 符合查询条件的元件。

语法

Comment : String

用法示例

Comment = 'Res1'
返回所有 Comment 为 Res1 的元件。

Comment = '100nF'
返回所有 Comment 为 100nF 的元件。

Comment Like '*33*'
返回所有 Comment 包含 33 的元件。

注意事项

• 请确保使用 文件库搜索对话框中的 Search in 字段，将搜索范围设置为 Components。

• 搜索元件时，将检索所有可用的或位于所定义搜索路径下的 SchLib 和 IntLib 库。

• 所有结果均列在 元件面板的 Query Results 列表中。

概述

返回所有 Component Type 属性符合查询条件的元件。

语法

ComponentType = ComponentType_String

ComponentType_String 必须是以下列表中的一个字符串：

• 'Graphical'
• 'Jumper'
• 'Mechanical'
• 'Net Tie'
• 'Net Tie (In BOM)'
• 'Standard'
• 'Standard (No BOM)'

用法示例

ComponentType = 'Graphical'
返回 Component Type 为 Graphical 的所有元件。

ComponentType = 'Standard'
返回 Component Type 为 Standard 的所有元件。

注意事项

• 请确保使用文件库搜索对话框中的 Search in 字段，将搜索范围设置为 Components 。

• 搜索元件时，将检索所有可用的或位于指定搜索路径中的 SchLib 和 IntLib 库。

• 所有结果均列在 Components 面板中的 Query Results 列表中。

• ComponentType_String 开头和结尾的单引号 (') 不可省略。

概述

返回 Designator 属性符合查询条件的所有元件。

语法

Designator : String

使用示例

Designator = 'U2'
返回 Designator 属性为 U2 的所有元件。

Designator Like '*Channel*'
返回 Designator 属性包含 Channel 的所有元件。

Designator <> 'C*'
返回所有元件，except 其中 Designator 属性以 C 开头的元件。

注意事项

• 请确保使用文件库搜索对话框中的 Search in 字段，将搜索范围设置为 Components 。

• 搜索元件时，将检索所有可用的或位于指定搜索路径中的 SchLib 和 IntLib 库。

• 所有结果均列在 Components 面板中的 Query Results 列表中 。

概述

返回链接到（或引用）属性符合查询条件的域模型的每个元件。

语法

HasModel(ModelType : String,ModelName : String,CurrentModelOnly : Boolean) : Boolean/Boolean_String

ModelType 字符串指定所链接模型的 Type 属性，且必须是以下列表中的某个字符串：

• 'PCB3DLIB' - 使用此字符串定位 Type 属性为 PCB3D 的链接模型。
• 'PCBLIB' - 使用此字符串定位 Type 属性为 Footprint 的链接模型。
• 'IBIS' - 使用此字符串定位 Type 属性为 Ibis Model 的链接模型。
• 'SI' - 使用此字符串定位 Type 属性为 Signal Integrity 的链接模型。
• 'SIM' - 使用此字符串定位 Type 属性为 Simulation 的链接模型。

ModelName 字符串指定所链接模型的 Name 属性。

CurrentModelOnly 参数指定所链接的模型是否必须是每个元件的当前模型。当此参数为 False 时，所链接的模型不必是当前模型（但也可以是）；当此参数为 True 时，所链接的模型必须是当前模型。

使用示例

HasModel('PCBLIB','SOIC14',False)
HasModel('PCBLIB','SOIC14',False) = True
HasModel('PCBLIB','SOIC14',False) = 'True'
返回链接到 Name 属性为 SOIC14 的封装模型的所有元件；该模型不必是每个元件的当前封装模型（但也可以是）。

HasModel('PCBLIB','DIP14',True)
HasModel('PCBLIB','DIP14',True) = True
HasModel('PCBLIB','DIP14',True) = 'True'
返回链接到 Name 属性为 DIP14 的封装模型的所有元件；该模型必须是该元件的当前封装模型。

HasModel('SI','RES1',False)
HasModel('SI','RES1',False) = True
HasModel('SI','RES1',False) = 'True'
返回链接到 Name 属性为 RES1 的信号完整性模型的所有元件；该模型不必是每个元件的当前信号完整性模型（但也可以是）。

HasModel('SIM','RESISTOR',True)
HasModel('SIM','RESISTOR',True) = True
HasModel('SIM','RESISTOR',True) = 'True'
返回链接到 Name 属性为 RESISTOR 的仿真模型的所有元件；该模型必须是该元件的当前仿真模型。

注意事项

• 请确保使用文件库搜索对话框中的 Search in 字段，将搜索范围设置为 Components 。

• 搜索元件时，将检索所有可用的或位于指定搜索路径中的 SchLib 和 IntLib 库。

• 所有结果均列在 Components 面板中的 Query Results 列表中 。

概述

返回链接到（或引用）某个域模型的每个元件，该域模型包含一个 Parameter Name 和 Value 属性符合查询条件的参数对象。

语法

HasModelParameter(Parameter Name : String,Value : String,CurrentModelOnly : Boolean) : Boolean/Boolean_String

CurrentModelOnly 参数指定所链接的模型（包含符合条件的参数）是否必须是每个元件的当前模型。当此参数为 False 时，所链接的模型不必是当前模型（但也可以是）；当此参数为 True 时，所链接的模型必须是当前模型。

使用示例

HasModelParameter('Inductance A','1mH',False)
HasModelParameter('Inductance A','1mH',False) = True
HasModelParameter('Inductance A','1mH',False) = 'True'
返回链接到某个模型的所有元件，该模型包含一个 Parameter Name 属性为 Inductance A 且 Value 属性为 1mH 的参数对象。该模型不必是每个元件的当前模型（但也可以是）。

HasModelParameter('Coupling Factor','0.999',True)
HasModelParameter('Coupling Factor','0.999',True) = True
HasModelParameter('Coupling Factor','0.999',True) = 'True'
返回链接到某个模型的所有元件，该模型包含一个 Parameter Name 属性为 Coupling Factor 且 Value 属性为 0.999 的参数对象。该模型必须是该元件的当前模型。

注意事项

• 请确保使用文件库搜索对话框中的 Search in 字段，将搜索范围设置为 Components 。

• 搜索元件时，将检索所有可用的或位于指定搜索路径中的 SchLib 和 IntLib 库。

• 所有结果均列在 Components 面板中的 Query Results 列表中 。

概述

返回 Library Reference 属性符合查询条件的所有元件。

语法

LibReference : String

使用示例

LibReference = 'LM833'
返回 Library Reference 属性为 LM833 的所有元件。

LibReference Like 'C*'
返回 Library Reference 属性以 C 开头的所有元件。

注意事项

• 请确保使用文件库搜索对话框中的 Search in 字段，将搜索范围设置为 Components 。

• 搜索元件时，将检索所有可用的或位于指定搜索路径中的 SchLib 和 IntLib 库。

• 所有结果均列在 Components 面板中的 Query Results 列表中 。

概述

返回 Part Count 属性符合查询条件的所有元件。

语法

PartCount : Number

用法示例

PartCount = 2
返回 Part Count 为 2 的所有元件。

PartCount > 4
返回 Part Count 大于 4 的所有元件（即包含四个以上子部件的所有多部件元件）。

注意事项

• 请使用文件库搜索对话框中的 Search in 字段，将搜索范围设置为 Components 。

• 搜索元件时，将检索所有可用的或位于指定搜索路径下的 SchLib 和 IntLib 库。

• 所有结果均显示在元件面板的 Query Results 列表中 。

概述

返回 Pin Count 属性符合查询条件的所有元件。

语法

PinCount : Number

用法示例

PinCount = 2
返回 Pin Count 为 2 的所有元件。

PinCount > 14
返回 Pin Count 大于 14 的所有元件。

注意事项

• 请使用文件库搜索对话框中的 Search in 字段，将搜索范围设置为 Components 。

• 搜索元件时，将检索所有可用的或位于指定搜索路径下的 SchLib 和 IntLib 库。

• 所有结果均显示在元件面板的 Query Results 列表中。

概述

返回 Description 属性符合查询条件的所有元件或封装。

语法

Description : String

用法示例

Description = 'TTL-RS232 DRIVER'
返回 Description 属性为 TTL-RS232 DRIVER 的所有元件或封装。

Description Like '*RS485*'
返回 Description 属性包含 RS485 的所有元件或封装。

注意事项

• 返回的对象是元件还是封装，取决于所选的范围 ，该范围通过文件库搜索对话框中的 Search in 字段定义。

• 所有结果均显示在元件面板的 Query Results 列表中 。

概述

返回包含参数对象且该对象的 Parameter Name 和 Value 属性符合查询条件的所有元件。

语法

HasParameter(Parameter Name : String,Value : String) : Boolean/Boolean_String

用法示例

HasParameter('Comment','1K')
HasParameter('Comment','1K') = True
HasParameter('Comment','1K') = 'True'
返回包含参数对象且该对象的 Parameter Name 属性为 Comment、Value 属性为 1K 的所有元件。

注意事项

• 返回的对象是元件还是封装，取决于所选的范围 ，该范围通过文件库搜索对话框中的 Search in 字段定义。

• 所有结果均显示在元件面板的 Query Results 列表中 。

概述

返回所属库的名称符合查询条件的所有元件或封装。

语法

LibraryName : String

用法示例

LibraryName = 'Miscellaneous Devices.SchLib'
返回所属库为 Miscellaneous Devices.SchLib 的所有元件。

LibraryName Like 'Miscellaneous*.IntLib'
返回所属库的名称以 Miscellaneous 开头且以 .IntLib 结尾的所有元件或封装。

LibraryName Like '*Vishay*'
返回所属库的名称包含 Vishay 的所有元件。

注意事项

• 返回的对象是元件还是封装，取决于所选的范围 ，该范围通过文件库搜索对话框中的 Search in 字段定义。

• 搜索元件时，将检索所有可用的 或位于指定搜索路径下的 SchLib、IntLib 和 DbLib 库。搜索封装时，将检索所有 PcbLib 和 IntLib 库。

• 所有结果均显示在元件面板的 Query Results 列表中 。

概述

返回查询中指定的库内的所有元件或封装。

语法

LibraryPath : String

用法示例

LibraryPath = 'C:\Documents\Altium\Library\MyExampleLibrary.SchLib'
返回所属库为 MyExampleLibrary.SchLib 且该库位于  C:\Documents\Altium\Library 文件夹中的所有元件。

LibraryPath Like ' C:\Documents\Altium\Library\Miscellaneous*.IntLib'
返回所属库的名称以 Miscellaneous 开头且以 .IntLib 结尾，并且该库位于  C:\Documents\Altium\Library 文件夹中的所有元件或封装。

LibraryPath = 'C:\Test Projects\Example DBLib\VishayCapacitor.DBLib'
返回所属库为 VishayCapacitor.DBLib 且该库位于  C:\Test Projects\Example DBLib 文件夹中的所有元件。

注意事项

• 返回的对象是元件还是封装，取决于所选的范围 ，该范围通过文件库搜索对话框中的 Search in 字段定义。

• 搜索元件时，将检索指定库路径下所有可用的 SchLib、IntLib 和 DbLib 库。搜索封装时，将检索所有 PcbLib 和 IntLib 库。

• 所有结果均显示在元件面板的 Query Results 列表中 。

概述

返回名称符合查询条件的所有元件或封装。

语法

Name : String

用法示例

Name = 'Res1'
返回名称为 Res1 的所有元件或封装。

Name Like 'DIP*'
返回名称以 DIP 开头的所有元件或封装。

Name Like '*33*'
返回名称包含 33 的所有元件或封装。

注意事项

• 返回的对象是元件还是封装，取决于所选的范围 ，该范围通过文件库搜索对话框中的 Search in 字段定义。

• 搜索元件时，将检索所有可用的或位于指定搜索路径下的 SchLib 和 IntLib 库。搜索封装时，将检索所有 PcbLib 和 IntLib 库。

• 所有结果均显示在元件面板的 Query Results 列表中。

• 原理图元件的名称根据其 Design Item ID 属性进行检查，而 PCB 封装的名称根据其 Footprint 属性进行检查。

概述

返回所属源库的名称符合查询条件的所有元件或封装。

语法

SourceLibraryName : String

用法示例

SourceLibraryName = 'Miscellaneous Devices.SchLib'
返回所属源库为 Miscellaneous Devices.SchLib 的所有元件。

SourceLibraryName = 'Miscellaneous Devices.PcbLib '
返回父源库为 Miscellaneous Devices.PcbLib 的所有封装。

注意事项

• 返回的实体（元件或封装）取决于所选的搜索范围，该范围通过文件库搜索对话框中的 Search in 字段定义。

• 搜索元件时，仅查询可用的或位于指定搜索路径下的原理图源库。搜索封装时，仅查询 PCB 库。

• 所有结果均列在元件面板的 Query Results 列表中。

概述

返回查询中指定的源库内的所有元件或封装。

语法

SourceLibraryPath : String

使用示例

SourceLibraryPath = ' C:\Documents\Altium\Library\MyExampleLibrary.SchLib'
返回父源库为 MyExampleLibrary.SchLib 且该库位于 C:\Documents\Altium\Library 文件夹中的所有元件。

SourceLibraryPath = ' C:\Documents\Altium\Library\Miscellaneous Devices.PcbLib'
返回父源库为 Miscellaneous Devices.PcbLib 且该库位于 C:\Documents\Altium\Library 文件夹中的所有封装。

SourceLibraryPath Like ' C:\Documents\Altium\Library\*'
返回父源库位于 C:\Documents\Altium\Library 文件夹中的所有元件或封装。

注意事项

• 返回的实体（元件或封装）取决于所选的搜索范围，该范围通过文件库搜索对话框中的 Search in 字段定义。

• 搜索元件时，仅查询指定库路径下可用的原理图库。搜索封装时，仅查询 PCB 库。

• 所有结果均列在元件面板的 Query Results 列表中。

概述

返回 Height 属性符合查询条件的所有封装。

语法

Height : Number

Number将遵循库当前使用的计量单位，即英制（mil；1mil = 0.001 英寸）或公制（mm；1mm = 0.001 米）。

使用示例

Height = 300
返回 Height 属性等于 300 个当前计量单位的所有封装。

Height >= 5.08
返回 Height 属性大于或等于 5.08 个当前计量单位的所有封装。

Height <> 550
返回 Height 属性not 等于 550 个当前计量单位的所有封装。

注意事项

• 请确保通过文件库搜索对话框中的 Search in 字段将搜索范围设置为 Components。

• 搜索封装时，将查询所有可用的或位于指定搜索路径下的 PcbLib 和 IntLib 库。

• 所有结果均列在元件面板的 Query Results 列表中。

概述

返回 Pad Count 属性符合查询条件的所有封装。

语法

PadCount : Number

使用示例

PadCount = 2
返回 Pad Count 为 2 的所有封装。

PadCount > 14
返回 Pad Count 大于 14 的所有封装。

注意事项

• 请确保通过文件库搜索对话框中的 Search in 字段将搜索范围设置为 Components。

• 搜索封装时，将查询所有可用的或位于指定搜索路径下的 PcbLib 和 IntLib 库。

• 所有结果均列在元件面板的 Query Results 列表中。