Shapes

形狀

A PageElement kind representing a generic shape that doesn't have a more specific classification. 詳情請參閱「設定網頁元素的大小和位置」。

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 標準的預先定義形狀。詳情請參閱「Office Open XML File Formats - Fundamentals and Markup Language Reference」第 1 部分 (ECMA-376 第 5 版) 的 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「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 U 形下彎箭號。對應至 ECMA-376 ST_ShapeType「curvedDownArrow」
CURVED_LEFT_ARROW 彎曲的向左箭頭形狀。對應於 ECMA-376 ST_ShapeType「curvedLeftArrow」
CURVED_RIGHT_ARROW U 形右彎箭號。對應至 ECMA-376 ST_ShapeType「curvedRightArrow」
CURVED_UP_ARROW U 形上彎箭號。對應至 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「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 Ribbon 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 Callout wedge ellipse shape. 對應至 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)

形狀的背景填滿顏色。如未設定,背景填滿會沿用父項預留位置 (如有)。如果形狀沒有父項,預設背景填滿顏色會視形狀類型而定,與在 Google 簡報編輯器中建立新形狀時的預設值相同。

outline

object (Outline)

形狀的外框。如未設定,系統會沿用父項預留位置的大綱 (如有)。如果形狀沒有父項,預設輪廓會根據形狀類型而定,與在 Google 簡報編輯器中建立新形狀時的預設值相符。

shadow

object (Shadow)

形狀的陰影屬性。如未設定,系統會沿用父項預留位置的陰影 (如有)。如果形狀沒有父項,預設陰影會與在 Google 簡報編輯器中建立新形狀時的預設陰影相符。這個屬性是唯讀。

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)

純色填滿。

自動調整

Shape 的自動調整大小屬性。這項屬性只會針對允許文字的形狀設定。

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

enum (AutofitType)

形狀的自動調整類型。如果自動調整類型為 AUTOFIT_TYPE_UNSPECIFIED,系統會從上層預留位置 (如有) 沿用自動調整類型。如果提出的要求可能會影響文字在邊界文字方塊內的調整方式,系統會自動將這個欄位設為 NONE。在本例中,fontScale 會套用至 fontSizelineSpacingReduction 則會套用至 lineSpacing。這兩個屬性也會重設為預設值。

fontScale

number

套用至形狀的字型比例。如果是具有 autofitTypeNONESHAPE_AUTOFIT 的形狀,這個值是預設值 1。對於 TEXT_AUTOFIT,這個值乘以 fontSize 會得出編輯器中轉譯的字型大小。fontSize

這個屬性是唯讀。

lineSpacingReduction

number

套用至形狀的行距縮減量。如果是具有 autofitTypeNONESHAPE_AUTOFIT 的形狀,這個值為預設值 0。對於 TEXT_AUTOFIT,這個值會從 lineSpacing 中減去,得出在編輯器中顯示的行距。

這個屬性是唯讀。

AutofitType

Shape 的自動調整類型。

請注意,所有值都適用於讀取要求,但只有 AUTOFIT_TYPE_UNSPECIFIEDNONE 適用於寫入要求。

列舉
AUTOFIT_TYPE_UNSPECIFIED 未指定自動調整類型。
NONE 不要自動調整。
TEXT_AUTOFIT 縮小溢位文字,使其符合形狀。
SHAPE_AUTOFIT 根據文字調整形狀大小。