Worksheet 接口

工作表接口代表工作簿中的单个工作表，提供单元格操作、格式化和工作表管理的全面功能。

类

class oo::iWorksheet

用于单元格操作、格式化和工作表配置的主要工作表接口。

尺寸和基本信息

int min_row() const

获取最小行号。

返回:

最小行号

int min_col() const

获取最小列号

返回:

最小列号

int max_row() const

获取最大行号

返回:

最大行号

int max_col() const

获取最大列号

返回:

最大列号

const char *name() const

获取工作表名称

返回:

工作表名称

bool set_name(const char *newname)

设置工作表名称

参数:

newname -- 工作表新名称

返回:

成功返回 true，名称无效或重复返回 false

SheetTypeEnum sheet_type() const

获取工作表类型

返回:

工作表类型

SheetStateEnum get_sheet_state() const

获取工作表的可见性状态。

返回:

可见性状态

单元格数据操作

CellTypeEnum cell_type(int row, int col) const

获取单元格的数据类型。

参数:

• row -- 行号

• col -- 列号

返回:

单元格数据类型

bool contains_formula(int row, int col) const

检查单元格是否包含公式。

参数:

• row -- 行号

• col -- 列号

返回:

如果单元格包含公式返回 true

bool contains_richtext(int row, int col) const

检查单元格是否包含富文本。

参数:

• row -- 行号

• col -- 列号

返回:

如果单元格包含富文本返回 true

数据检索方法

double get_num(int row, int col) const

从单元格获取数值。

参数:

• row -- 行号

• col -- 列号

返回:

数值

const char *get_text(int row, int col) const

从单元格获取文本值。

参数:

• row -- 行号

• col -- 列号

返回:

文本字符串

bool get_boolean(int row, int col) const

从单元格获取布尔值。

参数:

• row -- 行号

• col -- 列号

返回:

布尔值

double get_datetime(int row, int col) const

从单元格获取日期时间值。

参数:

• row -- 行号

• col -- 列号

返回:

以 double 类型表示的日期时间值

iRichtext *get_richtext(int row, int col) const

从单元格获取富文本。

参数:

• row -- 行号

• col -- 列号

返回:

指向富文本对象的指针

const char *get_formula_expr(int row, int col) const

从单元格获取公式表达式。

参数:

• row -- 行号

• col -- 列号

返回:

公式表达式字符串

ErrorCodeEnum get_error(int row, int col) const

从单元格获取错误代码。

参数:

• row -- 行号

• col -- 列号

返回:

错误代码

数据设置方法

bool set_num(int row, int col, double val)

在单元格中设置数值。

参数:

• row -- 行号

• col -- 列号

• val -- 要设置的数值

返回:

成功返回 true

bool set_text(int row, int col, const char *val)

在单元格中设置文本。

参数:

• row -- 行号

• col -- 列号

• val -- 要设置的文本字符串

返回:

成功返回 true

bool set_boolean(int row, int col, bool b)

在单元格中设置布尔值。

参数:

• row -- 行号

• col -- 列号

• b -- 要设置的布尔值

返回:

成功返回 true

bool set_datetime(int row, int col, double dt)

在单元格中设置日期时间。

参数:

• row -- 行号

• col -- 列号

• dt -- 以 double 类型表示的日期时间值

返回:

成功返回 true

bool set_richtext(int row, int col, iRichtext *rt)

在单元格中设置富文本。

参数:

• row -- 行号

• col -- 列号

• rt -- 要设置的富文本对象指针

返回:

成功返回 true

bool set_error(int row, int col, ErrorCodeEnum code)

在单元格中设置错误值。

参数:

• row -- 行号

• col -- 列号

• code -- 要设置的错误代码

返回:

成功返回 true

公式操作

bool set_formula(int row, int col, const char *expr)

在单元格中设置公式表达式。

参数:

• row -- 行号

• col -- 列号

• expr -- 公式表达式

返回:

成功返回 true

bool set_formula_num(int row, int col, double val)

设置公式的数值结果。

参数:

• row -- 行号

• col -- 列号

• val -- 公式结果的数值

返回:

成功返回 true

bool set_formula_string(int row, int col, const char *s)

设置公式的字符串值结果。

参数:

• row -- 行号

• col -- 列号

• s -- 公式结果的字符串值

返回:

成功返回 true

bool set_formula_boolean(int row, int col, bool b)

设置公式的布尔值结果。

参数:

• row -- 行号

• col -- 列号

• b -- 公式结果的布尔值

返回:

成功返回 true

bool set_formula_datetime(int row, int col, double dt)

设置公式的日期时间值结果。

参数:

• row -- 行号

• col -- 列号

• dt -- 公式结果的日期时间值

返回:

成功返回 true

bool set_formula_error(int row, int col, ErrorCodeEnum code)

设置公式的错误值结果。

参数:

• row -- 行号

• col -- 列号

• code -- 公式结果的错误代码

返回:

成功返回 true

void clear_contents(int begin_row, int begin_col, int end_row, int end_col)

清除范围内的单元格内容。

参数:

• begin_row -- 开始行号

• begin_col -- 开始列号

• end_row -- 终止行号

• end_col -- 终止列号

样式和格式化

void set_cell_style(int row, int col, iStyle *style)

设置单个单元格的样式。

参数:

• row -- 行号

• col -- 列号

• style -- 要应用的样式对象指针

iStyle *cell_style(int row, int col) const

获取特定单元格的样式。

参数:

• row -- 行号

• col -- 列号

返回:

指向单元格样式的指针

警告

为了节省内存，cell_style() 返回的指针指向同一个实例:

Style* s1 = cell_style(1, 1); //s1 is the format of cell (1,1)
Style* s2 = cell_style(2, 2); //s1 is the format of cell (2,2)

也就是说，在同一个 worksheet 中，所有调用 cell_style() 的返回值都是最后一次调用的返回值。如果需要各自不同的返回值，请调用 get_style()。

iStyle *get_style(int row, int col) const

获取特定单元格的样式。

参数:

• row -- 行号

• col -- 列号

返回:

指向有效样式的指针

备注

当返回的指针不再使用时，建议调用 release() 释放内存。

void set_range_style(int start_row, int start_col, int stop_row, int stop_col, iStyle *style)

设置单元格范围的样式。

参数:

• start_row -- 开始行号

• start_col -- 开始列号

• stop_row -- 终止行号

• stop_col -- 终止列号

• style -- 要应用的样式对象指针

行和列尺寸

bool is_default_row_height(int start, int end = 0) const

检查行高是否为默认高度。

参数:

• start -- 开始行号

• end -- 终止行号

返回:

如果行高为默认高度返回 true

bool get_custom_row_height(int start, int end, double *height, RowHeightUnitEnum unit = ROWHEIGHT_POINTS) const

获取自定义行高。

参数:

• start -- 开始行号

• end -- 终止行号

• height -- 存储高度值的指针

• unit -- 测量单位

返回:

如果行高为自定义高度返回 true

void set_custom_row_height(int start, int end, double height, RowHeightUnitEnum unit = ROWHEIGHT_POINTS)

设置自定义行高。

参数:

• start -- 开始行号

• end -- 终止行号

• height -- 要设置的高度值

• unit -- 测量单位

bool is_default_col_width(int start, int end = 0) const

检查列宽是否为默认宽度。

参数:

• start -- 开始列号

• end -- 终止列号(如果为0，仅检查起始列)

返回:

如果列宽为默认宽度返回 true

bool get_custom_col_width(int start, int end, double *width, ColWidthUnitEnum unit = COLWIDTH_CHARS) const

获取自定义列宽。

参数:

• start -- 开始列号

• end -- 终止列号

• width -- 存储宽度值的指针

• unit -- 测量单位

返回:

如果列宽为自定义列宽返回 true

void set_custom_col_width(int start, int end, double width, ColWidthUnitEnum unit = COLWIDTH_CHARS)

设置自定义列宽。

参数:

• start -- 开始列号

• end -- 终止列号

• width -- 要设置的宽度值

• unit -- 测量单位

行和列样式

iStyle *row_style(int row)

获取行样式。

参数:

row -- 行号

返回:

指向行样式的指针

void remove_row_style(int row)

移除行样式。

参数:

row -- 行号

void set_row_style(int start_row, int stop_row, iStyle *style)

设置行范围的样式。

参数:

• start_row -- 开始行号

• stop_row -- 终止行号

• style -- 要应用的样式对象指针

iStyle *col_style(int col)

获取列样式。

参数:

col -- 列号

返回:

指向列样式的指针

void remove_col_style(int col)

移除列样式。

参数:

col -- 列号

void set_col_style(int start_col, int stop_col, iStyle *style)

设置列范围的样式。

参数:

• start_col -- 开始列号

• stop_col -- 终止列号

• style -- 要应用的样式对象指针

可见性控制

bool row_hidden(int row) const

检查行是否隐藏。

参数:

row -- 行号

返回:

如果行隐藏返回 true

void set_row_hidden(int start_row, int stop_row, bool hidden = true)

设置行可见性。

参数:

• start_row -- 开始行号

• stop_row -- 终止行号

• hidden -- true 隐藏，false 显示

bool col_hidden(int col) const

检查列是否隐藏。

参数:

col -- 列号

返回:

如果列隐藏返回 true

void set_col_hidden(int start_col, int stop_col, bool hidden = true)

设置列可见性。

参数:

• start_col -- 开始列号

• stop_col -- 终止列号

• hidden -- true 隐藏，false 显示

行和列操作

bool insert_row(int row, int count = 1)

插入行。

参数:

• row -- 插入的位置

• count -- 要插入的行数

返回:

成功返回 true

bool delete_row(int begin, int end = 0)

删除行。

参数:

• begin -- 开始行号

• end -- 终止行号(如果为 0，仅删除起始行)

返回:

成功返回 true

bool insert_col(int col, int count = 1)

插入列。

参数:

• col -- 插入的位置

• count -- 要插入的列数

返回:

成功返回 true

bool delete_col(int begin, int end = 0)

删除列。

参数:

• begin -- 开始列号

• end -- 终止列号(如果为 0，仅删除起始列)

返回:

成功返回 true

范围移动操作

bool shift_range_down(int start_col, int end_col, int start_row, int count = 1)

向下移动范围。

参数:

• start_col -- 开始列号

• end_col -- 终止列号

• start_row -- 开始行号

• count -- 要移动的行数

返回:

成功返回 true

bool shift_range_up(int start_col, int end_col, int start_row, int count = 1)

向上移动范围。

参数:

• start_col -- 开始列号

• end_col -- 终止列号

• start_row -- 开始行号

• count -- 要移动的行数

返回:

成功返回 true

bool shift_range_right(int start_row, int end_row, int start_col, int count = 1)

向右移动范围。

参数:

• start_row -- 开始行号

• end_row -- 终止行号

• start_col -- 开始列号

• count -- 要移动的列数

返回:

成功返回 true

bool shift_range_left(int start_row, int end_row, int start_col, int count = 1)

向左移动范围。

参数:

• start_row -- 开始行号

• end_row -- 终止行号

• start_col -- 开始列号

• count -- 要移动的列数

返回:

成功返回 true

图像和背景

void set_bg_picture(const char *file)

设置背景图片。

参数:

file -- 图像文件(含路径)

int add_cell_image(const char *file, int start_row, int start_col, int stop_row, int stop_col)

在指定的单元格范围内添加图像。

参数:

• file -- 图像文件(含路径)

• start_row -- 起始行锚点

• start_col -- 起始列锚点

• stop_row -- 结束行锚点

• stop_col -- 结束列锚点

返回:

图像标识

int add_image_with_two_cells(const char *file, int row1, int col1, int row2, int col2, int offset_x1 = 0, int offset_y1 = 0, int offset_x2 = 0, int offset_y2 = 0)

在工作表中添加图像，以两个单元格定位图像。

参数:

• file -- 图像文件(含路径)

• row1 -- 左上角定位单元格的行号。

• col1 -- 左上角定位单元格的列号。

• row2 -- 右下角定位单元格的行号。

• col2 -- 右下角定位单元格的列号。

• offset_x1 -- 左上角定位单元格的水平偏移量(像素值)。

• offset_y1 -- 左上角定位单元格的垂直偏移量(像素值)。

• offset_x2 -- 右下角定位单元格的水平偏移量(像素值)

• offset_y2 -- 右下角定位单元格的垂直偏移量(像素值)。

返回:

所添加的图片的ID。

int add_image_with_one_cell(const char *file, int row, int col, int width = 0, int height = 0, double scale = 1.0, int offset_x = 0, int offset_y = 0)

在工作表中添加图片，以一个单元格定位图片。如果给定图片的长度和宽度均为 0，则根据 scale 参数计算图片的大小。

参数:

• file -- 图像文件(含路径)

• row -- 定位单元格的行号。

• col -- 定位单元格的列号。

• width -- 图像的宽度(像素)(0表示使用缩放参数计算大小)。

• height -- 图像的高度(像素)(0表示使用缩放参数计算大小)。

• scale -- 图像的缩放因子(当宽度和高度都为0时使用)。

• offset_x -- 定位单元格内的水平偏移(像素)。

• offset_y -- 定位单元格内的垂直偏移(像素)。

返回:

所添加的图片的ID。

int add_absolute_image(const char *file, int x, int y, int width = 0, int height = 0, double scale = 1.0)

在worksheet中添加图片，以像素坐标定位图片。如果给定的图片宽度和高度均为 0，则使用 scale 参数计算图片的大小。

参数:

• file -- 图像文件(含路径)

• x -- 图片左上角的 x 坐标(像素值)。

• y -- 图片左上角的 y 坐标(像素值)。

• width -- 图像的宽度(像素)(0表示使用缩放参数计算大小)。

• height -- 图像的高度(像素)(0表示使用缩放参数计算大小)。

• scale -- 图像的缩放因子(当宽度和高度都为0时使用)。

返回:

所添加的图片的ID。

int image_num() const

获取工作表中图片的数量。

返回:

图片数量。

int get_image_id(int index)

根据图像的顺序检索图片标识。

参数:

index -- 基于 0 的图片索引。

返回:

图片标识

ImageAnchorEnum image_anchor_type(int image_id)

获取图片的定位方式。

参数:

image_id -- 图片的标识。

返回:

ImageAnchorEnum 枚举值。

bool get_anchored_cell(int image_id, int *row, int *col)

检索以单个单元格定位的单元格行号和列号。

参数:

• image_id -- 图片的标识。

• row -- 存储行号的指针。

• col -- 存储列号的指针。

返回:

成功返回 true。

bool get_absolute_coord(int image_id, int *x, int *y)

检索以绝对坐标定位的坐标。

参数:

• image_id -- 图片的标识。

• x -- 存储 x 坐标的指针。

• y -- 存储 y 坐标的指针。

返回:

成功返回 true。

void delete_image(int image_id)

根据标识删除图片。

参数:

image_id -- 要删除的图片标识。

void remove_image(int row, int col)

删除以单个单元格定位的图片。

参数:

• row -- 定位单元格的行号。

• col -- 定位单元格的列号。

void remove_absolute_image(int x, int y)

删除以绝对坐标定位的图片。

参数:

• x -- 图片的 x 坐标 (像素值)。

• y -- 图片的 y 坐标 (像素值)。

单元格导航

bool first_data_cell(int *row, int *col) const

查找第一个有数据的单元格。

参数:

• row -- 存储行索引的指针

• col -- 存储列索引的指针

返回:

如果找到数据单元格返回 true

bool last_data_cell(int *row, int *col) const

查找最后一个有数据的单元格。

参数:

• row -- 存储行索引的指针

• col -- 存储列索引的指针

返回:

如果找到数据单元格返回 true

单元格合并

int merged_num() const

获取合并范围的数量。

返回:

合并范围的数量

bool merged_range(int index, int *start_row, int *start_col, int *stop_row, int *stop_col) const

获取合并范围。

参数:

• index -- 合并范围的索引

• start_row -- 存储合并起始行的指针

• start_col -- 存储合并起始列的指针

• stop_row -- 存储合并结束行的指针

• stop_col -- 存储合并结束列的指针

返回:

成功返回 true

bool merge(int start_row, int start_col, int stop_row, int stop_col)

合并范围内的单元格。

参数:

• start_row -- 开始行号

• start_col -- 开始列号

• stop_row -- 终止行号

• stop_col -- 终止列号

返回:

成功返回 true

bool unmerge(int row, int col)

取消指定位置的单元格合并。

参数:

• row -- 合并范围内的行索引

• col -- 合并范围内的列索引

返回:

成功返回 true

表格(列表对象)

int tabledef_count() const

获取工作表中表格的数量。

返回:

表格的数量

const char *get_tabledef_name(int index) const

按索引获取表格名称。

参数:

index -- 表格索引

返回:

表格名称

iTabledef *set_tabledef_name(int index, const char *newName)

设置表格名称。

参数:

• index -- 表格索引

• newName -- 新表格名称

返回:

指向表格对象的指针

iTabledef *get_tabledef(int index) const

按索引获取表格。

参数:

index -- 表格索引

返回:

指向表格对象的指针

iTabledef *get_tabledef_by_name(const char *name) const

按名称获取表格。

参数:

name -- 表格名称

返回:

指向表格对象的指针

iTabledef *add_tabledef(const char *name, int begin_row, int begin_col, int end_row, int end_col)

向工作表添加新表格。

参数:

• name -- 表格名称

• begin_row -- 开始行号

• begin_col -- 开始列号

• end_row -- 终止行号

• end_col -- 终止列号

返回:

指向新表格对象的指针

bool delete_tabledef(const char *name)

按名称删除表格。

参数:

name -- 要删除的表格名称

返回:

成功返回 true

分组和大纲

void group_rows(int begin_row, int end_row, bool collapsed = false)

分组行以创建大纲。

参数:

• begin_row -- 开始行号

• end_row -- 终止行号

• collapsed -- true 初始化折叠组

void ungroup_rows(int begin_row, int end_row)

取消行分组。

参数:

• begin_row -- 开始行号

• end_row -- 终止行号

void group_cols(int begin_col, int end_col, bool collapsed = true)

分组列以创建大纲。

参数:

• begin_col -- 开始列号

• end_col -- 终止列号

• collapsed -- true 初始化折叠组

void ungroup_cols(int begin_col, int end_col)

取消列分组。

参数:

• begin_col -- 开始列号

• end_col -- 终止列号

int row_outline_level(int row, bool *collapsed = nullptr) const

获取行大纲级别。

参数:

• row -- 行号

• collapsed -- 存储折叠状态的指针

返回:

大纲级别

int col_outline_level(int col, bool *collapsed = nullptr) const

获取列大纲级别。

参数:

• col -- 列号

• collapsed -- 存储折叠状态的指针

返回:

大纲级别

int max_row_outline_level() const

获取最大行大纲级别。

返回:

最大大纲级别

int max_col_outline_level() const

获取最大列大纲级别。

返回:

最大大纲级别

void delete_row_outline()

移除所有行大纲。

void delete_col_outline()

移除所有列大纲。

bool group_summary_below() const

检查摘要行是否在详细信息下方。

返回:

如果摘要在下部返回 true

void set_group_summary_below(bool below)

设置摘要行位置。

参数:

below -- true 摘要在下部，false 在上部

bool group_summary_right() const

检查摘要列是否在详细信息右侧。

返回:

如果摘要在右侧返回 true

void set_group_summary_right(bool right)

设置摘要列位置。

参数:

right -- true 摘要在右侧，false 在左侧

超链接

bool add_hyperlink(const char *hyperlink, int start_row, int start_col, int end_row, int end_col)

向单元格范围添加超链接。

参数:

• hyperlink -- URL 或链接地址

• start_row -- 开始行号

• start_col -- 开始列号

• end_row -- 终止行号

• end_col -- 终止列号

返回:

成功返回 true

int hyperlink_num() const

获取超链接数量。

返回:

超链接数量

int hyperlink_index(int row, int col) const

获取单元格的超链接索引。

参数:

• row -- 行号

• col -- 列号

返回:

超链接索引，未找到返回 -1

const char *hyperlink(int index, int *start_row, int *start_col, int *end_row, int *end_col)

获取超链接信息。

参数:

• index -- 超链接索引

• start_row -- 存储起始行的指针

• start_col -- 存储起始列的指针

• end_row -- 存储结束行的指针

• end_col -- 存储结束列的指针

返回:

超链接地址

bool delete_hyperlink(int index)

删除超链接。

参数:

index -- 要删除的超链接索引

返回:

成功返回 true

工作表保护

bool is_protected() const

检查工作表是否受保护。

返回:

如果受保护返回 true

bool protect(SheetProtectEnum item = PROTECT_DEFAULT, const char *password = nullptr)

保护工作表。

参数:

• item -- 保护选项

• password -- 可选密码

返回:

成功返回 true

void unprotect()

取消工作表保护。

bool protect_range(int start_row, int start_col, int end_row, int end_col)

保护特定单元格范围。

参数:

• start_row -- 开始行号

• start_col -- 开始列号

• end_row -- 终止行号

• end_col -- 终止列号

返回:

成功返回 true

bool set_editable_range(int start_row, int start_col, int end_row, int end_col)

在受保护的工作表上允许编辑特定范围。

参数:

• start_row -- 开始行号

• start_col -- 开始列号

• end_row -- 终止行号

• end_col -- 终止列号

返回:

成功返回 true

int editable_range_count() const

获取可编辑范围的数量。

返回:

可编辑范围数量

const char *get_editable_range(int index, int *start_row = nullptr, int *start_col = nullptr, int *stop_row = nullptr, int *stop_col = nullptr) const

获取可编辑范围的信息。

参数:

• index -- 可编辑范围的索引

• start_row -- 存储起始行的指针

• start_col -- 存储起始列的指针

• stop_row -- 存储结束行的指针

• stop_col -- 存储结束列的指针

返回:

范围名称

bool delete_editable_range(int index)

删除一个可编辑范围。

参数:

index -- 要删除的可编辑范围索引

返回:

成功返回 true

视图设置

int zoom() const

获取工作表缩放级别。

返回:

缩放百分比

void set_zoom(int zoom)

设置工作表缩放级别。

参数:

zoom -- 缩放百分比

bool right_to_left() const

检查是否启用从右到左显示。

返回:

如果从右到左返回 true

void set_right_to_left(bool right_to_left = true)

设置从右到左显示模式。

参数:

right_to_left -- true 从右到左，false 从左到右

void topleft_cell(int *row, int *col) const

获取左上角可见单元格。

参数:

• row -- 存储行索引的指针

• col -- 存储列索引的指针

void set_topleft_cell(int row, int col)

设置左上角可见单元格。

参数:

• row -- 行号

• col -- 列号

void active_cell(int *row, int *col) const

获取活动单元格位置。

参数:

• row -- 存储行索引的指针

• col -- 存储列索引的指针

void set_active_cell(int row, int col)

设置活动单元格。

参数:

• row -- 行号

• col -- 列号

void split_cell(int *row, int *col) const

获取拆分位置。

参数:

• row -- 存储拆分行的指针

• col -- 存储拆分列的指针

void set_split_cell(int row, int col)

设置拆分位置。

参数:

• row -- 拆分行索引

• col -- 拆分列索引

bool display_gridlines() const

检查是否显示网格线。

返回:

如果网格线可见返回 true

void set_display_gridlines(bool show = true)

设置网格线可见性。

参数:

show -- true 显示网格线，false 隐藏

分页符

int row_break_count() const

获取行分页符数量。

返回:

行分页符数量

int row_break(int index) const

获取行分页符位置。

参数:

index -- 分页符索引

返回:

分页符的行索引

bool set_row_break(int row, bool pageBreak = true)

设置行分页符。

参数:

• row -- 分页符的行索引

• pageBreak -- true 为分页符，false 为手动分页符

返回:

成功返回 true

int col_break_count() const

获取列分页符数量。

返回:

列分页符数量

int col_break(int index) const

获取列分页符位置。

参数:

index -- 分页符索引

返回:

分页符列索引

bool set_col_break(int col, bool pageBreak = true)

设置列分页符。

参数:

• col -- 分页符的列索引

• pageBreak -- true 为分页符，false 为手动分页符

返回:

成功返回 true

打印设置

bool print_gridlines() const

检查是否打印网格线。

返回:

如果打印网格线返回 true

void set_print_gridlines(bool print = true)

设置网格线打印。

参数:

print -- true 打印网格线

bool print_headings() const

检查是否打印标题。

返回:

如果打印标题返回 true

void set_print_headings(bool print = false)

设置标题打印。

参数:

print -- true 打印标题

bool h_centered_printing() const

检查是否启用水平居中打印。

返回:

如果水平居中返回 true

void set_h_centered_printing(bool centered = true)

设置水平居中打印。

参数:

centered -- true 水平居中

bool v_centered_printing() const

检查是否启用垂直居中打印。

返回:

如果垂直居中返回 true

void set_v_centered_printing(bool centered = true)

设置打印垂直居中。

参数:

centered -- true 垂直居中

页边距

double left_margin() const

获取左边距。

返回:

边距值"

void set_left_margin(double value)

设置左边距。

参数:

value -- 边距值

double right_margin() const

获取右边距。

返回:

右边距值

void set_right_margin(double value)

设置右边距。

参数:

value -- 边距值

double top_margin() const

获取上边距。

返回:

上边距值

void set_top_margin(double value)

设置上边距。

参数:

value -- 边距值

double bottom_margin() const

获取下边距。

返回:

下边距值

void set_bottom_margin(double value)

设置下边距。

参数:

value -- 边距值

double header_margin() const

获取页眉边距。

返回:

页眉边距值

void set_header_margin(double value)

设置页眉边距。

参数:

value -- 边距值

double footer_margin() const

获取页脚边距。

返回:

页脚边距值

void set_footer_margin(double value)

设置页脚边距。

参数:

value -- 边距值

页面设置

int paper() const

获取纸张大小代码。

返回:

纸张大小代码

bool set_paper(int paper_code)

设置纸张大小。

参数:

paper_code -- 纸张大小代码

返回:

成功返回 true

int print_scale() const

获取打印缩放比例。

返回:

打印缩放百分比

void set_print_scale(int zoom)

设置打印缩放比例。

参数:

zoom -- 缩放百分比

PageOrientEnum page_orientation() const

获取页面方向。

返回:

页面方向

void set_page_orientation(PageOrientEnum orientation)

设置页面方向。

参数:

orientation -- 要设置的方向

PrintErrorEnum print_errors() const

获取错误打印方法。

返回:

错误打印方法

void set_print_errors(PrintErrorEnum way)

设置错误打印方式。

参数:

way -- 错误打印方法

int fit_page_height() const

获取适应页面高度设置。

返回:

适应的高度页数

void set_fit_page_height(int num)

设置适应页面高度。

参数:

num -- 适应的高度页数(0禁用)

int fit_page_width() const

获取适应页面宽度设置。

返回:

适应的宽度页数

void set_fit_page_width(int num)

设置适应页面宽度。

参数:

num -- 适应的宽度页数(0禁用)

页眉和页脚

const char *page_header() const

获取页眉。

返回:

页眉文本

void set_page_header(const char *header)

设置页眉。

参数:

header -- 页眉文本

const char *page_footer() const

获取页脚。

返回:

页脚文本

void set_page_footer(const char *footer)

设置页脚。

参数:

footer -- 页脚文本

使用示例

#include "oosxl.hxx"

// Get worksheet from workbook
oo::iWorksheet* sheet = workbook->get_sheet(0);

// Set cell values
sheet->set_text(0, 0, "Name");
sheet->set_text(0, 1, "Age");
sheet->set_num(1, 0, 25.5);
sheet->set_boolean(1, 1, true);

// Apply styles
oo::iStyle* headerStyle = workbook->make_normal_style();
headerStyle->set_bold(true);
sheet->set_range_style(0, 0, 0, 1, headerStyle);

// Merge cells
sheet->merge(0, 0, 0, 2);

// Add hyperlink
sheet->add_hyperlink("https://example.com", 2, 0, 2, 0);