形狀
   PageElement 類型代表沒有更具體分類的一般形狀。詳情請參閱「調整頁面元素大小和位置」一文。
| JSON 表示法 | 
|---|
      { "shapeType": enum (  | 
    
| 欄位 | |
|---|---|
      shapeType
      | 
     
       
        形狀的類型。  | 
    
      text
      | 
     
       
        形狀的文字內容。  | 
    
      shapeProperties
      | 
     
       
        形狀的屬性。  | 
    
      placeholder
      | 
     
       
        預留位置是繼承版面配置和母版中對應預留位置的網頁元素。 
       如果已設定,則形狀為預留位置形狀,只要查看   | 
    
類型
形狀類型。
其中許多形狀都與 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 的「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
      | 
     緞帶 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
      | 
     
       
        形狀的外框。如果未設定,則大綱會沿用父項預留位置 (如果有的話)。如果形狀沒有父項,則預設的輪廓取決於形狀類型,與在「簡報」編輯器中建立的新形狀的預設值相符。  | 
    
      shadow
      | 
     
       
        形狀的陰影屬性。如果未設定,則會從父項預留位置 (如果有的話) 繼承陰影。如果形狀沒有父項,則預設陰影會與在簡報編輯器中建立的新形狀的預設值相符。這是唯讀屬性。  | 
    
      link
      | 
     
       
        形狀的超連結目的地。如果未設定,則不會顯示連結。連結不會從父項預留位置繼承。  | 
    
      contentAlignment
      | 
     
       
        
       形狀中內容的對齊方式。如果是   | 
    
      autofit
      | 
     
       
        形狀的自動調整屬性。這個屬性只會設為允許文字的形狀。  | 
    
ShapeBackgroundFill
形狀背景填充。
| JSON 表示法 | 
|---|
      { "propertyState": enum (  | 
    
| 欄位 | |
|---|---|
      propertyState
      | 
     
       
        背景填充屬性狀態。 
       更新形狀的填充時,系統會隱含地將這個欄位更新為   | 
    
      聯集欄位 kind。背景填充的類型。kind 只能是下列其中一個: | 
    |
      solidFill
      | 
     
       
        純色填滿。  | 
    
自動調整
   Shape 的自動調整屬性。這個屬性只會設為允許文字的形狀。
| JSON 表示法 | 
|---|
      {
  "autofitType": enum ( | 
    
| 欄位 | |
|---|---|
      autofitType
      | 
     
       
        
       形狀的自動調整類型。如果自動調整大小類型為   | 
    
      fontScale
      | 
     
       
        
       套用至形狀的字型比例。對於具有  這是唯讀屬性。  | 
    
      lineSpacingReduction
      | 
     
       
        
       套用至形狀的行距縮減量。對於具有  這是唯讀屬性。  | 
    
AutofitType
   Shape 的自動調整類型。
   請注意,雖然所有值都適用於讀取要求,但只有 AUTOFIT_TYPE_UNSPECIFIED 和 NONE 適用於寫入要求。
| 列舉 | |
|---|---|
      AUTOFIT_TYPE_UNSPECIFIED
      | 
     未指定自動調整類型。 | 
      NONE
      | 
     不要自動調整。 | 
      TEXT_AUTOFIT
      | 
     縮小溢位文字以符合形狀。 | 
      SHAPE_AUTOFIT
      | 
     根據文字調整形狀大小。 |