Lines

線

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)

線條的填充色彩。預設的線條填色會與在簡報編輯器中建立的新線條的預設值相符。

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 檔案格式 - 基礎知識和標記語言參考資料」(「Office Open XML File Formats - Fundamentals and Markup Language Reference」) 的 第 5 版 ECMA-376 規範第 1 部分第 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. ECMA-376 第 5 版第 1 部分的「Office Open XML 檔案格式 - 基礎知識和標記語言參考資料」中的「預先定義的 DrawingML 形狀和文字幾何圖形範例」。

您也可以透過簡報編輯器查看每個連接點的位置。

類型

線條類型。

其中許多形狀都與 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 未指定的線條類型。
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。