Query_Lang-PCBFunctions_MembershipChecks_InNamedUnionInNamedUnion_AD

This document is no longer available beyond version 4. Information can now be found here: InNamedUnion 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 objects (parent and children) that are part of the specified union.

Syntax

InNamedUnion(UnionName : String) : Boolean/Boolean_String

Union names are automatically assigned, but can be renamed through using the PCB panel in Unions mode. As you define the Query expression, a pop-up list of all existing unions, by name, is presented.

Example Usage

InNamedUnion('Unions')
InNamedUnion('Unions') = True
InNamedUnion('Unions') = 'True'

Returns all objects (parent and children) that are part of the union whose name is Unions.

Not InNamedUnion('Unions 1')
InNamedUnion('Unions 1') = False
InNamedUnion('Unions 1') = 'False'

Returns all objects except objects (parent and children) that are part of the union whose name is Unions 1.

Tips

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