创建图案填充对象。(2004修改)

参阅 | 示例

语法

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

Object

ModelSpace 集合, PaperSpace 集合, Block
使用该方法的对象。

PatternType

AcPatternType 或 AcGradientPatternType 常数; 仅用于输入
如果 HatchObjectType 常数值为 acHatchObject，则使用 AcPatternType 常数; 如果 HatchObjectType 常数值为 AcGradientObject则使用 AcGradientPatternType 常数。

PatternName

String[字符串]; 仅用于输入
如果 HatchObjectType 常数值为 acHatchObject, 则 PatternName 包含填充图案名称。如果 HatchObjectType 常数值为 acGradientObject，则 PatternName 包含在 GradientName 中列出的其中一个渐变图案名称。

Associativity

Boolean[布尔值]; 仅用于输入

TRUE: 图案填充为关联的。

FALSE: 图案填充为不关联的。

HatchObjectType

HatchObjectType; 可选项; 仅用于输入
默认值为 AcHatchObjectType 常数值的 AcHatchObject。如果 AcHatchObjectType 常数值为 AcGradientObject，则 PatternType 为 AcGradientPatternType 类型，并且 PatternName 包含渐变图案名称。
(该参数为2004新增参数，在2002及以前版本没有该参数，也就是说没有渐变的选项。)

RetVal

Hatch 对象
新创建的 Hatch 对象。

说明

PatternType 常数值如下:

acHatchPatternTypePredefined

选择那些定义在 acad.pat 文件中的图案名称。

acHatchPatternTypeUserDefined

使用当前线线型定义的线图案。

acHatchPatternTypeCustomDefined

从 acad.pat 文件名的其它 PAT 中选择图案名称。

创建了 Hatch 对象后，必须使用 AppendOuterLoop 方法添加外边界。外边界必须封闭而且必须在任何内边界创建前创建。内边界使用 AppendInnerLoop 方法创建的，一次只能创建一个。

警告! 当创建了 Hatch 对象后，你必须立即追加外边界到 Hatch 对象以便它成为有效的 AutoCAD 对象。如果试图进行调用  AppendOuterLoop 方法以外的其它操作， AutoCAD 将进入无法预测的状态。