AddHatch メソッド(ActiveX)

ハッチングオブジェクトを作成します。

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

構文と要素

VBA:

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

object

タイプ: Block、ModelSpace、PaperSpace

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

PatternType

アクセス: 入力のみ

タイプ: AcPatternType 列挙型または AcGradientPatternType 列挙型

HatchObjectType パラメータの値が acHatchObject の場合は、AcPatternType 列挙型を使用します。HatchObjectType パラメータの値が AcGradientObject の場合は、AcGradientPatternType 列挙型を使用します。

AcPatternType 列挙型

acHatchPatternTypePredefined: acad.pat ファイルに定義されている中からパターン名を選択します。
acHatchPatternTypeUserDefined: 現在の線種を使用して、線分のパターンを定義します。
acHatchPatternTypeCustomDefined: acad.pat ファイル以外の PAT ファイルからパターン名を選択します。

AcGradientPatternType 列挙型

acPreDefinedGradient: 標準値のいずれかから塗り潰し名を選択します。
acUserDefinedGradient: プロパティ値に基づいてパターンを定義します。

PatternName

アクセス: 入力のみ

タイプ: 文字列

パラメータ HatchObjectType の値が acHatchObject である場合は、PatternName にはハッチングパターン名を含める必要があります。パラメータ HatchObjectType の値が acGradientObject である場合は、PatternName には GradientName にリストされているグラデーションパターン名の１つを含める必要があります。

Associativity

アクセス: 入力のみ

タイプ: ブール型

True: ハッチングは自動調整されます。
False: ハッチングは自動調整されません。

HatchObjectType

アクセス: 入力のみ

タイプ: AcHatchObjectType 列挙型

既定値は、AcHatchObject の AcHatchObjectType 列挙型値です。AcHatchObjectType 列挙型値が AcGradientObject である場合は、PatternType は AcGradientPatternType タイプで、PatternName にはグラデーションパターン名を含める必要があります。

戻り値(RetVal)

タイプ: Hatch

新しく作成される Hatch オブジェクト。

注意

作成した Hatch オブジェクトに、AppendOuterLoop メソッドを使用して外側のループを追加しなければなりません。外側のループは閉じたループで、内側のループより先に作成しなければなりません。内側のループは、AppendInnerLoop メソッドを使用して一度に 1 つずつ作成されます。

注: いったん Hatch オブジェクトを作成したら、これを有効な AutoCAD オブジェクトにするためには、外側のループを Hatch オブジェクトに追加する必要があります。AppendOuterLoop メソッドの呼び出し以外の操作をしようとすると、AutoCAD は予期できない状態に陥ります。

例

VBA:

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)
)