عنصر عام. يتم تمثيل محتوى Document
كعناصر. على سبيل المثال، ListItem
وParagraph
وTable
عناصر
وتكتسب جميع الطرق التي تحددها Element
، مثل getType()
.
جارٍ تنفيذ الصفوف
الاسم | وصف قصير |
---|---|
Body | عنصر يمثّل نص المستند. |
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
— العنصر الحالي.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
asDate()
لعرض العنصر الحالي كـ Date
.
وعندما تعرف أن أحد العناصر هو Date
، استخدِم هذه الطريقة لضبط نوعه على أنه Date
. يتيح ذلك إمكانية الإكمال التلقائي في محرّر "برمجة تطبيقات Google" عرض الطرق التي يمكنك استخدامها مع 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
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
، استخدِم هذه الطريقة لضبط نوعه كشخص.
يتيح ذلك إمكانية الإكمال التلقائي في محرّر "برمجة تطبيقات Google" عرض الطرق التي يمكنك استخدامها مع
عنصر الشخص.
تذكرة ذهاب وعودة
Person
- العنصر الحالي الذي تم ضبط نوعه على Person
.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
asRichLink()
لعرض العنصر الحالي بتنسيق RichLink
، مثلاً، رابط إلى ملف "جداول بيانات Google".
وعندما تعرف أن أحد العناصر هو RichLink
، استخدِم هذه الطريقة لضبط نوعه على أنه RichLink
. يتيح ذلك إمكانية الإكمال التلقائي في محرّر "برمجة تطبيقات Google" عرض الطرق التي يمكنك استخدامها مع 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()
لاسترداد سمات العنصر\u39s.
النتيجة هي كائن يحتوي على خاصية لكل سمة عنصر صالحة حيث يتوافق
كل اسم سمة مع عنصر في تعداد 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
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
's.
استخدِم 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
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();
تذكرة ذهاب وعودة
Element
— العنصر المُدمج
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
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(); }
تذكرة ذهاب وعودة
Element
- العنصر الذي تمت إزالته
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setAttributes(attributes)
تحدد سمات العنصر\u39;s.
يجب أن تكون معلّمة السمات المحدّدة عنصرًا يكون فيه كل اسم موقع عنصرًا في تعداد 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 | سمات العنصر\39;s. |
تذكرة ذهاب وعودة
Element
— العنصر الحالي.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents