Shapes

形状

PageElement 种类,表示没有更具体的分类的通用形状。

JSON 表示法
{
  "shapeType": enum (Type),
  "text": {
    object (TextContent)
  },
  "shapeProperties": {
    object (ShapeProperties)
  },
  "placeholder": {
    object (Placeholder)
  }
}
字段
shapeType

enum (Type)

形状的类型。

text

object (TextContent)

形状的文本内容。

shapeProperties

object (ShapeProperties)

形状的属性。

placeholder

object (Placeholder)

占位符是页面元素,继承自布局和母版上的相应占位符。

如果设置此形状,则是一个占位符形状,并且任何继承的属性都可以通过查看由 Placeholder.parent_object_id 字段标识的父占位符来解析。

类型

形状类型。

其中很多形状对应于 ECMA-376 标准的预定义形状。如需详细了解这些形状,请参阅 OfficeMA-376(第四版)第 20.1.10.55 节“Office Open XML 文件格式 - 基础和标记语言参考文档”中“ST_ShapeType”简单类型的说明。

枚举
TYPE_UNSPECIFIED 预定义的形状类型。
TEXT_BOX 文本框形状。
RECTANGLE 矩形。对应于 ECMA-376 ST_ShapeType 'rect'。
ROUND_RECTANGLE 圆角矩形。对应于 ECMA-376 ST_ShapeType 'roundRect'
ELLIPSE 椭圆形。对应于 ECMA-376 ST_ShapeType 'ellipse'
ARC 弧形。对应于 ECMA-376 ST_ShapeType 'arc'
BENT_ARROW 弯曲箭头形状。对应于 ECMA-376 ST_ShapeType 'bentArrow'
BENT_UP_ARROW 弧形向上箭头。对应于 ECMA-376 ST_ShapeType 'bentUpArrow'
BEVEL 棱台形状。对应于 ECMA-376 ST_ShapeType 'bevel'
BLOCK_ARC 屏蔽弧形。对应于 ECMA-376 ST_ShapeType 'blockArc'
BRACE_PAIR 大括号对形状。对应于 ECMA-376 ST_ShapeType 'bracePair'
BRACKET_PAIR 括号对形状。对应于 ECMA-376 ST_ShapeType 'bracketPair'
CAN 可以形状。对应于 ECMA-376 ST_ShapeType 'can'
CHEVRON V 形。对应于 ECMA-376 ST_ShapeType 'chevron'
CHORD 和弦形状。对应于 ECMA-376 ST_ShapeType 'chord'
CLOUD 云形。对应于 ECMA-376 ST_ShapeType 'cloud'
CORNER 角形状。对应于 ECMA-376 ST_ShapeType '角'
CUBE 立方体形状。对应于 ECMA-376 ST_ShapeType 'cube'
CURVED_DOWN_ARROW 弧形向下箭头。对应于 ECMA-376 ST_ShapeType 'curvedDownArrow'
CURVED_LEFT_ARROW 弧形向左箭头形状。对应于 ECMA-376 ST_ShapeType 'curvedLeftArrow'
CURVED_RIGHT_ARROW 弧形向右箭头图标。对应于 ECMA-376 ST_ShapeType 'curvedRightArrow'
CURVED_UP_ARROW 弧形向上箭头。对应于 ECMA-376 ST_ShapeType 'curvedUpArrow'
DECAGON 十边形形状。对应于 ECMA-376 ST_ShapeType 'decagon'
DIAGONAL_STRIPE 斜条纹。对应于 ECMA-376 ST_ShapeType 'diagStripe'
DIAMOND 菱形。对应于 ECMA-376 ST_ShapeType 'diamond'
DODECAGON 十二边形。对应于 ECMA-376 ST_ShapeType 'dodecagon'
DONUT 圆环形状。对应于 ECMA-376 ST_ShapeType 'donut'
DOUBLE_WAVE 双波形。对应于 ECMA-376 ST_ShapeType 'doubleWave'
DOWN_ARROW 向下箭头形状。对应于 ECMA-376 ST_ShapeType 'downArrow'
DOWN_ARROW_CALLOUT 宣传信息向下箭头形状。对应于 ECMA-376 ST_ShapeType 'downArrow callout'
FOLDED_CORNER 角落的形状。对应于 ECMA-376 ST_ShapeType 'foldedCorner'
FRAME 边框形状。对应于 ECMA-376 ST_ShapeType 'frame'
HALF_FRAME 半帧形状。对应于 ECMA-376 ST_ShapeType 'halfFrame'
HEART 心形。对应于 ECMA-376 ST_ShapeType 'heart'
HEPTAGON 七边形。对应于 ECMA-376 ST_ShapeType 'heptagon'
HEXAGON 六边形。对应于 ECMA-376 ST_ShapeType '六边形'
HOME_PLATE 主板形状。对应于 ECMA-376 ST_ShapeType 'homePlate'
HORIZONTAL_SCROLL 水平滚动形状。对应于 ECMA-376 ST_ShapeType 'horizontalScroll'
IRREGULAR_SEAL_1 印章 1 形状不规则。对应于 ECMA-376 ST_ShapeType 'irregularSeal1'
IRREGULAR_SEAL_2 印章 2 不规则形状。对应于 ECMA-376 ST_ShapeType 'irregularSeal2'
LEFT_ARROW 向左箭头形状。对应于 ECMA-376 ST_ShapeType 'leftArrow'
LEFT_ARROW_CALLOUT 宣传信息向左箭头形状。对应于 ECMA-376 ST_ShapeType 'leftArrow callout'
LEFT_BRACE 左大括号形状。对应于 ECMA-376 ST_ShapeType 'leftBrace'
LEFT_BRACKET 左中括号形状。对应于 ECMA-376 ST_ShapeType 'leftBracket'
LEFT_RIGHT_ARROW 左右箭头形状。对应于 ECMA-376 ST_ShapeType 'leftRightArrow'
LEFT_RIGHT_ARROW_CALLOUT 宣传信息向左箭头形状。对应于 ECMA-376 ST_ShapeType 'leftRightArrow callout'
LEFT_RIGHT_UP_ARROW 向左上方箭头形状。对应于 ECMA-376 ST_ShapeType 'leftRightUpArrow'
LEFT_UP_ARROW 向左箭头形状。对应于 ECMA-376 ST_ShapeType 'leftUpArrow'
LIGHTNING_BOLT 闪电形。对应于 ECMA-376 ST_ShapeType 'lightningBolt'
MATH_DIVIDE 除以数学形状。对应于 ECMA-376 ST_ShapeType 'mathDivide'
MATH_EQUAL 等式形状。对应于 ECMA-376 ST_ShapeType 'mathEqual'
MATH_MINUS 减去数学形状。对应于 ECMA-376 ST_ShapeType 'mathMinus'
MATH_MULTIPLY 将数学题相乘。对应于 ECMA-376 ST_ShapeType 'mathMultiply'
MATH_NOT_EQUAL 数学题不等号。对应于 ECMA-376 ST_ShapeType 'mathNotEqual'
MATH_PLUS 加上数学形状。对应于 ECMA-376 ST_ShapeType 'mathPlus'
MOON 月形。对应于 ECMA-376 ST_ShapeType 'moon'
NO_SMOKING 禁止吸烟。对应于 ECMA-376 ST_ShapeType 'noSmoking'
NOTCHED_RIGHT_ARROW 燕尾形箭头形状。对应于 ECMA-376 ST_ShapeType 'notchedRightArrow'
OCTAGON 八边形对应于 ECMA-376 ST_ShapeType 'octagon'
PARALLELOGRAM 平行四边形对应于 ECMA-376 ST_ShapeType 'Parallelogram'
PENTAGON 五边形。对应于 ECMA-376 ST_ShapeType '五边形'
PIE 饼形。对应于 ECMA-376 ST_ShapeType 'pie'
PLAQUE 缺角形状。对应于 ECMA-376 ST_ShapeType 'plaque'
PLUS 加号形状。对应于 ECMA-376 ST_ShapeType 'plus'
QUAD_ARROW 四箭头形状。对应于 ECMA-376 ST_ShapeType 'quadArrow'
QUAD_ARROW_CALLOUT 标注四箭头形状。对应于 ECMA-376 ST_ShapeType 'quadArrow callout'
RIBBON 丝带形状。对应于 ECMA-376 ST_ShapeType 'ribbon'
RIBBON_2 带形 2 的形状。对应于 ECMA-376 ST_ShapeType 'ribbon2'
RIGHT_ARROW 向右箭头形状。对应于 ECMA-376 ST_ShapeType 'rightArrow'
RIGHT_ARROW_CALLOUT 标注向右箭头图标。对应于 ECMA-376 ST_ShapeType 'rightArrow callout'
RIGHT_BRACE 右大括号形状。对应于 ECMA-376 ST_ShapeType 'rightBrace'
RIGHT_BRACKET 右中括号形状。对应于 ECMA-376 ST_ShapeType 'rightBracket'
ROUND_1_RECTANGLE 一个圆角矩形。对应于 ECMA-376 ST_ShapeType 'round1Rect'
ROUND_2_DIAGONAL_RECTANGLE 两个对角圆角矩形。对应于 ECMA-376 ST_ShapeType 'round2DiagRect'
ROUND_2_SAME_RECTANGLE 两个同侧圆角矩形。对应于 ECMA-376 ST_ShapeType 'round2SameRect'
RIGHT_TRIANGLE 直角三角形。对应于 ECMA-376 ST_ShapeType 'rtTriangle'
SMILEY_FACE 笑脸形状。对应于 ECMA-376 ST_ShapeType 'smileyFace'
SNIP_1_RECTANGLE 缺单角矩形。对应于 ECMA-376 ST_ShapeType 'snip1Rect'
SNIP_2_DIAGONAL_RECTANGLE 对角线缺角的矩形。对应于 ECMA-376 ST_ShapeType 'snip2DiagRect'
SNIP_2_SAME_RECTANGLE 缺同侧圆角矩形。对应于 ECMA-376 ST_ShapeType 'snip2SameRect'
SNIP_ROUND_RECTANGLE 缺一个圆角矩形。对应于 ECMA-376 ST_ShapeType 'snipRoundRect'
STAR_10 十指星形。对应于 ECMA-376 ST_ShapeType 'star10'
STAR_12 十二角星形。对应于 ECMA-376 ST_ShapeType 'star12'
STAR_16 十六角星形。对应于 ECMA-376 ST_ShapeType 'star16'
STAR_24 二十四角星形。对应于 ECMA-376 ST_ShapeType 'star24'
STAR_32 三十二角星形。对应于 ECMA-376 ST_ShapeType 'star32'
STAR_4 四角星形。对应于 ECMA-376 ST_ShapeType 'star4'
STAR_5 五角星。对应于 ECMA-376 ST_ShapeType 'star5'
STAR_6 六角星。对应于 ECMA-376 ST_ShapeType 'star6'
STAR_7 七点状星形。对应于 ECMA-376 ST_ShapeType 'star7'
STAR_8 八角星形状。对应于 ECMA-376 ST_ShapeType 'star8'
STRIPED_RIGHT_ARROW 条纹向右箭头。对应于 ECMA-376 ST_ShapeType 'stripedRightArrow'
SUN 太阳形状。对应于 ECMA-376 ST_ShapeType 'sun'
TRAPEZOID 梯形。对应于 ECMA-376 ST_ShapeType 'trapezoid'
TRIANGLE 三角形。对应于 ECMA-376 ST_ShapeType '三角形'
UP_ARROW 向上箭头形状。对应于 ECMA-376 ST_ShapeType 'upArrow'
UP_ARROW_CALLOUT 标注箭头形状。对应于 ECMA-376 ST_ShapeType 'upArrow callout'
UP_DOWN_ARROW 向上箭头形状。对应于 ECMA-376 ST_ShapeType 'upDownArrow'
UTURN_ARROW U 形箭头形状。对应于 ECMA-376 ST_ShapeType 'uturnArrow'
VERTICAL_SCROLL 垂直滚动形状。对应于 ECMA-376 ST_ShapeType 'verticalScroll'
WAVE 波浪形状。对应于 ECMA-376 ST_ShapeType 'wave'
WEDGE_ELLIPSE_CALLOUT 标注楔形椭圆形。对应于 ECMA-376 ST_ShapeType 'wedgeEllipse callout'
WEDGE_RECTANGLE_CALLOUT 标注楔形。对应于 ECMA-376 ST_ShapeType 'wedgeRect callout'
WEDGE_ROUND_RECTANGLE_CALLOUT 标注楔形矩形。对应于 ECMA-376 ST_ShapeType 'wedgeRoundRect callout'
FLOW_CHART_ALTERNATE_PROCESS 备用流程形状。对应于 ECMA-376 ST_ShapeType 'flowChartAlternateProcess'
FLOW_CHART_COLLATE 整理流程形状。对应于 ECMA-376 ST_ShapeType 'flowChartCollate'
FLOW_CHART_CONNECTOR 连接器流形状。对应于 ECMA-376 ST_ShapeType 'flowChartConnector'
FLOW_CHART_DECISION 决策流程形状。对应于 ECMA-376 ST_ShapeType 'flowChartDecision'
FLOW_CHART_DELAY 延迟流形状。对应于 ECMA-376 ST_ShapeType 'flowChartDelay'
FLOW_CHART_DISPLAY 显示流程形状。对应于 ECMA-376 ST_ShapeType 'flowChartDisplay'
FLOW_CHART_DOCUMENT 文档流程形状。对应于 ECMA-376 ST_ShapeType 'flowChartDocument'
FLOW_CHART_EXTRACT 提取流程形状。对应于 ECMA-376 ST_ShapeType 'flowChartExtract'
FLOW_CHART_INPUT_OUTPUT 输入输出流的形状。对应于 ECMA-376 ST_ShapeType 'flowChartInputOutput'
FLOW_CHART_INTERNAL_STORAGE 内部存储流程形状。对应于 ECMA-376 ST_ShapeType 'flowChartInternalStorage'
FLOW_CHART_MAGNETIC_DISK 磁盘流形状。对应于 ECMA-376 ST_ShapeType 'flowChartMagneticDisk'
FLOW_CHART_MAGNETIC_DRUM 磁鼓流动形状。对应于 ECMA-376 ST_ShapeType 'flowChartMagneticDrum'
FLOW_CHART_MAGNETIC_TAPE 磁带流动形状。对应于 ECMA-376 ST_ShapeType 'flowChartMagneticTape'
FLOW_CHART_MANUAL_INPUT 手动输入流程形状。对应于 ECMA-376 ST_ShapeType 'flowChartManualInput'
FLOW_CHART_MANUAL_OPERATION 手动操作流程形状。对应于 ECMA-376 ST_ShapeType 'flowChartManualOperation'
FLOW_CHART_MERGE 合并流程形状。对应于 ECMA-376 ST_ShapeType 'flowChartMerge'
FLOW_CHART_MULTIDOCUMENT 多文档流程形状。对应于 ECMA-376 ST_ShapeType 'flowChartMultidocument'
FLOW_CHART_OFFLINE_STORAGE 离线存储流程。对应于 ECMA-376 ST_ShapeType 'flowChartofflineStorage'
FLOW_CHART_OFFPAGE_CONNECTOR 页外连接器流程形状。对应于 ECMA-376 ST_ShapeType 'flowChartOffpageConnector'
FLOW_CHART_ONLINE_STORAGE 在线存储流程形状。对应于 ECMA-376 ST_ShapeType 'flowChartOnlineStorage'
FLOW_CHART_OR 或形状。对应于 ECMA-376 ST_ShapeType 'flowChartOr'
FLOW_CHART_PREDEFINED_PROCESS 预定义的进程流程形状。对应于 ECMA-376 ST_ShapeType 'flowChart 预定义的 Process'
FLOW_CHART_PREPARATION 准备流程形状。对应于 ECMA-376 ST_ShapeType 'flowChartPreparation'
FLOW_CHART_PROCESS 处理流程形状。对应于 ECMA-376 ST_ShapeType 'flowChartProcess'
FLOW_CHART_PUNCHED_CARD 穿孔卡片流程。对应于 ECMA-376 ST_ShapeType 'flowChartPunchedCard'
FLOW_CHART_PUNCHED_TAPE 穿孔胶带形状。对应于 ECMA-376 ST_ShapeType 'flowChartPunchedTape'
FLOW_CHART_SORT 对流程形状进行排序。对应于 ECMA-376 ST_ShapeType 'flowChartSort'
FLOW_CHART_SUMMING_JUNCTION 汇总连接流程形状。对应于 ECMA-376 ST_ShapeType 'flowChartSummingJunction'
FLOW_CHART_TERMINATOR 终止符流形状。对应于 ECMA-376 ST_ShapeType 'flowChartterminator'
ARROW_EAST 东箭头形状。
ARROW_NORTH_EAST 东北箭头形状。
ARROW_NORTH 北箭头形状。
SPEECH 语音形状。
STARBURST 星形爆发形状。
TEARDROP 泪珠形。对应于 ECMA-376 ST_ShapeType 'teardrop'
ELLIPSE_RIBBON 椭圆带形。对应于 ECMA-376 ST_ShapeType 'ellipseRibbon'
ELLIPSE_RIBBON_2 椭圆形丝带 2 形状。对应于 ECMA-376 ST_ShapeType 'ellipseRibbon2'
CLOUD_CALLOUT 宣传信息云形。对应于 ECMA-376 ST_ShapeType 'cloud callout'
CUSTOM 自定义形状。

ShapeProperties

Shape 的属性。

如果形状是由 placeholder 字段确定的占位符形状,则这些属性可能会从父占位符形状继承。确定属性的渲染值取决于相应的 propertyState 字段值。

形状中的任何文本自动调整设置都会被可能会影响形状在文本中的适应度的请求自动停用。

JSON 表示法
{
  "shapeBackgroundFill": {
    object (ShapeBackgroundFill)
  },
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  },
  "link": {
    object (Link)
  },
  "contentAlignment": enum (ContentAlignment),
  "autofit": {
    object (Autofit)
  }
}
字段
shapeBackgroundFill

object (ShapeBackgroundFill)

形状的背景填充色。如果未设置此政策,背景填充将继承自父占位符(如果存在)。如果形状没有父形状,则默认的背景填充方式取决于形状类型,因此它会匹配在幻灯片编辑器中创建的新形状的默认设置。

outline

object (Outline)

形状的轮廓。如果未设置,大纲继承自父占位符(如果存在)。如果形状没有父形状,则默认轮廓取决于形状类型,并且与幻灯片编辑器中创建的新形状的默认设置相匹配。

shadow

object (Shadow)

形状的阴影属性。如果未设置,阴影将继承自父占位符(如果存在)。如果形状没有父形状,则默认阴影与在幻灯片编辑器中创建的新形状的默认设置相匹配。此属性为只读属性。

contentAlignment

enum (ContentAlignment)

内容在形状中的对齐方式。如果为 unspecified,则对齐方式会从父占位符(如果存在)继承。如果形状没有父项,则默认对齐方式与在幻灯片编辑器中创建的新形状对齐。

autofit

object (Autofit)

形状的自动调整属性。仅针对允许文本的形状设置此属性。

形状背景填充

形状背景填充。

JSON 表示法
{
  "propertyState": enum (PropertyState),

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  }
  // End of list of possible types for union field kind.
}
字段
propertyState

enum (PropertyState)

背景填充属性状态。

更新形状上的填充会隐式将此字段更新为 RENDERED,除非在同一请求中指定了其他值。如需填充形状,请将此字段设置为 NOT_RENDERED。在这种情况下,系统会忽略在同一请求中设置的所有其他填充字段。

联合字段 kind。背景填充的类型。 kind 只能是下列其中一项:
solidFill

object (SolidFill)

纯色填充。

自动调整

Shape 的自动调整属性。

JSON 表示法
{
  "autofitType": enum (AutofitType),
  "fontScale": number,
  "lineSpacingReduction": number
}
字段
autofitType

enum (AutofitType)

形状的自动调整类型。如果自动调整类型为 AUTOFIT_TYPE_UNSPECIFIED,则继承自父占位符(如果存在)的自动调整类型。如果发出的请求可能会影响其边界框内的文本调整,则此字段将自动设置为 NONE。在这种情况下,fontScale 应用于 fontSizelineSpacingReduction 应用于 lineSpacing。这两个属性也都会重置为默认值。

fontScale

number

应用到形状的字体大小。对于具有 autofitType NONESHAPE_AUTOFIT 的形状,此值是默认值 1。对于 TEXT_AUTOFIT,此值乘以 fontSize 即可得出编辑器中呈现的字体大小。

此属性为只读属性。

lineSpacingReduction

number

已为形状应用的线条间距减小幅度。对于具有 autofitType NONESHAPE_AUTOFIT 的形状,此值是默认值 0。对于 TEXT_AUTOFIT,此值从 lineSpacing 中减去后,就会得出在编辑器中呈现的行间距。

此属性为只读属性。

自动调整类型

Shape 的自动调整类型。

枚举
AUTOFIT_TYPE_UNSPECIFIED 未指定自动调整类型。
NONE 不自动调整。
TEXT_AUTOFIT 溢出时收缩文字以适应形状。
SHAPE_AUTOFIT 调整形状大小以适合文本大小。