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

一旦将 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。这将让你访问 Select Columns dialog， 在其中你可以启用显示该表中的任意附加字段。

摘要

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

语法

Comment : String

示例用法

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

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

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

注意事项

• 请确保使用 File Libraries Search dialog 中的 Search in 字段，将搜索范围设置为 Components 。

• 在搜索元件时，将会查询所有可用的 SchLib 与 IntLib 库，或位于已定义搜索路径上的库。

• 所有结果都会列在 Components panel 中的 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 的元件。

注意事项

• 请确保使用 File Libraries Search dialog 中的 Search in 字段，将搜索范围设置为 Components 。

• 在搜索元件时，将会查询所有可用的 SchLib 与 IntLib 库，或位于已定义搜索路径上的库。

• 所有结果都会列在返回的 Components panel 中的 Query Results 列表里。

• ComponentType_String 开头与结尾处的单引号字符 (') 为必需。

摘要

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

语法

Designator : String

示例用法

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

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

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

注意事项

• 请确保使用 File Libraries Search dialog 中的 Search in 字段，将搜索范围设置为 Components 。

• 在搜索元件时，将会查询所有可用的 SchLib 与 IntLib 库，或位于已定义搜索路径上的库。

• 所有结果都会列在 Components panel 中的 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 参数用于指定包含该链接模型是否必须是每个元件的当前模型（Current Model）。当其为 False 时，链接模型不必是当前模型（但也可以是）；当其为 True 时，链接模型必须是当前模型。

示例用法

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

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

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

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

注意事项

• 请确保使用 File Libraries Search dialog 中的 Search in 字段，将搜索范围设置为 Components 。

• 在搜索元件时，将会查询所有可用的 SchLib 与 IntLib 库，或位于已定义搜索路径上的库。

• 所有结果都会列在 Components panel 中的 Query Results 列表里。

摘要

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

语法

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

CurrentModelOnly 参数用于指定该链接模型（其包含符合条件的参数）是否必须是每个元件的当前模型（Current Model）。当其为 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。该模型必须是该元件的当前模型。

注意事项

• 请确保使用 File Libraries Search dialog 中的 Search in 字段，将搜索范围设置为 Components 。

• 在搜索元件时，将会查询所有可用的 SchLib 与 IntLib 库，或位于已定义搜索路径上的库。

• 所有结果都会列在 Components panel 中的 Query Results 列表里。

摘要

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

语法

LibReference : String

示例用法

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

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

注意事项

• 请确保使用 File Libraries Search dialog 中的 Search in 字段，将搜索范围设置为 Components 。

• 在搜索元件时，将会查询所有可用的 SchLib 与 IntLib 库，或位于已定义搜索路径上的库。

• 所有结果都会列在 Components panel 中的 Query Results 列表里。

摘要

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

语法

PartCount : Number

示例用法

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

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

注意事项

• 请确保使用 File Libraries Search dialog 中的 Search in 字段，将搜索范围设置为 Components 。

• 在搜索元件时，将会查询所有可用的 SchLib 与 IntLib 库，或位于已定义搜索路径上的库。

• 所有结果都会列在 Query Results 列表中，该列表位于 Components panel。

摘要

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

语法

PinCount : Number

示例用法

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

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

注意事项

• 请确保在 File Libraries Search dialog 中使用 Search in 字段将搜索范围设置为 Components 。

• 搜索元件时，将查询所有 SchLib 和 IntLib 库——可用的，或位于已定义的搜索路径上的库。

• 所有结果都会列在 Query Results 列表中，该列表位于 Components panel。

摘要

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

语法

Description : String

示例用法

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

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

注意事项

• 返回的实体（元件或封装）取决于所选范围，该范围在 File Libraries Search dialog 中通过 Search in 字段定义。

• 所有结果都会列在 Query Results 列表中，该列表位于 Components panel。

摘要

返回所有包含参数对象的元件，且该参数对象的 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。

注意事项

• 返回的实体（元件或封装）取决于所选范围，该范围在 File Libraries Search dialog 中通过 Search in 字段定义。

• 所有结果都会列在 Query Results 列表中，该列表位于 Components panel。

摘要

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

语法

LibraryName : String

示例用法

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

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

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

注意事项

• 返回的实体（元件或封装）取决于所选范围，该范围在 File Libraries Search dialog 中通过 Search in 字段定义。

• 搜索元件时，将查询所有 SchLib、IntLib 和 DbLib 库——可用的或位于已定义搜索路径上的库。搜索封装时，将查询所有 PcbLib 和 IntLib 库。

• 所有结果都会列在 Query Results 列表中，该列表位于 Components panel。

摘要

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

语法

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 文件夹中。

注意事项

• 返回的实体（元件或封装）取决于所选范围，该范围在 File Libraries Search dialog 中通过 Search in 字段定义。

• 搜索元件时，将查询沿已定义库路径可用的所有 SchLib、IntLib 和 DbLib 库。搜索封装时，将查询所有 PcbLib 和 IntLib 库。

• 所有结果都会列在 Query Results 列表中，该列表位于 Components panel。

摘要

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

语法

Name : String

示例用法

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

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

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

注意事项

• 返回的实体（元件或封装）取决于所选范围，该范围在 File Libraries Search dialog 中通过 Search in 字段定义。

• 搜索元件时，将查询所有 SchLib 和 IntLib 库——可用的，或位于已定义的搜索路径上的库。搜索封装时，将查询所有 PcbLib 和 IntLib 库。

• 所有结果都会列在 Query Results 列表中，并返回到 Components panel。

• 原理图元件的名称会与其 Design Item ID  属性进行比对，而 PCB 封装 的名称会与其 Footprint 属性进行比对。

摘要

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

语法

SourceLibraryName : String

示例用法

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

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

注意事项

• 返回的实体（元件或封装）取决于所选范围，该范围在 File Libraries Search dialog 中通过 Search in 字段定义。

• 搜索元件时，只会查询源原理图库——可用的，或位于已定义的搜索路径上的库。搜索封装时，只会查询 PCB 库。

• 所有结果都会列在 Query Results 列表中，该列表位于 Components panel。

摘要

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

语法

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 文件夹中的元件或封装。

注意事项

• 返回的实体（元件或封装）取决于所选范围，该范围在 File Libraries Search dialog 中通过 Search in 字段定义。

• 搜索元件时，只会查询沿已定义库路径可用的原理图库。搜索封装时，只会查询 PCB 库。

• 所有结果都会列在 Query Results 列表中，该列表位于 Components panel。

摘要

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

语法

Height : Number

Number将遵循当前库所使用的测量单位——英制（mil；1mil = 0.001inch）或公制（mm；1mm = 0.001meter）。

示例用法

Height = 300
返回所有其 Height 属性等于 300（当前测量单位）的封装。

Height >= 5.08
返回所有其 Height 属性大于或等于 5.08（当前测量单位）的封装。

Height <> 550
返回所有其 Height 属性 not 等于 550（当前测量单位） 的封装。

注意事项

• 请确保在 File Libraries Search dialog 中使用 Search in 字段将搜索范围设置为 Components 。

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

• 所有结果都会列在 Query Results 列表中，该列表位于 Components panel。

摘要

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

语法

PadCount : Number

示例用法

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

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

注意事项

• 确保在 File Libraries Search dialog 中使用 Search in 字段将搜索范围设置为 Components 。

• 在搜索封装（footprint）时，将会查询所有可用的 PcbLib 和 IntLib 库，或位于已定义搜索路径中的库。

• 所有结果都会列在 Components panel 中的 Query Results 列表 里。