string.html.toRtf 库模块帮助文档

设计要点

设计要点（面向 RichEdit 控件实测，而非 Word）：

RichEdit 不渲染段落边框 \brdr*，分隔线与标题下划线用单行单元格表格实现。
RichEdit 会为未声明的单元格边框画默认银灰网格，\brdrnone 无效，不想显示的边必须显式声明并把颜色设为背景色。
段落属性（\sb \sa \li 等）必须与结束该段的 \par 位于同一组内，写成 {\pard\sb200 标题}\par 则间距全部丢失。
RichEdit 忽略 \falt 备选字体，字体降级必须在生成时自行检测。
pageWidth 是可用宽度而非硬性上限：短表格不拉满，宽表格/长代码可超出并横向滚动。
宿主应启用 hscroll=1；再设置 wrap=true 可让普通正文换行，不妨碍超宽表格滚动。

string.html.toRtf 成员列表 #

string.html.toRtf.defaultCheckboxFont() #

返回复选框使用的系统 Unicode 符号字体名，优先 Segoe UI Symbol，其次 MS Gothic / Arial Unicode MS。
全部缺失返回 false，转换器改用 [x] / [ ] 保留状态。任务列表及 input checkbox 均不再依赖 FontAwesome；显式 fa 图标仍使用 FontAwesome

string.html.toRtf.defaultFont() #

返回当前系统自动选择的正文字体名（微软雅黑，不存在则降级为宋体）

string.html.toRtf.defaultMonoFont() #

返回当前系统自动选择的等宽字体名（Consolas，不存在则降级为 Courier New）

string.html.toRtf.defaults #

默认选项表，可直接修改以改变全局默认样式

string.html.toRtf.escapeRtf() #

将文本转换为 RTF 安全字符串，非 ASCII 字符转为 \uN? 控制字

string.html.toRtf.fitWidth(richedit控件,预留容差边距) #

根据 richedit 控件客户区的实际宽度计算并返回选项 pageWidth 的值( twips )，
参数 @2 可选指定预留的容差边距（逻辑像素），默认为 6

string.html 成员列表 #

string.html.toRtf() #

简单的 HTML 转 RTF 类库函数，需要导入才能使用。
本模块专为 string.markdown 生成的 HTML 设计，并面向 richedit 控件实测调优，
也可处理常见简单 HTML（标题/粗体/斜体/列表/链接/表格/代码块/引用等）。
不支持完整 HTML/CSS，不保证所有 HTML 都能正确转换。

参数 @1 指定 HTML，可选用参数 @2 指定选项表（可只指定部分字段，默认值见 string.html.toRtf.defaults）：
font 正文字体，monoFont 等宽字体，fontSize 正文磅值，codeFontSize 代码磅值，
lineSpacing 行距倍数，pageWidth 可用宽度( twips )，colors 颜色表( 0xRRGGBB )。
tableMinColumnWidth / tableMaxColumnWidth 指定列宽下限 / 首选上限( twips，默认 4em / 24em )。
短表格按内容收缩，宽表格允许超出 pageWidth；宿主应启用 hscroll=1，并可设置 wrap=true 使正文换行。
wrapCode 默认 false，长代码可扩展到 codeMaxWidth( 默认 30000 twips )，超长行再换行；设 true 则按 pageWidth 换行。
colors.inlineCodeBackground 默认浅灰色，设 false 关闭底色；不压缩文字行高

Markdown 格式