Main Content

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

mlreportgen.ppt.BackgroundColor 类

命名空间: mlreportgen.ppt

演示文稿元素的背景颜色

自 R2020a 起

全页展开

描述

指定这些演示文稿元素 PPT API 对象的背景颜色：

  • TextBox

  • TextBoxPlaceholder

  • ContentPlaceholder

  • TablePlaceholder

  • Table

  • TableRow

  • TableEntry

  • ColSpec

  • TextBox

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

创建对象

描述

backgroundColorObj = BackgroundColor 创建白色背景。

示例

backgroundColorObj = BackgroundColor(color) 根据指定的 CSS 颜色名称或十六进制 RGB 颜色值创建背景颜色对象。

输入参量

全部展开

背景颜色，指定为字符向量。您可以使用：

  • 颜色名称，指定为字符向量。该名称必须是 CSS 颜色名称。请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。

  • 十六进制 RGB（红、绿、蓝）颜色值，指定为字符向量。使用格式 #RRGGBB。使用 # 作为第一个字符，并使用两位十六进制数分别表示红色、绿色和蓝色的值。例如，'#0000ff' 指定蓝色。

属性

全部展开

此 PPT API 对象的 ID，指定为字符向量或字符串标量。会话唯一 ID 是在对象创建过程中生成的。您可以指定一个 ID 来 替换生成的 ID。

属性：

NonCopyable
true

数据类型: char | string

此 PPT API 对象的标签，指定为字符向量或字符串标量。在创建此对象的过程中会生成一个会话唯一标签。生成的标签形式为 CLASS:ID，其中 CLASS 是对象类，ID 是对象的 Id 属性的值。

指定您自己的标签值可以帮助您识别演示文稿生成过程中出现问题的位置。

属性：

NonCopyable
true

数据类型: char | string

颜色名称，指定为字符向量，使用以下值之一：

  • CSS 颜色名称。请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。

  • RGB 值，使用具有 #RRGGBB 格式的字符向量。使用 # 作为第一个字符，并使用两位十六进制数分别表示红色、绿色和蓝色的值。例如，'#0000ff' 指定蓝色。

示例

全部折叠

创建一个包含不同颜色行和表条目的表格。

创建一个带有 A Colorful Table 标题幻灯片的演示文稿。

import mlreportgen.ppt.*

ppt = Presentation('myBackground.pptx');
open(ppt);
slide1 = add(ppt,'Title and Content');
replace(slide1,'Title','A Colorful Table');

定义表格，为顶行和第二行的第一个条目指定不同的颜色。

table1 = Table();

row1 = TableRow();
row1.Style = {BackgroundColor('beige')};
row1entry1 = TableEntry();
p2 = Paragraph('Beige row');
append(row1entry1,p2);
row1entry2 = TableEntry();
p3 = Paragraph('More text');
append(row1entry2,p3);
append(row1,row1entry1);
append(row1,row1entry2);

row2 = TableRow();
row2entry1 = TableEntry();
row2entry1.Style = {BackgroundColor('yellow')};
p4 = Paragraph('yellow cell');
append(row2entry1,p4);
row2entry2 = TableEntry();
p5 = Paragraph('default white background');
append(row2entry2,p5);
append(row2,row2entry1);
append(row2,row2entry2);

append(table1,row1);
append(table1,row2);

用表格替换幻灯片内容，生成演示文稿，然后打开 myBackground 演示文稿。

replace(slide1,'Content',table1);
close(ppt); 
rptview(ppt);

版本历史记录

在 R2020a 中推出

另请参阅

主题