mlreportgen.dom.ColSep 类

命名空间: mlreportgen.dom

在表列之间绘制线

描述

使用 mlreportgen.dom.ColSep 类的对象，在 mlreportgen.dom.Table、mlreportgen.dom.FormalTable 或 mlreportgen.dom.MATLABTable 对象的各列之间绘制列分隔符。

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 颜色名称	指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。
十六进制 RGB 值	使用格式 `"#RRGGBB"`。使用 `#` 作为第一个字符，并使用两位十六进制数作为红色、绿色和蓝色的值。您可以使用大写或小写字母。
十进制 RGB 颜色值	请使用格式 `"rgb(r,g,b)"`，其中 `r`、`g` 和 `b` 是以逗号分隔的正整数，分别表示红色、绿色和蓝色的值。每个值的范围必须介于 `0` 和 `255` 之间。

示例: "red" 使用 CSS 颜色名称指定红色。

示例: "#0000ff" 使用十六进制 RGB 值指定蓝色。

示例: "rgb(128,0,128)" 使用十进制 RGB 颜色值指定紫色。

`width` — 表列分隔线的宽度
字符向量 | 字符串标量

分隔符宽度以百分比表示，应指定为字符向量或字符串标量，其中包含一个数字，后跟一个计量单位的缩写。例如，"10%" 表示百分之十。有效的缩写是：

不使用缩写 - 像素
px - 像素
cm - 厘米
in - 英寸
mm - 毫米
pc - 派卡
pt - 磅
% - 百分比

属性

全部展开

`Color` — 列分隔线颜色
`[]` (默认) | 字符向量 | 字符串标量

列分隔符颜色，指定为包含 CSS 颜色名称、十六进制 RGB 值或十进制 RGB 值的字符向量或字符串标量。

格式	值
CSS 颜色名称	指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。
十六进制 RGB 值	使用格式 `"#RRGGBB"`。使用 `#` 作为第一个字符，并使用两位十六进制数作为红色、绿色和蓝色的值。您可以使用大写或小写字母。
十进制 RGB 颜色值	请使用格式 `"rgb(r,g,b)"`，其中 `r`、`g` 和 `b` 是以逗号分隔的正整数，分别表示红色、绿色和蓝色的值。每个值的范围必须介于 `0` 和 `255` 之间。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`Width` — 分隔符宽度
`[]` (默认) | 字符向量 | 字符串标量

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

不使用缩写 - 像素
px - 像素
cm - 厘米
in - 英寸
mm - 毫米
pc - 派卡
pt - 磅
% - 百分比

示例: "100%"

示例: "3pt" 指定三磅。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`Style` — 列分隔线样式
`[]` (默认) | `"dashed"` | `"dashdotstroked"` | `"dashsmallgap"` | ...

列分隔线样式，指定为字符向量或字符串标量。指定以下值之一：

边框样式	描述	支持在 Microsoft^® Word 中使用。	支持 HTML 和 PDF
`"dashed"`	虚线	是	是
`"dashdotstroked"`	斜划线和点交替出现的线	是	是
`"dashsmallgap"`	划线之间有小间隙的虚线	是	是
`"dotted"`	点线	是	是
`"dotdash"`	点划线交替出现的线	是	否
`"dotdotdash"`	双点和划线交替出现的线	是	否
`"double"`	双线	是	是
`"doublewave"`	双波浪线	是	否
`"groove"`	三维效果凹槽线	否	是
`"hidden"`	无线条当存在冲突的边框样式时，`"hidden"` 边框样式将优先于冲突的边框样式，导致不显示边框线。	否	是
`"inset"`	三维效果线	否	是
`"none"`	无线条当边框样式发生冲突时，冲突的边框样式将优先于 `"none"`，从而导致冲突的边框样式显示出来。	是	是
`"outset"`	三维效果线	是	是
`"ridge"`	三维效果脊状线	否	是
`"single"`	单线	是	是
`"solid"`	单线	否	是
`"thick"`	粗线	是	否
`"thickthinlargegap"`	粗划线和细划线交替，间隙较大	是	否
`"thickthinmediumgap"`	粗划线和细划线交替，间隙适中	是	否
`"thickthinsmallgap"`	粗划线和细划线交替，间隙较小	是	否
`"thinthicklargegap"`	细划线和粗划线交替，间隙较大	是	否
`"thinthickmediumgap"`	细划线和粗划线交替，间隙适中	是	否
`"thinthicksmallgap"`	细划线和粗划线交替，间隙较小	是	否
`"thinthickthinlargegap"`	细划线和粗划线交替，间隙较大	是	否
`"thinthickthinmediumgap"`	细划线和粗划线交替，间隙适中	是	否
`"thinthickthinsmallgap"`	细划线和粗划线交替，间隙较小	是	否
`"threedemboss"`	浮雕效果线	是	否
`"threedengrave"`	雕刻效果线	是	否
`"triple"`	三线	是	否
`"wave"`	波浪线	是	否

注意

对于 Microsoft Word 报告，当您将 mlreportgen.dom.Border 对象分配给 mlreportgen.dom.TableHeaderEntry、mlreportgen.dom.TableEntry 或 mlreportgen.dom.HorizontalRule 对象的 Style 属性时，报告器不支持此属性的 "inset" 或 "outset" 样式。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`Tag` — 标签
字符向量 | 字符串标量

标记，指定为字符向量或字符串标量。DOM API 在创建此对象的过程中生成一个会话唯一标记。生成的标记形式为 CLASS:ID，其中 CLASS 是对象类，ID 是对象的 Id 属性的值。使用此值来帮助确定在文档生成过程中出现的问题的位置。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`NonCopyable`	`true`

数据类型: char | string

`Id` — 目标标识符
字符向量 | 字符串标量

目标标识符，指定为字符向量或字符串标量。DOM API 在创建文档元素对象时会生成一个会话唯一标识符。

属性：

`GetAccess`	`public`
`SetAccess`	`public`
`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);

版本历史记录

在 R2014b 中推出

另请参阅

mlreportgen.dom.RowSep | mlreportgen.dom.Table

主题

创建非正式表

mlreportgen.dom.ColSep 类

描述

创建对象

描述

输入参量

style — 表列分隔线的样式 字符向量

color — 表中列分隔线的颜色 字符向量 | 字符串标量

width — 表列分隔线的宽度 字符向量 | 字符串标量

属性

Color — 列分隔线颜色 [] (默认) | 字符向量 | 字符串标量

属性：

Width — 分隔符宽度 [] (默认) | 字符向量 | 字符串标量

属性：

Style — 列分隔线样式 [] (默认) | "dashed" | "dashdotstroked" | "dashsmallgap" | ...

属性：

Tag — 标签 字符向量 | 字符串标量

属性：

Id — 目标标识符 字符向量 | 字符串标量

属性：

示例

指定表列分隔线

版本历史记录

另请参阅

主题

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

`color` — 表中列分隔线的颜色
字符向量 | 字符串标量

`width` — 表列分隔线的宽度
字符向量 | 字符串标量

`Color` — 列分隔线颜色
`[]` (默认) | 字符向量 | 字符串标量

`Width` — 分隔符宽度
`[]` (默认) | 字符向量 | 字符串标量

`Style` — 列分隔线样式
`[]` (默认) | `"dashed"` | `"dashdotstroked"` | `"dashsmallgap"` | ...

`Tag` — 标签
字符向量 | 字符串标量

`Id` — 目标标识符
字符向量 | 字符串标量