CDR插件开发教程之Application.ActiveDocument（应用程序.活动文档）

在 CorelDRAW（简称 CDR）的插件开发中，Application.ActiveDocument 是一个非常重要的属性，它允许开发者访问当前活动的文档。CorelDRAW 提供了一个强大的自动化接口，可以让开发者使用诸如 VBA (Visual Basic for Applications)、C++、.NET 等语言来编写扩展程序和插件。

Application.ActiveDocument 详解：

• 所属对象：Application 对象是 CorelDRAW 自动化模型的根对象，它代表了 CorelDRAW 应用程序实例。
• 属性功能：ActiveDocument 属性返回一个 Document 对象，该对象代表当前由用户激活或选定的文档。如果当前没有文档打开，则此属性返回 Nothing（在 VBA 中）或者 null（在其他编程语言中）。

使用场景示例：

1. 获取文档信息：

   • 获取当前文档的页面数量、尺寸等。

2. 操作文档元素：

   • 添加、删除或修改图形对象。
   • 改变页面布局或背景颜色。

3. 自动化工作流程：

   • 执行批量处理任务，比如导出所有页面为 PDF 文件。

示例代码（VBA）：

Sub Example()
    Dim doc As Document
    Set doc = Application.ActiveDocument
    
    If Not doc Is Nothing Then
        MsgBox "当前文档名称: " & doc.Name
        ' 进行更多操作...
    Else
        MsgBox "没有打开任何文档。"
    End If
End Sub

示例代码（C#）：

using System;
using Corel.Interop.VGCore; // 请确保你引用的是正确的 CorelDRAW 版本的 COM 组件

public class Program {
    
    // 这里只是例子演示，实际情况下是不能在Main方法中运行的
    public static void Main(string[] args) {
        try {
            // 检查是否有活动文档
            Document activeDoc = Application.ActiveDocument;
            if (activeDoc != null) {
                Console.WriteLine("当前文档名称: " + activeDoc.Name);
                // 进行更多操作...
            } else {
                Console.WriteLine("没有打开任何文档。");
            }
        } catch (Exception ex) {
            Console.WriteLine("发生错误: " + ex.Message);
        }
    }
}

上述代码首先检查是否有活动文档，如果有，则显示文档的名称；如果没有，则提示用户没有打开任何文档。

注意事项：

• 在进行任何涉及文档的操作之前，务必检查 Application.ActiveDocument 是否返回有效值。
• 处理多个文档时，可能需要考虑更复杂的逻辑以确保正确处理目标文档。