Shapes

形狀

A 罩杯 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 標準預先定義的形狀。如要進一步瞭解這些形狀,請參閱「ST_ShapeType」的說明。「Office Open XML 檔案格式 - 基礎知識和標記語言參考資料」第 20.1.10.55 節的簡單型別 ECMA-376 第 4 版

列舉
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 V 形圖案。對應於 ECMA-376 ST_ShapeType「chevron」
CHORD 和弦形狀。對應於 ECMA-376 ST_ShapeType 'chord'
CLOUD 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「downArrow callout」
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「六角形」
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 'leftArrow callout'
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 'leftRightArrow callout'
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 'quadArrow callout'
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「rightArrow callout」
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 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 'upArrow callout'
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 '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「flowChartAlternativeProcess」
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

如果 Pod 的屬性 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)

純色填滿。

自動調整

的 Autofit 屬性 Shape

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

enum (AutofitType)

形狀的自動調整類型。如果自動調整類型為 AUTOFIT_TYPE_UNSPECIFIED,自動調整類型 (如果有的話) 會沿用自父項預留位置。這個欄位會自動設為 NONE 的要求可能會影響其邊界文字方塊內的文字合框。在這種情況下 fontScale 套用於 fontSizelineSpacingReduction 套用於 lineSpacing。這兩個屬性也會重設為預設值。

fontScale

number

套用至形狀的字型大小。適用於有 autofitType NONESHAPE_AUTOFIT,這個值是預設值 1。適用對象 TEXT_AUTOFIT,這個值乘以 fontSize 設定編輯器中顯示的字型大小。

這個屬性處於唯讀狀態。

lineSpacingReduction

number

套用至圖形的線條間距。適用於有 autofitType NONESHAPE_AUTOFIT,這個值是預設值 0。適用對象 TEXT_AUTOFIT,這個值由 lineSpacing 提供在編輯器中顯示的行距。

這個屬性處於唯讀狀態。

AutofitType

Pod 的自動調整類型 Shape

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