Other

affineTransform

AffineTransform sử dụng ma trận 3x3 với hàng cuối cùng được ngụ ý là [0 0 1 ] để chuyển đổi tọa độ nguồn (x,y) thành tọa độ đích (x', y') theo:

 [ x']   [  scaleX  shearX  translateX  ] [ x ]
 [ y'] = [  shearY  scaleY  translateY  ] [ y ]
 [ 1 ]   [      0       0         1     ] [ 1 ]

Sau khi chuyển đổi,

 x' = scaleX * x + shearX * y + translateX;
 y' = scaleY * y + shearY * x + translateY;

Do đó, thông báo này bao gồm 6 phần tử ma trận.

Biểu diễn dưới dạng JSON
{
  "scaleX": number,
  "scaleY": number,
  "shearX": number,
  "shearY": number,
  "translateX": number,
  "translateY": number,
  "unit": enum (Unit)
}
Các trường
scaleX

number

Phần tử tỷ lệ tọa độ X.

scaleY

number

Phần tử tọa độ Y.

shearX

number

Phần tử cắt tọa độ X.

shearY

number

Phần tử cắt tọa độ Y.

translateX

number

Phần tử dịch toạ độ X.

translateY

number

Phần tử dịch toạ độ Y.

unit

enum (Unit)

Đơn vị của phần tử dịch.

Màu đục

Giá trị đồng màu có thể tạo giao diện.

Biểu diễn dưới dạng JSON
{

  // Union field kind can be only one of the following:
  "rgbColor": {
    object (RgbColor)
  },
  "themeColor": enum (ThemeColorType)
  // End of list of possible types for union field kind.
}
Các trường
Trường nhóm kind. Loại giá trị màu sắc. kind chỉ có thể là một trong những loại sau đây:
rgbColor

object (RgbColor)

Màu RGB mờ.

themeColor

enum (ThemeColorType)

Màu giao diện mờ.

Màu Rgb

Màu RGB.

Biểu diễn dưới dạng JSON
{
  "red": number,
  "green": number,
  "blue": number
}
Các trường
red

number

Thành phần màu đỏ của màu, từ 0,0 đến 1,0.

green

number

Thành phần màu xanh lá cây, từ 0,0 đến 1,0.

blue

number

Thành phần màu xanh lam của màu, từ 0,0 đến 1,0.

Loại màu giao diện

Loại màu giao diện.

PageProperties chứa ColorScheme xác định mối liên kết của các loại màu giao diện này với màu cụ thể.

Enum
THEME_COLOR_TYPE_UNSPECIFIED Màu giao diện không xác định. Không được sử dụng giá trị này.
DARK1 Đại diện cho màu tối đầu tiên.
LIGHT1 Thể hiện màu sáng đầu tiên.
DARK2 Thể hiện màu tối thứ hai.
LIGHT2 Thể hiện màu sáng thứ hai.
ACCENT1 Đại diện cho màu nhấn đầu tiên.
ACCENT2 Đại diện cho màu nhấn thứ hai.
ACCENT3 Đại diện cho màu nhấn thứ ba.
ACCENT4 Đại diện cho màu nhấn thứ tư.
ACCENT5 Đại diện cho màu nhấn thứ năm.
ACCENT6 Đại diện cho màu nhấn thứ sáu.
TEXT1 Thể hiện màu văn bản đầu tiên.
BACKGROUND1 Thể hiện màu nền đầu tiên.
TEXT2 Thể hiện màu văn bản thứ hai.
BACKGROUND2 Thể hiện màu nền thứ hai.

Trạng thái bất động sản

Các trạng thái có thể có của một cơ sở lưu trú.

Enum
RENDERED Nếu trạng thái của thuộc tính là RENDERED thì phần tử có thuộc tính tương ứng khi được hiển thị trên trang. Nếu phần tử là một hình dạng phần giữ chỗ như được xác định bởi trường placeholder và nó kế thừa từ hình dạng phần giữ chỗ, thì trường tương ứng có thể không đặt được, nghĩa là giá trị thuộc tính được kế thừa từ phần giữ chỗ chính. Nếu phần tử đó không kế thừa thì trường này sẽ chứa giá trị được hiển thị. Đây là giá trị mặc định.
NOT_RENDERED Nếu trạng thái của thuộc tính là NOT_RENDERED thì phần tử không có thuộc tính tương ứng khi được hiển thị trên trang. Tuy nhiên, trường vẫn có thể được đặt để có thể kế thừa trường này theo hình dạng con. Để xóa thuộc tính khỏi phần tử được hiển thị, hãy đặt propertyState thành NOT_RENDERED.
INHERIT Nếu trạng thái của một thuộc tính là INHERIT, thì trạng thái thuộc tính sẽ sử dụng giá trị của trường propertyState tương ứng trên hình dạng mẹ. Các phần tử không kế thừa sẽ không bao giờ có trạng thái thuộc tính INHERIT.

Chất rắn

Màu nền đồng nhất. Trang hoặc phần tử trang được điền hoàn toàn bằng giá trị màu đã chỉ định.

Nếu bạn không đặt bất kỳ trường nào, giá trị của trường đó có thể được kế thừa từ phần giữ chỗ chính nếu có.

Biểu diễn dưới dạng JSON
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number
}
Các trường
color

object (OpaqueColor)

Giá trị màu của màu nền đồng nhất.

alpha

number

Phần tử color này cần được áp dụng cho pixel. Tức là, màu pixel cuối cùng được xác định theo phương trình:

pixel màu = alpha * (màu) + (1,0 - alpha) * (màu nền)

Điều này có nghĩa là giá trị 1.0 tương ứng với màu đồng nhất, trong khi giá trị 0.0 tương ứng với màu hoàn toàn trong suốt.

Đường viền

Đường viền của PageElement.

Nếu bạn không đặt chính sách này, các trường đó có thể được kế thừa từ trình giữ chỗ chính nếu có. Nếu không có thành phần mẹ, các trường sẽ được mặc định là giá trị được sử dụng cho các phần tử trang mới được tạo trong trình chỉnh sửa Trang trình bày. Trường này có thể phụ thuộc vào loại phần tử trang.

Biểu diễn dưới dạng JSON
{
  "outlineFill": {
    object (OutlineFill)
  },
  "weight": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
Các trường
outlineFill

object (OutlineFill)

Lấp đầy bố cục.

weight

object (Dimension)

Độ dày của đường viền.

dashStyle

enum (DashStyle)

Kiểu dấu gạch ngang.

propertyState

enum (PropertyState)

Trạng thái thuộc tính đường viền.

Việc cập nhật đường viền trên một phần tử trang sẽ ngầm cập nhật trường này thành RENDERED, trừ khi có một giá trị khác được chỉ định trong cùng yêu cầu. Để không có đường viền trên phần tử trang, hãy đặt trường này thành NOT_RENDERED. Trong trường hợp này, mọi trường đường viền khác được đặt trong cùng một yêu cầu sẽ bị bỏ qua.

Tô màu nền

Lấp đầy bố cục.

Biểu diễn dưới dạng JSON
{

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  }
  // End of list of possible types for union field kind.
}
Các trường
Trường nhóm kind. Loại đường viền tô màu. kind chỉ có thể là một trong những loại sau đây:
solidFill

object (SolidFill)

Tô màu đồng nhất.

Kiểu gạch ngang

Các loại gạch ngang mà có thể hiển thị hình học tuyến tính. Các giá trị này dựa trên loại đơn giản "ST_PresetLineDashVal" được mô tả trong phần 20.1.10.48 của "Định dạng tệp XML mở Office - Thông tin cơ bản và tham chiếu ngôn ngữ đánh dấu", phần 1 của ECMA-376 4th edition.

Enum
DASH_STYLE_UNSPECIFIED Kiểu dấu gạch ngang không xác định.
SOLID Đường nét liền. Tương ứng với giá trị ECMA-376 ST_PresetLineDashVal 'rắn'. Đây là kiểu dấu gạch ngang mặc định.
DOT Đường chấm. Tương ứng với giá trị 'dot' của ECMA-376 ST_PresetLineDashVal.
DASH Đường nét đứt. Tương ứng với giá trị ECMA-376 ST_PresetLineDashVal 'dash'.
DASH_DOT Dấu gạch ngang và dấu chấm. Tương ứng với giá trị 'dashDot' của ECMA-376 ST_PresetLineDashVal.
LONG_DASH Dòng có dấu gạch ngang lớn. Tương ứng với giá trị ECMA-376 ST_PresetLineDashVal 'lgDash'.
LONG_DASH_DOT Dấu gạch ngang và dấu chấm lớn thay thế. Tương ứng với giá trị ECMA-376 ST_PresetLineDashVal 'lgDashDot'.

Bóng

Thuộc tính đổ bóng của một phần tử trang.

Nếu bạn không đặt chính sách này, các trường đó có thể được kế thừa từ trình giữ chỗ chính nếu có. Nếu không có thành phần mẹ, các trường sẽ được mặc định là giá trị được sử dụng cho các phần tử trang mới được tạo trong trình chỉnh sửa Trang trình bày. Trường này có thể phụ thuộc vào loại phần tử trang.

Biểu diễn dưới dạng JSON
{
  "type": enum (Type),
  "transform": {
    object (AffineTransform)
  },
  "alignment": enum (RectanglePosition),
  "blurRadius": {
    object (Dimension)
  },
  "color": {
    object (OpaqueColor)
  },
  "alpha": number,
  "rotateWithShape": boolean,
  "propertyState": enum (PropertyState)
}
Các trường
type

enum (Type)

Loại bóng. Thuộc tính này ở chế độ chỉ đọc.

transform

object (AffineTransform)

Chuyển đổi mã hóa bản dịch, tỷ lệ và độ lệch của bóng, so với vị trí căn chỉnh.

alignment

enum (RectanglePosition)

Điểm căn chỉnh của bóng đổ, đặt điểm bắt đầu dịch, tỷ lệ và độ nghiêng của bóng. Thuộc tính này ở chế độ chỉ đọc.

blurRadius

object (Dimension)

Bán kính làm mờ bóng. Bán kính càng lớn, bóng càng lan tỏa.

color

object (OpaqueColor)

Giá trị màu bóng.

alpha

number

Alpha của màu bóng, từ 0,0 đến 1,0.

rotateWithShape

boolean

Liệu bóng có nên quay theo hình dạng hay không. Thuộc tính này ở chế độ chỉ đọc.

propertyState

enum (PropertyState)

Trạng thái thuộc tính bóng.

Việc cập nhật bóng trên một phần tử trang sẽ ngầm cập nhật trường này thành RENDERED, trừ khi có một giá trị khác được chỉ định trong cùng yêu cầu. Để không có bóng trên thành phần trang, hãy đặt trường này thành NOT_RENDERED. Trong trường hợp này, mọi trường đổ bóng khác được đặt trong cùng một yêu cầu sẽ bị bỏ qua.

Loại

Các loại bóng.

Enum
SHADOW_TYPE_UNSPECIFIED Loại bóng không xác định.
OUTER Bóng ngoài.

Vị trí hình chữ nhật

Xác định vị trí tham chiếu trong hình chữ nhật.

Enum
RECTANGLE_POSITION_UNSPECIFIED Không xác định.
TOP_LEFT Trên cùng bên trái.
TOP_CENTER Trên cùng chính giữa.
TOP_RIGHT Trên cùng bên phải.
LEFT_CENTER Căn giữa bên trái.
CENTER Giữa.
RIGHT_CENTER Căn giữa bên phải.
BOTTOM_LEFT Dưới cùng bên trái.
BOTTOM_CENTER Dưới cùng chính giữa.
BOTTOM_RIGHT Dưới cùng bên phải.

Căn chỉnh nội dung

Các loại căn chỉnh nội dung.

Bắt nguồn từ tập hợp con các giá trị của loại đơn giản "ST_TextAnchoringType" trong phần 20.1.10.59 của "Định dạng tệp XML mở Office - Các nguyên tắc cơ bản và ngôn ngữ đánh dấu", phần 1 của ECMA-376 4th edition.

Enum
CONTENT_ALIGNMENT_UNSPECIFIED Căn chỉnh nội dung không xác định. Nội dung căn chỉnh được kế thừa từ cấp độ gốc nếu có.
CONTENT_ALIGNMENT_UNSUPPORTED Căn chỉnh nội dung không được hỗ trợ.
TOP Căn chỉnh để căn chỉnh nội dung lên trên cùng của ngăn chứa nội dung. Tương ứng với ECMA-376 ST_TextAnchoringType 't'.
MIDDLE Căn chỉnh để căn chỉnh nội dung vào giữa chủ sở hữu nội dung. Tương ứng với ECMA-376 ST_TextAnchoringType 'ctr'.
BOTTOM Căn chỉnh để căn chỉnh nội dung vào cuối chủ sở hữu nội dung. Tương ứng với ECMA-376 ST_TextAnchoringType 'b'.

Phần giữ chỗ

Thông tin trình giữ chỗ xác định duy nhất hình dạng trình giữ chỗ.

Biểu diễn dưới dạng JSON
{
  "type": enum (Type),
  "index": integer,
  "parentObjectId": string
}
Các trường
type

enum (Type)

Loại phần giữ chỗ.

index

integer

Chỉ mục của trình giữ chỗ. Nếu cùng một loại trình giữ chỗ, trang sẽ có các giá trị chỉ mục khác nhau.

parentObjectId

string

ID đối tượng của phần giữ chỗ mẹ của hình này. Nếu bạn không đặt chính sách này, thì hình dạng giữ chỗ của thành phần mẹ sẽ không tồn tại, vì vậy, hình dạng sẽ không kế thừa các thuộc tính của bất kỳ hình dạng nào khác.

Loại

Loại hình dạng phần giữ chỗ.

Nhiều loại phần giữ chỗ trong số này tương ứng với mã phần giữ chỗ trong tiêu chuẩn ECMA-376. Bạn có thể xem thêm thông tin về những hình dạng đó trong phần mô tả của loại "ST_placeholderType" trong phần 19.7.10 của "Office Open XML File Format - Fundamentals and Markup Language Reference", phần 1 của ECMA-376 4th edition.

Enum
NONE Giá trị mặc định, cho biết rằng đó không phải là trình giữ chỗ.
BODY Nội dung.
CHART Biểu đồ.
CLIP_ART Hình ảnh mẫu.
CENTERED_TITLE Tiêu đề được căn giữa.
DIAGRAM Sơ đồ.
DATE_AND_TIME Ngày và giờ.
FOOTER Văn bản chân trang.
HEADER Văn bản tiêu đề.
MEDIA Đa phương tiện.
OBJECT Mọi loại nội dung.
PICTURE Ảnh.
SLIDE_NUMBER Số trang trình bày.
SUBTITLE Phụ đề.
TABLE Bảng.
TITLE Tiêu đề trang trình bày.
SLIDE_IMAGE Hình ảnh trang trình bày.

Thuộc tính hình ảnh

Các thuộc tính của Image.

Biểu diễn dưới dạng JSON
{
  "cropProperties": {
    object (CropProperties)
  },
  "transparency": number,
  "brightness": number,
  "contrast": number,
  "recolor": {
    object (Recolor)
  },
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  },
  "link": {
    object (Link)
  }
}
Các trường
cropProperties

object (CropProperties)

Thuộc tính cắt của hình ảnh. Nếu bạn không đặt chính sách này, hình ảnh sẽ không được cắt. Thuộc tính này ở chế độ chỉ đọc.

transparency

number

Hiệu ứng trong suốt của hình ảnh. Giá trị phải nằm trong khoảng [0,0, 1,0], trong đó 0 có nghĩa là không có hiệu lực và 1 có nghĩa là hoàn toàn trong suốt. Thuộc tính này ở chế độ chỉ đọc.

brightness

number

Hiệu ứng độ sáng của hình ảnh. Giá trị phải nằm trong khoảng [-1,0, 1,0], trong đó 0 có nghĩa là không có hiệu lực. Thuộc tính này ở chế độ chỉ đọc.

contrast

number

Hiệu ứng tương phản của hình ảnh. Giá trị phải nằm trong khoảng [-1,0, 1,0], trong đó 0 có nghĩa là không có hiệu lực. Thuộc tính này ở chế độ chỉ đọc.

recolor

object (Recolor)

Hiệu ứng tô màu lại của hình ảnh. Nếu bạn không đặt chính sách này, hình ảnh sẽ không được đổi màu. Thuộc tính này ở chế độ chỉ đọc.

outline

object (Outline)

Đường viền của hình ảnh. Nếu bạn không đặt chính sách này, hình ảnh sẽ không có đường viền.

shadow

object (Shadow)

Bóng của hình ảnh. Nếu bạn không đặt chính sách này, hình ảnh sẽ không có bóng. Thuộc tính này ở chế độ chỉ đọc.

Thuộc tính cây trồng

Thuộc tính cắt của đối tượng nằm trong vùng chứa. Ví dụ: Image.

Các thuộc tính cắt được biểu thị bằng số đo bốn cạnh xác định hình chữ nhật cắt. Độ lệch được đo theo phần trăm từ các cạnh tương ứng của hình chữ nhật ranh giới ban đầu của đối tượng về phía bên trong, so với kích thước ban đầu của đối tượng.

  • Nếu độ lệch nằm trong khoảng (0, 1), cạnh tương ứng của hình chữ nhật cắt được đặt bên trong hình chữ nhật bao quanh ban đầu của đối tượng.
  • Nếu độ lệch là âm hoặc lớn hơn 1, cạnh tương ứng của hình chữ nhật cắt sẽ được đặt bên ngoài hình chữ nhật bao quanh ban đầu của đối tượng.
  • Nếu cạnh trái của hình chữ nhật cắt nằm ở bên phải, thì đối tượng sẽ được lật theo chiều ngang.
  • Nếu cạnh trên của hình chữ nhật cắt nằm dưới cạnh dưới, đối tượng sẽ được lật theo chiều dọc.
  • Nếu tất cả các giá trị bù và góc quay bằng 0, đối tượng sẽ không bị cắt.

Sau khi cắt, nội dung trong hình chữ nhật sẽ được kéo giãn để vừa với vùng chứa.

Biểu diễn dưới dạng JSON
{
  "leftOffset": number,
  "rightOffset": number,
  "topOffset": number,
  "bottomOffset": number,
  "angle": number
}
Các trường
leftOffset

number

Độ lệch chỉ định cạnh trái của hình chữ nhật cắt nằm ở bên phải của cạnh trái của hình chữ nhật ban đầu, so với chiều rộng ban đầu của đối tượng.

rightOffset

number

Độ lệch chỉ định cạnh phải của hình chữ nhật cắt nằm ở bên trái cạnh bên phải của hình chữ nhật ban đầu, so với chiều rộng ban đầu của đối tượng.

topOffset

number

Độ lệch chỉ định cạnh trên cùng của hình chữ nhật cắt nằm dưới cạnh trên cùng của hình chữ nhật bao quanh, so với chiều cao ban đầu của đối tượng.

bottomOffset

number

Độ lệch chỉ định cạnh dưới cùng của hình chữ nhật cắt nằm ở phía trên cạnh dưới của hình chữ nhật bao quanh ban đầu, so với chiều cao ban đầu của đối tượng.

angle

number

Góc xoay của cửa sổ cắt xung quanh tâm, tính bằng radian. Góc xoay được áp dụng sau độ lệch.

Tô lại màu

Hiệu ứng đổi màu được áp dụng cho hình ảnh.

Biểu diễn dưới dạng JSON
{
  "recolorStops": [
    {
      object (ColorStop)
    }
  ],
  "name": enum (Name)
}
Các trường
recolorStops[]

object (ColorStop)

Hiệu ứng tô màu lại được thể hiện bằng một gradient, đây là một danh sách các điểm dừng màu.

Các màu trong gradient sẽ thay thế các màu tương ứng ở cùng một vị trí trong bảng màu và áp dụng cho hình ảnh. Thuộc tính này ở chế độ chỉ đọc.

name

enum (Name)

Tên của hiệu ứng tô màu lại.

Tên được xác định từ recolorStops bằng cách so khớp độ dốc với màu trong color scheme hiện tại của trang. Thuộc tính này ở chế độ chỉ đọc.

Chặn màu

Màu sắc và vị trí trong dải màu gradient.

Biểu diễn dưới dạng JSON
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number,
  "position": number
}
Các trường
color

object (OpaqueColor)

Màu của điểm chuyển màu.

alpha

number

Giá trị alpha của màu này trong dải gradient. Mặc định là 1.0, mờ toàn bộ.

position

number

Vị trí tương đối của điểm dừng màu trong dải màu được đo bằng phần trăm. Giá trị phải nằm trong khoảng [0,0, 1,0].

Tên

Tên hiệu ứng đổi màu.

Enum
NONE Không có hiệu ứng đổi màu. Giá trị mặc định.
LIGHT1 Hiệu ứng tô màu lại làm sáng hình ảnh bằng cách sử dụng màu đầu tiên có sẵn của trang từ bảng phối màu.
LIGHT2 Hiệu ứng tô màu lại làm sáng hình ảnh bằng cách sử dụng màu có sẵn thứ hai của trang từ bảng phối màu.
LIGHT3 Hiệu ứng tô màu lại làm sáng hình ảnh bằng cách sử dụng màu có sẵn thứ ba của trang từ bảng màu của trang.
LIGHT4 Hiệu ứng tô màu lại làm sáng hình ảnh bằng cách sử dụng màu hiện có trên trang từ bảng phối màu.
LIGHT5 Hiệu ứng tô màu lại làm sáng hình ảnh bằng cách sử dụng màu thứ năm có sẵn trên trang từ bảng phối màu.
LIGHT6 Hiệu ứng tô màu lại làm sáng hình ảnh bằng cách sử dụng màu thứ sáu hiện có trên trang từ phối màu.
LIGHT7 Hiệu ứng tô màu lại làm sáng hình ảnh bằng cách sử dụng màu có sẵn thứ bảy của trang từ bảng phối màu.
LIGHT8 Hiệu ứng tô màu lại làm sáng hình ảnh bằng cách sử dụng màu có sẵn thứ tám của trang từ bảng phối màu.
LIGHT9 Hiệu ứng tái màu làm sáng hình ảnh bằng cách sử dụng màu thứ chín của trang có sẵn từ bảng phối màu.
LIGHT10 Hiệu ứng tô màu lại làm sáng hình ảnh bằng cách sử dụng màu có sẵn thứ mười của trang từ bảng phối màu.
DARK1 Hiệu ứng tô màu lại làm tối hình ảnh bằng cách sử dụng màu hiện có đầu tiên trên trang từ bảng phối màu.
DARK2 Hiệu ứng chuyển màu sẽ làm tối hình ảnh bằng cách sử dụng màu có sẵn thứ hai của trang từ bảng phối màu.
DARK3 Hiệu ứng tô màu lại làm tối hình ảnh bằng cách sử dụng màu có sẵn thứ ba của trang từ bảng màu của trang.
DARK4 Hiệu ứng tô màu lại làm tối hình ảnh bằng cách sử dụng màu có sẵn thứ tư của trang từ bảng màu của trang.
DARK5 Hiệu ứng tô màu lại làm tối hình ảnh bằng cách sử dụng màu có sẵn thứ năm của trang từ bảng phối màu.
DARK6 Hiệu ứng chuyển màu sẽ làm tối hình ảnh bằng cách sử dụng màu thứ sáu hiện có trên trang từ phối màu.
DARK7 Hiệu ứng tô màu lại làm tối hình ảnh bằng cách sử dụng màu có sẵn thứ bảy của trang từ bảng phối màu.
DARK8 Hiệu ứng tô màu lại làm tối hình ảnh bằng cách sử dụng màu có sẵn thứ tám của trang từ bảng phối màu.
DARK9 Hiệu ứng tô màu lại làm tối hình ảnh bằng cách sử dụng màu thứ chín của trang từ bảng màu của trang đó.
DARK10 Hiệu ứng tô màu lại làm tối hình ảnh bằng cách sử dụng màu có sẵn thứ mười của trang từ bảng phối màu.
GRAYSCALE Hiệu ứng đổi màu sẽ chuyển màu ảnh sang thang màu xám.
NEGATIVE Hiệu ứng đổi màu sẽ chuyển màu ảnh sang thang màu xám âm.
SEPIA Hiệu ứng tô màu lại màu của hình ảnh bằng màu nâu đỏ.
CUSTOM Hiệu ứng đổi màu tuỳ chỉnh. Tham khảo recolorStops để biết hiệu ứng chuyển màu cụ thể.