يشير ذلك المصطلح إلى عنصر يمثّل عنصر قائمة. ListItem
هو Paragraph
مرتبط.
بمعرّف قائمة. قد تحتوي ListItem
على Equation
وFootnote
وHorizontalRule
وInlineDrawing
وInlineImage
وPageBreak
وText
.
عناصر. لمزيد من المعلومات عن بنية المستند، يُرجى الاطّلاع على دليل توسيع نطاق عمل "مستندات Google".
لا يجوز أن يحتوي ListItems
على أحرف سطر جديد. الأحرف الجديدة ("\n")
تم تحويلها إلى أحرف فاصل أسطر ("\r").
ListItems
التي لها رقم تعريف القائمة نفسه تنتمي إلى القائمة نفسها ويتم ترقيمها وفقًا لذلك.
لا يُشترط أن يكون ListItems
لقائمة معيّنة بجانب علامة التبويب أو حتى
نفس العنصر الأصلي. قد يوجد عنصران ينتميان إلى نفس القائمة في أي مكان في علامة التبويب
الحفاظ على الترقيم المتتالية، كما هو موضح في المثال التالي:
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Append a new list item to the body. var item1 = body.appendListItem('Item 1'); // Log the new list item's list ID. Logger.log(item1.getListId()); // Append a table after the list item. body.appendTable([ ['Cell 1', 'Cell 2'] ]); // Append a second list item with the same list ID. The two items are treated as the same list, // despite not being consecutive. var item2 = body.appendListItem('Item 2'); item2.setListId(item1);
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
addPositionedImage(image) | PositionedImage | لإنشاء PositionedImage جديد وإدراجه من الكائن الثنائي الكبير (blob) للصورة المحدد. |
appendHorizontalRule() | HorizontalRule | تنشئ سمة HorizontalRule جديدة وتلحقها |
appendInlineImage(image) | InlineImage | تنشئ هذه الدالة InlineImage جديدًا وتلحقه من الكائن الثنائي الكبير المحدّد للصورة. |
appendInlineImage(image) | InlineImage | تُرفِق السمة InlineImage المحدّدة. |
appendPageBreak() | PageBreak | تنشئ سمة PageBreak جديدة وتلحقها |
appendPageBreak(pageBreak) | PageBreak | تُرفِق السمة PageBreak المحدّدة. |
appendText(text) | Text | تنشئ هذه الطريقة عنصر Text جديدًا وتتضمّن المحتوى المحدّد وتُلحقه. |
appendText(text) | Text | لإلحاق عنصر Text المحدّد |
clear() | ListItem | يؤدي إلى محو محتوى العنصر. |
copy() | ListItem | لعرض نسخة منفصلة عميقة من العنصر الحالي. |
editAsText() | Text | الحصول على نسخة Text من العنصر الحالي للتعديل. |
findElement(elementType) | RangeElement | يبحث في محتوى العنصر عن تابع من النوع المحدد. |
findElement(elementType, from) | RangeElement | يبحث في محتوى العنصر عن تابع من النوع المحدد، بدءًا من
تم تحديد RangeElement . |
findText(searchPattern) | RangeElement | للبحث في محتويات العنصر عن نمط النص المحدد باستخدام التعبيرات العادية. |
findText(searchPattern, from) | RangeElement | يبحث في محتويات العنصر عن نمط النص المحدد، بدءًا من عنصر نتيجة البحث. |
getAlignment() | HorizontalAlignment | لاسترداد HorizontalAlignment . |
getAttributes() | Object | يسترد سمات العنصر. |
getChild(childIndex) | Element | استرداد العنصر الفرعي في الفهرس الفرعي المحدد. |
getChildIndex(child) | Integer | استرداد الفهرس الفرعي للعنصر الفرعي المحدد. |
getGlyphType() | GlyphType | لاسترداد GlyphType لعنصر القائمة. |
getHeading() | ParagraphHeading | لاسترداد ParagraphHeading . |
getIndentEnd() | Number | لاسترداد المسافة البادئة للنهاية بالنقاط. |
getIndentFirstLine() | Number | لاسترداد المسافة البادئة للسطر الأول بالنقاط. |
getIndentStart() | Number | استرداد المسافة البادئة للبدء. |
getLineSpacing() | Number | لاسترداد تباعد الأسطر بالنقاط. |
getLinkUrl() | String | يسترد عنوان URL للرابط. |
getListId() | String | لاسترداد رقم تعريف القائمة. |
getNestingLevel() | Integer | يسترد مستوى تداخل عنصر القائمة. |
getNextSibling() | Element | لاسترداد العنصر الشقيق التالي للعنصر. |
getNumChildren() | Integer | لاسترداد عدد الأطفال. |
getParent() | ContainerElement | استرداد العنصر الأصلي للعنصر. |
getPositionedImage(id) | PositionedImage | الحصول على PositionedImage من رقم تعريف الصورة. |
getPositionedImages() | PositionedImage[] | لتثبيت جميع كائنات PositionedImage في الفقرة |
getPreviousSibling() | Element | لاسترداد العنصر الشقيق السابق للعنصر. |
getSpacingAfter() | Number | استرداد التباعد بعد العنصر، بالنقاط. |
getSpacingBefore() | Number | استرداد التباعد قبل العنصر بالنقاط. |
getText() | String | لاسترداد محتوى العنصر كسلسلة نصية. |
getTextAlignment() | TextAlignment | الحصول على محاذاة النص |
getType() | ElementType | لاسترداد ElementType للعنصر. |
insertHorizontalRule(childIndex) | HorizontalRule | تنشئ السمة HorizontalRule وإدراجها في الفهرس المحدد. |
insertInlineImage(childIndex, image) | InlineImage | تنشئ هذه الدالة InlineImage جديدًا وإدراجه من الكائن الثنائي الكبير (blob) الخاص بالصورة المحدد،
الفهرس. |
insertInlineImage(childIndex, image) | InlineImage | إدراج InlineImage المحدّد في الفهرس المحدّد |
insertPageBreak(childIndex) | PageBreak | تنشئ السمة PageBreak جديدة وإدراجها في الفهرس المحدّد. |
insertPageBreak(childIndex, pageBreak) | PageBreak | إدراج PageBreak المحدّد في الفهرس المحدّد |
insertText(childIndex, text) | Text | تنشئ عنصرًا نصيًا جديدًا وإدراجه في الفهرس المحدد. |
insertText(childIndex, text) | Text | إدراج عنصر Text المحدد في الفهرس المحدد، مع النص المحدد
المحتوى. |
isAtDocumentEnd() | Boolean | وتحدِّد ما إذا كان العنصر في نهاية Document . |
isLeftToRight() | Boolean | يسترد الإعداد من اليسار إلى اليمين. |
merge() | ListItem | تدمج العنصر مع العنصر التابع السابق من النوع نفسه. |
removeChild(child) | ListItem | إزالة العنصر الفرعي المحدد |
removeFromParent() | ListItem | إزالة العنصر من عنصره الأساسي |
removePositionedImage(id) | Boolean | ستتم إزالة PositionedImage من خلال رقم تعريف الصورة. |
replaceText(searchPattern, replacement) | Element | لاستبدال جميع ورود نمط نص معين بسلسلة استبدال معينة، باستخدام والتعبيرات. |
setAlignment(alignment) | ListItem | لضبط HorizontalAlignment . |
setAttributes(attributes) | ListItem | يعيّن سمات العنصر. |
setGlyphType(glyphType) | ListItem | لضبط GlyphType لعنصر القائمة. |
setHeading(heading) | ListItem | لضبط ParagraphHeading . |
setIndentEnd(indentEnd) | ListItem | لتعيين المسافة البادئة للنهاية بالنقاط. |
setIndentFirstLine(indentFirstLine) | ListItem | لضبط المسافة البادئة للسطر الأول بالنقاط. |
setIndentStart(indentStart) | ListItem | لضبط المسافة البادئة للبداية بالنقاط. |
setLeftToRight(leftToRight) | ListItem | لتعيين الإعداد من اليسار إلى اليمين. |
setLineSpacing(multiplier) | ListItem | لضبط تباعد الأسطر، ككمية تشير إلى عدد الأسطر المستخدمة في التباعد. |
setLinkUrl(url) | ListItem | لضبط عنوان URL للرابط. |
setListId(listItem) | ListItem | لضبط رقم تعريف القائمة. |
setNestingLevel(nestingLevel) | ListItem | يعيّن مستوى تداخل عنصر القائمة. |
setSpacingAfter(spacingAfter) | ListItem | لضبط التباعد بعد العنصر بالنقاط. |
setSpacingBefore(spacingBefore) | ListItem | لتعيين التباعد قبل العنصر، بالنقاط. |
setText(text) | void | لضبط محتوى عنصر القائمة كنص. |
setTextAlignment(textAlignment) | ListItem | لضبط محاذاة النص. |
الوثائق التفصيلية
addPositionedImage(image)
لإنشاء PositionedImage
جديد وإدراجه من الكائن الثنائي الكبير (blob) للصورة المحدد.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
image | BlobSource | بيانات الصورة |
الإرجاع
PositionedImage
- الصورة الجديدة في الموضع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendHorizontalRule()
تنشئ سمة HorizontalRule
جديدة وتلحقها
الإرجاع
HorizontalRule
: القاعدة الأفقية الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendInlineImage(image)
تنشئ هذه الدالة InlineImage
جديدًا وتلحقه من الكائن الثنائي الكبير المحدّد للصورة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
image | BlobSource | بيانات الصورة |
الإرجاع
InlineImage
: الصورة الملحقة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendInlineImage(image)
تُرفِق السمة InlineImage
المحدّدة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
image | InlineImage | بيانات الصورة |
الإرجاع
InlineImage
: الصورة الملحقة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendPageBreak()
تنشئ سمة PageBreak
جديدة وتلحقها
ملاحظة: لا يجوز أن تكون السمة PageBreaks
مضمنة في TableCells
.
إذا كان العنصر الحالي مضمنًا في خلية جدول، فسيتم طرح استثناء.
الإرجاع
PageBreak
- العنصر الجديد لفاصل الصفحات
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendPageBreak(pageBreak)
تُرفِق السمة PageBreak
المحدّدة.
ملاحظة: لا يجوز أن تكون السمة PageBreaks
مضمنة في TableCells
.
إذا كان العنصر الحالي مضمنًا في خلية جدول، فسيتم طرح استثناء.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
pageBreak | PageBreak | فاصل الصفحة لإلحاق |
الإرجاع
PageBreak
- عنصر فاصل الصفحة الملحق
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendText(text)
تنشئ هذه الطريقة عنصر Text
جديدًا وتتضمّن المحتوى المحدّد وتُلحقه.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
text | String | محتوى النص |
الإرجاع
Text
: العنصر النصي الجديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendText(text)
لإلحاق عنصر Text
المحدّد
المعلمات
الاسم | النوع | الوصف |
---|---|---|
text | Text | العنصر النصي لإلحاقه |
الإرجاع
Text
- عنصر النص الملحق
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
clear()
copy()
لعرض نسخة منفصلة عميقة من العنصر الحالي.
ويتم أيضًا نسخ أي عناصر فرعية موجودة في العنصر. لا يحتوي العنصر الجديد على أحد الوالدين.
الإرجاع
ListItem
: النسخة الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
editAsText()
الحصول على نسخة Text
من العنصر الحالي للتعديل.
استخدام editAsText
لمعالجة محتوى العناصر كنص منسق. يتجاهل وضع editAsText
العناصر غير النصية (مثل InlineImage
وHorizontalRule
).
تتم إزالة العناصر الثانوية الموجودة بالكامل داخل نطاق نص محذوف من العنصر.
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().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
.
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().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)
للبحث في محتويات العنصر عن نمط النص المحدد باستخدام التعبيرات العادية.
هناك مجموعة فرعية من ميزات التعبير العادي في JavaScript غير متوافقة بالكامل، مثل التقاط المجموعات ومعدِّلات الأوضاع.
تتم مطابقة نمط التعبير العادي المقدَّم بشكل مستقل مع كل جزء نصي الموجودة في العنصر الحالي.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
searchPattern | String | النمط للبحث عن |
الإرجاع
RangeElement
— نتيجة بحث تشير إلى موضع نص البحث أو "فارغ" إذا لم يكن هناك
مطابقة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findText(searchPattern, from)
يبحث في محتويات العنصر عن نمط النص المحدد، بدءًا من عنصر نتيجة البحث.
هناك مجموعة فرعية من ميزات التعبير العادي في JavaScript غير متوافقة بالكامل، مثل التقاط المجموعات ومعدِّلات الأوضاع.
تتم مطابقة نمط التعبير العادي المقدَّم بشكل مستقل مع كل جزء نصي الموجودة في العنصر الحالي.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
searchPattern | String | النمط للبحث عن |
from | RangeElement | نتيجة البحث للبحث منها |
الإرجاع
RangeElement
— نتيجة بحث تشير إلى الموضع التالي من نص البحث أو "فارغة" إذا لم يكن هناك
مطابقة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getAlignment()
لاسترداد HorizontalAlignment
.
الإرجاع
HorizontalAlignment
— المحاذاة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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
getChild(childIndex)
استرداد العنصر الفرعي في الفهرس الفرعي المحدد.
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Obtain the first element in the tab. 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
getGlyphType()
getHeading()
لاسترداد ParagraphHeading
.
الإرجاع
ParagraphHeading
— العنوان
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getIndentEnd()
لاسترداد المسافة البادئة للنهاية بالنقاط.
الإرجاع
Number
- المسافة البادئة للنهاية، بالنقاط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getIndentFirstLine()
لاسترداد المسافة البادئة للسطر الأول بالنقاط.
الإرجاع
Number
- المسافة البادئة للسطر الأول، بالنقاط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getIndentStart()
استرداد المسافة البادئة للبدء.
الإرجاع
Number
— المسافة البادئة للبداية
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLineSpacing()
لاسترداد تباعد الأسطر بالنقاط.
الإرجاع
Number
— تباعد الأسطر بالنقاط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLinkUrl()
يسترد عنوان URL للرابط.
الإرجاع
String
: عنوان URL للرابط أو قيمة فارغة إذا كان العنصر يحتوي على قيم متعددة لهذه السمة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getListId()
لاسترداد رقم تعريف القائمة.
الإرجاع
String
- رقم تعريف القائمة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getNestingLevel()
يسترد مستوى تداخل عنصر القائمة.
بشكل تلقائي، تحتوي عناصر القائمة على مستوى تداخل يبلغ صفر. يحدد مستوى التداخل الحرف الرسومي الذي يستخدمه عنصر القائمة.
الإرجاع
Integer
: مستوى التداخل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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
getNumChildren()
لاسترداد عدد الأطفال.
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Log the number of elements in the tab. Logger.log("There are " + body.getNumChildren() + " elements in the tab's 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
getPositionedImage(id)
الحصول على PositionedImage
من رقم تعريف الصورة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
id | String | معرّف الصورة |
الإرجاع
PositionedImage
- الصورة التي تم تحديد موضعها
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPositionedImages()
لتثبيت جميع كائنات PositionedImage
في الفقرة
الإرجاع
PositionedImage[]
— قائمة بالصور التي تم تحديد موضعها
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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
getSpacingAfter()
استرداد التباعد بعد العنصر، بالنقاط.
الإرجاع
Number
: التباعد بعد العنصر بالنقاط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getSpacingBefore()
استرداد التباعد قبل العنصر بالنقاط.
الإرجاع
Number
: التباعد قبل العنصر بالنقاط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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 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
insertHorizontalRule(childIndex)
تنشئ السمة HorizontalRule
وإدراجها في الفهرس المحدد.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي يتم عنده إدراج العنصر |
الإرجاع
HorizontalRule
- عنصر القاعدة الأفقية الجديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertInlineImage(childIndex, image)
تنشئ هذه الدالة InlineImage
جديدًا وإدراجه من الكائن الثنائي الكبير (blob) الخاص بالصورة المحدد،
الفهرس.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي يتم عنده إدراج العنصر |
image | BlobSource | بيانات الصورة |
الإرجاع
InlineImage
- عنصر الصورة المضمّن الذي تم إدراجه
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertInlineImage(childIndex, image)
إدراج InlineImage
المحدّد في الفهرس المحدّد
المعلمات
الاسم | النوع | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي يتم عنده إدراج العنصر |
image | InlineImage | بيانات الصورة |
الإرجاع
InlineImage
- عنصر الصورة المضمّن الذي تم إدراجه
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertPageBreak(childIndex)
تنشئ السمة PageBreak
جديدة وإدراجها في الفهرس المحدّد.
ملاحظة: لا يجوز أن تكون السمة PageBreaks
مضمنة في TableCells
.
إذا كان العنصر الحالي مضمنًا في خلية جدول، فسيتم طرح استثناء.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي يتم عنده إدراج العنصر |
الإرجاع
PageBreak
- العنصر الجديد لفاصل الصفحات
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertPageBreak(childIndex, pageBreak)
إدراج PageBreak
المحدّد في الفهرس المحدّد
ملاحظة: لا يجوز أن تكون السمة PageBreaks
مضمنة في TableCells
.
إذا كان العنصر الحالي مضمنًا في خلية جدول، فسيتم طرح استثناء.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي يتم عنده إدراج العنصر |
pageBreak | PageBreak | [الفئة العمرية التي تؤديها هذه الكلمة في سن |
الإرجاع
PageBreak
- عنصر فاصل الصفحات المُدرج
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertText(childIndex, text)
تنشئ عنصرًا نصيًا جديدًا وإدراجه في الفهرس المحدد.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي يتم عنده إدراج العنصر |
text | String | محتوى النص |
الإرجاع
Text
: العنصر النصي الجديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertText(childIndex, text)
إدراج عنصر Text
المحدد في الفهرس المحدد، مع النص المحدد
المحتوى.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي يتم عنده إدراج العنصر |
text | Text | العنصر النصي لإدراجه |
الإرجاع
Text
- العنصر النصي المدرج
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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
isLeftToRight()
يسترد الإعداد من اليسار إلى اليمين.
الإرجاع
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();
الإرجاع
ListItem
— العنصر المدمج
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
removeChild(child)
إزالة العنصر الفرعي المحدد
المعلمات
الاسم | النوع | الوصف |
---|---|---|
child | Element | العنصر الفرعي المطلوب إزالته |
الإرجاع
ListItem
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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(); }
الإرجاع
ListItem
— العنصر الذي تمت إزالته
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
removePositionedImage(id)
ستتم إزالة PositionedImage
من خلال رقم تعريف الصورة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
id | String |
الإرجاع
Boolean
: ما إذا تمت إزالة الصورة المحدّدة أم لا
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
replaceText(searchPattern, replacement)
لاستبدال جميع ورود نمط نص معين بسلسلة استبدال معينة، باستخدام والتعبيرات.
ويتم تمرير نمط البحث كسلسلة، وليس ككائن تعبير عادي في JavaScript. لهذا السبب، ستحتاج إلى تجنب أي شرطات مائلة للخلف في النمط.
تستخدم هذه الطرق طريقة RE2 العادية من Google. مكتبة التعبيرات، التي تحدّ من البنية المتوافقة.
تتم مطابقة نمط التعبير العادي المقدَّم بشكل مستقل مع كل جزء نصي الموجودة في العنصر الحالي.
var body = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab().getBody(); // Clear the text surrounding "Apps Script", with or without text. body.replaceText("^.*Apps ?Script.*$", "Apps Script");
المعلمات
الاسم | النوع | الوصف |
---|---|---|
searchPattern | String | نمط التعبير العادي للبحث عن |
replacement | String | النص المطلوب استخدامه كبديل |
الإرجاع
Element
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setAlignment(alignment)
لضبط HorizontalAlignment
.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
alignment | HorizontalAlignment | المحاذاة الأفقية |
الإرجاع
ListItem
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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 | سمات العنصر. |
الإرجاع
ListItem
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setGlyphType(glyphType)
لضبط GlyphType
لعنصر القائمة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
glyphType | GlyphType | نوع الحرف الرسومي |
الإرجاع
ListItem
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setHeading(heading)
لضبط ParagraphHeading
.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
heading | ParagraphHeading | العنوان |
الإرجاع
ListItem
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setIndentEnd(indentEnd)
لتعيين المسافة البادئة للنهاية بالنقاط.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
indentEnd | Number | المسافة البادئة للنهاية، بالنقاط |
الإرجاع
ListItem
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setIndentFirstLine(indentFirstLine)
لضبط المسافة البادئة للسطر الأول بالنقاط.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
indentFirstLine | Number | المسافة البادئة للسطر الأول، بالنقاط |
الإرجاع
ListItem
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setIndentStart(indentStart)
لتعيين المسافة البادئة للبداية بالنقاط.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
indentStart | Number | المسافة البادئة للبداية، بالنقاط |
الإرجاع
ListItem
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLeftToRight(leftToRight)
لتعيين الإعداد من اليسار إلى اليمين.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
leftToRight | Boolean | الإعداد من اليسار إلى اليمين |
الإرجاع
ListItem
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLineSpacing(multiplier)
لضبط تباعد الأسطر، ككمية تشير إلى عدد الأسطر المستخدمة في التباعد.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
multiplier | Number | عدد الأسطر |
الإرجاع
ListItem
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLinkUrl(url)
لضبط عنوان URL للرابط.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
url | String | عنوان URL للرابط |
الإرجاع
ListItem
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setListId(listItem)
لضبط رقم تعريف القائمة.
تم ضبط رقم تعريف القائمة على القيمة نفسها للسمة ListItem
المحدّدة. سيتم التعامل مع العنصرَين ListItems
كأعضاء في القائمة نفسها.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
listItem | ListItem | عنصر القائمة الذي سيتم استخدام معرّف القائمة الخاص به |
الإرجاع
ListItem
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setNestingLevel(nestingLevel)
يعيّن مستوى تداخل عنصر القائمة.
بشكل تلقائي، تحتوي عناصر القائمة على مستوى تداخل يبلغ صفر. يحدد مستوى التداخل الحرف الرسومي الذي يستخدمه عنصر القائمة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
nestingLevel | Integer | مستوى التداخل |
الإرجاع
ListItem
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setSpacingAfter(spacingAfter)
لضبط التباعد بعد العنصر بالنقاط.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
spacingAfter | Number | التباعد بعد العنصر، بالنقاط |
الإرجاع
ListItem
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setSpacingBefore(spacingBefore)
لتعيين التباعد قبل العنصر، بالنقاط.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
spacingBefore | Number | التباعد قبل العنصر، بالنقاط |
الإرجاع
ListItem
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setText(text)
لضبط محتوى عنصر القائمة كنص.
ملاحظة: يتم محو المحتوى الحالي.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
text | String | المحتوى النصي الجديد |
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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 in the active tab be superscript. var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab(); var text = documentTab.getBody().getParagraphs()[0].editAsText(); text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
textAlignment | TextAlignment | نوع محاذاة النص لتطبيقه |
الإرجاع
ListItem
— العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents