Class 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
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 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`"]]