CAD开发者社区 › 首页 ›AutoCAD开发文档› AutoCAD 2023 开发者帮助 › 查看内容

AutoCAD 2023 开发者帮助

AddRegion 方法（ActiveX）

2024-5-18 18:55| 发布者: admin| 查看: 206| 评论: 0|原作者: admin|来自: AutoCAD

从一组实体创建区域。给定的图元必须形成一个封闭的共面区域。

支持的平台：仅限 Windows

签名

VBA：

RetVal = object.AddRegion(ObjectList)

对象

类型：块、模型空间、纸空间

此方法应用到的对象。

对象列表

访问：仅输入

类型：变体（弧、圆、椭圆、线、LWPolyline、样条对象的数组）

形成闭合共面面的物体阵列，要制成一个区域。

返回值（RetVal）

类型：Variant（Region 对象数组）

此方法输出新创建的对象的数组。Region

言论

此方法将在由曲线输入数组形成的每个闭环中创建一个区域。AutoCAD 将闭合的 2D 和平面 3D 折线转换为单独的区域，然后转换形成闭合平面环的折线、直线和曲线。如果两条以上的曲线共享一个端点，则生成的区域可能是任意的。

您可以使用该方法将区域分解为各个循环。该方法允许您根据实体或区域与另一个实体或区域的交集、并集或减法创建复合 3D 实体或区域。ExplodeBoolean

创建的对象总数为。RegionUbound(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

可视化 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)
)