AddRegion メソッド(ActiveX)

1 組の図形からリージョンを作成します。指定する図形は、同一平面の閉じたリージョンでなければなりません。

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

構文と要素

VBA:

RetVal = object.AddRegion(ObjectList)

object

タイプ: Block、ModelSpace、PaperSpace

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

ObjectList

アクセス: 入力のみ

タイプ: バリアント型(Arc、Circle、Ellipse、Line、LWPolyline、Spline オブジェクトの配列)

リージョンとなる閉じた同一平面を形成するオブジェクトの配列。

戻り値(RetVal)

タイプ: バリアント型(Region オブジェクトの配列)

このメソッドは、新しく作成された Region オブジェクトの配列を出力します。

注意

このメソッドは、曲線の入力配列によって形成される閉じたループからリージョンを作成します。 AutoCAD は、閉じた 2D および平面 3D ポリラインを個別のリージョンに変換し、次に閉じた平面ループを形成するポリライン、線分、および曲線を変換します。3 本以上の曲線が 1 つの端点を共有する場合、最終的なリージョンは任意に決定されます。

Explode メソッドを使用して、リージョンを個々のループに分解することができます。Boolean メソッドを使用すれば、別のソリッドやリージョンとの交差、和、または差によって、合成 3D ソリッドや合成リージョンを作成することができます。

作成される Region オブジェクトの総数は、Ubound(objRegions) - Lbound(objRegions) + 1 です。

例

VBA:

Sub Example_AddRegion()
    ' This example creates a region from an arc and a line.
    
    Dim curves(0 To 1) As AcadEntity

    ' Define the arc
    Dim centerPoint(0 To 2) As Double
    Dim radius As Double
    Dim startAngle As Double
    Dim endAngle As Double
    centerPoint(0) = 5#: centerPoint(1) = 3#: centerPoint(2) = 0#
    radius = 2#
    startAngle = 0
    endAngle = 3.141592
    Set curves(0) = ThisDrawing.ModelSpace.AddArc(centerPoint, radius, startAngle, endAngle)
    
    ' Define the line
    Set curves(1) = ThisDrawing.ModelSpace.AddLine(curves(0).startPoint, curves(0).endPoint)
        
    ' Create the region
    Dim regionObj As Variant
    regionObj = ThisDrawing.ModelSpace.AddRegion(curves)
    ZoomAll
    
End Sub

Visual LISP:

(vl-load-com)
(defun c:Example_AddRegion()
    ;; This example creates a region from an arc and a line.
    (setq acadObj (vlax-get-acad-object))
    (setq doc (vla-get-ActiveDocument acadObj))
    (setq modelSpace (vla-get-ModelSpace doc))

    ;; Define the arc
    (setq centerPoint (vlax-3d-point 5 3 0)
          radius 2
          startAngle 0
          endAngle 3.141592)
    (setq arc (vla-AddArc modelSpace centerPoint radius startAngle endAngle))
    
    ;; Define the line
    (setq line (vla-AddLine modelSpace (vla-get-StartPoint arc) (vla-get-EndPoint arc)))

    (setq curves (vlax-make-safearray vlax-vbObject '(0 . 1)))
    (vlax-safearray-put-element curves 0 arc)
    (vlax-safearray-put-element curves 1 line)
  
    ;; Create the region
    (setq regionObj (vla-AddRegion modelSpace curves))
    (vla-ZoomAll acadObj)
)