描述

配置表格、单元格、行、列、边框等参数。

接口

bool SetTableConfig(const char* id, const char* json_cfg)
参数名 必填 类型 说明 备注
id string 表格ID,为””时表示当前操作表格
json_cfg json 配置参数 桌面版为json字符串,web版为json对象

参数

{
    "id": "",
    "name": "",
    "width": "14.17",
    "height": "4.62",
    "lockedFormat": false,
    "alignHorizontalMode": 0,
    "leftIndent": "0.00",
    "topPadding": "0.03",
    "bottomPadding": "0.01",
    "leftPadding": "0.01",
    "rightPadding": "0.01",
    "border": {
        "borderSetMode": 2,
        "borderStyle": 1,
        "topBorderColor": "ffd9d9d9",
        "bottomBorderColor": "ffd9d9d9",
        "leftBorderColor": "ffd9d9d9",
        "rightBorderColor": "ffd9d9d9",
        "borderWidth": "0.02"
    },
    "cell": {
        "id": "",
        "name": "",
        "width": "3.44",
        "fitContent": 0,
        "alignVerticalMode": 0,
        "followTableCellPadding": true,
        "topPadding": "0.03",
        "bottomPadding": "0.03",
        "leftPadding": "0.03",
        "rightPadding": "0.03"
    },
    "row": {
        "height": "0.66",
        "adjustMode": 0,
        "forbidSplit": 0,
        "titleRow": 0,
        "enterGenerateNewRow": 0
    },
    "col": {
        "width": "3.44"
    }
}

表格

字段 类型 说明 备注
id string 表格id
name string 表格name
width float 表格宽度
height float 表格高度
lockedFormat bool 表格锁定 不允许拖动调整表格
alignHorizontalMode enum 当前对齐方式 可选项依据枚举E_ALIGN_HORIZONTAL_MODE数据构造
leftIndent float 左缩进
topPadding float 单元格默认-上边距
bottomPadding float 单元格默认-下边距
leftPadding float 单元格默认-左边距
rightPadding float 单元格默认-右边距
cell json obj 单元格属性 详见后续单元格章节
row json obj 行属性 详见后续行章节
col json obj 列属性 详见后续列章节
border json obj 边框属性 详见后续列章节
shading json obj 底纹属性 暂不支持

单元格

字段 类型 说明 备注
id string 单元格id
name string 单元格name
width float 单元格宽度
fitContent bool 内容自适应 固定行高时,单元格可配置该项
alignVerticalMode enum 当前纵向对齐方式 可选项依据枚举E_ALIGN_VERTICAL_MODE数据构造
followTableDefaultCellPadding bool 跟随表格默认单元格边距 0: 不跟随 1:跟随
topPadding float 单元格上边距
bottomPadding float 单元格下边距
leftPadding float 单元格左边距
rightPadding float 单元格右边距

字段 类型 说明 备注
height float 行高
adjustMode enum 行调整模式 E_ROW_ADJUST_MODE
forbidSplit bool 禁止分行 0:行跨页时自动拆分到不同页 1:不拆分
titleRow bool 是否为标题行
enterGenerateNewRow bool 是否回车产生新行

字段 类型 说明 备注
width float 列宽度

边框

字段 类型 说明 备注
apply string 本次边框设置应用于。该值由应用维护,取属性时没有该字段。设置时需要该字段。 “cell”:应用于单元格 “table”:应用于表格
borderSetMode enum 当前边框设置模式 只用于显示,设置时不需要该配置项E_BORDER_SET_MODE
borderStyle enum 当前边框线型 E_BORDER_STYLE
borderWidth float 边框宽度
backColor ARGB 背景色
topBorderColor ARGB 上边框颜色
bottomBorderColor ARGB 下边框颜色
leftBorderColor ARGB 左边框颜色
rightBorderColor ARGB 右边框颜色

返回值

类型 说明 备注
bool 是否有更新 0:设置失败 1:设置成功

示例代码

var tableCfg={};
/* 表格相关 */
tableCfg.id=
tableCfg.name=
tableCfg.width=
...略

/* 单元格相关 */
var cellCfg={};
tableCfg.cell=cellCfg;
cellCfg.id=
cellCfg.name=
cellCfg.fitContent=
...略

/* 行相关 */
var rowCfg={};
tableCfg.row=rowCfg;
row.height=
row.adjustMode=
...略

/* 列相关 */
var colCfg={};
tableCfg.col=colCfg;
row.width=
...略

/* 边框相关 */
var borderCfg={};
tableCfg.border=borderCfg;
borderCfg.width=

ThinkEditor.SetTableConfig("",tableCfg);
文档更新时间: 2025-03-05 19:58   作者:admin