ComponentEntry 元素
 
 
 

ComponentEntry 元素是必需的,用于指定关于“组件”元素中各个组件的详细信息。

可以根据需要指定任意多个 ComponentEntry 元素。组件类型可以是以下文件格式之一:

如果 LoadReasons 属性设置为 LoadOnCommandInvocation,则 ComponentEntry 元素可能包含 “命令”元素

注意ComponentEntry 元素以所列出的顺序加载,但自下而上。因此,其他组件所从属的任何文件都必须在列表的底部。例如,如果 ObjectARX 模块从属于 ObjectDBX 模块,则 ObjectARX 模块在列表中需要出现在 ObjectDBX 模块的上面。

ComponentEntry 元素可以有以下任一附着属性:

属性

说明

应用程序名称

对于 AutoLISP 可选;对于 ObjectARX 和 .NET 必需 - 组件的名称;与 ObjectARX API AcadAppInfo 类中的“应用程序名称”相同。

应用程序说明

组件的说明;与 ObjectARX API AcadAppInfo 类中的 AppDescription 相同。

AppType

组件类型;替代源自 ModuleName 属性中提供的文件扩展名的类型。

组件类型可以是以下类型之一:

  • Arx – ObjectARX
  • Cui 或 CuiX – 局部自定义
  • Mnu – 菜单自定义
  • Dbx – ObjectDBX
  • .NET – 受管或混合 .NET 部件
  • LISP 或 CompiledLisp – AutoLISP
  • 套装 – 套装软件包
  • 从属关系 – 资源 DLL(不会加载到 AutoCAD)

模块名称

程序包中组件的相对路径;与 ObjectARX API AcadAppInfo 类中的 ModuleName 相同。

组件类型由文件的扩展名确定:

  • .arx – ObjectARX
  • .cuix - 局部自定义
  • .dbx – ObjectDBX
  • .dll – 受管 .NET 部件
  • .lsp.fas.vlx – AutoLISP

该应用程序将处理特定组件的多种语言的不同版本,以支持可以通过将“模块名称”与区域设置代码组合在一起而指定的不同的语言。有关支持的区域设置代码的完整列表,请参见 支持的区域设置代码

注意所有路径指定符为“/”和“\”,路径相对于根 .bundle 文件夹。

每文档

仅对于 AutoLISP - 当为“真”时,每个文档加载 AutoLISP 文件一次。默认值为“真”。

Loadreasons

可以指定多个值 - 使用 Loadreasons 定义组件的加载行为参数,除了 LoadOnCommandInvocation 参数。

默认情况下,如果 LoadReasons 未指定,LoadOnAutoCADStartup、LoadOnAppearance 和 LoadOnProxy 处于启用状态(设置为“真”)。如果需要禁用参数(设置为“假”),则 LoadReasons 元素必须与设置为“假”的参数一起指定。

默认情况下,LoadOnCommandInvocation 处于禁用状态,启用它将禁用 LoadOnAutoCADStartup 和 LoadOnAppearance,除非明确启用。

有关 AcadAppInfo LoadReasons 的完整的详细信息,请参见 《ObjectARX 参考手册》。

有效参数值:

  • 真 - 参数已启用。
  • 假 - 参数已禁用。

可以使用下列参数:

  • LoadOnCommandInvocation。仅在调用自定义命令时加载。当使用此参数时,“命令”元素元必须包括在内。如果启用了 LoadOnCommandInvocation,则 LoadOnAutoCADStartup 和 LoadOnAppearance 都假定为禁用,除非明确启用。仅适用于 ObjectARX 和 .NET 模块。
    注意对于 AutoCAD 启动性能原因,在组件定义命令时使用此选项非常重要。
  • LoadOnAutoCADStartup -(仅适用于 ObjectARX 和 .NET 模块)。在 AutoCAD 启动时加载。如果已指定,此参数优先于其他所有参数。建议仅当没有任何其他参数适用时,才使用 LoadOnAutoCADStartup,只要有可能就将其禁用(将其设置为“假”)。如果 LoadOnAutoCADStartup 参数被省略,则将其默认为启用(设置为“真”),除非 LoadOnCommandInvocation 已启用,在这种情况下 LoadOnAutoCADStartup 默认为“假”。
  • LoadOnProxyDetection。当检测到自定义图元的代理时加载。默认情况下,启用此参数,除非明确禁用(设置为“假”)。当启用时(设置为“真”),LoadOnAutoCADStartup 应处于禁用状态。仅适用于 ObjectDBX 文件。
  • LoadOnAppearance。当产品在其中一个 ApplicationPlugins 文件夹中检测到应用程序包时加载,从而支持在安装时即时加载而无需重新启动 AutoCAD。参数的行为方式与 LoadOnAutoCADStartup 相同,除了加载上下文与在产品运行的同时何时安装应用程序相关(例如,如果通过 AutoCAD Exchange 上的“应用程序”选项卡安装)。