Vla-put-textoverride

AutoLISP Home - AutoLISP 目次 - DCL - AutoLisp関数互換表 - CAD&CGブログ - オンラインショップ- GizmoTools ヘルプセンター

構文: (vla-put-textoverride vla-object text )

機能: 寸法値の文字列を指定する。

引数

vla-object … VLAオブジェクト（Dim3PointAngular、DimAligned、DimAngular、DimArcLength、DimDiametric、Dimension、DimOrdinate、DimRadial、DimRadialLarge、DimRotated）
text … 寸法値の文字列。最大 256 文字。

戻り値: nil

MEMO：ユーザ文字列は、計算された寸法値から置き換える。文字を NULL 値("")に設定することで計算された寸法値に戻すことができる。値を表示するために括弧(<>)を使用することで、初期の寸法値に文字を付加することができる。文字列が表示されたときに初期値は括弧()に置き換わる。たとえば、TextString="<> mm" は、文字列 "3.5mm" が表示される。この場合の寸法値は 3.5。角括弧([])を使用して変換単位の寸法値を含めることもできる。

サンプル

(vl-load-com)
(defun c:Example_TextOverride()
    ;; 寸法を作成して寸法値を上書きするサンプル
    (setq acadObj (vlax-get-acad-object))
    (setq doc (vla-get-ActiveDocument acadObj))
    
    ;; 寸法の定義
    (setq point1 (vlax-3d-point 5 3 0)
          point2 (vlax-3d-point 10 3 0)
          location (vlax-3d-point 7.5 5 0))
    
    ;; 寸法を作成
    (setq modelSpace (vla-get-ModelSpace doc))
    (setq dimObj (vla-AddDimAligned modelSpace point1 point2 location))

    (vla-ZoomAll acadObj)
    (alert "寸法は、計測値が表示されているけど上書きするよ")
    
    ;; 変更
    (vla-put-TextOverride dimObj "この値は <> で [] だよ")
    (vla-Update dimObj)
    (alert "寸法値を変えたよ。")
    
    ;; 戻す
    (vla-put-TextOverride dimObj "")
    (vla-Update dimObj)
        
    (alert "戻ったよ。")
)