Style 接口

Style 接口代表单元格格式属性，包括数字格式、字体、边框、填充、对齐方式和保护设置。

类

class oo::iStyle

管理数字格式、字体、边框、填充、对齐方式和保护的单元格格式接口。

数字格式

int set_numfmt_code(const char *numFmtCode)

设置内置或自定义数字格式代码。

参数:: numFmtCode -- 自定义数字格式字符串(例如："0.00", "mm/dd/yyyy")
返回:: 成功返回格式 ID，失败返回 -1

const char *numfmt_code() const

获取数字格式代码。

返回:: 数字格式代码字符串

int numfmt_id() const

获取数字格式 ID。

返回:: 数字格式 ID

bool set_numfmt_id(int numFmtId)

通过格式 ID 设置内置或自定义数字格式。

参数:: numFmtId -- 数字格式标识
返回:: 成功返回 true

字体属性

void set_font(const char *name, int fontSize = 0)

设置字体名称和大小。

参数:

name -- 字体名称
fontSize -- 字体大小(磅值)(0 保持当前大小)

const char *font_name() const

获取字体名称。

返回:: 字体名称

int font_size() const

获取字体大小。

void set_font_size(int size)

设置字体大小。

参数:: size -- 字体大小(磅值)

bool italic() const

检查字体是否为斜体。

返回:: 如果是斜体返回 true

void set_italic(bool italic = true)

设置斜体字体样式。

参数:: italic -- true 为斜体，false 为正常

bool strikeout() const

检查字体是否有删除线。

返回:: 如果启用删除线返回 true

void set_strikeout(bool strikeOut = true)

设置删除线字体样式。

参数:: strikeOut -- true 为删除线，false 为正常

COLORREF font_color() const

获取字体颜色。

返回:: 字体颜色(COLORREF 格式)

void set_font_color(COLORREF color)

设置字体颜色。

参数:: color -- 字体颜色(COLORREF 格式)

bool bold() const

检查字体是否为粗体。

返回:: 如果是粗体返回 true

void set_bold(bool bold = true)

设置粗体字重。

参数:: bold -- true 为粗体，false 为正常

VertAlignRunEnum font_vert_align() const

获取字体垂直对齐方式。

返回:: 垂直对齐类型

void set_font_vert_align(VertAlignRunEnum v_alignRun)

设置字体垂直对齐方式。

参数:: v_alignRun -- 垂直对齐类型

UnderlineEnum underlined() const

获取下划线样式。

返回:: 下划线类型

void set_underline(UnderlineEnum underline)

设置下划线样式。

参数:: underline -- 下划线类型

边框属性

BorderStyleEnum border(BorderIndexEnum index) const

获取特定边的边框样式。

参数:: index -- 边框的边标识符
返回:: 边框样式

bool set_border(BorderIndexEnum index, BorderStyleEnum style)

设置特定边的边框样式。

参数:

index -- 边框的边标识符
style -- 边标识符

返回:

成功返回 true

COLORREF border_color(BorderIndexEnum index) const

获取特定边的边框颜色。

参数:: index -- 边框的边标识符
返回:: 边框颜色(COLORREF 格式)

bool set_border_color(BorderIndexEnum index, COLORREF color)

设置特定边的边框颜色。

参数:

index -- 边框的边标识符
color -- 要设置的边框颜色

返回:

成功返回 true

填充和图案属性

PatternTypeEnum fill_pattern() const

获取填充图案类型。

返回:: 填充图案类型

void set_fill_pattern(PatternTypeEnum pattern)

设置填充图案类型。

参数:: pattern -- 填充图案类型

COLORREF pattern_fg_color() const

获取图案前景色。

返回:: 前景色(COLORREF 格式)

void set_pattern_fg_color(COLORREF color)

设置图案前景色。

参数:: color -- 前景色

COLORREF pattern_bg_color() const

获取图案背景色。

返回:: 背景色(COLORREF 格式)

void set_pattern_bg_color(COLORREF color)

设置图案背景色。

参数:: color -- 背景色

对齐属性

HAlignEnum align_h() const

获取水平对齐方式。

返回:: 水平对齐类型

void set_align_h(HAlignEnum h_alignment)

设置水平对齐方式。

参数:: h_alignment -- 水平对齐类型

VAlignEnum align_v() const

获取垂直对齐方式。

返回:: 垂直对齐类型

void set_align_v(VAlignEnum v_alignment)

设置垂直对齐方式。

参数:: v_alignment -- 垂直对齐类型

bool wrap() const

检查是否启用文本换行。

返回:: 如果启用文本换行返回 true

void set_wrap(bool wrap = true)

设置文本换行。

参数:: wrap -- true 启用文本换行

int rotation() const

获取文本旋转角度。

返回:: 文本旋转角度(度)

void set_rotation(int rotation)

设置文本旋转。

参数:: rotation -- 文本旋转角度(-90 到 90 度)

int indent() const

获取文本缩进的字符数。

返回:: 缩进的字符数

void set_indent(int indent)

设置文本缩进的字符数。

参数:: indent -- 缩进的字符数

bool shrink_to_fit() const

检查是否启用缩小填充。

返回:: 如果启用缩小填充返回 true

void set_shrink_to_fit(bool shrinkToFit = true)

设置缩小填充属性。

参数:: shrinkToFit -- true 启用缩小填充

保护属性

bool locked() const

检查单元格是否锁定。

返回:: 如果单元格锁定返回 true

void set_locked(bool locked = true)

设置单元格锁定状态。

参数:: locked -- true 锁定单元格

bool hidden() const

检查单元格是否隐藏。

返回:: 如果单元格隐藏返回 true

void set_hidden(bool hidden = true)

设置单元格的可见属性

参数:: hidden -- true 隐藏单元格

样式移除方法

void unapply_numfmt(): 从样式中移除数字格式。

void unapply_font(): 从样式中移除字体格式。

void unapply_fill(): 从样式中移除填充格式。

void unapply_border(): 从样式中移除边框格式。

void unapply_alignment(): 从样式中移除对齐格式。

void unapply_protection(): 从样式中移除保护格式。

void unapply_all(): 从样式中移除所有格式。

资源管理

void release(): 释放样式对象并清理相关资源。

备注

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