mlreportgen.ppt.Border 类

命名空间: mlreportgen.ppt

表或表条目的边框

全页展开

描述

使用 mlreportgen.ppt.Border 格式对象自定义 PPT API 演示文稿中表或表条目的边框。

注意

如果两个表条目共享一个边界段，就会发生冲突。对于有冲突的水平边框段，Microsoft^® PowerPoint^® 将忽略底部条目指定的格式。对于有冲突的垂直边框段，PowerPoint 会忽略右侧条目指定的格式。

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

类属性

`ConstructOnLoad`	`true`
`HandleCompatible`	`true`

有关类属性的信息，请参阅类属性。

创建对象

描述

mlreportgen.ppt.Border 创建一个空 mlreportgen.ppt.Border 对象。默认情况下，PowerPoint 将表边框呈现为细的、实的黑线。使用对象属性指定不同的边框宽度、样式或颜色。

示例

mlreportgen.ppt.Border(style) 将 Style、TopStyle、BottomStyle、LeftStyle 和 RightStyle 属性设置为 style 的值。

mlreportgen.ppt.Border(style,color) 还将 Color、TopColor、BottomColor、LeftColor 和 RightColor 属性设置为 color 的值。

mlreportgen.ppt.Border(style,color,width) 还将 Width、TopWidth、BottomWidth、LeftWidth 和 RightWidth 属性设置为 width 的值。

输入参量

全部展开

`style` — 绘制边框的类型
`"solid"` | `"dot"` | `"dash"` | `...` | ...

要绘制的边框类型，指定为以下值之一：

"none"
"solid"
"dot"
"dash"
"largeDash"
"dashDot"
"largeDashDot"
"largeDashDotDot"
"systemDash"
"systemDot"
"systemDashDot"
"systemDashDotDot"

数据类型: char | string

`color` — 边框颜色
字符向量 | 字符串标量

您可以指定：

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

数据类型: char | string

`width` — 边框宽度
字符向量 | 字符串标量

边框宽度，指定为字符向量或字符串标量，其中包含一个数字后跟一个测量单位的缩写。例如，"10px" 指定 10 像素。有效的缩写是：

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

数据类型: char | string

属性

全部展开

`Color` — 边框的默认颜色
`[]` (默认) | 字符向量 | 字符串标量

边框段的颜色，指定为包含 CSS 颜色名称或十六进制 RGB 值的字符向量或字符串标量。

要使用颜色名称，请指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。
要指定十六进制 RGB 格式，请使用 # 作为第一个字符，并使用两位十六进制数作为红色、绿色和蓝色值。例如，"#0000ff" 指定蓝色。

示例: "blue"

示例: "#0000ff"

属性：

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

数据类型: char | string

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

边框宽度，指定为字符向量或字符串标量，其中包含一个数字后跟一个测量单位的缩写。例如，"3pt" 指定三磅。有效的缩写是：

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

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

属性：

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

数据类型: string | char

`BottomStyle` — 底部边框样式
`[]` (默认) | `"none"` | `"solid"` | `"dot"` | ...

底部边框段的样式，指定为字符向量或字符串标量。指定以下值之一：

"none"
"solid"
"dot"
"dash"
"largeDash"
"dashDot"
"largeDashDot"
"largeDashDotDot"
"systemDash"
"systemDot"
"systemDashDot"
"systemDashDotDot"

属性：

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

数据类型: char | string

`BottomColor` — 底部边框颜色
`[]` (默认) | 字符向量 | 字符串标量

底部边框段的颜色，指定为包含 CSS 颜色名称或十六进制 RGB 值的字符向量或字符串标量。

要使用颜色名称，请指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。
要指定十六进制 RGB 格式，请使用 # 作为第一个字符，并使用两位十六进制数作为红色、绿色和蓝色值。例如，"#0000ff" 指定蓝色。

示例: "blue"

示例: "#0000ff"

属性：

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

数据类型: char | string

`BottomWidth` — 底部边框的宽度
`[]` (默认) | 字符向量 | 字符串标量

底部边框段的宽度，指定为字符向量或字符串标量，其中包含一个数字，后跟一个测量单位的缩写。例如，"3pt" 指定三磅。有效的缩写是：

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

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

属性：

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

数据类型: char | string

`TopStyle` — 顶部边框样式
`[]` (默认) | `"none"` | `"solid"` | `"dot"` | ...

顶部边框段的样式，指定为字符向量或字符串标量。指定以下值之一：

"none"
"solid"
"dot"
"dash"
"largeDash"
"dashDot"
"largeDashDot"
"largeDashDotDot"
"systemDash"
"systemDot"
"systemDashDot"
"systemDashDotDot"

属性：

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

数据类型: char | string

`TopColor` — 顶部边框颜色
`[]` (默认) | 字符向量 | 字符串标量

顶部边框段的颜色，指定为包含 CSS 颜色名称或十六进制 RGB 值的字符向量或字符串标量。

要使用颜色名称，请指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。
要指定十六进制 RGB 格式，请使用 # 作为第一个字符，并使用两位十六进制数作为红色、绿色和蓝色值。例如，"#0000ff" 指定蓝色。

示例: "blue"

示例: "#0000ff"

属性：

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

数据类型: char | string

`TopWidth` — 顶部边框的宽度
`[]` (默认) | 字符向量 | 字符串标量

顶部边框段的宽度，指定为字符向量或字符串标量，其中包含一个数字，后跟一个测量单位的缩写。例如，"3pt" 指定三磅。有效的缩写是：

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

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

属性：

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

数据类型: char | string

`LeftStyle` — 左边框样式
`[]` (默认) | `"none"` | `"solid"` | `"dot"` | ...

左边框段的样式，指定为字符向量或字符串标量。指定以下值之一：

"none"
"solid"
"dot"
"dash"
"largeDash"
"dashDot"
"largeDashDot"
"largeDashDotDot"
"systemDash"
"systemDot"
"systemDashDot"
"systemDashDotDot"

属性：

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

数据类型: char | string

`LeftColor` — 左边框颜色
`[]` (默认) | 字符向量 | 字符串标量

左边框段的颜色，指定为包含 CSS 颜色名称或十六进制 RGB 值的字符向量或字符串标量。

要使用颜色名称，请指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。
要指定十六进制 RGB 格式，请使用 # 作为第一个字符，并使用两位十六进制数作为红色、绿色和蓝色值。例如，"#0000ff" 指定蓝色。

示例: "blue"

示例: "#0000ff"

属性：

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

数据类型: char | string

`LeftWidth` — 左边框的宽度
`[]` (默认) | 字符向量 | 字符串标量

左边框段的宽度，指定为字符向量或字符串标量，其中包含一个数字，后跟一个测量单位的缩写。例如，"3pt" 指定三磅。有效的缩写是：

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

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

属性：

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

数据类型: char | string

`RightStyle` — 右边框样式
`[]` (默认) | `"none"` | `"solid"` | `"dot"` | ...

右边框段的样式，指定为字符向量或字符串标量。指定以下值之一：

"none"
"solid"
"dot"
"dash"
"largeDash"
"dashDot"
"largeDashDot"
"largeDashDotDot"
"systemDash"
"systemDot"
"systemDashDot"
"systemDashDotDot"

属性：

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

数据类型: char | string

`RightColor` — 右边框颜色
`[]` (默认) | 字符向量 | 字符串标量

右边框段的颜色，指定为包含 CSS 颜色名称或十六进制 RGB 值的字符向量或字符串标量。

要使用颜色名称，请指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。
要指定十六进制 RGB 格式，请使用 # 作为第一个字符，并使用两位十六进制数作为红色、绿色和蓝色值。例如，"#0000ff" 指定蓝色。

示例: "blue"

示例: "#0000ff"

属性：

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

数据类型: char | string

`RightWidth` — 右边框的宽度
`[]` (默认) | 字符向量 | 字符串标量

右边框段的宽度，指定为字符向量或字符串标量，其中包含一个数字，后跟一个测量单位的缩写。例如，"3pt" 指定三磅。有效的缩写是：

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

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

属性：

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

数据类型: char | string

`Style` — 边框的默认样式
`[]` (默认) | `"none"` | `"solid"` | `"dot"` | ...

边框段的默认样式，指定为字符向量或字符串标量。指定以下值之一：

"none"
"solid"
"dot"
"dash"
"largeDash"
"dashDot"
"largeDashDot"
"largeDashDotDot"
"systemDash"
"systemDot"
"systemDashDot"
"systemDashDotDot"

属性：

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

数据类型: char | string

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

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

属性：

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

数据类型: char | string

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

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

属性：

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

数据类型: char | string

示例

全部折叠

自定义演示文稿中的表边框

打开实时脚本

要自定义 PPT API 演示文稿中表或表条目的边框或边框段，请在 mlreportgen.ppt.Border 格式对象中指定边框样式、颜色和宽度，并将该对象添加到 Style 或 mlreportgen.ppt.Table 对象的 mlreportgen.ppt.TabeEntry 属性。此示例指定第二行第二列的条目的下边框为虚线、红色、宽度为三磅。

创建演示文稿。

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

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

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

创建一个表。

t = Table(magic(3));

创建边框对象来自定义底部边框段。

border = Border();
border.BottomStyle = "dash";
border.BottomColor = "red";
border.BottomWidth = "3pt";

将自定义边框应用于第二列第二行的条目。

tr2te2 = t.entry(2,2);
tr2te2.Style = [tr2te2.Style {border}];

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

replace(slide,"Title","Table entry with custom borders");
replace(slide,"Table",t);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

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

版本历史记录

在 R2020a 中推出

另请参阅

mlreportgen.ppt.Table | mlreportgen.ppt.TableEntry

mlreportgen.ppt.Border 类

描述

类属性

创建对象

描述

输入参量

style — 绘制边框的类型 "solid" | "dot" | "dash" | ... | ...

color — 边框颜色 字符向量 | 字符串标量

width — 边框宽度 字符向量 | 字符串标量

属性

Color — 边框的默认颜色 [] (默认) | 字符向量 | 字符串标量

属性：

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

属性：

BottomStyle — 底部边框样式 [] (默认) | "none" | "solid" | "dot" | ...

属性：

BottomColor — 底部边框颜色 [] (默认) | 字符向量 | 字符串标量

属性：

BottomWidth — 底部边框的宽度 [] (默认) | 字符向量 | 字符串标量

属性：

TopStyle — 顶部边框样式 [] (默认) | "none" | "solid" | "dot" | ...

属性：

TopColor — 顶部边框颜色 [] (默认) | 字符向量 | 字符串标量

属性：

TopWidth — 顶部边框的宽度 [] (默认) | 字符向量 | 字符串标量

属性：

LeftStyle — 左边框样式 [] (默认) | "none" | "solid" | "dot" | ...

属性：

LeftColor — 左边框颜色 [] (默认) | 字符向量 | 字符串标量

属性：

LeftWidth — 左边框的宽度 [] (默认) | 字符向量 | 字符串标量

属性：

RightStyle — 右边框样式 [] (默认) | "none" | "solid" | "dot" | ...

属性：

RightColor — 右边框颜色 [] (默认) | 字符向量 | 字符串标量

属性：

RightWidth — 右边框的宽度 [] (默认) | 字符向量 | 字符串标量

属性：

Style — 边框的默认样式 [] (默认) | "none" | "solid" | "dot" | ...

属性：

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

属性：

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

属性：

示例

自定义演示文稿中的表边框

版本历史记录

另请参阅

主题

`style` — 绘制边框的类型
`"solid"` | `"dot"` | `"dash"` | `...` | ...

`color` — 边框颜色
字符向量 | 字符串标量

`width` — 边框宽度
字符向量 | 字符串标量

`Color` — 边框的默认颜色
`[]` (默认) | 字符向量 | 字符串标量

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

`BottomStyle` — 底部边框样式
`[]` (默认) | `"none"` | `"solid"` | `"dot"` | ...

`BottomColor` — 底部边框颜色
`[]` (默认) | 字符向量 | 字符串标量

`BottomWidth` — 底部边框的宽度
`[]` (默认) | 字符向量 | 字符串标量

`TopStyle` — 顶部边框样式
`[]` (默认) | `"none"` | `"solid"` | `"dot"` | ...

`TopColor` — 顶部边框颜色
`[]` (默认) | 字符向量 | 字符串标量

`TopWidth` — 顶部边框的宽度
`[]` (默认) | 字符向量 | 字符串标量

`LeftStyle` — 左边框样式
`[]` (默认) | `"none"` | `"solid"` | `"dot"` | ...

`LeftColor` — 左边框颜色
`[]` (默认) | 字符向量 | 字符串标量

`LeftWidth` — 左边框的宽度
`[]` (默认) | 字符向量 | 字符串标量

`RightStyle` — 右边框样式
`[]` (默认) | `"none"` | `"solid"` | `"dot"` | ...

`RightColor` — 右边框颜色
`[]` (默认) | 字符向量 | 字符串标量

`RightWidth` — 右边框的宽度
`[]` (默认) | 字符向量 | 字符串标量

`Style` — 边框的默认样式
`[]` (默认) | `"none"` | `"solid"` | `"dot"` | ...

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

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