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 檔案格式 - 基礎知識和標記語言參考資料」(「Office Open XML File Formats - Fundamentals and Markup Language Reference」) 的 第 5 版 ECMA-376 的 1 部分，第 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 彎曲的向下箭頭形狀。對應至 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 '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 說明圖示的楔形橢圓形狀。對應至 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 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 適用於寫入要求。

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