AX2009初始化Twain DataSourceManager参数类型不兼容问题咨询

问题描述 #

在AX2009中添加twainScanner.dll引用后，对象初始化阶段报错："第1个参数与所需类型不兼容"。经确认TwainScanning.DataSourceManager构造函数需要传入WinForm Form类型参数，直接传入AX原生Form/FormRun对象无法满足类型要求，问题代码如下：

void openScannerForm()
{
    Args                                  args;
    FormRun                               formRun;
    TwainScanning.AppInfo                 app;
    TwainScanning.DataSourceManager       twainDSM;
    ;

    app = new TwainScanning.AppInfo();
    twainDSM = new TwainScanning.DataSourceManager(*HERE I HAVE A PROBLEM* , app); //this object require Form parameter, how to get it ?
}

解决方法 #

AX原生FormRun属于X++自身的窗体类型，和.NET WinForm的Form类型不在同一类型体系，不能直接传参。Twain组件实际只需要一个承载消息循环的父窗口句柄，通过System.Windows.Forms.NativeWindow包装AX窗体句柄即可符合参数要求，修改后代码如下：

void openScannerForm()
{
    Args                                  args;
    FormRun                               formRun;
    TwainScanning.AppInfo                 app;
    TwainScanning.DataSourceManager       twainDSM;
    System.Windows.Forms.NativeWindow     twainHostWindow;
    IntPtr                                axFormHandle;
    ;

    app = new TwainScanning.AppInfo();
    
    // 获取AX窗体句柄：如果当前方法写在窗体类内部，直接用this.hWnd()即可
    // 如果是外部调用，先获取对应窗体的FormRun实例，待窗体运行后取formRun.hWnd()
    axFormHandle = new IntPtr(this.hWnd());

    // 用NativeWindow关联AX窗体句柄，该类可被Twain组件识别为合法的Form类型参数
    twainHostWindow = new System.Windows.Forms.NativeWindow();
    twainHostWindow.AssignHandle(axFormHandle);

    // 传入包装后的窗口对象完成实例化
    twainDSM = new TwainScanning.DataSourceManager(twainHostWindow, app);

    // 后续扫描仪操作逻辑...

    // 使用完成后记得释放资源
    twainHostWindow.ReleaseHandle();
}

注意事项 #

• 禁止直接传入AX原生FormRun对象，必然触发类型不兼容错误
• 如果是在外部类/Job中调用，需要等FormRun执行完run()方法后再获取hWnd，否则拿到的句柄无效
• 操作结束后必须调用ReleaseHandle()解除句柄关联，避免内存泄漏

内容的提问来源于stack exchange，提问作者Ktas