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 標準的預先定義形狀。如要進一步瞭解這些形狀，請參閱「Office Open XML 檔案格式 - 基礎知識和標記語言參考資料」一節「20.1.10.55 版」一節 (位於 ECMA-376 4 版) 的「1_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 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 'downArrowsummary'
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 「十六進位 agon」
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 'leftArrowSummary'
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 'leftRightArrowSummary'
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 'quadArrowSummary'
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 'rightArrowSummary'
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 10 角星形。對應 ECMA-376 ST_ShapeType 'star10'
STAR_12 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 'upArrowSummary'
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 「wa」
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 '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 '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)

形狀的自動調整屬性。這個屬性僅適用於允許文字的形狀。

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 根據文字調整形狀大小。