頁面元素大小和位置

取得及變更 網頁元素:

  1. 使用其 getter 和 setter 函式作為大小和位置。
  2. 使用 getTransform()setTransform() 函式操控仿生轉換,同時保留固有的大小。

讀取網頁元素屬性

大小與旋轉

如圖所示,系統會根據 轉譯網頁元素未經旋轉時的邊框:

  • 左側頂端:從頁面左上角到 未旋轉定界框的左上角。使用 getLeft()getTop(): 讀取值
  • 寬度高度:未旋轉定界框的寬度和高度。 使用 getWidth()getHeight() 讀取值。
  • 旋轉:相對於垂直線條的順時針旋轉 定界框的中央。使用 getRotation() 讀取值。

所有長度的測量單位為 pt。旋轉角度是以度為單位 (°).

設定網頁元素屬性

您可以在建立網頁元素時,設定網頁元素的大小和位置,方法是使用 採用 insertShape() 等插入方法如果是現有形狀,您可以設定 大小、位置和旋轉您也可以將元素的縮放比例設為 調整大小,或是沿著其邊緣反映。

建立時

建立網頁元素時,您可以提供位置和大小資訊。

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = slide.insertShape(SlidesApp.ShapeType.TEXT_BOX, 100, 200, 300, 60);
Logger.log('Left: ' + shape.getLeft() + 'pt; Top: '
                    + shape.getTop() + 'pt; Width: '
                    + shape.getWidth() + 'pt; Height: '
                    + shape.getHeight() + 'pt; Rotation: '
                    + shape.getRotation() + ' degrees.');

上述指令碼會在使用中簡報的第一張投影片上建立圖案 並讀取其位置和大小資訊 形狀的向量預期的記錄如下:

Left: 100pt; Top: 200pt; Width: 300pt; Height: 60pt; Rotation: 0 degrees.

大小、位置和旋轉

您可以在建立頁面元素後更新大小和位置:

  • 使用 setLeft()setTop() 即可設定 無旋轉的定界框。
  • 使用 setWidth()setHeight() 即可設定邊界的顯示寬度和高度 方塊。
  • 使用 setRotation() 即可設定定界框周圍的順時針旋轉 中央。

以下指令碼會在進行中的簡報的第一張投影片上建立圖案。 使用 setter 更新位置、大小和旋轉資訊,並讀取位置 形狀和形狀的大小資訊

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
shape.setLeft(100).setTop(200).setWidth(50).setHeight(60).setRotation(90);
Logger.log('Left: ' + shape.getLeft()
                    + 'pt; Top: ' + shape.getTop()
                    + 'pt; Width: ' + shape.getWidth()
                    + 'pt; Height: ' + shape.getHeight()
                    + 'pt; Rotation: ' + shape.getRotation() + '\u00B0.');

這個指令碼的預期記錄如下所示:

Left: 100pt; Top: 200pt; Width: 50pt; Height: 60pt; Rotation: 90°.

您可以使用任何順序或組合,使用大小、位置和旋轉設定器。 使用下列指令碼取代上方的第三行會產生相同的結果:

shape.setWidth(55);
shape.setRotation(90).setHeight(60).setLeft(100);
shape.setWidth(50).setTop(200);

資源調度

設定形狀大小時不應使用上方的 setWidth()setHeight() 為絕對值,scaleWidth()scaleHeight() 可用於延展或 使用相對縮放係數縮小網頁元素。

shape.scaleHeight(0.5).scaleWidth(2);

下圖顯示上述程式碼在 45° 旋轉正方形形狀的運作方式。 請注意,縮放時,邊界方塊的左上角是固定的。

簡報縮放比例

沿著邊緣回想

scaleWidth()scaleHeight() 中的引數可以是負數,因此能夠 可用來水平或垂直翻轉頁面元素。

shape.scaleWidth(-1); // Flip horizontally along the left edge of the bounding box.
shape.scaleHeight(-1); // Flip vertically along the top edge of the bounding box.

下圖說明上述程式碼在 45° 旋轉形狀中的運作方式。請注意, 網頁元素沿著其定界框的邊緣翻轉,但沒有

簡報反思

線條旋轉

如同其他頁面元素,線條的旋轉角度與 但定界框的旋轉角度。當您建立一行 指定的起點和終點後,其旋轉角度一律為 0°。拖曳 在 Google 簡報 UI 中,線條的端點也會變更其垂直角度 做為其定界框的大小和位置,但不會改變 旋轉使用 setRotation() 會旋轉線條的定界框, 可有效變換垂直的垂直角度因此兩行程式碼 視覺垂直內角相同,但定界框不同, 不同的大小、位置和旋轉值

限制

部分大小和定位方法與某些類型的頁面不相容 元素。下表摘要說明不相容的方法 特定類型的網頁元素

方法 圖案 影片 資料表
getHeight(), getWidth() NO (傳回空值)
setHeight(), setWidth()
setRotation()
scaleHeight(), scaleWidth()

如果網頁採用任何大小調整和定位方法,可能會導致非預期的結果 元素具有鋸齒狀。所有限制都可能會變動。檢查以下項目的參考資料: 最新資訊

使用 affine 轉換

如要使用進階控制項,網頁元素的大小和位置也可以 並透過固有 (原生) 大小和 affine 轉換功能進行計算和調整。

Google Apps Script 提供與 Google Slides API 一樣使用 affine 轉換的介面。

  • 為了閱讀 請參閱這篇文章。 仿生轉換的概念,以及如何從固有地推斷轉譯大小 (原生) 大小和轉換頁面元素。在 Apps Script 中,請使用
    • 適用於網頁原生大小的 getInherentWidth()getInherentHeight() 元素;
    • getTransform() 用於頁面元素的 affine 轉換。
  • 為了寫作 這篇文章說明 如何使用 affine 轉換工具調整頁面元素的大小和位置 縮放、旋轉、倒影等
    • setTransform():可設定頁面元素的 affine 轉換 (類似 ABSOLUTE 模式);
    • preconcatenateTransform() 來預先串連咖啡因轉換為 頁面元素目前的轉換 (類似 RELATIVE 模式)。

下列指令碼會建立形狀、設定轉換、讀取固有大小。 並讀取其 affine 轉換

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var shape = slide.insertShape(SlidesApp.ShapeType.RECTANGLE);
shape.setTransform(SlidesApp.newAffineTransformBuilder()
                   .setScaleX(2)
                   .setScaleY(1)
                   .setTranslateX(100)
                   .setTranslateY(200)
                   .build());
Logger.log('Inherent width: ' + shape.getInherentWidth()
                              + 'pt; Inherent height: '
                              + shape.getInherentHeight() + 'pt.');

這個指令碼的預期記錄如下所示:

Inherent width: 236.2pt; Inherent height: 236.2pt.

產生的形狀將包含下列轉換,以及算繪的大小和位置:

AffineTransform{scaleX=2.0, scaleY=1.0, shearX=0.0, shearY=0.0, translateX=100.0, translateY=200.0}
Left: 100pt; Top: 200pt; Width: 472.4pt; Height: 236.2pt; Rotation: 0°.