文本内容
一般性文字内容。文本必须位于兼容的形状(例如文本框或矩形)或网页中的表单元格中。
JSON 表示法 |
---|
{ "textElements": [ { object ( |
字段 | |
---|---|
textElements[]
|
将文本内容细分为组件部分,包括样式信息。此属性为只读属性。 |
lists
|
此文本中包含的项目符号列表,由列表 ID 键控。 |
文本元素
TextElement 描述了 Shape 或 TableCell 的文本内容中一系列索引的内容。
JSON 表示法 |
---|
{ "startIndex": integer, "endIndex": integer, // Union field |
字段 | |
---|---|
startIndex
|
此文本元素的起始索引(从零开始),以 Unicode 代码单元的形式表示。 |
endIndex
|
此文本元素的结束索引(从零开始,采用 Unicode 代码单元)。 |
联合字段 kind 。此元素所代表的文本的类型。
kind 只能是下列其中一项:
|
|
paragraphMarker
|
表示新段落开头的标记。
此 TextElement 的 |
textRun
|
一个表示文本运行的文本元素,该文本运行中的所有字符都具有相同的
TextRun 的 |
autoText
|
一个文本元素,表示文本中的一个点会动态地替换为随时间变化的内容。 |
ParagraphMarker
表示新段落开头的文本元素。
JSON 表示法 |
---|
{ "style": { object ( |
字段 | |
---|---|
style
|
段落的样式 |
bullet
|
此段落的项目符号。如果不存在,该段落不属于任何列表。 |
ParagraphStyle
适用于整个段落的样式。
如果此文本包含在具有父项 placeholder
的形状中,这些段落样式可能会从父项继承。继承的段落样式取决于列表的嵌套级别:
- 不在列表中的段落会继承其在父占位符内第 0 层的嵌套层级的段落样式。
- 列表中的段落会继承段落在父占位符内的对应嵌套级别中的段落样式。
继承的段落样式在此消息中表示为未设置的字段。
JSON 表示法 |
---|
{ "lineSpacing": number, "alignment": enum ( |
字段 | |
---|---|
lineSpacing
|
线之间的空间量,以正常百分比的百分比表示,其中正常值表示为 100.0。如果未设置,则值从父项继承。 |
alignment
|
此段落的文本对齐方式。 |
indentStart
|
段落右侧的缩进量,与当前文本方向相对应的文本起始缩进。如果未设置,则值从父项继承。 |
indentEnd
|
段落右侧的缩进量,与当前文本方向相对应的文本末尾缩进。如果未设置,则值从父项继承。 |
spaceAbove
|
段落上方多出的空间量。如果未设置,则值从父项继承。 |
spaceBelow
|
段落下方多余的空格。如果未设置,则值从父项继承。 |
indentFirstLine
|
段落第一行开头的缩进量。如果未设置,则值从父项继承。 |
direction
|
此段落的文本方向。如果未设置,则该值默认为 |
spacingMode
|
段落的间距模式。 |
对齐
段落的文本对齐类型。
枚举 | |
---|---|
ALIGNMENT_UNSPECIFIED
|
段落对齐方式继承自父项。 |
START
|
此段落与行首对齐。对于 LTR 文本,左对齐;否则,右对齐。 |
CENTER
|
段落居中。 |
END
|
段落行与行末对齐。对于 LTR 文本,则为右对齐;否则为左对齐。 |
JUSTIFIED
|
段落已两端对齐。 |
文本方向
文本文本可以在其中流入。
枚举 | |
---|---|
TEXT_DIRECTION_UNSPECIFIED
|
文本方向从父项继承。 |
LEFT_TO_RIGHT
|
文本从左向右书写。 |
RIGHT_TO_LEFT
|
文本从右向左移动。 |
SpacingMode
段落间距的不同模式。
枚举 | |
---|---|
SPACING_MODE_UNSPECIFIED
|
间距模式继承自父项。 |
NEVER_COLLAPSE
|
始终会呈现段落间距。 |
COLLAPSE_LISTS
|
系统会跳过列表元素之间的段落间距。 |
要点
描述段落项目符号。
JSON 表示法 |
---|
{
"listId": string,
"nestingLevel": integer,
"glyph": string,
"bulletStyle": {
object (
|
字段 | |
---|---|
listId
|
此段落所属的列表的 ID。 |
nestingLevel
|
此段落在列表中的嵌套级别。 |
glyph
|
此段落的渲染项目符号。 |
bulletStyle
|
应用于此项目符号的段落特定文本样式。 |
文本样式
表示可应用于 TextRun 的样式。
如果此文本包含在形状为父级 placeholder
的形状中,这些文本样式可以从父项继承。继承的文本样式取决于列表的嵌套级别:
- 如果某个段落内没有在列表中运行某个文本,该文本将沿用段落中父级占位符内第 0 层嵌套行的换行符。
- 以列表形式运行的段落中的文本会继承段落中相应嵌套列级别在父占位符内的嵌套级别的文本样式。
继承的文本样式在此消息中表示为未设置的字段。如果文本包含的形状不包含父占位符,则取消设置这些字段会将样式还原为幻灯片编辑器中的默认值。
JSON 表示法 |
---|
{ "backgroundColor": { object ( |
字段 | |
---|---|
backgroundColor
|
文本的背景颜色。如果设置了此标记,则该颜色为不透明或透明,具体取决于其中是否设置了 |
foregroundColor
|
文本本身的颜色。如果设置了此标记,则该颜色为不透明或透明,具体取决于其中是否设置了 |
bold
|
文本是否以粗体呈现。 |
italic
|
文本是否为斜体。 |
fontFamily
|
文本的字体系列。
字体系列可以是 Google 幻灯片中“字体”菜单中的任何字体,也可以是 Google Fonts 中的字体。如果无法识别字体名称,文本将在
某些字体可能会影响文本粗细。如果更新请求同时为 |
fontSize
|
文本字体大小。读取时,系统会以点为单位指定 |
link
|
文本的超链接目的地。如果此政策未设置,系统将不会显示任何链接。链接不会从父文本继承。 更改更新请求中的链接会对范围的文本样式进行一些其他更改:
|
baselineOffset
|
文本到其正常位置的垂直偏移量。
以 |
smallCaps
|
文本是否使用小型大写字母。 |
strikethrough
|
文本是否包含删除线。 |
underline
|
文本是否带有下划线。 |
weightedFontFamily
|
文本的字体系列和渲染粗细。
此字段是
如果更新请求同时为
如果未设置
如果设置了 |
OptionalColor
可以是完全不透明或完全透明的颜色。
JSON 表示法 |
---|
{
"opaqueColor": {
object (
|
字段 | |
---|---|
opaqueColor
|
如果设置此标记,此颜色将用作不透明颜色。如果未设置,则表示透明。 |
BaselineOffset
文本垂直于其正常位置的方式。
枚举 | |
---|---|
BASELINE_OFFSET_UNSPECIFIED
|
文本的基线偏移量继承自父文本。 |
NONE
|
文本未垂直偏移。 |
SUPERSCRIPT
|
文本垂直上移(上标)。 |
SUBSCRIPT
|
文本垂直下移(下标)。 |
WeightedFontFamily
表示用于设置 TextRun 样式的字体系列和粗细。
JSON 表示法 |
---|
{ "fontFamily": string, "weight": integer } |
字段 | |
---|---|
fontFamily
|
文本的字体系列。
字体系列可以是 Google 幻灯片中“字体”菜单中的任何字体,也可以是 Google Fonts 中的字体。如果无法识别字体名称,文本将在 |
weight
|
文本的渲染粗细。此字段的值可以是 |
文本运行
表示所有样式相同的 TextElement 种类。
JSON 表示法 |
---|
{
"content": string,
"style": {
object (
|
字段 | |
---|---|
content
|
此运行的文本。 |
style
|
应用于此运行的样式。 |
自动文字
表示自动文本的 TextElement 种类。
JSON 表示法 |
---|
{ "type": enum ( |
字段 | |
---|---|
type
|
此自动文字的类型。 |
content
|
此自动文字的呈现内容(如果有)。 |
style
|
应用于此自动文字的样式。 |
类型
自动文字的类型
枚举 | |
---|---|
TYPE_UNSPECIFIED
|
未指定的自动文本类型。 |
SLIDE_NUMBER
|
代表当前幻灯片编号的自动输入类型。 |
列表
列表描述属于列表所含段落的项目符号的外观和风格。属于某个列表的段落有隐式引用该列表的 ID。
JSON 表示法 |
---|
{
"listId": string,
"nestingLevel": {
integer: {
object (
|
字段 | |
---|---|
listId
|
列表的 ID。 |
nestingLevel
|
关联级别与关联级别的项目符号属性的映射。一个列表最多只能有 9 层嵌套,因此该映射的键的可能值为 0 至 8(含 0 和 8)。 |
NestingLevel
包含描述列表项在给定嵌套级别的外观和风格的属性。
JSON 表示法 |
---|
{
"bulletStyle": {
object (
|
字段 | |
---|---|
bulletStyle
|
此嵌套级别的项目符号样式。 |