Lines

Line

A PageElement 代表非連接器線、直線連接器、彎曲連接器或彎折連接器。

JSON 表示法 
{
  "lineProperties": {
    object (LineProperties)
  },
  "lineType": enum (Type),
  "lineCategory": enum (LineCategory)
}
欄位
lineProperties

object (LineProperties)

線條的屬性。

lineType

enum (Type)

線條類型。

lineCategory

enum (LineCategory)

線條類別。

這與 CreateLineRequest 中指定的 category 相符，且可透過 UpdateLineCategoryRequest 更新。

LineProperties

Line 的屬性。

如未設定，這些欄位預設會採用與在 Google 簡報編輯器中建立新行時的外觀相符的值。

JSON 表示法 
{
  "lineFill": {
    object (LineFill)
  },
  "weight": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "startArrow": enum (ArrowStyle),
  "endArrow": enum (ArrowStyle),
  "link": {
    object (Link)
  },
  "startConnection": {
    object (LineConnection)
  },
  "endConnection": {
    object (LineConnection)
  }
}
欄位
lineFill

object (LineFill)

線條的填滿顏色。預設線條填滿顏色與在 Google 簡報編輯器中建立新線條時的預設顏色相同。

weight

object (Dimension)

線條粗細。

dashStyle

enum (DashStyle)

線條的虛線樣式。

startArrow

enum (ArrowStyle)

線條開頭的箭頭樣式。

endArrow

enum (ArrowStyle)

線條結尾的箭頭樣式。

startConnection

object (LineConnection)

線條開頭的連線。如未設定，則不會有連線。

只有標示為「連接器」的線條 (以 Type 表示) 才能有 startConnection。
endConnection

object (LineConnection)

線路末端的接頭。如未設定，則不會有連線。

只有標示為「連接器」的線條 (Type) 才能有 endConnection。

LineFill

線條的填滿顏色。

JSON 表示法 
{

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  }
  // End of list of possible types for union field kind.
}
欄位
聯集欄位 kind。線條填滿類型。 kind 只能是下列其中一項：
solidFill

object (SolidFill)

純色填滿。

ArrowStyle

可算繪線性幾何圖形的開始和結束表單種類。部分值是根據「Office Open XML File Formats - Fundamentals and Markup Language Reference」第 1 部分 ECMA-376 第 5 版第 20.1.10.33 節所述的「ST_LineEndType」簡單型別。

列舉
ARROW_STYLE_UNSPECIFIED 未指定箭頭樣式。
NONE 沒有箭頭。
STEALTH_ARROW 箭頭，背面有凹口。對應於 ECMA-376 ST_LineEndType 值「stealth」。
FILL_ARROW 實心箭頭。對應於 ECMA-376 ST_LineEndType 值「triangle」。
FILL_CIRCLE 實心圓。對應於 ECMA-376 ST_LineEndType 值「oval」。
FILL_SQUARE 實心方塊。
FILL_DIAMOND 實心菱形。對應於 ECMA-376 ST_LineEndType 值「diamond」。
OPEN_ARROW 空心箭頭。
OPEN_CIRCLE 空心圓形。
OPEN_SQUARE 空心方塊。
OPEN_DIAMOND 空心菱形。

LineConnection

連線一端的屬性。Line

JSON 表示法 
{
  "connectedObjectId": string,
  "connectionSiteIndex": integer
}
欄位
connectedObjectId

string

已連結頁面元素的物件 ID。

部分頁面元素 (例如 groups、tables 和 lines) 沒有連接點，因此無法連接至連接線。
connectionSiteIndex

integer

連結頁面元素上連結網站的索引。

在大多數情況下，這會對應至 ECMA-376 標準中預先定義的連線網站索引。如要進一步瞭解這些連線網站，請參閱第 20.1.9.9 節中「cxn」屬性的說明，以及「附錄 H. 「Office Open XML File Formats - Fundamentals and Markup Language Reference」第 1 部分的「Example Predefined DrawingML Shape and Text Geometries」，ECMA-376 第 5 版。

您也可以在 Google 簡報編輯器中查看各個連結網站的位置。

類型

線條類型。

其中許多形狀都對應至 ECMA-376 標準的預先定義形狀。詳情請參閱「Office Open XML File Formats - Fundamentals and Markup Language Reference」第 1 部分 (ECMA-376 第 5 版) 的 20.1.10.56 節中「ST_ShapeType」簡單型別的說明。

列舉
TYPE_UNSPECIFIED 未指定的行類型。
STRAIGHT_CONNECTOR_1 直線連接點 1 個。對應於 ECMA-376 ST_ShapeType「straightConnector1」。
BENT_CONNECTOR_2 彎曲接頭 2 表單。對應於 ECMA-376 ST_ShapeType「bentConnector2」。
BENT_CONNECTOR_3 彎曲接頭 3 表單。對應於 ECMA-376 ST_ShapeType「bentConnector3」。
BENT_CONNECTOR_4 彎曲接頭 4 形狀。對應於 ECMA-376 ST_ShapeType「bentConnector4」。
BENT_CONNECTOR_5 彎曲接頭 5 形狀。對應至 ECMA-376 ST_ShapeType「bentConnector5」。
CURVED_CONNECTOR_2 弧形連接線 2 種形式。對應至 ECMA-376 ST_ShapeType「curvedConnector2」。
CURVED_CONNECTOR_3 弧形連接線 3 表單。對應於 ECMA-376 ST_ShapeType「curvedConnector3」。
CURVED_CONNECTOR_4 弧形連接線 4 種形式。對應至 ECMA-376 ST_ShapeType「curvedConnector4」。
CURVED_CONNECTOR_5 弧形連接線 5 種形式。對應至 ECMA-376 ST_ShapeType「curvedConnector5」。
STRAIGHT_LINE 直線。對應於 ECMA-376 ST_ShapeType「line」。這條線不是連接器。

LineCategory

類別 Line。

列舉
LINE_CATEGORY_UNSPECIFIED 未指定線條類別。
STRAIGHT 直式接頭，包括直式接頭 1。
BENT 彎曲的接頭，包括彎曲的接頭 2 到 5。
CURVED 弧形連接線，包括弧形連接線 2 到 5。