HasPad

Now reading version 1.1. For the latest, read: HasPad for version 4
Applies to NEXUS Client versions: 1.0, 1.1, 2.0, 2.1, 3.0, 3.1 and 3.2

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 pad objects whose full name property complies with the Query.

Syntax

HasPad(PadName : String) : Boolean/Boolean_String

The PadName string specifies the full name that a pad has to match; this consists of an initial substring which specifies the Name property of the pad's parent component (i.e. the component's Designator), followed by a substring that specifies the pad's own Name property (i.e. the pad's Designator). The format will therefore be 'ParentComponentDesignator-PadDesignator'.

Example Usage

Not HasPad('C14-1')
HasPad('C14-1') = False
HasPad('C14-1') = 'False'

Returns all objects except the pad object whose Name property is 1, and which is a child object of the component object whose Name property is C14.

HasPad('U5-11')
HasPad('U5-11') = True
HasPad('U5-11') = 'True'

Returns the pad object whose Name property is 11, and which is a child object of the component object whose Name property is U5.

HasPad('U*-11')
HasPad('U*-11') = True
HasPad('U*-11') = 'True'

Returns all pad objects whose Name property is 11, and which are child objects of component objects whose Name property starts with U.

HasPad('*-1*')
HasPad('*-1*') = True
HasPad('*-1*') = 'True'

Returns all pad objects whose Name property starts with 1, and which are child objects of any component object.

Tips

  1. The single quote characters (') at the start and end of the PadName string are mandatory.