Query_Lang-PCBFunctions_Fields_TextWidthTextWidth_AD

This document is no longer available beyond version 4. Information can now be found here: TextWidth 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 - Fields

Summary

Returns all coordinate, original dimension and text string (comment, designator, free) objects whose Text Width property complies with the Query.

Syntax

TextWidth : Number

Number will follow the measurement units currently employed for the document – either Imperial (mil; 1mil = 0.001inch) or Metric (mm; 1mm = 0.001meter).

A specific option for the measurement unit can be specified – overriding the default units specified at the document level – through use of an additional measurement unit-based keyword:

  • AsMils(TextWidth) : Number – to specify a width in mil.
  • AsMM(TextWidth) : Number – to specify a width in mm.

Example Usage

TextWidth = 6
Returns all coordinate, original dimension and text string (comment, designator, free) objects that have an Text Width property which is 6 current measurement units.

TextWidth >= 0.127
Returns all coordinate, original dimension and text string (comment, designator, free) objects that have an Text Width property which is greater than, or equal to, 0.127 current measurement units.

AsMils(TextWidth) Between 4 And 8
Returns all coordinate, original dimension and text string (comment, designator, free) objects that have an Text Width property which is greater than, or equal to, 4mil and less than, or equal to, 8mil.

AsMM(TextWidth) < 0.1778
Returns all coordinate, original dimension and text string (comment, designator, free) objects that have an Text Width property which is less than 0.1778mm.

Tips

  1. The Text Width property is only defined for coordinate, original dimension and text string (comment, designator, free) objects.