用指定属性在给定的位置创建属性定义。

参阅 | 示例

语法

RetVal = object.AddAttribute(Height, Mode, Prompt, InsertionPoint, Tag, Value)

Object

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

Height

Double[双精度]; 仅用于输入
当前图形单位的文字高度。

Mode

AcAttributeMode 常数; 仅用于输入
(通过相加来任意组合这些常数):

acAttributeModeInvisible

acAttributeModeConstant

acAttributeModeVerify

acAttributeModePreset

Prompt

String[字符串]; 仅用于输入
当包含该属性的块插入时该字符串将显示。该字符串的默认值为 Tag 字符串。输入 Mode 参数为 acAttributeModeConstant 时禁用该提示。

InsertionPoint

Variant[变体] (三元素双精度数组); 仅用于输入
指定属性位置的三维 WCS 坐标。

Tag

String[字符串]; 仅用于输入
确定每一出现的属性的非空字符串。输入除空格或感叹号外的任何字符。 AutoCAD 会将小写字母改为大写字母。

Value

String[字符串]; 仅用于输入
该非空字符串为默认的属性值。

RetVal

Attribute 对象
新创建的 Attribute 对象。

说明

Mode 值解释如下:

acAttributeModeInvisible

指定在插入块时不显示属性值。ATTDISP 命令将覆盖 Invisible(不可见)模式。

acAttributeModeConstant

在块插入时给定一个固定的属性值。

acAttributeModeVerify

插入块时提示用户验证属性值是否正确。

acAttributeModePreset

当插入块包含有预设属性时设置属性为默认值。该值在该模式下不可编辑。

属性定义与创建它的块相关联。在模型空间或图纸空间创建的属性定义不会附加到任何给定块。

AFLAGS 系统变量保存着模式设置。可使用 GetVariable 方法查询该值，或使用 SetVariable 方法来设置它。