AddDimDiametric メソッド(ActiveX)

直径上の 2 点と引出線の長さを指定して、円または円弧の直径寸法を作成します。

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

構文と要素

VBA:

RetVal = object.AddDimDiametric(ChordPoint, FarChordPoint, LeaderLength)

object

タイプ: Block、ModelSpace、PaperSpace

このメソッドが適用されるオブジェクト。

ChordPoint

アクセス: 入力のみ

タイプ: バリアント型(3 要素の倍精度浮動小数点数型配列)

円または円弧の直径の 1 番目の点を指定する 3D WCS 座標。

FarChordPoint

アクセス: 入力のみ

タイプ: バリアント型(3 要素の倍精度浮動小数点数型配列)

円または円弧の直径の 2 番目の点を指定する 3D WCS 座標。

LeaderLength

アクセス: 入力のみ

タイプ: 倍精度浮動小数点数型

ChordPoint から注釈文字または参照線(ドッグレグ)までの長さを示す正の値。

戻り値(RetVal)

タイプ: DimDiametric

新しく作成される直径寸法

注意

さまざまな種類の直径寸法が、次の値を基に記入されます。円または円弧のサイズ、引出線の長さ、AutoCAD のシステム変数 DIMUPT[寸法値位置指定]、DIMTOFL[寸法線内側記入]、DIMFIT[寸法値フィット]、DIMTIH[補助線内水平]、DIMTOH[補助線外水平]、DIMJUST[寸法値水平位置]、DIMTAD[寸法線上記入]の値。

寸法線の角度が水平より 15 度を超えている場合、および寸法線が円または円弧の外側にある場合には、寸法値を水平に表示するため、ランディングまたはドッグレッグと呼ばれるフックラインが描かれます。最初の 2 つの図に示されているように、フックラインは矢印 1 個分の長さを持ち、寸法値の隣りに配置されます。

この関数では、パラメータ LeaderLength を、ChordPoint から注釈文字への水平参照線(ドッグレグ)まで(参照線が不要な場合は寸法線の端)までの距離として使用します。

LeaderLength の設定は寸法作成時のみ(しかも、その寸法が、既定の文字位置を使用するように設定されている場合のみ)使用されます。いったん寸法を閉じた後は、LeaderLength の値を変更しても寸法の表示方法は変わりませんが、新しい設定は保存されて、DXF、LISP、および ARX に反映されます。

例

VBA:

Sub Example_AddDimDiametric()
    ' This example creates a diametric dimension in model space.
    
    Dim dimObj As AcadDimDiametric
    Dim chordPoint(0 To 2) As Double
    Dim farChordPoint(0 To 2) As Double
    Dim leaderLength As Double
    
    ' Define the dimension
    chordPoint(0) = 5#: chordPoint(1) = 3#: chordPoint(2) = 0#
    farChordPoint(0) = 5#: farChordPoint(1) = 5#: farChordPoint(2) = 0#
    leaderLength = 1#
    
    ' Create the diametric dimension in model space
    Set dimObj = ThisDrawing.ModelSpace.AddDimDiametric(chordPoint, farChordPoint, leaderLength)
    ZoomAll
End Sub

Visual LISP:

(vl-load-com)
(defun c:Example_AddDimDiametric()
    ;; This example creates a diametric dimension in model space.
    (setq acadObj (vlax-get-acad-object))
    (setq doc (vla-get-ActiveDocument acadObj))
    
    ;; Define the dimension
    (setq chordPoint (vlax-3d-point 5 3 0)
          farChordPoint (vlax-3d-point 5 5 0)
          leaderLength 1)
    
    ;; Create the diametric dimension in model space
    (setq modelSpace (vla-get-ModelSpace doc))
    (setq dimObj (vla-AddDimDiametric modelSpace chordPoint farChordPoint leaderLength))
    (vla-ZoomAll acadObj)
)