主要内容

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

mlreportgen.ppt.ColSep 类

命名空间: mlreportgen.ppt

表列分隔线

描述

使用 mlreportgen.ppt.ColSep 格式对象自定义 PPT API 演示文稿中表列之间的分隔线。

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

类属性

ConstructOnLoad
true
HandleCompatible
true

有关类属性的信息,请参阅类属性

创建对象

描述

mlreportgen.ppt.ColSep 创建一个空 mlreportgen.ppt.ColSep 对象。默认情况下,PowerPoint® 在列之间绘制细的实黑线。使用对象属性指定不同的线宽、样式或颜色。

mlreportgen.ppt.ColSep(style)Style 属性设置为 style 的值。

mlreportgen.ppt.ColSep(style,color) 还将 Color 属性设置为 color 的值。

mlreportgen.ppt.ColSep(style,color, width) 还将 Width 属性设置为 width 的值。

示例

属性

全部展开

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

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

列分隔线宽度,指定为字符向量或字符串标量,其中包含一个数字,后跟一个计量单位的缩写。例如,"10px" 指定 10 像素。有效的缩写是:

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

您也可以通过省略单位来指定像素值。例如,"5" 指定 5 像素。

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

  • "none"

  • "solid"

  • "dot"

  • "dash"

  • "largeDash"

  • "dashDot"

  • "largeDashDot"

  • "largeDashDotDot"

  • "systemDash"

  • "systemDot"

  • "systemDashDot"

  • "systemDashDotDot"

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

目标标识符,指定为字符向量或字符串标量。PPT API 在创建演示文稿元素对象时,会生成一个会话唯一标识符。您可以为 Id 指定自己的值。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

示例

全部折叠

要自定义表列之间的分隔线,请设置 mlreportgen.ppt.ColSep 对象的属性,并将该对象添加到 Style 对象的 mlreportgen.ppt.Table 属性。此示例将列分隔线设为虚线和红色,线宽为三磅。

创建演示文稿。

import mlreportgen.ppt.*
ppt = Presentation("myColSep.pptx");
open(ppt);

向演示文稿中添加幻灯片。

slide = add(ppt,"Title and Table");

创建一个表并设置自定义列分隔线。

t = Table(magic(3));
t.Style = [t.Style {ColSep("dash","red","3pt")}];

在幻灯片中添加标题和表。

replace(slide,"Title","Table with custom column separators");
replace(slide,"Table",t);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

以下是生成的演示文稿中的表:

版本历史记录

在 R2020a 中推出