Main Content

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

mlreportgen.ppt.ColSpec 类

命名空间: mlreportgen.ppt

表列格式

全页展开

描述

使用 mlreportgen.ppt.ColSpec 类的对象来格式化 PPT API 演示文稿中表列的内容。通过设置格式属性、向 Style 属性添加格式对象或两者结合来指定格式。请参阅演示格式化方法。

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

类属性

ConstructOnLoad
true
HandleCompatible
true

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

创建对象

描述

colSpecObj = mlreportgen.ppt.ColSpec 创建一个空表列规范对象。

示例

colSpecObj = mlreportgen.ppt.ColSpec(colWidth) 将 Width 属性设置为 colWidth。

属性

全部展开

表列宽，指定为由数字和测量单位组成的字符向量或字符串标量。例如，'2in' 指定 2 英寸。有效的缩写是：

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

选择使用粗体作为列文本，指定为数字或逻辑 1 (true) 或 0 (false)。要使文本变为粗体，请将此属性设置为 true 或 1。

列文本的字体系列，指定为字符向量或字符串标量。指定 Microsoft® PowerPoint® 中的字体列表中出现的字体。要查看字体列表，请在 PowerPoint 的主页选项卡上的字体组中点击字体右侧的箭头。

复杂脚本的字体系列，指定为字符向量或字符串标量。指定在需要使用复杂脚本（如阿拉伯语或亚洲语）来呈现文本的区域设置中替换时要使用的字体系列。

列文本的字体颜色，指定为字符向量或字符串标量，格式化为 CSS 颜色名称或十六进制 RGB 值。

  • 有关 CSS 颜色名称的列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。

  • 要指定十六进制 RGB 格式，请使用 # 作为第一个字符，并使用两位十六进制数作为红色、绿色和蓝色值。例如，'#0000ff' 指定蓝色。

列文本的字体大小，指定为由数字和测量单位组成的字符向量或字符串标量。例如，'11pt' 指定 11 个点。有效的缩写是：

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

选择使用斜体作为列文本，指定为数字或逻辑 1 (true) 或 0 (false)。如果 Italic 是 true 或 1，则文本以斜体呈现。如果 Italic 是 false 或 0，则文本呈现为罗马字体（直体）。

列文本的删除线样式，指定为字符向量或字符串标量。指定以下值之一：

  • 'single' - 单条水平线

  • 'none' - 没有删除线

  • 'double' - 双水平线

将列文本呈现为下标的选项，指定为数字或逻辑 1 (true) 或 0 (false)。如果 Subscript 是 true 或 1，则文本呈现为下标。如果 Subscript 是 false 或 0，则文本将呈现为常规文本。

将列文本呈现为上标的选项，指定为数字或逻辑 1 (true) 或 0 (false)。如果 Superscript 是 true 或 1，则文本呈现为上标。如果 Superscript 是 false 或 0，则文本将呈现为常规文本。

列文本的下划线样式，指定为字符向量或字符串标量。指定表中的一个值。

值描述
'single'单下划线
'double'双下划线
'heavy'粗下划线
'words'仅对单词加下划线（不包括空格）
'dotted'点线下划线
'dottedheavy'粗点线下划线
'dash'虚线下划线
'dashheavy'粗虚线下划线
'dashlong'长虚线下划线
'dashlongheavy'粗长虚线下划线
'dotdash'点划线下划线
'dotdashheavy'粗点划线下划线
'dotdotdash'双点划线下划线
'dotdotdashheavy'粗双点划线下划线
'wavy'波浪下划线
'wavyheavy'粗波浪下划线
'wavydouble'双波浪下划线
'none'无下划线

背景颜色，指定为字符向量或字符串标量，格式化为 CSS 颜色名称或十六进制 RGB 值。

  • 有关 CSS 颜色名称的列表，请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords。

  • 要指定十六进制 RGB 格式，请使用 # 作为第一个字符，并使用两位十六进制数作为红色、绿色和蓝色值。例如，'#0000ff' 指定蓝色。

列的表条目内容的水平对齐，指定为字符向量或字符串标量。指定表中的一个值。

值描述

'center'

居中

'left'

左对齐

'right'

右对齐

'justified'

左右对齐，单词间距均匀

'distributed'

左右对齐，字母间距均匀

'thaiDistributed'

泰语文本左右对齐，字符间距均匀

'justifiedLow'

阿拉伯语文本的对齐方式

列的表条目中内容的垂直对齐，指定为字符向量或字符串标量。指定表中的一个值。

值描述

'top'

垂直对齐至顶部

'bottom'

垂直对齐到表条目的底部

'middle'

垂直对齐到表条目的中间

'topCentered'

垂直对齐到表条目的顶部，水平对齐到表条目的中心

'bottomCentered'

垂直对齐到表条目的底部，水平对齐到表条目的中心

'middleCentered'

垂直对齐到中间，水平对齐到表条目的中心

列文本的方向，指定为字符向量或字符串标量。指定表中的一个值。

值描述
'horizontal'文字方向为水平。
'down'文本方向为垂直，内容顺时针旋转 90 度。
'up'文本方向为垂直，内容逆时针旋转 90 度。

请参阅指定列文本的方向。

列格式化，指定为 PPT API 格式对象的元胞数组。不适用于 ColSpec 对象的格式将被忽略。

此 PPT API 对象的子元素，指定为 PPT API 对象的元胞数组。

属性：

NonCopyable
true

该对象的父级，指定为 PPT 对象。

属性：

SetAccess
private
NonCopyable
true

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

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

属性：

NonCopyable
true

数据类型: char | string

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

属性：

NonCopyable
true

数据类型: char | string

示例

全部折叠

创建演示文稿并添加幻灯片。

import mlreportgen.ppt.*

ppt = Presentation('myColSpec.pptx');
open(ppt);
slide = add(ppt,'Title and Content');

创建一个表。指定表格前两列的宽度和背景颜色。

t = Table(magic(12));
t.Style = {HAlign('center')};

colSpecs(2) = ColSpec('2in');
colSpecs(1) = ColSpec('1in');
colSpecs(1).BackgroundColor = 'red';
colSpecs(2).BackgroundColor = 'green';
t.ColSpecs = colSpecs;

将表格添加到幻灯片中。 

replace(slide,'Content',t);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

创建演示文稿。

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

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

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

创建一个表。

table = Table({'Col 1','Col 2';'entry 1','entry 2'});
table.Height = "2in";
table.Style = [table.Style {VAlign("middleCentered")}];

使用 mlreportgen.ppt.ColSpec 对象定义表列的格式。指定第一列文本的方向为垂直、逆时针旋转 90 度。指定第二列文本的方向为垂直、顺时针旋转 90 度。

colSpecs(1) = ColSpec("1in");
colSpecs(1).TextOrientation = "up";
colSpecs(2) = ColSpec("1in");
colSpecs(2).TextOrientation = "down";

将 ColSpec 对象分配给 Table 对象。

table.ColSpecs = colSpecs;

将表格添加到幻灯片中。

replace(slide,"Table",table);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

版本历史记录

在 R2015b 中推出

另请参阅

| | | | | | | | | | | |

主题