Document 接口

Document 接口表示管理 Excel 工作簿的主文档对象。

类 (Classes)

class oo::iDocument

用于创建和管理 Excel 工作簿的主要文档接口。

oo::iWorkbook *get_workbook()

获取与此文档关联的工作簿。

返回:

指向工作簿的指针

bool save(const char *filename = nullptr)

将文档保存到文件。

参数:

filename -- 保存文档的文件名(含路径)。如果为 null，则保存到当前文件。

返回:

成功返回 true，否则返回 false

void release()

释放文档并清理相关资源。

警告

当不再需要文档时应调用此方法，以防止内存泄漏。

全局函数

oo::iDocument *create_document()

创建一个新的空文档。

返回:

指向新创建文档的指针

oo::iDocument *load_document(const char *filename)

从文件加载现有文档。

参数:

filename -- 要加载的 Excel 文件(含路径)

返回:

指向已加载文档的指针，失败返回 nullptr

const char *lib_version()

获取库版本字符串。

返回:

包含库版本信息的常量字符串

使用示例

#include "oosxl.hxx"

// Create a new document
oo::iDocument* doc = create_document();

if (doc) {
    // Get workbook and work with sheets
    oo::iWorkbook* workbook = doc->get_workbook();

    // Perform operations...

    // Save document
    doc->save("example.xlsx");

    // Clean up
    doc->release();
}