Interface Element

العنصر

عنصر عام يتم تمثيل محتوى Document كعناصر. على سبيل المثال، ListItem وParagraph وTable هي عناصر ترث جميع الطرق المحدّدة بواسطة Element، مثل getType().

تنفيذ الفئات

الاسم	وصف قصير
Body	محتوى علامة تبويب في مستند "مستندات Google"
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|null	يستردّ العنصر الشقيق التالي للعنصر.
getParent()	ContainerElement|null	تعرض هذه السمة العنصر الرئيسي للعنصر الحالي.
getPreviousSibling()	Element|null	يتم استرداد العنصر الشقيق السابق للعنصر.
getType()	ElementType	يستردّ ElementType الخاص بالعنصر.
isAtDocumentEnd()	Boolean	تحدّد هذه السمة ما إذا كان العنصر في نهاية Document.
merge()	Element|null	يدمج العنصر مع العنصر الشقيق السابق من النوع نفسه.
removeFromParent()	Element|null	تزيل هذه الطريقة العنصر من العنصر الأصل.
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

---

asRichLink()

تعرض العنصر الحالي كـ RichLink، مثلاً، رابط إلى ملف في "جداول بيانات Google".

عندما تعرف أنّ العنصر هو RichLink، استخدِم هذه الطريقة لضبط نوعه على RichLink. يسمح لك ذلك بأن تعرض ميزة الإكمال التلقائي في أداة تعديل النصوص البرمجية لبرمجة تطبيقات الطرق التي يمكنك استخدامها مع 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.

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

// Append a styled paragraph.
const par = body.appendParagraph('A bold, italicized paragraph.');
par.setBold(true);
par.setItalic(true);

// Retrieve the paragraph's attributes.
const atts = par.getAttributes();

// Log the paragraph attributes.
for (const att in atts) {
  Logger.log(`${att}:${atts[att]}`);
}

الإرجاع

Object: سمات العنصر

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

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

---

getNextSibling()

يستردّ العنصر الشقيق التالي للعنصر.

العنصر الشقيق التالي له العنصر الرئيسي نفسه ويتبع العنصر الحالي.

الإرجاع

Element|null: العنصر الشقيق التالي

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

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

---

getParent()

تعرض هذه السمة العنصر الرئيسي للعنصر الحالي.

يحتوي العنصر الرئيسي على العنصر الحالي.

الإرجاع

ContainerElement|null: العنصر الرئيسي

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

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

---

getPreviousSibling()

يتم استرداد العنصر الشقيق السابق للعنصر.

العنصر الشقيق السابق له العنصر الأصلي نفسه ويسبق العنصر الحالي.

الإرجاع

‫Element|null: العنصر الشقيق السابق

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

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

---

getType()

يستردّ ElementType الخاص بالعنصر.

استخدِم getType() لتحديد النوع الدقيق لعنصر معيّن.

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

// Obtain the first element in the active tab's body.

const 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 نفسه فقط. يتم نقل أي عناصر فرعية مضمّنة في العنصر الحالي إلى العنصر الشقيق السابق.

تتم إزالة العنصر الحالي من المستند.

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

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
const par1 = body.appendParagraph('Paragraph 1.');
const 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.
const cells = [
  ['Row 1, Cell 1', 'Row 1, Cell 2'],
  ['Row 2, Cell 1', 'Row 2, Cell 2'],
];
// Build a table from the array.
const table = body.appendTable(cells);
// Get the first row in the table.
const row = table.getRow(0);
// Get the two cells in this row.
const cell1 = row.getCell(0);
const cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
const merged = cell2.merge();

الإرجاع

Element|null: العنصر المدمج

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

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

---

removeFromParent()

تزيل هذه الطريقة العنصر من العنصر الأصل.

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

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

الإرجاع

Element|null: العنصر الذي تمت إزالته

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

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

---

setAttributes(attributes)

تضبط هذه السمة سمات العنصر.

يجب أن تكون مَعلمة السمات المحدّدة عبارة عن عنصر يكون فيه كل اسم خاصية عنصرًا في التعداد DocumentApp.Attribute، وتكون كل قيمة خاصية هي القيمة الجديدة التي سيتم تطبيقها.

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

// Define a custom paragraph style.
const 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.
const 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