Interface Element

عنصر

یک عنصر عمومی محتوای Document به عنوان عناصر نمایش داده می شود. به عنوان مثال، ListItem ، Paragraph و Table عناصر هستند و تمام متدهای تعریف شده توسط Element ، مانند getType() را به ارث می برند.

اجرای کلاس ها

نام شرح مختصر
Body محتوای یک برگه در سند Google Docs.
ContainerElement یک عنصر عمومی که ممکن است حاوی عناصر دیگری باشد.
Date عنصری که تاریخ قالب بندی شده را نشان می دهد
Equation عنصری که بیانگر یک عبارت ریاضی است.
EquationFunction عنصری که یک تابع را در یک Equation ریاضی نشان می دهد.
EquationFunctionArgumentSeparator عنصری که جداکننده تابع در یک Equation ریاضی را نشان می دهد.
EquationSymbol عنصری که نمادی را در یک Equation ریاضی نشان می دهد.
FooterSection عنصری که بخش پاورقی را نشان می دهد.
Footnote عنصری که نشان دهنده پاورقی است.
FootnoteSection عنصری که بخش پاورقی را نشان می دهد.
HeaderSection عنصری که بخش سرصفحه را نشان می دهد.
HorizontalRule عنصری که یک قانون افقی را نشان می دهد.
InlineDrawing عنصری که یک طراحی جاسازی شده را نشان می دهد.
InlineImage عنصری که یک تصویر جاسازی شده را نشان می دهد.
ListItem عنصری که یک آیتم لیست را نشان می دهد.
PageBreak عنصری که نمایانگر شکست صفحه است.
Paragraph عنصری که یک پاراگراف را نشان می دهد.
Person عنصری که نشان دهنده پیوند به یک شخص است.
RichLink عنصری که پیوندی به یک منبع Google را نشان می دهد، مانند یک فایل Drive یا یک ویدیوی YouTube.
Table عنصری که یک جدول را نشان می دهد.
TableCell عنصری که نشان دهنده یک سلول جدول است.
TableOfContents عنصری که حاوی فهرست مطالب است.
TableRow عنصری که یک ردیف جدول را نشان می دهد.
Text عنصری که یک منطقه متن غنی را نشان می دهد.
UnsupportedElement عنصری که منطقه ای را نشان می دهد که ناشناخته است یا نمی تواند تحت تأثیر یک اسکریپت قرار گیرد، مانند شماره صفحه.

روش ها

روش نوع برگشت شرح مختصر
asBody() Body عنصر فعلی را به عنوان Body برمی‌گرداند.
asDate() Date عنصر فعلی را به عنوان Date برمی‌گرداند.
asEquation() Equation عنصر جاری را به صورت Equation برمی‌گرداند.
asEquationFunction() EquationFunction عنصر فعلی را به عنوان یک EquationFunction برمی‌گرداند.
asEquationFunctionArgumentSeparator() EquationFunctionArgumentSeparator عنصر فعلی را به عنوان یک EquationFunctionArgumentSeparator برمی گرداند.
asEquationSymbol() EquationSymbol عنصر فعلی را به عنوان EquationSymbol برمی‌گرداند.
asFooterSection() FooterSection عنصر فعلی را به صورت FooterSection برمی‌گرداند.
asFootnote() Footnote عنصر فعلی را به عنوان Footnote برمی گرداند.
asFootnoteSection() FootnoteSection عنصر فعلی را به عنوان FootnoteSection برمی گرداند.
asHeaderSection() HeaderSection عنصر فعلی را به عنوان HeaderSection برمی‌گرداند.
asHorizontalRule() HorizontalRule عنصر فعلی را به صورت HorizontalRule برمی‌گرداند.
asInlineDrawing() InlineDrawing عنصر فعلی را به صورت InlineDrawing برمی‌گرداند.
asInlineImage() InlineImage عنصر فعلی را به عنوان InlineImage برمی‌گرداند.
asListItem() ListItem عنصر فعلی را به عنوان ListItem برمی گرداند.
asPageBreak() PageBreak عنصر فعلی را به صورت PageBreak برمی‌گرداند.
asParagraph() Paragraph عنصر فعلی را به عنوان یک Paragraph برمی گرداند.
asPerson() Person عنصر فعلی را به عنوان یک Person برمی گرداند.
asRichLink() RichLink عنصر فعلی را به عنوان یک RichLink برمی‌گرداند، به عنوان مثال، پیوندی به فایل کاربرگ‌نگار Google.
asTable() Table عنصر فعلی را به صورت Table برمی گرداند.
asTableCell() TableCell عنصر فعلی را به عنوان TableCell برمی‌گرداند.
asTableOfContents() TableOfContents عنصر فعلی را به عنوان TableOfContents برمی گرداند.
asTableRow() TableRow عنصر فعلی را به عنوان TableRow برمی‌گرداند.
asText() Text عنصر فعلی را به عنوان یک Text برمی گرداند.
copy() Element یک کپی جدا شده و عمیق از عنصر فعلی را برمی گرداند.
getAttributes() Object ویژگی های عنصر را بازیابی می کند.
getNextSibling() Element عنصر خواهر و برادر بعدی عنصر را بازیابی می کند.
getParent() ContainerElement عنصر والد عنصر را بازیابی می کند.
getPreviousSibling() Element عنصر خواهر و برادر قبلی عنصر را بازیابی می کند.
getType() ElementType ElementType عنصر را بازیابی می کند.
isAtDocumentEnd() Boolean تعیین می کند که آیا عنصر در انتهای Document قرار دارد یا خیر.
merge() Element عنصر را با خواهر و برادر قبلی از همان نوع ادغام می کند.
removeFromParent() Element عنصر را از والد خود حذف می کند.
setAttributes(attributes) Element ویژگی های عنصر را تنظیم می کند.

مستندات دقیق

asBody()

عنصر فعلی را به عنوان Body برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

Body - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asDate()

عنصر فعلی را به عنوان Date برمی‌گرداند.

هنگامی که می دانید یک عنصر یک Date است، از این روش برای تنظیم نوع آن به عنوان Date استفاده کنید. با انجام این کار، تکمیل خودکار در ویرایشگر اسکریپت برنامه‌ها روش‌هایی را که می‌توانید با Date استفاده کنید به شما نشان می‌دهد.

بازگشت

Date - عنصر فعلی با نوع آن به عنوان Date تنظیم شده است.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asEquation()

عنصر جاری را به صورت Equation برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

Equation - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asEquationFunction()

عنصر فعلی را به عنوان یک EquationFunction برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

EquationFunction - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asEquationFunctionArgumentSeparator()

عنصر فعلی را به عنوان یک EquationFunctionArgumentSeparator برمی گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

EquationFunctionArgumentSeparator - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asEquationSymbol()

عنصر فعلی را به عنوان EquationSymbol برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

EquationSymbol - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asFooterSection()

عنصر فعلی را به صورت FooterSection برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

FooterSection - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asFootnote()

عنصر فعلی را به عنوان Footnote برمی گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

Footnote - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asFootnoteSection()

عنصر فعلی را به عنوان FootnoteSection برمی گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

FootnoteSection - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asHeaderSection()

عنصر فعلی را به عنوان HeaderSection برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

HeaderSection - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asHorizontalRule()

عنصر فعلی را به صورت HorizontalRule برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

HorizontalRule - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asInlineDrawing()

عنصر فعلی را به صورت InlineDrawing برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

InlineDrawing - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asInlineImage()

عنصر فعلی را به عنوان InlineImage برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

InlineImage - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asListItem()

عنصر فعلی را به عنوان ListItem برمی گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

ListItem - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asPageBreak()

عنصر فعلی را به عنوان یک PageBreak برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

PageBreak - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asParagraph()

عنصر فعلی را به عنوان یک Paragraph برمی گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

Paragraph - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asPerson()

عنصر فعلی را به عنوان یک Person برمی گرداند.

هنگامی که می دانید یک عنصر یک Person است، از این روش برای تنظیم نوع آن به عنوان یک شخص استفاده کنید. با انجام این کار، تکمیل خودکار در ویرایشگر اسکریپت برنامه‌ها، روش‌هایی را که می‌توانید با عنصر شخص استفاده کنید، به شما نشان می‌دهد.

بازگشت

Person - عنصر فعلی با نوع آن به عنوان Person تنظیم شده است.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

عنصر فعلی را به عنوان یک RichLink برمی‌گرداند، به عنوان مثال، پیوندی به فایل کاربرگ‌نگار Google.

هنگامی که می دانید یک عنصر یک RichLink است، از این روش برای تنظیم نوع آن به عنوان یک RichLink استفاده کنید. با انجام این کار، تکمیل خودکار در ویرایشگر Apps Script روش‌هایی را که می‌توانید با RichLink استفاده کنید به شما نشان می‌دهد.

بازگشت

RichLink - عنصر فعلی با نوع آن RichLink تنظیم شده است.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asTable()

عنصر فعلی را به صورت Table برمی گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

Table - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asTableCell()

عنصر فعلی را به عنوان TableCell برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

TableCell - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asTableOfContents()

عنصر فعلی را به عنوان TableOfContents برمی گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

TableOfContents - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asTableRow()

عنصر فعلی را به عنوان TableRow برمی‌گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

TableRow - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

asText()

عنصر فعلی را به عنوان یک Text برمی گرداند.

از این روش برای کمک به تکمیل خودکار هر زمان که یک عنصر مشخص از نوع خاصی است استفاده کنید.

بازگشت

Text - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

copy()

یک کپی جدا شده و عمیق از عنصر فعلی را برمی گرداند.

هر عنصر فرزند موجود در عنصر نیز کپی می شود. عنصر جدید والد ندارد.

بازگشت

Element - کپی جدید.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getAttributes()

ویژگی های عنصر را بازیابی می کند.

نتیجه یک شی حاوی یک ویژگی برای هر ویژگی عنصر معتبر است که در آن نام هر ویژگی با یک مورد در شمارش DocumentApp.Attribute مطابقت دارد.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.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

getNextSibling()

عنصر خواهر و برادر بعدی عنصر را بازیابی می کند.

خواهر و برادر بعدی همان والد را دارد و از عنصر فعلی پیروی می کند.

بازگشت

Element - عنصر خواهر و برادر بعدی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • 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

getPreviousSibling()

عنصر خواهر و برادر قبلی عنصر را بازیابی می کند.

خواهر و برادر قبلی والد مشابهی دارد و مقدم بر عنصر فعلی است.

بازگشت

Element - عنصر خواهر و برادر قبلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

getType()

ElementType عنصر را بازیابی می کند.

از getType() برای تعیین نوع دقیق یک عنصر استفاده کنید.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Obtain the first element in the active tab's 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

isAtDocumentEnd()

تعیین می کند که آیا عنصر در انتهای Document قرار دارد یا خیر.

بازگشت

Boolean - اینکه آیا عنصر در انتهای برگه است.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

merge()

عنصر را با خواهر و برادر قبلی از همان نوع ادغام می کند.

فقط عناصر همان ElementType را می توان ادغام کرد. هر عنصر فرزند موجود در عنصر فعلی به عنصر خواهر و برادر قبلی منتقل می شود.

عنصر فعلی از سند حذف می شود.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
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();

بازگشت

Element - عنصر ادغام شده.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

removeFromParent()

عنصر را از والد خود حذف می کند.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab()
var body = documentTab.getBody();

// Remove all images in the active tab's body.
var imgs = body.getImages();
for (var i = 0; i < imgs.length; i++) {
  imgs[i].removeFromParent();
}

بازگشت

Element - عنصر حذف شده.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

setAttributes(attributes)

ویژگی های عنصر را تنظیم می کند.

پارامتر مشخصه مشخص شده باید یک شی باشد که در آن نام هر ویژگی یک مورد در شمارش DocumentApp.Attribute باشد و هر مقدار ویژگی مقدار جدیدی است که باید اعمال شود.

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.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 ویژگی های عنصر

بازگشت

Element - عنصر فعلی.

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents