AddHatch Method （ActiveX）

签名

工 务 局：

RetVal = object.AddHatch(PatternType, PatternName, Associativity [, HatchObjectType])

对象

类型：块，模型空间，图纸空间

此方法适用的对象。

模式类型

访问：仅输入

类型：奥勒姆AcPatternTypeAcGradientPatternType

如果HatchObjectType参数值为 ，则使用枚举;如果HatchObjectType参数值为 ，则使用枚举。acHatchObjectAcPatternTypeAcGradientObjectAcGradientPatternType

AcPatternType枚举

• acHatchPatternTypePredefined：从acad.pat文件中定义的模式名称中选择模式名称。
• acHatchPatternTypeUserDefined：使用当前线型定义线型的线阵列。
• acHatchPatternTypeCustomDefined：从acad.pat文件以外的 PAT 文件中选择模式名称。

AcGradientPatternType枚举

• acPreDefinedGradient：从其中一个标准值中选择填充名称。
• acUserDefinedGradient：定义基于属性值的模式。

模式名称

访问：仅输入

类型：字符串

如果HatchObjectType参数值为 ，则图案名称应包含图案填充图案名称。如果HatchObjectType参数值为 ，则PatternName应包含GradientName 中列出的渐变图案名称之一。acHatchObjectacGradientObject

结合性

访问：仅输入

类型：布尔

• True：舱口将是关联的。
• False：舱口不会关联。

图案填充对象类型

访问：仅输入

类型：枚举AcHatchObjectType

默认值为 的枚举值。如果枚举值为，则模式类型应为类型，模式名称应包含渐变模式名称。AcHatchObjectTypeAcHatchObjectAcHatchObjectTypeAcGradientObjectAcGradientPatternType

返回值（RetVal）

类型：舱口

新创建的对象。Hatch

言论

创建对象后，必须使用方法添加外部循环。必须关闭外部循环，并且必须先创建外部循环，然后才能创建任何内部循环。内部循环是使用该方法一次创建一个的。HatchAppendOuterLoopAppendInnerLoop

例子

工 务 局：

Sub Example_AddHatch()
    ' This example creates an associative gradient hatch in model space.
    
    Dim hatchObj As AcadHatch
    Dim patternName As String
    Dim PatternType As Long
    Dim bAssociativity As Boolean
    
    ' Define the hatch
    patternName = "CYLINDER"
    PatternType = acPreDefinedGradient '0
    bAssociativity = True
    
    ' Create the associative Hatch object in model space
    Set hatchObj = ThisDrawing.ModelSpace.AddHatch(PatternType, patternName, bAssociativity, acGradientObject)
    Dim col1 As AcadAcCmColor, col2 As AcadAcCmColor
    Set col1 = AcadApplication.GetInterfaceObject("AutoCAD.AcCmColor." & Left(AcadApplication.Version, 2))
    Set col2 = AcadApplication.GetInterfaceObject("AutoCAD.AcCmColor." & Left(AcadApplication.Version, 2))
    Call col1.SetRGB(255, 0, 0)
    Call col2.SetRGB(0, 255, 0)
    hatchObj.GradientColor1 = col1
    hatchObj.GradientColor2 = col2
    
    ' Create the outer boundary for the hatch (a circle)
    Dim outerLoop(0 To 0) As AcadEntity
    Dim center(0 To 2) As Double
    Dim radius As Double
    center(0) = 3: center(1) = 3: center(2) = 0
    radius = 1
    Set outerLoop(0) = ThisDrawing.ModelSpace.AddCircle(center, radius)
    
    ' Append the outerboundary to the hatch object, and display the hatch
    hatchObj.AppendOuterLoop outerLoop
    hatchObj.Evaluate
    ThisDrawing.Regen True
End Sub

Visual LISP:

(vl-load-com)
(defun c:Example_AddHatch()
    ;; This example creates an associative gradient hatch in model space.
    (setq acadObj (vlax-get-acad-object))
    (setq doc (vla-get-ActiveDocument acadObj))    
    
    ;; Define the hatch
    (setq patternName "CYLINDER")
    (setq patternType acPreDefinedGradient)
    (setq bAssociativity :vlax-true)
    
    ;; Create the associative Hatch object in model space
    (setq modelSpace (vla-get-ModelSpace doc))  
    (setq hatchObj (vla-AddHatch modelSpace patternType patternName bAssociativity acGradientObject))

    (setq col1 (vlax-create-object (strcat "AutoCAD.AcCmColor." (substr (getvar "ACADVER") 1 2))))
    (setq col2 (vlax-create-object (strcat "AutoCAD.AcCmColor." (substr (getvar "ACADVER") 1 2))))
    (vla-SetRGB col1 255 0 0)
    (vla-SetRGB col2 0 255 0)
    (vla-put-GradientColor1 hatchObj col1)
    (vla-put-GradientColor2 hatchObj col2)
    
    ;; Create the outer boundary for the hatch (a circle)
    (setq center (vlax-3d-point 3 3 0))
  
    (setq radius 1)
    (setq circle (vla-AddCircle modelSpace center radius))

    (setq outerLoop (vlax-make-safearray vlax-vbObject '(0 . 0)))
    (vlax-safearray-put-element outerLoop 0 circle)
    
    ;; Append the outerboundary to the hatch object, and display the hatch
    (vla-AppendOuterLoop hatchObj outerLoop)
    (vla-Evaluate hatchObj)
    (vla-Regen doc :vlax-true)

    (vlax-release-object col1)
    (vlax-release-object col2)
)