本頁面由 Cloud Translation API 翻譯而成。

Class Table

代表資料表的 PageElement。

方法

方法	傳回類型	簡短說明
`alignOnPage(alignmentPosition)`	`Table`	將元素對齊頁面指定的對齊位置。
`appendColumn()`	`TableColumn`	在表格最後一欄的右側附加新資料欄。
`appendRow()`	`TableRow`	在表格最後一列的下方附加一個新資料列。
`bringForward()`	`Table`	將頁面元素往前移動一個元素。
`bringToFront()`	`Table`	將網頁元素移到網頁前方。
`duplicate()`	`PageElement`	複製頁面元素。
`getCell(rowIndex, columnIndex)`	`TableCell`	傳回表格中的指定儲存格。
`getColumn(columnIndex)`	`TableColumn`	傳回表格中的指定欄。
`getConnectionSites()`	`ConnectionSite[]`	傳回頁面元素上的 `ConnectionSite` 清單；如果是網頁，則傳回空白清單元素沒有任何連接網站。
`getDescription()`	`String`	傳回頁面元素的替代文字說明。
`getHeight()`	`Number`	取得元素的高度 (以點為單位)，也就是當元素沒有旋轉角度。
`getInherentHeight()`	`Number`	傳回元素的固有高度 (以點為單位)。
`getInherentWidth()`	`Number`	傳回元素在點的固有寬度。
`getLeft()`	`Number`	傳回元素的水平位置 (以點的為單位，從顯示網頁。
`getNumColumns()`	`Integer`	傳回資料表中的資料欄數。
`getNumRows()`	`Integer`	傳回資料表中的資料列數。
`getObjectId()`	`String`	傳回此物件的專屬 ID。
`getPageElementType()`	`PageElementType`	傳回頁面元素的類型，以 `PageElementType` 列舉表示。
`getParentGroup()`	`Group`	傳回此頁面元素所屬的群組，或傳回 `null` (如果元素不在群組。
`getParentPage()`	`Page`	傳回這個頁面元素所在的頁面。
`getRotation()`	`Number`	傳回元素的中心以度為單位的順時針旋轉角度，其中 0 度也意味著沒有輪播
`getRow(rowIndex)`	`TableRow`	傳回表格中的指定資料列。
`getTitle()`	`String`	傳回頁面元素的替代文字標題。
`getTop()`	`Number`	從頁面左上角取得元素的垂直位置表示元素未旋轉時
`getTransform()`	`AffineTransform`	傳回頁面元素的轉換。
`getWidth()`	`Number`	傳回元素的寬度，也就是元素邊界方塊的寬度則該元素不會旋轉。
`insertColumn(index)`	`TableColumn`	在資料表指定的索引處插入新資料欄。
`insertRow(index)`	`TableRow`	在資料表指定的索引處插入新的資料列。
`preconcatenateTransform(transform)`	`Table`	將提供的轉換預先串連成頁面元素的現有轉換。
`remove()`	`void`	移除網頁元素。
`scaleHeight(ratio)`	`Table`	根據指定的比例縮放元素的高度。
`scaleWidth(ratio)`	`Table`	根據指定的比例縮放元素的寬度。
`select()`	`void`	僅選取使用中的簡報中的 `PageElement`，並移除先前使用中的任何文件。
`select(replace)`	`void`	選取目前簡報中的`PageElement`。
`sendBackward()`	`Table`	讓頁面元素回到頁面中的一個元素。
`sendToBack()`	`Table`	將網頁元素傳送至網頁背面。
`setDescription(description)`	`Table`	設定頁面元素的替代文字說明。
`setHeight(height)`	`Table`	設定元素的高度 (以點為單位)，也就是當元素沒有旋轉角度。
`setLeft(left)`	`Table`	設定元素的水平位置 (以點的為單位，從顯示網頁。
`setRotation(angle)`	`Table`	設定元素的順時針旋轉角度，以度為單位。
`setTitle(title)`	`Table`	設定頁面元素的替代文字標題。
`setTop(top)`	`Table`	設定元素的垂直位置 (從頁面左上角開始計算) 表示元素未旋轉時
`setTransform(transform)`	`Table`	使用提供的轉換設定頁面元素的轉換。
`setWidth(width)`	`Table`	設定元素的寬度 (以點為單位)，也就是當元素沒有旋轉角度。

內容詳盡的說明文件

`alignOnPage(alignmentPosition)`

將元素對齊頁面指定的對齊位置。

參數

名稱	類型	說明
`alignmentPosition`	`AlignmentPosition`	此頁面元素在網頁上的對齊位置。

回攻員

Table：此頁面元素，用於鏈結。

`appendColumn()`

在表格最後一欄的右側附加新資料欄。

回攻員

TableColumn：新的附加資料欄。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`appendRow()`

在表格最後一列的下方附加一個新資料列。

回攻員

TableRow：新的附加資料列。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`bringForward()`

將頁面元素往前移動一個元素。

網頁元素不得位於群組中。

回攻員

Table：此頁面元素，用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`bringToFront()`

將網頁元素移到網頁前方。

網頁元素不得位於群組中。

回攻員

Table：此頁面元素，用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`duplicate()`

複製頁面元素。

將重複的頁面元素放在與原始頁面位於相同位置的頁面。

回攻員

PageElement：這個頁面元素的新副本。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getCell(rowIndex, columnIndex)`

傳回表格中的指定儲存格。

參數

名稱	類型	說明
`rowIndex`	`Integer`	要擷取的儲存格列索引。
`columnIndex`	`Integer`	要擷取的儲存格欄索引。

回攻員

TableCell：擷取到表格儲存格。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getColumn(columnIndex)`

傳回表格中的指定欄。

參數

名稱	類型	說明
`columnIndex`	`Integer`	從 0 開始的欄索引。

回攻員

TableColumn：擷取的表格資料欄。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getConnectionSites()`

傳回頁面元素上的 ConnectionSite 清單；如果是網頁，則傳回空白清單元素沒有任何連接網站。

回攻員

ConnectionSite[]：連線網站清單，如果這個元素沒有連線網站，則不會顯示任何內容。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getDescription()`

傳回頁面元素的替代文字說明。說明會與顯示和讀取替代文字

回攻員

String：頁面元素的替代文字說明。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getHeight()`

取得元素的高度 (以點為單位)，也就是當元素沒有旋轉角度。

這個方法不適用於所有網頁元素。瞭解有哪些網頁元素請參閱大小和位置限制。

回攻員

Number — 網頁元素在點中的固有高度，或 null 如果網頁元素包含沒有高度

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getInherentHeight()`

傳回元素的固有高度 (以點為單位)。

頁面元素的轉換相對於本身大小。使用內部大小結合元素的轉換，以決定元素最終的視覺外觀。

回攻員

Number — 網頁元素在點中的固有高度，或 null 如果網頁元素包含沒有高度

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getInherentWidth()`

傳回元素在點的固有寬度。

頁面元素的轉換相對於本身大小。使用內部大小結合元素的轉換，以決定元素最終的視覺外觀。

回攻員

Number — 網頁元素固有的寬度，或 null 如果網頁元素包含沒有寬度

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getLeft()`

傳回元素的水平位置 (以點的為單位，從顯示網頁。

回攻員

Number：此元素的水平位置 (從頁面左上角算起)。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getNumColumns()`

傳回資料表中的資料欄數。

回攻員

Integer：這個表格的欄數。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getNumRows()`

傳回資料表中的資料列數。

回攻員

Integer：這個資料表的列數。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getObjectId()`

傳回此物件的專屬 ID。網頁和網頁元素所使用的物件 ID 不在相同的命名空間中

回攻員

String：此物件的專屬 ID。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getPageElementType()`

傳回頁面元素的類型，以 PageElementType 列舉表示。

回攻員

PageElementType：頁面元素的類型。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentGroup()`

傳回此頁面元素所屬的群組，或傳回 null (如果元素不在群組。

回攻員

Group：網頁元素所屬的群組，或 null。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getParentPage()`

傳回這個頁面元素所在的頁面。

回攻員

Page - 含有此元素的網頁。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getRotation()`

傳回元素的中心以度為單位的順時針旋轉角度，其中 0 度也意味著沒有輪播

回攻員

Number：以度為單位的旋轉角度，範圍介於 0 (含) 和 360 (不含) 之間。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getRow(rowIndex)`

傳回表格中的指定資料列。

參數

名稱	類型	說明
`rowIndex`	`Integer`	要擷取的資料列索引。

回攻員

TableRow - 擷取到表格列。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTitle()`

傳回頁面元素的替代文字標題。標題會與說明結合顯示和讀取替代文字

回攻員

String：頁面元素的替代文字標題。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTop()`

從頁面左上角取得元素的垂直位置表示元素未旋轉時

回攻員

Number：此元素的垂直位置，從頁面左上角開始。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getTransform()`

傳回頁面元素的轉換。

頁面元素的外觀取決於絕對轉換。目的地：計算絕對轉換，使用轉換將頁面元素的轉換預先串連起來所有上層群組如果網頁元素不在群組中，則此元素的絕對轉換與這個欄位中的值相同

回攻員

AffineTransform：頁面元素的轉換。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`getWidth()`

傳回元素的寬度，也就是元素邊界方塊的寬度則該元素不會旋轉。

這個方法不適用於所有網頁元素。瞭解有哪些網頁元素請參閱大小和位置限制。

回攻員

Number — 網頁元素固有的寬度，或 null 如果網頁元素包含沒有寬度

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertColumn(index)`

在資料表指定的索引處插入新資料欄。

如果指定索引左側的資料欄所有儲存格與其他儲存格合併欄中，新資料欄會插入這些儲存格涵蓋的共同欄右側。

參數

名稱	類型	說明
`index`	`Integer`	要插入新資料欄的索引。

回攻員

TableColumn - 新插入的資料欄。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`insertRow(index)`

在資料表指定的索引處插入新的資料列。

如果指定索引上方資料列中的所有儲存格與其他資料列合併，則這個新資料列已在這些儲存格範圍的共同列下方插入 1 列。

參數

名稱	類型	說明
`index`	`Integer`	要插入新資料列的索引。

回攻員

TableRow - 新插入的列。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`preconcatenateTransform(transform)`

將提供的轉換預先串連成頁面元素的現有轉換。

newTransform = argument * existingTransform

舉例來說，如要將頁面元素往左移動 36 指向左：

element.preconcatenateTransform(SlidesApp.newAffineTransformBuilder()
    .setTranslateX(-36.0)
    .build());

您也可以使用 setTransform(transform) 取代頁面元素的轉換。

參數

名稱	類型	說明
`transform`	`AffineTransform`	轉換至此頁面元素轉換的轉換。

回攻員

Table：此頁面元素，用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`remove()`

移除網頁元素。

移除作業之後，如果 Group 只包含一或多個網頁元素，群組本身也會移除

如果從主版面配置或版面配置中移除預留位置 PageElement，則任何空白沿用機制預留位置。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`scaleHeight(ratio)`

根據指定的比例縮放元素的高度。元素的高度是指元素的高度定界框。

這個方法不適用於所有網頁元素。瞭解有哪些網頁元素請參閱大小和位置限制。

參數

名稱	類型	說明
`ratio`	`Number`	此頁面元素高度的縮放比例。

回攻員

Table：此頁面元素，用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`scaleWidth(ratio)`

根據指定的比例縮放元素的寬度。元素的寬度是指定界框。

這個方法不適用於所有網頁元素。瞭解有哪些網頁元素請參閱大小和位置限制。

參數

名稱	類型	說明
`ratio`	`Number`	此頁面元素寬度的縮放比例。

回攻員

Table：此頁面元素，用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`select()`

僅選取使用中的簡報中的 PageElement，並移除先前使用中的任何文件。這與使用 true 呼叫 select(replace) 相同。

指令碼只能存取執行該指令碼的使用者所選取的項目，而且指令碼會繫結至簡報。

這會將 PageElement 的父項 Page 設為 current page selection。

var slide = SlidesApp.getActivePresentation().getSlides()[0];
var pageElement = slide.getPageElements()[0];
// Only select this page element and replace any previous selection.
pageElement.select();

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`select(replace)`

選取目前簡報中的PageElement。

指令碼只能存取執行該指令碼的使用者所選取的項目，而且指令碼會繫結至簡報。

將 true 傳遞至這個方法，即可僅選取 PageElement，並移除任何先前的選項這也會將 PageElement 的父項 Page 設為 current page selection。

傳遞 false 以選取多個 PageElement 物件。PageElement 物件必須位於同一個 Page。

使用 false 選取網頁元素時，必須符合下列條件參數：

PageElement 物件的父項 Page 必須是 current page selection。
請勿選取多個 Page 物件。

為確保這是我們建議的做法，請選取父項 Page 使用 Page.selectAsCurrentPage()，然後選取該網頁中的頁面元素

var slide = SlidesApp.getActivePresentation().getSlides()[0];
// First select the slide page, as the current page selection.
slide.selectAsCurrentPage();
// Then select all the page elements in the selected slide page.
var pageElements = slide.getPageElements();
for (var i = 0; i < pageElements.length; i++) {
  pageElements[i].select(false);
}

參數

名稱	類型	說明
`replace`	`Boolean`	如果是 `true`，所選範圍會取代先前選取的項目；否則，就會加進先前選取的項目中

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`sendBackward()`

讓頁面元素回到頁面中的一個元素。

網頁元素不得位於群組中。

回攻員

Table：此頁面元素，用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`sendToBack()`

將網頁元素傳送至網頁背面。

網頁元素不得位於群組中。

回攻員

Table：此頁面元素，用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setDescription(description)`

設定頁面元素的替代文字說明。

Group 元素不支援該方法。

// Set the first page element's alt text description to "new alt text description".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setDescription('new alt text description');
Logger.log(pageElement.getDescription());

參數

名稱	類型	說明
`description`	`String`	用來設定替代文字說明的字串。

回攻員

Table：這個網頁元素。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setHeight(height)`

設定元素的高度 (以點為單位)，也就是當元素沒有旋轉角度。

這個方法不適用於所有網頁元素。瞭解有哪些網頁元素請參閱大小和位置限制。

參數

名稱	類型	說明
`height`	`Number`	此頁面元素要設定的新高度 (以點表示)。

回攻員

Table：此頁面元素，用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setLeft(left)`

設定元素的水平位置 (以點的為單位，從顯示網頁。

參數

名稱	類型	說明
`left`	`Number`	要設定的新水平位置，以點表示。

回攻員

Table：此頁面元素，用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setRotation(angle)`

設定元素的順時針旋轉角度，以度為單位。

這個方法不適用於所有網頁元素。瞭解有哪些網頁元素請參閱大小和位置限制。

參數

名稱	類型	說明
`angle`	`Number`	要設定的新順時針旋轉角度，以度為單位。

回攻員

Table：此頁面元素，用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTitle(title)`

設定頁面元素的替代文字標題。

Group 元素不支援該方法。

// Set the first page element's alt text title to "new alt text title".
var pageElement = SlidesApp.getActivePresentation().getSlides()[0].getPageElements()[0];
pageElement.setTitle('new alt text title');
Logger.log(pageElement.getTitle());

參數

名稱	類型	說明
`title`	`String`	要設定替代文字標題的字串。

回攻員

Table：這個網頁元素。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTop(top)`

設定元素的垂直位置 (從頁面左上角開始計算) 表示元素未旋轉時

參數

名稱	類型	說明
`top`	`Number`	要設定的新垂直位置 (以點為單位)。

回攻員

Table：此頁面元素，用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setTransform(transform)`

使用提供的轉換設定頁面元素的轉換。

更新群組轉換會變更進而變更視覺外觀

更新群組中的網頁元素轉換只會變更該網頁元素這不會影響群組或群組。

如要進一步瞭解轉換如何影響頁面元素視覺外觀，請參閱 getTransform()。

參數

名稱	類型	說明
`transform`	`AffineTransform`	為這個頁面元素設定的轉換。

回攻員

Table：這個元素是用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations

`setWidth(width)`

設定元素的寬度 (以點為單位)，也就是當元素沒有旋轉角度。

這個方法不適用於所有網頁元素。瞭解有哪些網頁元素請參閱大小和位置限制。

參數

名稱	類型	說明
`width`	`Number`	此頁面元素要設定的新寬度 (以點表示)。

回攻員

Table：此頁面元素，用於鏈結。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

https://www.googleapis.com/auth/presentations.currentonly
https://www.googleapis.com/auth/presentations