HasFootprint

This document is no longer available beyond version 4. Information can now be found here: HasFootprint for version 5

Applies to NEXUS Client version: 4

This documentation page references Altium NEXUS/NEXUS Client (part of the deployed NEXUS solution), which has been discontinued. All your PCB design, data management and collaboration needs can now be delivered by Altium Designer and a connected Altium 365 Workspace. Check out the FAQs page for more information.

Parent page: PCB Query Functions - Membership Checks

Summary

Returns all component objects whose Footprint property complies with the Query.

Syntax

HasFootprint(Footprint : String) : Boolean/Boolean_String

Example Usage

HasFootprint('SIP?0')
HasFootprint('SIP?0') = True
HasFootprint('SIP?0') = 'True'

Returns all component objects whose Footprint property starts with SIP and finishes with 0, and includes one other intermediate character. Example compliant footprints include SIP10, SIP20, and SIPQ0.

HasFootprint('DIP*')
HasFootprint('DIP*') = True
HasFootprint('DIP*') = 'True'

Returns all component objects whose Footprint property starts with DIP. Example compliant footprints include DIP8, DIP14, and DIP24N.

Not HasFootprint('IDC16')
HasFootprint('IDC16') = False
HasFootprint('IDC16') = 'False'

Returns all objects except component objects whose Footprint property is IDC16.

HasFootprint('*2*')
HasFootprint('*2*') = True
HasFootprint('*2*') = 'True'

Returns all component objects whose Footprint property includes the character 2. Example compliant footprints include 2012, 2N5001, IDC20, and HDR1X2.

Tips

  1. The single quote characters (') at the start and end of the Footprint string are mandatory.
  2. For each returned component object, its associated child objects are also returned.