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 的属性。

如果未设置,这些字段的默认值与在幻灯片编辑器中创建的新行的外观一致。

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

可用于渲染线性几何图形的起始和结束形式。部分值基于 ECMA-376 第 5 版第 1 部分“Office Open XML 文件格式 - 基础知识和标记语言参考”的 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。

某些页面元素(例如 groupstableslines)没有连接点,因此无法连接到连接线。

connectionSiteIndex

integer

关联的网页元素上关联网站的索引。

在大多数情况下,它与 ECMA-376 标准中的预定义连接点索引相对应。如需详细了解这些连接点,请参阅第 20.1.9.9 节中“cxn”属性的说明以及“附录 H. ECMA-376 第 5 版的“Office Open XML 文件格式 - 基础知识和标记语言参考”第 1 部分中的“预定义 DrawingML 形状和文本几何图形示例”。

您还可以在幻灯片编辑器中查看每个连接点的位置。

类型

线条类型。

其中许多形状与 ECMA-376 标准中的预定义形状相对应。如需了解详情,请参阅 ECMA-376 第 5 版第 1 部分“Office Open XML 文件格式 - 基础知识和标记语言参考”的 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。