mlreportgen.dom.ColSep 类

命名空间: mlreportgen.dom

在表格列之间绘制线

全页展开

描述

在表格列之间画线。

mlreportgen.dom.ColSep 类是一个 handle 类。

创建对象

描述

colSepObj = ColSep 创建未指定的列分隔符。

colSepObj = ColSep(style) 创建指定样式的列分隔符。

colSepObj = ColSep(style,color) 创建具有指定样式和颜色的列分隔符。

colSepObj = ColSep(style,color,width) 创建具有指定样式、颜色和宽度的列分隔符。

示例

输入参量

全部展开

`style` — 表格中列分隔符的样式
字符向量

表格列分隔符的样式，指定为以下值之一。

值	支持 DOCX	支持 HTML 和 PDF
`'dashed'`	是	是
`'dashdotstroked'`	是	否
`'dashsmallgap'`	是	否
`'dotted'`	是	是
`'dotdash'`	是	否
`'dotdotdash'`	是	否
`'double'`	是	是
`'doublewave'`	是	否
`'inset'`	是	是
`'none'`	是	是
`'outset'`	是	是
`'single'`	是	否
`'solid'`	否	是
`'thick'`	是	否
`'thickthinlargegap'`	是	否
`'thickthinmediumgap'`	是	否
`'thickthinsmallgap'`	是	否
`'thinthicklargegap'`	是	否
`'thinthickmediumgap'`	是	否
`'thinthicksmallgap'`	是	否
`'thinthickthinlargegap'`	是	否
`'thinthickthinmediumgap'`	是	否
`'thinthickthinsmallgap'`	是	否
`'threedemboss'`	是	否
`'threedengrave'`	是	否
`'triple'`	是	否
`'wave'`	是	否

`color` — 表格中列分隔符的颜色
字符向量

您可以指定：

颜色的名称。该名称必须是 CSS 颜色名称。请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。
十六进制 RGB（真彩色）值为 #RRGGBB。例如，#0000ff 是蓝色。

`width` — 表格中列分隔符的宽度
字符向量

分隔符宽度以百分比表示，例如“100%”，或以 valueUnits 形式表示的计量单位数。Units 是单位的缩写。有效的缩写是：

"px" - 像素
"cm" - 厘米
"in" - 英寸
"mm" - 毫米
"pc" - 派卡
"pt" - 磅

属性

全部展开

`Color` — 分隔符颜色
字符向量

您可以指定：

颜色的名称。该名称必须是 CSS 颜色名称。请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。
十六进制 RGB（真彩色）值为 #RRGGBB。例如，#0000ff 是蓝色。

`Width` — 分隔符宽度
字符向量

分隔符宽度以百分比表示，例如 '100%'，或以 valueUnits 形式表示的计量单位数。Units 是单位的缩写。使用这些缩写之一作为宽度的单位。

"px" - 像素
"cm" - 厘米
"in" - 英寸
"mm" - 毫米
"pc" - 派卡
"pt" - 磅

数据类型: char

`Style` — 格式设定
`{}` (默认) | 格式对象数组

此文档元素对象的格式规范，指定为格式对象数组。此属性指定的格式将覆盖此元素的 StyleName 属性指定的相应格式。不适用于此元素的格式将被忽略。

属性：

NonCopyable true

数据类型: cell

`Tag` — `mlreportgen.dom.ColSep` 对象的标签
字符向量 | 字符串标量

mlreportgen.dom.ColSep 对象的标签，指定为字符向量或字符串标量。DOM API 在创建此对象的过程中生成一个会话唯一标签。生成的标签形式为 CLASS:ID，其中 CLASS 是对象类，ID 是对象的 Id 属性的值。指定您自己的标签值，以帮助您确定在文档生成过程中出现问题时要查找的位置。

属性：

NonCopyable true

数据类型: char | string

`Id` — `mlreportgen.dom.ColSep` 对象的标识符
字符向量 | 字符串标量

mlreportgen.dom.ColSep 对象的对象标识符，指定为字符向量或字符串标量。DOM API 在创建文档元素对象时会生成一个会话唯一标识符。您可以为 Id 指定自己的值。

属性：

NonCopyable true

数据类型: char | string

示例

全部折叠

指定表列分隔符

打开实时脚本

此示例创建表格并设置边框、列分隔符和行分隔符样式。TableEntriesStyle 属性用于格式化表格条目。

import mlreportgen.dom.*;
doctype = 'html';
d = Document('test',doctype);
t = Table(magic(5));

t.Style = { ...
    RowHeight('0.75in'), ...
    Border('solid','Green','6pt'), ...
    ColSep('double','DarkGreen','3pt'), ...
    RowSep('single','DarkGreen')};

t.TableEntriesStyle = { ...
    Width('0.75in'), ...
    InnerMargin('0'), ...
    OuterMargin('0'), ...
    HAlign('center'), ...
    VAlign('middle') };
    
append(d,t);
close(d);
rptview(d.OutputPath);