VerticalTextPosition プロパティ(ActiveX)

寸法線に対する寸法値の垂直方向の位置を指定します。

サポートされているプラットフォーム: Windows のみ

構文と要素

VBA:

object.VerticalTextPosition

object

タイプ: Dim3PointAngular、DimAligned、DimAngular、DimArcLength、DimDiametric、Dimension、DimOrdinate、DimRadial、DimRadialLarge、DimRotated、Leader

このプロパティが適用されるオブジェクト。

プロパティの値

読み込み専用: いいえ

タイプ: acDimVerticalJustification 列挙型

• acVertCentered: 寸法値を寸法補助線間の中央に記入します。
• acAbove: 寸法線が水平ではなく、寸法補助線の内側の寸法値が強制水平(DIMTIH[補助線内水平] = 1)でない限り、寸法線の上に寸法値を記入します。寸法線から寸法値の基準線(最下線)までの距離が、DIMGAP[寸法ギャップ]の現在値です。
• acUnder: 寸法線が水平ではなく、寸法補助線の内側の寸法値が強制水平(DIMTIH[補助線内水平] = 1)でない限り、寸法線の下に寸法値を記入します。寸法線から寸法値の基準線(最下線)までの距離が、DIMGAP[寸法ギャップ]の現在値です。
• acOutside: 寸法値を、定義点から最も遠くにある寸法線の横に記入します。
• acJIS: 寸法値を JIS(日本工業規格)に準拠するように記入します。

注意

このプロパティの初期値は acVertCentered です。

注: このプロパティは、指定された寸法、引出線、または幾何公差オブジェクトでシステム変数 DIMTAD[寸法線上記入]の値を変更します。

例

VBA:

Sub Example_VerticalTextPosition()
    ' This example creates an aligned dimension in model space
    ' and cycles the dimension text through a couple of different
    ' vertical alignments
    
    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 CurrentValue As String
    
    ' Define the dimension
    point1(0) = 5: point1(1) = 5: point1(2) = 0
    point2(0) = 9: 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)
    ThisDrawing.Application.ZoomAll

    ' Read and display current text position
    Select Case dimObj.VerticalTextPosition
        Case acVertCentered:    CurrentValue = "centered"
        Case acAbove:           CurrentValue = "above"
        Case acOutside:         CurrentValue = "outside"
        Case acJIS:             CurrentValue = "to Japanesee industrial standards"
    End Select

    MsgBox "The vertical position of the dimension is: " & CurrentValue

    ' Change the position of the dimension text to be above the extesnion lines
    dimObj.VerticalTextPosition = acAbove
    ThisDrawing.Regen acAllViewports
    MsgBox "Dimension text is now aligned above extension lines"
   
    ' Change the position of the dimension text to be centered with the extension lines
    dimObj.VerticalTextPosition = acVertCentered
    ThisDrawing.Regen acAllViewports
    MsgBox "Dimension text is now centered with the extension lines"

End Sub

Visual LISP:

(vl-load-com)
(defun c:Example_VerticalTextPosition()
    ;; This example creates an aligned dimension in model space
    ;; and cycles the dimension text through a couple of different
    ;; vertical alignments
    (setq acadObj (vlax-get-acad-object))
    (setq doc (vla-get-ActiveDocument acadObj))
    
    ;; Define the dimension
    (setq point1 (vlax-3d-point 5 5 0)
          point2 (vlax-3d-point 9 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))
    (vla-ZoomAll acadObj)

    ;; Read and display current text position
    (setq CurrentValue (cond
                           ((= (vla-get-VerticalTextPosition dimObj) acVertCentered) "centered")
                           ((= (vla-get-VerticalTextPosition dimObj) acAbove) "above")
                           ((= (vla-get-VerticalTextPosition dimObj) acOutside) "outside")
                           ((= (vla-get-VerticalTextPosition dimObj) acJIS) "to Japanesee industrial standards")
                       ))
    
    (alert (strcat "The vertical position of the dimension is: " CurrentValue))

    ;; Change the position of the dimension text to be above the extesnion lines
    (vla-put-VerticalTextPosition dimObj acAbove)
    (vla-Regen doc acAllViewports)
    (alert "Dimension text is now aligned above extension lines")
   
    ;; Change the position of the dimension text to be centered with the extension lines
    (vla-put-VerticalTextPosition dimObj acVertCentered)
    (vla-Regen doc acAllViewports)
    (alert "Dimension text is now centered with the extension lines")
)