عنصری که یک ردیف جدول را نشان می دهد. یک TableRow
همیشه در یک Table
قرار دارد و ممکن است فقط حاوی عناصر TableCell
باشد. برای اطلاعات بیشتر در مورد ساختار سند، راهنمای گسترش Google Docs را ببینید.
مواد و روش ها
روش | نوع برگشت | توضیح مختصر |
---|---|---|
appendTableCell() | TableCell | یک TableCell جدید ایجاد و اضافه می کند. |
appendTableCell(textContents) | TableCell | TableCell داده شده را حاوی متن مشخص شده اضافه می کند. |
appendTableCell(tableCell) | TableCell | TableCell داده شده را اضافه می کند. |
clear() | TableRow | محتویات عنصر را پاک می کند. |
copy() | TableRow | یک کپی جدا شده و عمیق از عنصر فعلی را برمی گرداند. |
editAsText() | Text | یک نسخه Text از عنصر فعلی را برای ویرایش دریافت می کند. |
findElement(elementType) | RangeElement | محتویات عنصر را برای یک نسل از نوع مشخص شده جستجو می کند. |
findElement(elementType, from) | RangeElement | محتویات عنصر را برای یک نسل از نوع مشخص شده جستجو می کند، که از RangeElement مشخص شده شروع می شود. |
findText(searchPattern) | RangeElement | با استفاده از عبارات منظم، محتویات عنصر را برای الگوی متن مشخص شده جستجو می کند. |
findText(searchPattern, from) | RangeElement | محتویات عنصر را برای الگوی متن مشخص شده، از یک نتیجه جستجوی معین شروع می کند. |
getAttributes() | Object | ویژگی های عنصر را بازیابی می کند. |
getCell(cellIndex) | TableCell | TableCell را در نمایه سلول مشخص شده بازیابی می کند. |
getChild(childIndex) | Element | عنصر فرزند را در نمایه فرزند مشخص شده بازیابی می کند. |
getChildIndex(child) | Integer | شاخص فرزند را برای عنصر فرزند مشخص شده بازیابی می کند. |
getLinkUrl() | String | آدرس لینک را بازیابی می کند. |
getMinimumHeight() | Number | حداقل ارتفاع را بر حسب امتیاز بازیابی می کند. |
getNextSibling() | Element | عنصر خواهر و برادر بعدی عنصر را بازیابی می کند. |
getNumCells() | Integer | تعداد سلول های ردیف را بازیابی می کند. |
getNumChildren() | Integer | تعداد فرزندان را بازیابی می کند. |
getParent() | ContainerElement | عنصر والد عنصر را بازیابی می کند. |
getParentTable() | Table | Table حاوی ردیف فعلی را بازیابی می کند. |
getPreviousSibling() | Element | عنصر خواهر و برادر قبلی عنصر را بازیابی می کند. |
getText() | String | محتویات عنصر را به عنوان یک رشته متنی بازیابی می کند. |
getTextAlignment() | TextAlignment | تراز متن را دریافت می کند. |
getType() | ElementType | ElementType عنصر را بازیابی می کند. |
insertTableCell(childIndex) | TableCell | یک TableCell جدید را در نمایه مشخص شده ایجاد و درج می کند. |
insertTableCell(childIndex, textContents) | TableCell | TableCell داده شده را در نمایه مشخص شده، حاوی متن داده شده، درج می کند. |
insertTableCell(childIndex, tableCell) | TableCell | TableCell داده شده را در شاخص مشخص شده درج می کند. |
isAtDocumentEnd() | Boolean | تعیین می کند که آیا عنصر در انتهای Document قرار دارد یا خیر. |
merge() | TableRow | عنصر را با خواهر و برادر قبلی از همان نوع ادغام می کند. |
removeCell(cellIndex) | TableCell | TableCell در نمایه سلول مشخص شده حذف می کند. |
removeChild(child) | TableRow | عنصر فرزند مشخص شده را حذف می کند. |
removeFromParent() | TableRow | عنصر را از والد خود حذف می کند. |
replaceText(searchPattern, replacement) | Element | با استفاده از عبارات منظم، تمام رخدادهای یک الگوی متنی را با یک رشته جایگزین معین جایگزین میکند. |
setAttributes(attributes) | TableRow | ویژگی های عنصر را تنظیم می کند. |
setLinkUrl(url) | TableRow | آدرس لینک را تنظیم می کند. |
setMinimumHeight(minHeight) | TableRow | حداقل ارتفاع را بر حسب امتیاز تنظیم می کند. |
setTextAlignment(textAlignment) | TableRow | تراز متن را تنظیم می کند. |
مستندات دقیق
appendTableCell()
appendTableCell(textContents)
TableCell
داده شده را حاوی متن مشخص شده اضافه می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
textContents | String | محتویات متن سلول |
برگشت
TableCell
- عنصر سلول جدول ضمیمه شده
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendTableCell(tableCell)
TableCell
داده شده را اضافه می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
tableCell | TableCell | سلول جدول برای پیوست |
برگشت
TableCell
- سلول جدول ضمیمه شده
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
clear()
copy()
یک کپی جدا شده و عمیق از عنصر فعلی را برمی گرداند.
هر عنصر فرزند موجود در عنصر نیز کپی می شود. عنصر جدید والد ندارد.
برگشت
TableRow
- کپی جدید.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
editAsText()
یک نسخه Text
از عنصر فعلی را برای ویرایش دریافت می کند.
از editAsText
برای دستکاری محتویات عناصر به عنوان متن غنی استفاده کنید. حالت editAsText
عناصر غیر متنی (مانند InlineImage
و HorizontalRule
) را نادیده می گیرد.
عناصر فرزند به طور کامل در محدوده متن حذف شده از عنصر حذف می شوند.
var body = DocumentApp.getActiveDocument().getBody(); // Insert two paragraphs separated by a paragraph containing an // horizontal rule. body.insertParagraph(0, "An editAsText sample."); body.insertHorizontalRule(0); body.insertParagraph(0, "An example."); // Delete " sample.\n\n An" removing the horizontal rule in the process. body.editAsText().deleteText(14, 25);
برگشت
Text
- نسخه متنی عنصر فعلی
findElement(elementType)
محتویات عنصر را برای یک نسل از نوع مشخص شده جستجو می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
elementType | ElementType | نوع عنصر مورد جستجو |
برگشت
RangeElement
- یک نتیجه جستجو که موقعیت عنصر جستجو را نشان می دهد
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findElement(elementType, from)
محتویات عنصر را برای یک نسل از نوع مشخص شده جستجو می کند، که از RangeElement
مشخص شده شروع می شود.
// Get the body section of the active document. var body = DocumentApp.getActiveDocument().getBody(); // Define the search parameters. var searchType = DocumentApp.ElementType.PARAGRAPH; var searchHeading = DocumentApp.ParagraphHeading.HEADING1; var searchResult = null; // Search until the paragraph is found. while (searchResult = body.findElement(searchType, searchResult)) { var par = searchResult.getElement().asParagraph(); if (par.getHeading() == searchHeading) { // Found one, update and stop. par.setText('This is the first header.'); return; } }
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
elementType | ElementType | نوع عنصر مورد جستجو |
from | RangeElement | نتیجه جستجو برای جستجو از |
برگشت
RangeElement
- یک نتیجه جستجو که موقعیت بعدی عنصر جستجو را نشان می دهد
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findText(searchPattern)
با استفاده از عبارات منظم، محتویات عنصر را برای الگوی متن مشخص شده جستجو می کند.
زیرمجموعه ای از ویژگی های عبارت منظم جاوا اسکریپت به طور کامل پشتیبانی نمی شود، مانند گروه های ضبط و اصلاح کننده های حالت.
الگوی عبارت منظم ارائه شده به طور مستقل با هر بلوک متن موجود در عنصر فعلی مطابقت دارد.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
searchPattern | String | الگوی جستجو |
برگشت
RangeElement
- یک نتیجه جستجو که موقعیت متن جستجو را نشان می دهد، یا اگر مطابقت نداشته باشد، پوچ است
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findText(searchPattern, from)
محتویات عنصر را برای الگوی متن مشخص شده، از یک نتیجه جستجوی معین شروع می کند.
زیرمجموعه ای از ویژگی های عبارت منظم جاوا اسکریپت به طور کامل پشتیبانی نمی شود، مانند گروه های ضبط و اصلاح کننده های حالت.
الگوی عبارت منظم ارائه شده به طور مستقل با هر بلوک متن موجود در عنصر فعلی مطابقت دارد.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
searchPattern | String | الگوی جستجو |
from | RangeElement | نتیجه جستجو برای جستجو از |
برگشت
RangeElement
- یک نتیجه جستجو که موقعیت بعدی متن جستجو را نشان می دهد، یا اگر مطابقت نداشته باشد، پوچ است
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getAttributes()
ویژگی های عنصر را بازیابی می کند.
نتیجه یک شی حاوی یک ویژگی برای هر ویژگی عنصر معتبر است که در آن نام هر ویژگی با یک مورد در شمارش DocumentApp.Attribute
مطابقت دارد.
var body = DocumentApp.getActiveDocument().getBody(); // Append a styled paragraph. var par = body.appendParagraph('A bold, italicized paragraph.'); par.setBold(true); par.setItalic(true); // Retrieve the paragraph's attributes. var atts = par.getAttributes(); // Log the paragraph attributes. for (var att in atts) { Logger.log(att + ":" + atts[att]); }
برگشت
Object
- ویژگی های عنصر.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getCell(cellIndex)
TableCell
را در نمایه سلول مشخص شده بازیابی می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
cellIndex | Integer | شاخص سلول برای بازیابی |
برگشت
TableCell
- سلول جدول
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getChild(childIndex)
عنصر فرزند را در نمایه فرزند مشخص شده بازیابی می کند.
// Get the body section of the active document. var body = DocumentApp.getActiveDocument().getBody(); // Obtain the first element in the document. var firstChild = body.getChild(0); // If it's a paragraph, set its contents. if (firstChild.getType() == DocumentApp.ElementType.PARAGRAPH) { firstChild.asParagraph().setText("This is the first paragraph."); }
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
childIndex | Integer | شاخص عنصر فرزند برای بازیابی |
برگشت
Element
- عنصر فرزند در شاخص مشخص شده
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getChildIndex(child)
شاخص فرزند را برای عنصر فرزند مشخص شده بازیابی می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
child | Element | عنصر فرزند که برای بازیابی ایندکس |
برگشت
Integer
- شاخص فرزند
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLinkUrl()
آدرس لینک را بازیابی می کند.
برگشت
String
- URL پیوند یا اگر عنصر حاوی مقادیر متعددی برای این ویژگی باشد، null است
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getMinimumHeight()
حداقل ارتفاع را بر حسب امتیاز بازیابی می کند.
برگشت
Number
- حداقل ارتفاع، بر حسب امتیاز
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getNextSibling()
عنصر خواهر و برادر بعدی عنصر را بازیابی می کند.
خواهر و برادر بعدی همان والد را دارد و از عنصر فعلی پیروی می کند.
برگشت
Element
- عنصر خواهر و برادر بعدی.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getNumCells()
تعداد سلول های ردیف را بازیابی می کند.
برگشت
Integer
- تعداد سلول ها
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getNumChildren()
تعداد فرزندان را بازیابی می کند.
// Get the body section of the active document. var body = DocumentApp.getActiveDocument().getBody(); // Log the number of elements in the document. Logger.log("There are " + body.getNumChildren() + " elements in the document body.");
برگشت
Integer
- تعداد فرزندان
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getParent()
عنصر والد عنصر را بازیابی می کند.
عنصر والد حاوی عنصر فعلی است.
برگشت
ContainerElement
- عنصر والد.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getParentTable()
getPreviousSibling()
عنصر خواهر و برادر قبلی عنصر را بازیابی می کند.
خواهر و برادر قبلی والد مشابهی دارد و مقدم بر عنصر فعلی است.
برگشت
Element
- عنصر خواهر و برادر قبلی.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getText()
محتویات عنصر را به عنوان یک رشته متنی بازیابی می کند.
برگشت
String
- محتویات عنصر به عنوان رشته متن
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getTextAlignment()
تراز متن را دریافت می کند. انواع موجود ترازها DocumentApp.TextAlignment.NORMAL
، DocumentApp.TextAlignment.SUBSCRIPT
و DocumentApp.TextAlignment.SUPERSCRIPT
هستند.
برگشت
TextAlignment
- نوع همترازی متن، یا اگر متن حاوی چندین نوع همترازی متن باشد یا اگر تراز متن هرگز تنظیم نشده باشد null
.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getType()
ElementType
عنصر را بازیابی می کند.
از getType()
برای تعیین نوع دقیق عنصر داده شده استفاده کنید.
var body = DocumentApp.getActiveDocument().getBody(); // Obtain the first element in the document body. var firstChild = body.getChild(0); // Use getType() to determine the element's type. if (firstChild.getType() == DocumentApp.ElementType.PARAGRAPH) { Logger.log('The first element is a paragraph.'); } else { Logger.log('The first element is not a paragraph.'); }
برگشت
ElementType
- نوع عنصر.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertTableCell(childIndex)
یک TableCell
جدید را در نمایه مشخص شده ایجاد و درج می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
childIndex | Integer | شاخصی که در آن عنصر درج می شود |
برگشت
TableCell
- سلول جدول جدید
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertTableCell(childIndex, textContents)
TableCell
داده شده را در نمایه مشخص شده، حاوی متن داده شده، درج می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
childIndex | Integer | شاخصی که در آن عنصر درج می شود |
textContents | String | محتویات متن سلول |
برگشت
TableCell
- سلول جدول درج شده
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertTableCell(childIndex, tableCell)
TableCell
داده شده را در شاخص مشخص شده درج می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
childIndex | Integer | شاخصی که در آن عنصر درج می شود |
tableCell | TableCell | سلول جدول برای درج |
برگشت
TableCell
- سلول جدول درج شده
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isAtDocumentEnd()
تعیین می کند که آیا عنصر در انتهای Document
قرار دارد یا خیر.
برگشت
Boolean
- اینکه آیا عنصر در انتهای سند است.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
merge()
عنصر را با خواهر و برادر قبلی از همان نوع ادغام می کند.
فقط عناصر همان ElementType
را می توان ادغام کرد. هر عنصر فرزند موجود در عنصر فعلی به عنصر خواهر و برادر قبلی منتقل می شود.
عنصر فعلی از سند حذف می شود.
var body = DocumentApp.getActiveDocument().getBody(); // Example 1: Merge paragraphs // Append two paragraphs to the document. var par1 = body.appendParagraph('Paragraph 1.'); var par2 = body.appendParagraph('Paragraph 2.'); // Merge the newly added paragraphs into a single paragraph. par2.merge(); // Example 2: Merge table cells // Create a two-dimensional array containing the table's cell contents. var cells = [ ['Row 1, Cell 1', 'Row 1, Cell 2'], ['Row 2, Cell 1', 'Row 2, Cell 2'] ]; // Build a table from the array. var table = body.appendTable(cells); // Get the first row in the table. var row = table.getRow(0); // Get the two cells in this row. var cell1 = row.getCell(0); var cell2 = row.getCell(1); // Merge the current cell into its preceding sibling element. var merged = cell2.merge();
برگشت
TableRow
- عنصر ادغام شده.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
removeCell(cellIndex)
TableCell
در نمایه سلول مشخص شده حذف می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
cellIndex | Integer | شاخص سلولی که باید حذف شود |
برگشت
TableCell
- سلول حذف شده
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
removeChild(child)
عنصر فرزند مشخص شده را حذف می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
child | Element | عنصر فرزند برای حذف |
برگشت
TableRow
- عنصر فعلی
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
removeFromParent()
عنصر را از والد خود حذف می کند.
var body = DocumentApp.getActiveDocument().getBody(); // Remove all images in the document body. var imgs = body.getImages(); for (var i = 0; i < imgs.length; i++) { imgs[i].removeFromParent(); }
برگشت
TableRow
- عنصر حذف شده.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
replaceText(searchPattern, replacement)
با استفاده از عبارات منظم، تمام رخدادهای یک الگوی متنی را با یک رشته جایگزین معین جایگزین میکند.
الگوی جستجو به عنوان یک رشته ارسال می شود، نه یک شیء عبارت منظم جاوا اسکریپت. به همین دلیل شما باید از هر گونه بک اسلش در الگو فرار کنید.
این روش از کتابخانه عبارات منظم RE2 گوگل استفاده می کند که نحو پشتیبانی شده را محدود می کند.
الگوی عبارت منظم ارائه شده به طور مستقل با هر بلوک متن موجود در عنصر فعلی مطابقت دارد.
var body = DocumentApp.getActiveDocument().getBody(); // Clear the text surrounding "Apps Script", with or without text. body.replaceText("^.*Apps ?Script.*$", "Apps Script");
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
searchPattern | String | الگوی regex برای جستجو |
replacement | String | متن برای استفاده به عنوان جایگزین |
برگشت
Element
- عنصر فعلی
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setAttributes(attributes)
ویژگی های عنصر را تنظیم می کند.
پارامتر مشخصه مشخص شده باید یک شی باشد که در آن نام هر ویژگی یک مورد در شمارش DocumentApp.Attribute
باشد و هر مقدار ویژگی مقدار جدیدی است که باید اعمال شود.
var body = DocumentApp.getActiveDocument().getBody(); // Define a custom paragraph style. var style = {}; style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] = DocumentApp.HorizontalAlignment.RIGHT; style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri'; style[DocumentApp.Attribute.FONT_SIZE] = 18; style[DocumentApp.Attribute.BOLD] = true; // Append a plain paragraph. var par = body.appendParagraph('A paragraph with custom style.'); // Apply the custom style. par.setAttributes(style);
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
attributes | Object | ویژگی های عنصر |
برگشت
TableRow
- عنصر فعلی.
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLinkUrl(url)
آدرس لینک را تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
url | String | آدرس لینک |
برگشت
TableRow
- عنصر فعلی
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setMinimumHeight(minHeight)
حداقل ارتفاع را بر حسب امتیاز تنظیم می کند.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
minHeight | Number | حداقل ارتفاع بر حسب امتیاز |
برگشت
TableRow
- عنصر فعلی
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setTextAlignment(textAlignment)
تراز متن را تنظیم می کند. انواع موجود ترازها DocumentApp.TextAlignment.NORMAL
، DocumentApp.TextAlignment.SUBSCRIPT
و DocumentApp.TextAlignment.SUPERSCRIPT
هستند.
// Make the entire first paragraph be superscript. var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
textAlignment | TextAlignment | نوع تراز متنی که باید اعمال شود |
برگشت
TableRow
- عنصر فعلی
مجوز
اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents