描述

设置页面参数。

  • 注意:不填表示不设置相关项
  • 也可以通过内置UI-页面设置修改相关参数

桌面版接口

bool SetPageConfig(const char* jsonCfg)
参数名 必填 类型 说明 备注
jsonCfg 是 string/obj

参数

{
    "width": "21.00",
    "height": "29.70",
    "topPadding": "2.54",
    "bottomPadding": "2.54",
    "leftPadding": "3.14",
    "rightPadding": "3.14",
    "fristPageDiff": false,
    "evenPageDiff": false,
    "apply": 0,
    "bindLine": {
        "margin": "0.00",
        "position": 2,
        "showLine": false
    },
    "body": {
        "locked": false,
        "dynamicLocked": false
    },
    "header": {
        "topMargin": "0.20",
        "hide": 0,
        "showLine": false,
        "locked": false,
        "dynamicLocked": false
    },
    "footer": {
        "bottomMargin": "0.30",
        "hide": 0,
        "showLine": false,
        "locked": false,
        "dynamicLocked": false
    }
}
参数名 必填 类型 说明 备注
width 否 float 页面宽
height 否 float 页面高
topPadding 否 float 上边距,页眉默认高度 注意为float, 数值1应写为1.0
bottomPadding 否 float 下边距,页脚默认高度 注意为float, 数值1应写为1.0
leftPadding 否 float 左边距 注意为float, 数值1应写为1.0
rightPadding 否 float 右边距 注意为float, 数值1应写为1.0
fristPageDiff 否 bool 页眉页脚首页不同 0:不使能1:使能
evenPageDiff 否 bool 页眉页脚奇偶页不同 0:不使能1:使能
apply 否 enum 应用于 详见 E_PAGE_SET_APPLY_MODE

bindLine

参数名 必填 类型 说明 备注
margin 否 float 装订线边距
position 否 enum 装订线位置 支持上(0)、下(1)、左(2)
showLine 否 bool 是否显示装订线

main

参数名 必填 类型 说明 备注
locked 否 bool 正文内段落被锁定,不可编辑 0:解锁 1:锁定
dynamicLocked 否 bool 正文内段落被锁定,不可编辑 0:解锁 1:锁定

header

参数名 必填 类型 说明 备注
topMargin 否 float 页眉顶端边距
hide 否 bool 是否隐藏页眉
showLine 否 bool 是否显示页眉线
locked 否 bool 页眉内段落被锁定,不可编辑 0:解锁 1:锁定
dynamicLocked 否 bool 页眉内段落被锁定,不可编辑 0:解锁 1:锁定

footer

参数名 必填 类型 说明 备注
bottomMargin 否 float 页脚底端边距
hide 否 bool 是否隐藏页脚
showLine 否 bool 是否显示页脚线
locked 否 bool 页脚内段落被锁定,不可编辑 0:解锁 1:锁定 配置保存到XML中
dynamicLocked 否 bool 页脚内内段落被锁定,不可编辑 0:解锁 1:锁定 配置不保存

返回值

类型 说明 备注
bool 是否有更新 1:有更新 0:无更新
文档更新时间: 2026-05-27 10:12   作者:admin