自定义用户界面 （CUI） 托管 API （.NET）

开始

CUI 托管 API 提供了一个用于创建和操作 CUIx 文件的界面，并且不需要运行 AutoCAD。但是，当 API 在 AutoCAD 程序外部使用时，您的程序将无法访问 AutoCAD 运行时数据或其他运行时 API。

如果无法访问 AutoCAD 系统变量，则访问 AutoCAD 主文件和企业级 CUIx 文件可能会很棘手。主文件通常位于 C：\Documents and Settings\<users 配置文件>\Application Data\Autodesk\AutoCAD <release>\<version>\<language>\Support 文件夹中。在升级或用户为其自定义文件指定非默认路径时，对 CUIx 文件的位置进行硬编码会导致问题。

AcCui.dll文件包含 CUI 托管 API，位于 AutoCAD 安装目录中。将 AcCui.dll 文件引用到项目后，导入命名空间以访问 API 的类。Autodesk.AutoCAD.Customization

有关参照 AutoCAD Managed API 的库文件的信息，请参见“AutoCAD .NET API （.NET） 的组件”。

加载 CUIx 文件

必须通过将完整路径和文件名传递给类的构造函数来加载现有 CUIx 文件。这将解析文件并使用当前接口元素填充对象。在集合中包含大部分此类数据。CustomizationSectionMenuGroup

创建 .NET 插件时，可以从 MENUNAME 系统变量中检索 AutoCAD CUIx 主文件的完整路径。由于此系统变量返回的文件名不带扩展名，因此必须将扩展名显式添加到返回字符串中。除了主 CUIx 文件之外，还可以加载可选的企业级菜单。可从 ENTERPRISEMENU 系统变量访问加载的企业级菜单 CUIx 文件的名称。如果未加载企业级菜单 CUIx 文件，则将值 “.” 分配给 ENTERPRISEMENU 系统变量。.cuix

以下示例演示了如何获取主 CUIx 文件的完整路径。

VB.NET

Dim sMainCuiFile As String = Application.GetSystemVariable("MENUNAME")
sMainCuiFile = sMainCuiFile & ".cuix"
Dim oCs As CustomizationSection = New CustomizationSection(sMainCuiFile)

C#

string sMainCuiFile = (string)Application.GetSystemVariable("MENUNAME");
sMainCuiFile += ".cuix";
CustomizationSection oCs = new CustomizationSection(sMainCuiFile);

加载部分 CUIx 文件

部分 CUIx 文件是主文件或企业 CUIx 文件的有用扩展。这些可以与自定义部分中的 PartialCUIFiles 集合一起加载。此集合提供完整路径和文件名，扩展名为 .cuix。加载部分 CUIx 文件时，应用程序会评估 中的条目，以确保使用文件的完整路径。PartialCUIFileCollection

最好在部分 CUIx 文件中添加和删除工具栏和菜单，以保持应用程序自定义项的分离。在部分 CUIx 文件中定义唯一的菜单组，以避免与其他菜单组发生命名冲突。主 CUIx 文件中的默认组为“ACAD”。