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“椭圆”
`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“chevron”
`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“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“octagon”
`PARALLELOGRAM`	平行四边形。对应于 ECMA-376 ST_ShapeType“parallelogram”
`PENTAGON`	五边形。对应于 ECMA-376 ST_ShapeType“五边形”
`PIE`	饼图形状。对应于 ECMA-376 ST_ShapeType“饼图”
`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`	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“梯形”
`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`	手杖形箭头。对应于 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 表示法

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)
  },
  "link": {
    object (Link)
  },
  "contentAlignment": enum (ContentAlignment),
  "autofit": {
    object (Autofit)
  }
}

字段
`shapeBackgroundFill`	`object (ShapeBackgroundFill)` 形状的背景填充。如果未设置，则背景填充会从父占位符（如果存在）继承。如果形状没有父级，则默认背景填充取决于形状类型，与在 Google 幻灯片编辑器中创建的新形状的默认值一致。
`outline`	`object (Outline)` 形状的轮廓。如果未设置，则从父占位符（如果存在）继承轮廓。如果形状没有父形状，则默认轮廓取决于形状类型，与在 Google 幻灯片编辑器中创建的新形状的默认轮廓一致。
`shadow`	`object (Shadow)` 形状的阴影属性。如果未设置，则从父占位符（如果存在）继承阴影。如果形状没有父级，则默认阴影与在 Google 幻灯片编辑器中创建的新形状的默认阴影一致。此属性为只读属性。
`link`	`object (Link)` 形状的超链接目标。如果未设置，则表示没有链接。链接不会从父占位符继承。
`contentAlignment`	`enum (ContentAlignment)` 形状中内容的对齐方式。如果值为 `unspecified`，则对齐方式会继承自父占位符（如果存在）。如果形状没有父级，则默认对齐方式与在 Google 幻灯片编辑器中创建新形状时的对齐方式一致。
`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)` 纯色填充。

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

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`	调整形状大小以适应文本。

Shapes 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

形状

类型

ShapeProperties

ShapeBackgroundFill

自动调整

AutofitType

Shapes