Query_Lang-PCBFunctions_Fields_TextHeightTextHeight_AD

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

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 Height property complies with the Query.

Syntax

TextHeight : 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(TextHeight) : Number – to specify a height in mil.
  • AsMM(TextHeight) : Number – to specify a height in mm.

Example Usage

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

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

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

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

Tips

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