CAD开发者社区 › 首页 ›AutoCAD开发文档› AutoCAD 2024 开发者帮助 › 查看内容

AutoCAD 2024 开发者帮助

使用 Microsoft Visual Studio 设置 ObjectARX 项目

2024-5-18 19:11| 发布者: admin| 查看: 187| 评论: 0|原作者: admin|来自: AutoCAD

构建 ObjectARX 应用程序的第一步是在 Microsoft Visual Studio 中设置项目。本节列出了构建基本 ObjectARX 应用程序所需的项目设置和最少文件。

或者，您可以使用 ObjectARX Wizards for AutoCAD 创建新的 ObjectARX 项目，您可以从 ObjectARX utils\ObjARXWiz 目录安装该项目。

注意：ObjectARX 向导已从 ObjectARX SDK 中删除。您可以在 AutoCAD 开发人员中心找到最新版本。

对项目使用以下设置

将应用程序类型设置为 DLL。
指定 ObjectARX 库并包含文件位置。
执行此操作的最简单方法是将 ObjectARX 包含和库目录添加到 MSVC++ 环境设置中（在 Microsoft Visual Studio 菜单中的“工具”、“选项”、“项目和解决方案”、“VC++ 目录”下）。您还可以在“项目属性”中指定位置，但需要包含您创建的每个项目的文件的完整路径。
对于所有配置（调试和发布），请设置用于链接到多线程 DLL 的运行时库（在项目的“属性页”中的“配置属性”文件夹 C/C++ 文件夹“代码生成运行时库”下）。
对于所有配置（调试和发布），将“检测 64 位可移植性问题”选项设置为“否”（在项目的“属性页”中，在“配置属性 C/C++”文件夹“常规检测 64 位可移植性问题”下）。此设置禁止针对不兼容 64 位的指针分配的编译器警告 4311。某些 ObjectARX 头文件包含此类赋值。
如果您愿意，可以改用语句来控制此警告。有关语句的详细信息，请参阅 Microsoft 文档。#pragma warning#pragma warning
将输出文件名（在项目的“属性页”中的“配置属性链接器常规输出文件”下）设置为扩展名为 .arx 的名称。如果在项目中包含带有 LIBRARY 语句的 DEF 文件，则此名称应与 LIBRARY 值匹配。
注意：LIBRARY 语句在 DEF 文件中是可选的。
添加程序所需的 ObjectARX 库（在项目的“属性页”中的“配置属性”“链接器输入”其他依赖项“下）。
例如，下面显示的最小代码需要 rxapi.lib 和 acdb24.lib。

您需要将源文件添加到新项目中。如果您已有源文件或正在使用示例程序源文件，请添加这些文件。

此示例显示了创建 ObjectARX 程序所需的最少代码。

将新的 C++ 源文件添加到项目中，然后输入以下代码：

#include "rxregsvc.h"
#include "acutads.h"
// Simple acrxEntryPoint code. Normally intialization and cleanup
// (such as registering and removing commands) should be done here.
//
extern "C" AcRx::AppRetCode
acrxEntryPoint(AcRx::AppMsgCode msg, void* appId)
{
    switch(msg) {
    case AcRx::kInitAppMsg:
        // Allow application to be unloaded
        // Without this statement, AutoCAD will
        // not allow the application to be unloaded
        // except on AutoCAD exit.
        //
        acrxUnlockApplication(appId);
        // Register application as MDI aware. 
        // Without this statement, AutoCAD will
        // switch to SDI mode when loading the
        // application.
        //
        acrxRegisterAppMDIAware(appId);
        acutPrintf("\nExample Application Loaded");
    break;
    case AcRx::kUnloadAppMsg:
        acutPrintf("\nExample Application Unloaded");
    break;
    }
    return AcRx::kRetOK;
}

该项目还需要一个定义文件。将新的文本文件添加到项目中，并使用 .def 扩展名命名它。

在 DEF 文件中输入以下代码

LIBRARY "objectarx_program_name.arx"
EXPORTS
    acrxEntryPoint PRIVATE
    acrxGetApiVersion PRIVATE

EXPORTS 部分应存在，并且必须至少包含该函数（除非已使用其他机制导出此函数，如 Windows 约定）。acrxEntryPoint_declspec(dllexport)

在 DEF 文件中使用 PRIVATE 可防止这些符号出现在此 ObjectARX 应用程序的导入库中。该符号仍将显示在应用程序的导出表中，允许 AutoCAD 查找和调用该符号。这一点很重要，因为每个 ObjectARX 应用程序或 Object Enabler 都必须有自己的这些函数实现。应用程序通过链接到静态库 rxapi.lib 来获取实现。如果 ObjectARX 应用程序 app2 通过链接到 app1.lib 来使用 ObjectARX 应用程序 app1 中的符号，则 app2 从 app1 导入库中获取其定义将是一个错误。在 DEF 文件中使用 PRIVATE 将防止这种情况。在链接到另一个 ObjectARX 应用程序的任何导入库之前，确保链接到 rxapi.lib 也可以防止这种情况发生。acrxGetApiVersionacrxGetApiVersion

LIBRARY 名称应与要创建的 ObjectARX 文件的文件名匹配，并且必须显示 .arx 扩展名。例如，如果所需的输出文件名为 test.arx，则 DEF 文件中的 LIBRARY 语句应显示全名 test.arx。

注意：如果您愿意，可以在项目中包含标准 ObjectARX DEF 文件 AcRxDefault.def。此文件定义了所需的 ObjectARX 正确导出，位于 \inc SDK 目录中。它不使用 LIBRARY 语句。

添加这两个源文件后，可以构建基本的 ObjectARX 应用程序。