Shapes

形状

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

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 标准中的预定义形状。有关这些形状的更多信息，请参阅“ST_ShapeType”“Office Open XML 文件格式 - 基础知识和标记语言参考”的第 20.1.10.55 部分（第 1 部分） ECMA-376 第 4 版。

枚举
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“V 形”
CHORD 弦形形状。对应于 ECMA-376 ST_ShapeType“chord”
CLOUD 云朵的形状。对应于 ECMA-376 ST_ShapeType 'cloud'
CORNER 角形状。对应于 ECMA-376 ST_ShapeType 'corner'
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 'downArrowCallout'
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 'leftArrowCallout'
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 'leftRightArrowCallout'
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“pentagon”
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 'quadArrowCallout'
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 'rightArrowCallout'
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 'triangle'
UP_ARROW 向上箭头形状。对应于 ECMA-376 ST_ShapeType 'upArrow'
UP_ARROW_CALLOUT 标注向上箭头形状。对应于 ECMA-376 ST_ShapeType 'upArrowCallout'
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 'wedgeEllipseCallout'
WEDGE_RECTANGLE_CALLOUT 标注为楔形矩形。对应于 ECMA-376 ST_ShapeType 'wedgeRectCallout'
WEDGE_ROUND_RECTANGLE_CALLOUT 标注为圆角矩形。对应于 ECMA-376 ST_ShapeType 'wedgeRoundRectCallout'
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 'flowChartPredefinedProcess'
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 'cloudCallout'
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)

形状的自动调整属性。仅为允许使用文本的形状设置此属性。

ShapeBackgroundFill

形状背景填充。

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 应用于 fontSize 和 lineSpacingReduction 应用于 lineSpacing。这两个属性也会重置为默认值。

fontScale

number

应用于形状的字体缩放。对于 autofitType NONE 或 SHAPE_AUTOFIT，则此值为默认值 1。对于 TEXT_AUTOFIT，此值乘以 fontSize 指定了编辑器中呈现的字体大小。

此属性为只读属性。

lineSpacingReduction

number

减少应用于形状的行间距。对于具有 autofitType NONE 或 SHAPE_AUTOFIT，则此值为默认值 0。对于 TEXT_AUTOFIT，此值从 lineSpacing 提供了编辑器中呈现的行间距。

此属性为只读属性。

AutofitType

自动广告的 Shape。

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