“Components” 元素用于指定构成一个版本的插件的组件。
多个“Components” 元素可用于标识插件的组件；每个“Components” 元素可以标识一个或多个组件。“Components” 元素的平台和产品信息由“RuntimeRequirements” 元素定义。
如果要将所有在“Components” 元素中定义的组件应用到相同的平台，用户不需要将“RuntimeRequirements” 元素添加到每个单独的“ComponentEntry” 元素。
与“RuntimeRequirements” 元素一起，“Components” 元素可能包含一个或多个以下元素
ComponentEntry
RegistryEntries
SystemVariables
EnvironmentVariables
注： “Components” 元素可以仅包含一个“RegistryEntries” ，但是“SystemVariables” 和“EnvironmentVariables” 元素可以包含多个“ComponentEntry” 元素。
以下内容概述了“Components” 元素及其可以包含的任何元素之间的基本关系。
<Components>
<RuntimeRequirements ... />
<RegistryEntries>
<RegistryEntry ... />
</RegistryEntries>
<SystemVariables>
<SystemVariable ... />
</SystemVariables>
<EnvironmentVariables>
<EnvironmentVariable ... />
</EnvironmentVariables>
<ComponentEntry ... >
<RuntimeRequirements ... />
</ComponentEntry>
<ComponentEntry ... />
<Commands ...>
<Command ... />
</Commands>
</Components>
ComponentEntry 元素（基于 AutoCAD 2013 的产品及更高版本）
“ComponentEntry” 元素是必需的，用于指定关于“Components” 元素中各个组件的详细信息。
可以根据需要指定任意多个“ComponentEntry” 元素。组件类型可以是以下文件格式之一：
Windows 和 Mac OS
AutoLISP (LSP)
AutoLISP Fastload (FAS)
ObjectARX (ARX)
ObjectDBX (DBX)
仅适用于 Windows
编译的 AutoLISP 项目/Visual LISP (VLX)
可扩展应用程序标记语言 (XAML)
JavaScript (JS)
托管或混合模式 .NET 部件 (DLL)
局部自定义 (CUI/CUIx)
工具选项板 (ATC)
VBA 项目 (DVB)
如果“LoadReasons” 属性设置为“LoadOnCommandInvocation” ，则“ComponentEntry” 元素可能包含“命令” 元素。
注： “ComponentEntry” 元素以所列出的顺序加载，但自下而上。因此，其他组件所从属的任何文件都必须在列表的底部。例如，如果 ObjectARX 模块从属于 ObjectDBX 模块，则 ObjectARX 模块在列表中需要出现在 ObjectDBX 模块的上面。
“ComponentEntry” 元素可以有以下任一附着属性：
属性
说明
应用程序名称
对于 AutoLISP 可选；对于 ObjectARX 和 .NET 必需 - 组件的名称；与 ObjectARX API AcadAppInfo 类中的“应用程序名称” 相同。
应用程序说明
组件的说明；与 ObjectARX API AcadAppInfo 类中的“应用程序说明” 相同。
AppType
组件类型；替代源自“模块名称” 属性中提供的文件扩展名的类型。
组件类型可以是以下类型之一：
模块名称
程序包中组件的相对路径；与 ObjectARX API AcadAppInfo 类中的“模块名称” 相同。
组件类型由文件的扩展名确定：
.atc – 工具选项板
.arx – ObjectARX
.cuix - 局部自定义
.dbx – ObjectDBX
.dll – 受管 .NET 部件
.dvb – VBA 项目（基于 AutoCAD 2015 的产品及更高版本）
注： DVB 文件要求首先安装 VBA Enabler。加载后，用户需要先单击“启用宏”，才可以访问项目及其宏。
重要： 当前，仅在启动时打开图形文件时才会加载 VBA 工程文件，这是通过将 STARTUP 系统变量设置为 0 或 1 来实现的。
.js – Javascript（基于 AutoCAD 2015 的产品及更高版本）
.lsp 、.fas 或 .vlx – AutoLISP/Visual LISP
.xaml – 可扩展应用程序标记语言（基于 AutoCAD 2015 的产品及更高版本）
注： 属性 XamlType 必须设置为“ContextualTabRule”
如果应用程序要处理多种语言，通过将“模块名称” 与区域设置代码组合在一起来指定特定组件的不同语言版本。请参见“支持的区域设置代码参考”，以获取支持的区域设置代码的完整列表。
注： 所有路径指定符为“/”和“\”，路径相对于根 .bundle 文件夹。
每文档
仅对于 AutoLISP - 当为“真”时，每个文档加载 AutoLISP 文件一次。默认值为“真”。
Loadreasons
可以指定多个值 - 使用“Loadreasons” 定义组件的加载行为参数，除了“LoadOnCommandInvocation” 参数。
默认情况下，如果“LoadReasons” 未指定，“LoadOnAutoCADStartup” 、“LoadOnAppearance” 和“LoadOnProxy” 处于启用状态（设置为“真”）。如果需要禁用参数（设置为“假”），则“LoadReasons” 元素必须与设置为“假”的参数一起指定。
默认情况下，“LoadOnCommandInvocation” 处于禁用状态，启用它将禁用“LoadOnAutoCADStartup” 和“LoadOnAppearance” ，除非明确启用。如果一个或多个命令定义为“Components”元素的一部分，将隐式启用 LoadOnCommandInvocation 。
有关 AcadAppInfo LoadReasons 的完整的详细信息，请参见 《ObjectARX 参考手册》。
有效参数值：
可以使用下列参数：
XamlType
XAML 类型；当前唯一支持的值为“ContextualTabRule”，并且在将 XAML 文件分配给 ModuleName 属性时需要该值。使用 XAML 文件的应用程序文件应在包含 XAML 文件的“ComponentEntry” 元素后列出。
RegistryEntries 元素（基于 AutoCAD 2015 的产品及更高版本）
“RegistryEntries” 元素是可选的，并且可以包含一个或多个“RegistryEntry” 元素。“RegistryEntry” 元素包含插件应该创建或修改的注册表项的定义。注册表项存储在 Windows 注册表中或 Mac 操作系统上的特性列表 (PLIST) 文件中。
注： 在 Windows 上，可以在 HKEY_CURRENT_USER\Software\Autodesk\AutoCAD\<版本> \ACAD-<产品> :<语言> 下创建注册表项。无法在其他位置中创建注册表项。可以在 Mac 操作系统上的 PLIST 文件中使用该等效位置。
RegistryEntry 元素
属性
说明
名称
要创建或修改的注册表项的名称。
值
要指定给注册表项的值。
该值可以包括下列可选运算符前缀之一：+ 、- 、& 和 | 。
有关详细信息，请参见“变量值运算符前缀”部分。
注： 将值应用于注册表项后，不会保留运算符前缀。
类型
要分配给注册表项的数据类型。（可选）在修改现有的注册表项时。
有效值为：
REG_SZ – String; 空终止
REG_EXPAND_SZ – 包含未展开环境变量的字符串，例如 %APPDATA%; 空终止
REG_DWORD – 32 位无符号整数
REG_QWORD – 64 位有符号整数
如果运算符前缀用作注册表项值的一部分，则必须指定相应的数据类型。如果未使用相应的数据类型，则运算将被视作字符串运算。
标志
可选，创建和修改标志。可以指定多个标志；使用管道符号分隔各个标志。
支持以下标志：
Create – 如果不存在，将创建注册表项。（默认行为）
Open – 在每次加载插件时并且仅当注册表项存在时，修改注册表项的值。
OpenOnce – 在首次加载插件时并且仅当注册表项存在时，修改注册表项的值。卸载并重新安装插件会导致注册表项的值再次更改。
注： 必须使用 Open 或 OpenOnce 标志来修改注册表项的值。
下面的示例将创建注册表项 MYREGKEY 并添加值 STRING 和 NUMBER：
<RegistryEntries>
<RegistryEntry
Key="MYREGKEY"
Name="STRING"
Value="Example"
Type="REG_SZ"
/>
<RegistryEntry
Key="MYREGKEY"
Name="NUMBER"
Value="123"
Type="REG_DWORD"
/>
</RegistryEntries>
SystemVariables 元素（基于 AutoCAD 2015 的产品及更高版本）
“SystemVariables” 元素是可选的，并且可以包含一个或多个“SystemVariables” 元素。“SystemVariable” 元素包含插件应创建或修改的系统变量的定义。
SystemVariable 元素
属性
说明
名称
要创建或修改的系统变量的名称。
值
要分配给变量的值。
该值可以包括下列可选运算符前缀之一：+ 、- 、& 和 | 。
有关详细信息，请参见“变量值运算符前缀”部分。
注： 将值应用于变量后，不会保留运算符前缀。
PrimaryType
要分配给变量的数据类型。（可选）在修改现有系统变量时。
有效值为：
Int16 – 16 位有符号整数
Int32 – 32 位整数
Real – 浮点或双精度数值
String – 单个或多个字符值
如果运算符前缀用作变量值的一部分，则必须指定相应的数据类型。如果未使用相应的数据类型，则运算将被视作字符串运算。
StorageType
变量值的存储位置；在保持不变时。（可选）在修改现有系统变量时。
有效值为：
Database – 保留在创建变量的图形文件中
Profile – 保留为当前 AutoCAD 配置的一部分
Session – 不会在任务之间或在创建任务的图形中保留
User – 保留为 AutoCAD 的 FixedProfile 的一部分
所有者
可选，AcRX 服务名称。
用于使系统变量只读并且仅可通过使用 acrxRegisterService() 注册服务名称的应用程序进行修改。
标志
可选，创建和修改标志。可以指定多个标志；使用管道符号分隔各个标志。
支持以下标志：
Create – 如果不存在，将创建变量。（默认行为）
Open – 在每次加载插件时并且仅当变量存在时，修改变量的值。
OpenOnce – 在首次加载插件时并且仅当变量存在时，修改变量的值。卸载并重新安装插件会导致变量的值再次更改。
SpacesAllowed – 允许在命令提示下按空格键。如果未指定，则按空格键与按 Enter 键的效果一样。
注： 仅在 PrimaryType 属性设置为“String”时与“Create”标志结合使用。
DotIsEmpty – 允许通过在变量的值中输入“.”（句点），清除变量的值。
注： 仅在 PrimaryType 属性设置为“String”时与“Create”标志结合使用。
NoUndo – 不会记录对变量的更改，并且无法使用 U 或 UNDO 命令放弃更改。
注： 仅与 Create 标志结合使用。
Chatty – 触发反应器通知，即使在变量的值设置为当前值时也是如此。
注： 仅与 Create 标志结合使用。
注： 必须使用 Open 或 OpenOnce 标志来修改变量的值。
下面的示例创建了一个名为 MYVARIABLE 的系统变量：
<SystemVariable
Name="MYVARIABLE"
PrimaryType="String"
StorageType="User"
Value="Example"
Owner=""
Flags="Create|DotIsEmpty|SpacesAllowed"
/>
下面的示例在首次加载插件时，将 CURSORSIZE 系统变量的值更改为 100：
<SystemVariable
Name="CURSORSIZE"
Value="100"
Flags="OpenOnce"
/>
EnvironmentVariables 元素（基于 AutoCAD 2015 的产品及更高版本）
“EnvironmentVariables” 元素是可选的，并且可以包含一个或多个“EnvironmentVariable” 元素。“EnvironmentVariable” 元素包含插件应该创建或修改的环境变量的定义。环境变量存储在 Windows 注册表中或 Mac 操作系统上的特性列表 (PLIST) 文件中。
注： 环境变量的值始终存储为字符串，并且环境变量的名称区分大小写。
EnvironmentVariable 元素
属性
说明
名称
要创建或修改的环境变量的名称。
值
要分配给变量的值。
该值可以包括下列可选运算符前缀之一：+ 、- 、& 和 | 。
有关详细信息，请参见“变量值运算符前缀”部分。
注： 将值应用于变量后，不会保留运算符前缀。
类型
可选，值 表示的数据类型。
有效值为：
Int16 – 16 位有符号整数
Int32 – 32 位有符号整数
Real – 浮点或双精度数值
String – 单个或多个字符值
如果运算符前缀用作变量值的一部分，则必须指定相应的数据类型。如果未使用相应的数据类型，则运算将被视作字符串运算。
标志
可选，创建和修改标志。可以指定多个标志；使用管道符号分隔各个标志。
支持以下标志：
Create – 如果不存在，将创建变量。（默认行为）
Open – 在每次加载插件时并且仅当变量存在时，修改变量的值。
OpenOnce – 在首次加载插件时并且仅当变量存在时，修改变量的值。卸载并重新安装插件会导致变量的值再次更改。
注： 必须使用 Open 或 OpenOnce 标志来修改变量的值。
下面是创建两个名为 MYNUMVAR 和 MYSTRVAR 的环境变量的示例：
<EnvironmentVariables>
<EnvironmentVariable
Name="MYNUMVAR"
Value="123"
/>
<EnvironmentVariable
Name="MYSTRVAR"
Value="Example"
/>
</EnvironmentVariables>
变量值的运算符前缀
运算符前缀用于在加载插件后，修改变量的当前值。您可以将下表中列出的运算符前缀之一添加到“RegistryEntry” 、“SystemVariable” 或“EnvironmentVariable” 元素的“值”属性。
Powered by Discuz! X3.4
Copyright © 2001-2021, Tencent Cloud.
