主要内容

本页采用了机器翻译。点击此处可查看最新英文版本。

mlreportgen.dom.ColSep 类

命名空间: mlreportgen.dom

在表列之间绘制线

描述

在表列之间画线。

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

创建对象

描述

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

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

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

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

示例

输入参量

全部展开

表列分隔线的样式,指定为以下值之一。

支持 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"

您可以指定:

分隔符宽度(以百分比表示),指定为字符向量或字符串标量,包含一个数字后跟一个测量单位的缩写。例如,"10%" 表示百分之十。有效的缩写是:

  • px - 像素

  • cm - 厘米

  • in - 英寸

  • mm - 毫米

  • pc - 派卡

  • pt - 磅

  • % - 百分比

属性

全部展开

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

  • 要使用颜色名称,请指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表,请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords

  • 要指定十六进制 RGB 格式,请使用 # 作为第一个字符,并使用两位十六进制数作为红色、绿色和蓝色值。例如,"#0000ff" 指定蓝色。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

示例: "100%"

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

边框样式描述支持在 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.TableHeaderEntrymlreportgen.dom.TableEntrymlreportgen.dom.HorizontalRule 对象的 Style 属性时,报告器不支持此属性的 "inset""outset" 样式。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

目标标识符,指定为字符向量或字符串标量。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 中推出