mlreportgen.dom.BackgroundColor 类

命名空间: mlreportgen.dom

文档元素的背景颜色

全页展开

描述

规定文档元素的背景颜色

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

创建对象

描述

backgroundColorObj = BackgroundColor 创建白色背景。

backgroundColorObj = BackgroundColor(colorName) 根据指定的 CSS 颜色名称创建背景颜色对象。

示例

backgroundColorObj = BackgroundColor(rgbValue) 使用十六进制 RGB 颜色值创建背景颜色对象。

输入参量

全部展开

`colorName` — 要使用的颜色名称
字符向量

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

`rgbValue` — 十六进制 RGB（红、绿、蓝）颜色值
字符向量

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

属性

全部展开

`HexValue` — 十六进制 RGB 颜色值
字符向量 | 字符串标量

十六进制 RGB 颜色值，指定为字符向量。您可以使用大写或小写字母作为十六进制值的一部分。

示例: "#8b008b" 指定深洋红色。

属性：

NonCopyable true

数据类型: char | string

`Value` — 文档元素的颜色
字符向量 | 字符串标量 | 三个以逗号分隔的正整数 | 三个正数值的行向量

文档元素的颜色，指定为以下格式之一：

格式	数据类型
CSS 颜色名称	指定为字符向量或字符串标量。该名称必须是 CSS 颜色名称。请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。
十六进制 RGB 值	使用 `#RRGGBB` 格式指定为字符向量或字符串标量。使用 `#` 作为第一个字符，并使用两位十六进制数作为红色、绿色和蓝色的值。您可以使用大写或小写字母作为十六进制值的一部分。
十进制 RGB 颜色值	在字符串 `"rgb(values)"` 中指定三个以逗号分隔的正整数 `values`。数字指定红色、绿色和蓝色的值。每个值的范围从 `0` 到 `255`。
十进制百分比 RGB 颜色值	指定一个由三个正数值组成的行向量。数字指定红色、绿色和蓝色的值。每个值的范围从 `0` 到 `1`。

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

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

示例: "rgb(128,0,128)" 使用十进制 RGB 颜色值指定紫色。

示例: [0.5 0 0.5] 使用十进制百分比 RGB 颜色值指定紫色。

属性：

NonCopyable true

数据类型: double | char | string

`Tag` — `mlreportgen.dom.BackgroundColor` 对象的标签
字符向量 | 字符串标量

mlreportgen.dom.BackgroundColor 对象的标签，指定为字符向量或字符串标量。DOM API 在创建此对象的过程中生成一个会话唯一标签。生成的标签形式为 CLASS:ID，其中 CLASS 是对象类，ID 是对象的 Id 属性的值。指定您自己的标签值，以帮助您确定在文档生成过程中出现问题时要查找的位置。

属性：

NonCopyable true

数据类型: char | string

`Id` — `mlreportgen.dom.BackgroundColor` 对象的标识符
字符向量 | 字符串标量

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

属性：

NonCopyable true

数据类型: char | string

示例

全部折叠

创建并应用背景颜色

打开脚本

创建深天蓝色背景颜色对象并将其应用于段落。您可以使用十六进制值 #00bfff，而不必指定 CSS 颜色名称 DeepSkyBlue。

import mlreportgen.dom.*;
     doctype = 'html';
     d = Document('test',doctype);
     blue = 'DeepSkyBlue';
     % blue = '#00BFFF';
     colorfulStyle = {Bold,Color(blue),BackgroundColor('Yellow')};
     p = Paragraph('deep sky blue paragraph with yellow background');
     p.Style = colorfulStyle;
     append(d,p);
     close(d);
     rptview('test',doctype);