InLayerStackRegion

Now reading version 3.2. For the latest, read: InLayerStackRegion 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 objects whose reference point is within the named Board Region.

Syntax

InLayerStackRegion(RegionName1 : String,RegionName2 : String,...,RegionNamen : String) : Boolean/Boolean_String

Example Usage

InLayerStackRegion('Region1')
InLayerStackRegion('Region1') = True
InLayerStackRegion('Region1') = 'True'

Returns all objects whose reference point is within the Board Region whose Name property is Region1.

InLayerStackRegion('Region1','Region2')
InLayerStackRegion('Region1','Region2') = True
InLayerStackRegion('Region1','Region2') = 'True'

Returns all objects whose reference point is within the Board Region whose Name property is Region1, or the Board Region whose Name property is Region2.

Not InLayerStackRegion('Region2')
InLayerStackRegion('Region2') = False
InLayerStackRegion('Region2') = 'False'

Returns all objects except objects whose reference point is within the Board Region whose Name property is Region2.

Tips

  1. The single quote characters (') at the start and end of the RegionName string are mandatory.
  2. The reference point for each object kind varies, but is normally the X/Y location shown in the Properties panel. For example, for a pad or via it is the center; for a track it is the left vertex; for a string it is the bottom left corner. A component will be returned if its reference point is within the Board Region, if the reference point is not within the Board Region the query is applied to the individual primitive objects within the component.