Style 接口 — oosxl 0.1.0 文档

# 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()

    释放样式对象并清理相关资源。

    备注

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

Styled using the Piccolo Theme