“SystemVariables”元素(基于 AutoCAD 2015 的产品及更高版本、AutoCAD LT 2024 及更高版本)
SystemVariables 元素是可选的,并且可以包含一个或多个 SystemVariables 元素。SystemVariable 元素包含插件应创建或修改的系统变量的定义。
SystemVariable 元素
属性
说明
Name
要创建或修改的系统变量的名称。
Value
要指定给变量的值。
该值可以包括下列可选运算符前缀之一:+、-、& 和 |。
有关详细信息,请参见“变量值运算符前缀”部分。
注: 将值应用于变量后,不会保留运算符前缀。
PrimaryType
要分配给变量的数据类型。(可选)在修改现有系统变量时。
有效值包括:
Int16 – 16 位有符号整数
Int32 – 32 位整数
Real – 浮点或双精度数值
String – 单个或多个字符值
如果运算符前缀用作变量值的一部分,则必须指定相应的数据类型。如果未使用相应的数据类型,则运算将被视作字符串运算。
StorageType
变量值的存储位置;在保持不变时。(可选)在修改现有系统变量时。
有效值包括:
Database – 保留在创建变量的图形文件中
Profile – 保留为当前 AutoCAD 配置的一部分
Session – 不会在任务之间或在创建任务的图形中保留
User – 保留为 AutoCAD 的 FixedProfile 的一部分
Owner
可选,AcRX 服务名称。
用于使系统变量只读并且仅可通过使用 acrxRegisterService() 注册服务名称的应用程序进行修改。
Flags
可选,创建和修改标志。可以指定多个标志;使用管道符号分隔各个标志。
支持以下标志:
Create – 如果不存在,将创建变量。(默认行为)
Open – 每次加载插件时并且仅当变量存在时,修改变量的值。
OpenOnce – 首次加载插件时并且仅当变量存在时,修改变量的值。卸载并重新安装插件会导致变量的值再次发生更改。
SpacesAllowed – 允许在命令提示下按空格键。如果未指定,则按空格键与按 Enter 键的效果一样。
注: 仅在 PrimaryType 属性设置为“String”时与“Create”标志结合使用。
DotIsEmpty - 允许通过为变量的值输入“.”(句点)来清除变量的值。
注: 仅在 PrimaryType 属性设置为“String”时与“Create”标志结合使用。
NoUndo – 不会记录对变量的更改,并且无法使用 U 或 UNDO 命令放弃更改。
注: 仅与“Create”标志结合使用。
Chatty – 触发反应器通知,即使在变量的值设置为当前值时也是如此。
注: 仅与“Create”标志结合使用。
注: 必须使用 Open 或 OpenOnce 标志来修改变量的值。
以下样例创建了一个名为 MYVARIABLE 的系统变量:
Name="MYVARIABLE" PrimaryType="String" StorageType="User" Value="Example" Owner="" Flags="Create|DotIsEmpty|SpacesAllowed" /> 以下样例在首次加载插件时,将 CURSORSIZE 系统变量的值更改为 100: Name="CURSORSIZE" Value="100" Flags="OpenOnce" />