描述
配置表格、单元格、行、列、边框等参数。
接口
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