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 标准中的预定义形状相对应。如需了解详情，请参阅 ECMA-376 第 5 版第 1 部分“Office Open XML 文件格式 - 基础知识和标记语言参考”的 20.1.10.56 部分中对“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 锯齿形。对应于 ECMA-376 ST_ShapeType“箭头”
CHORD 弦形。对应于 ECMA-376 ST_ShapeType“chord”
CLOUD 云形状。对应于 ECMA-376 ST_ShapeType“云”
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“十边形”
DIAGONAL_STRIPE 斜条纹形状。对应于 ECMA-376 ST_ShapeType“diagStripe”
DIAMOND 菱形。对应于 ECMA-376 ST_ShapeType“diamond”
DODECAGON 十二边形。对应于 ECMA-376 ST_ShapeType“十二边形”
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“七边形”
HEXAGON 六边形。对应于 ECMA-376 ST_ShapeType“hexagon”
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“八边形”
PARALLELOGRAM 平行四边形。对应于 ECMA-376 ST_ShapeType“平行四边形”
PENTAGON 五边形。对应于 ECMA-376 ST_ShapeType“五角形”
PIE 饼图。对应于 ECMA-376 ST_ShapeType“pie”
PLAQUE 斑块形状。对应于 ECMA-376 ST_ShapeType“plaque”
PLUS 加号形状。对应于 ECMA-376 ST_ShapeType“加号”
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“上箭头”
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“泪滴”
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 适用于写入请求。

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