Class TableRow
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
TableRow
資料表中的一列。資料列由表格儲存格清單組成。資料列是由資料列索引識別。
內容詳盡的說明文件
getCell(cellIndex)
傳回指定索引的儲存格。
參數
名稱 | 類型 | 說明 |
cellIndex | Integer | 要擷取的儲存格索引 (從 0 開始)。 |
回攻員
TableCell
:儲存格。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getIndex()
傳回資料列的索引 (從 0 開始)。
回攻員
Integer
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getMinimumHeight()
傳回列的最小高度 (以點為單位)。實際高度取決於儲存格內容的長度。
回攻員
Number
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getNumCells()
傳回這個資料列中的儲存格數量。
回攻員
Integer
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParentTable()
傳回包含目前資料列的資料表。
回攻員
Table
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
remove()
移除表格列。
如果資料列中的所有儲存格都與其他資料列合併,系統會移除這些儲存格跨越的共同資料列。
如果移除後表格中沒有任何資料列,整個表格就會遭到移除。
授權
使用這個方法的腳本需要具備下列一或多個範圍的授權:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eA \u003ccode\u003eTableRow\u003c/code\u003e represents a row within a table in Google Slides, comprised of a list of table cells and identified by its index.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can access and manipulate \u003ccode\u003eTableRow\u003c/code\u003e objects using methods like \u003ccode\u003egetCell()\u003c/code\u003e, \u003ccode\u003egetIndex()\u003c/code\u003e, \u003ccode\u003egetMinimumHeight()\u003c/code\u003e, \u003ccode\u003egetNumCells()\u003c/code\u003e, \u003ccode\u003egetParentTable()\u003c/code\u003e, and \u003ccode\u003eremove()\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eTableRow\u003c/code\u003e methods allow for retrieving specific cells, obtaining row properties (index, minimum height, number of cells), accessing the parent table, and removing the row entirely.\u003c/p\u003e\n"],["\u003cp\u003eUsing these methods requires authorization with specific scopes related to Google Presentations.\u003c/p\u003e\n"]]],["A table row, identified by its index, contains a list of cells. Key actions include: retrieving a specific cell by its index (`getCell`), obtaining the row's index (`getIndex`), getting the minimum row height (`getMinimumHeight`), determining the number of cells (`getNumCells`), finding the parent table (`getParentTable`), and removing the row (`remove`). Removing a row may also remove merged or even the whole table if necessary. Accessing these methods requires specific authorization scopes.\n"],null,["# Class TableRow\n\nTableRow\n\nA row in a table. A row consists of a list of table cells. A row is identified by the row index. \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------|-------------------------------------------------------|--------------------------------------------------|\n| [getCell(cellIndex)](#getCell(Integer)) | [TableCell](/apps-script/reference/slides/table-cell) | Returns the cell at the specified index. |\n| [getIndex()](#getIndex()) | `Integer` | Returns the 0-based index of the row. |\n| [getMinimumHeight()](#getMinimumHeight()) | `Number` | Returns the minimum height of the row in points. |\n| [getNumCells()](#getNumCells()) | `Integer` | Returns the number of cells in this row. |\n| [getParentTable()](#getParentTable()) | [Table](/apps-script/reference/slides/table) | Returns the table containing the current row. |\n| [remove()](#remove()) | `void` | Removes the table row. |\n\nDetailed documentation\n----------------------\n\n### `get``Cell(cellIndex)`\n\nReturns the cell at the specified index.\n\n#### Parameters\n\n| Name | Type | Description |\n|---------------|-----------|--------------------------------------------|\n| `cell``Index` | `Integer` | The 0-based index of the cell to retrieve. |\n\n#### Return\n\n\n[TableCell](/apps-script/reference/slides/table-cell) --- the cell.\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `get``Index()`\n\nReturns the 0-based index of the row.\n\n#### Return\n\n\n`Integer`\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `get``Minimum``Height()`\n\nReturns the minimum height of the row in points. The actual height depends on the length of the\ncontent of the cell.\n\n#### Return\n\n\n`Number`\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `get``Num``Cells()`\n\nReturns the number of cells in this row.\n\n#### Return\n\n\n`Integer`\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `get``Parent``Table()`\n\nReturns the table containing the current row.\n\n#### Return\n\n\n[Table](/apps-script/reference/slides/table)\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `remove()`\n\nRemoves the table row.\n\nIf all the cells in the row are merged with other rows, the common rows spanned by these\ncells are removed.\n\nIf no rows remain in the table after this removal, the whole table is removed.\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`"]]