主要内容

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

mlreportgen.ppt.TextBox 类

命名空间: mlreportgen.ppt

文本框

描述

演示文稿中包含的文本框。

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

创建对象

描述

textBoxObj = TextBox 创建一个空的文本框对象。

示例

属性

全部展开

文本框名称,指定为字符向量或字符串标量。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

文本的字体颜色,指定为包含 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

文本的字体大小,指定为字符向量或字符串标量,其中包含一个数值和一个单位。例如,"11pt" 指定 11 磅。有效的缩写是:

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

使用粗体显示文本的选项,指定为数值或逻辑值 1 (true) 或 0 (false)。要使文本变为粗体,请将此属性设置为 true1

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: logical

是否对文本使用斜体,指定为数值或逻辑值 1 (true) 或 0 (false)。如果 Italictrue1,则文本以斜体呈现。如果 Italicfalse0,文本将以直线形式显示。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: logical

文本的删除线样式,指定为以下值之一:

  • "single" - 单条水平线

  • "none" -无删除线

  • "double" - 双水平线

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

是否以下标形式显示文本,下标形式可指定为数值或逻辑值 1 (true) 或 0 (false)。如果 Subscripttrue1,则文本呈现为下标。如果 Subscriptfalse0,则文本将呈现为常规文本。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: logical

是否以上标形式显示文本,上标形式可指定为数值或逻辑值 1 (true) 或 0 (false)。如果 Superscripttrue1,则文本呈现为上标。如果 Superscriptfalse0,则文本将呈现为常规文本。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: logical

文本的下划线样式,指定为以下值之一:

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

  • 要使用颜色名称,请指定一个 CSS 颜色名称。要查看 CSS 颜色名称列表,请参阅 https://www.w3.org/wiki/CSS/Properties/color/keywords

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

注意

设置 BackgroundColor 属性会将 mlreportgen.ppt.BackgroundColor 格式的对象添加到 Style 属性。将 BackgroundColor 属性设置为空值将删除该对象。

示例: "blue"

示例: "#0000ff"

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

文本的垂直对齐方式,指定为以下值之一:

描述

"top"

垂直对齐至顶部

"bottom"

垂直对齐到表条目的底部

"middle"

垂直对齐到表条目的中间

"topCentered"

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

"bottomCentered"

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

"middleCentered"

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

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

左上角 x 坐标位置,指定为字符向量或字符串标量,其中包含一个数字,后跟一个测量单位的缩写。例如,"5in" 指定五英寸。有效的缩写是:

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

注意

当 PPT API 创建 mlreportgen.ppt.TextBox 对象时,此属性值以英制公制单位 (EMU) 指定。如果设置此属性,则必须使用前面列表中的单位之一。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

左上角 y 坐标位置,指定为字符向量或字符串标量,其中包含一个数字,后跟一个测量单位的缩写。例如,"5in" 指定五英寸。有效的缩写是:

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

注意

当 PPT API 创建 mlreportgen.ppt.TextBox 对象时,此属性值以英制公制单位 (EMU) 指定。如果设置此属性,则必须使用前面列表中的单位之一。

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

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

  • "px" - 像素

  • "cm" - 厘米

  • "in" - 英寸

  • "mm" - 毫米

  • "pc" - 派卡

  • "pt" - 磅

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: char | string

文本格式,指定为由 PPT 格式对象组成的元胞数组。您可以指定这些 mlreportgen.ppt 格式的对象:

  • BackgroundColor 对象

  • FontFamily 对象

  • FontSize 对象

  • Bold 对象

  • FontColor 对象

  • Italic 对象

  • Underline 对象

属性:

GetAccess
public
SetAccess
public
NonCopyable
true

数据类型: cell

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

属性:

GetAccess
public
SetAccess
private
NonCopyable
true

数据类型: cell

此对象的父级,指定为 PPT API 对象。一个 PPT API 对象只能有一个父对象。

属性:

GetAccess
public
SetAccess
private
NonCopyable
true

标记,指定为字符向量或字符串标量。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

方法

全部展开

示例

全部折叠

创建一个包含两张幻灯片的演示文稿。

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

添加空白幻灯片。

blank = add(ppt,"Blank");

创建一个文本框并定义其位置和大小。

tb = TextBox();
tb.X = "1in";
tb.Y = "1in";
tb.Width = "8in";
tb.Height = "0.5in";

在文本框中添加文本,并将文本框追加到空白幻灯片。

add(tb,"This is the title of my blank slide");
add(blank,tb);

关闭并查看演示文稿。

close(ppt);
rptview(ppt);

以下是生成的演示文稿:

Generated presentation slide that reads "This is the title of my blank slide"

版本历史记录

在 R2014b 中推出