主要内容

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

mlreportgen.ppt.BackgroundColor 类

命名空间: mlreportgen.ppt

演示文稿元素的背景颜色

描述

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

  • TextBox

  • TextBoxPlaceholder

  • ContentPlaceholder

  • TablePlaceholder

  • Table

  • TableRow

  • TableEntry

  • ColSpec

  • TextBox

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

创建对象

描述

backgroundColorObj = BackgroundColor 创建白色背景。

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

示例

输入参量

全部展开

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

格式
CSS 颜色名称指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表,请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords
十六进制 RGB 值使用格式 "#RRGGBB"。使用 # 作为第一个字符,并使用两位十六进制数作为红色、绿色和蓝色的值。您可以使用大写或小写字母。

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

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

属性

全部展开

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

格式
CSS 颜色名称指定一个 CSS 颜色名称。有关 CSS 颜色名称的列表,请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords
十六进制 RGB 值使用格式 "#RRGGBB"。使用 # 作为第一个字符,并使用两位十六进制数作为红色、绿色和蓝色的值。您可以使用大写或小写字母。

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

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

属性:

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

示例

全部折叠

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

创建一个带有 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);

Sample slide with the heading A Colorful Table. In the table, the table headers are beige, and the first body cell is highlighted in yellow, while the second cell has no background color.

版本历史记录

在 R2020a 中推出