Specifies a suffix for the alternate dimension measurement for all dimension types except angular.
Supported platforms: Windows only
VBA:
object.AltTextSuffix
Type: DimAligned, DimArcLength, DimDiametric, DimOrdinate, DimRadial, DimRadialLarge, DimRotated
The objects this property applies to.
Read-only: No
Type: String
The suffix for the alternate dimensions.
The initial value for this property is "".
To turn off an established suffix, set this property equal to a single period (.).
VBA:
Sub Example_AltTextSuffix() ' This example creates an aligned dimension in model space and ' uses AltTextSuffix to allow the user to change the text suffix for the ' alternate dimension Dim dimObj As AcadDimAligned Dim point1(0 To 2) As Double, point2(0 To 2) As Double Dim location(0 To 2) As Double Dim suffix As String ' Define the dimension point1(0) = 0: point1(1) = 5: point1(2) = 0 point2(0) = 5: point2(1) = 5: point2(2) = 0 location(0) = 5: location(1) = 7: location(2) = 0 ' Create an aligned dimension object in model space Set dimObj = ThisDrawing.ModelSpace.AddDimAligned(point1, point2, location) ' Enable alternate unit display dimObj.AltUnits = True ThisDrawing.Application.ZoomAll ' Allow the user to change the text suffix for the alternate dimension suffix = InputBox("Enter a new text suffix for the alternate dimension", "Alternate Dimension Suffix", ":SUFFIX") dimObj.AltTextSuffix = suffix ' Commit changes to suffix ThisDrawing.Regen acAllViewports ' Read back and display the alternate dimension text suffix suffix = dimObj.AltTextSuffix If suffix <> "" Then MsgBox "The suffix of the alternate dimension has been changed to: " & suffix Else MsgBox "The suffix of the alternate dimension has been removed" End If End Sub
Visual LISP:
(vl-load-com) (defun c:Example_AltTextSuffix() ;; This example creates an aligned dimension in model space and ;; uses AltTextSuffix to allow the user to change the text suffix for the ;; alternate dimension (setq acadObj (vlax-get-acad-object)) (setq doc (vla-get-ActiveDocument acadObj)) ;; Define the dimension (setq point1 (vlax-3d-point 0 5 0) point2 (vlax-3d-point 5 5 0) location (vlax-3d-point 5 7 0)) ;; Create an aligned dimension object in model space (setq modelSpace (vla-get-ModelSpace doc)) (setq dimObj (vla-AddDimAligned modelSpace point1 point2 location)) ;; Enable alternate unit display (vla-put-AltUnits dimObj :vlax-true) (vla-ZoomAll acadObj) ;; Allow the user to change the text suffix for the alternate dimension (setq suffix (vla-GetString (vla-get-Utility doc) :vlax-false "\nEnter a new text suffix for the alternate dimension: ")) (vla-put-AltTextSuffix dimObj suffix) ;; Commit changes to suffix (vla-Regen doc acAllViewports) ;; Read back and display the alternate dimension text suffix (setq suffix (vla-get-AltTextSuffix dimObj)) (if (/= suffix "") (alert (strcat "The suffix of the alternate dimension has been changed to: " suffix)) (alert "The suffix of the alternate dimension has been removed") ) )