Class ListItem

ListItem

يشير ذلك المصطلح إلى عنصر يمثّل قائمة. علامة ListItem هي سمة Paragraph مرتبطة برقم تعريف قائمة. قد تحتوي السمة ListItem على عناصر Equation وFootnote وHorizontalRule وInlineDrawing وInlineImage وPageBreak وText. لمزيد من المعلومات حول بنية المستند، راجع دليل توسيع نطاق مستندات Google.

لا يمكن أن يحتوي ListItems على أحرف سطر جديد. يتم تحويل أحرف الأسطر الجديدة ("\n") إلى أحرف فواصل أسطر ("\r").

ListItems برقم تعريف القائمة نفسه ينتمي إلى القائمة نفسها ويتم ترقيمها وفقًا لذلك. ليس من الضروري أن تكون السمة ListItems الخاصة بقائمة معيّنة مجاورة في المستند أو تحتوي على العنصر الرئيسي نفسه. قد يتوفّر عنصران ينتميان إلى القائمة نفسها في أي مكان في المستند مع الحفاظ على الترقيم المتتالي، كما هو موضّح في المثال التالي:

var body = DocumentApp.getActiveDocument().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 جديدة من النقطة المحددة للصورة.
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 وتدرجها من كائن فقاعة الصورة المحدد في الفهرس المحدد.
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 جديدة من النقطة المحددة للصورة.

المَعلمات

الاسمTypeالوصف
imageBlobSourceبيانات الصورة

استرجاع الكرة

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 جديدًا وتُلحقه من كائن الصورة الثنائي المحدد.

المَعلمات

الاسمTypeالوصف
imageBlobSourceبيانات الصورة

استرجاع الكرة

InlineImage — الصورة الملحقة

التفويض

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

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

appendInlineImage(image)

لإلحاق InlineImage المقدَّمة

المَعلمات

الاسمTypeالوصف
imageInlineImageبيانات الصورة

استرجاع الكرة

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. إذا كان العنصر الحالي مضمنًا في خلية جدول، فسيتم طرح استثناء.

المَعلمات

الاسمTypeالوصف
pageBreakPageBreakفاصل الصفحة لإلحاقه

استرجاع الكرة

PageBreak — عنصر فاصل الصفحة الملحق

التفويض

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

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

appendText(text)

لإنشاء عنصر Text جديد وإلحاقه بالمحتوى المحدّد

المَعلمات

الاسمTypeالوصف
textStringمحتوى النص

استرجاع الكرة

Text - العنصر النصي الجديد

التفويض

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

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

appendText(text)

لإلحاق عنصر Text المحدّد

المَعلمات

الاسمTypeالوصف
textTextالعنصر النصي لإلحاقه

استرجاع الكرة

Text - العنصر النصي الملحق

التفويض

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

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

clear()

لمحو محتوى العنصر.

استرجاع الكرة

ListItem - العنصر الحالي


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().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)

للبحث في محتوى العنصر عن عنصر تابع من النوع المحدد.

المَعلمات

الاسمTypeالوصف
elementTypeElementTypeنوع العنصر للبحث عنه

استرجاع الكرة

RangeElement: نتيجة بحث تشير إلى موضع عنصر البحث

التفويض

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

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

findElement(elementType, from)

للبحث في محتوى العنصر عن عنصر تابع من النوع المحدّد، بدءًا من سمة RangeElement المحدّدة

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().getBody();

// Define the search parameters.
var searchType = DocumentApp.ElementType.PARAGRAPH;
var searchHeading = DocumentApp.ParagraphHeading.HEADING1;
var searchResult = null;

// Search until the paragraph is found.
while (searchResult = body.findElement(searchType, searchResult)) {
  var par = searchResult.getElement().asParagraph();
  if (par.getHeading() == searchHeading) {
    // Found one, update and stop.
    par.setText('This is the first header.');
    return;
  }
}

المَعلمات

الاسمTypeالوصف
elementTypeElementTypeنوع العنصر للبحث عنه
fromRangeElementنتيجة البحث للبحث منها

استرجاع الكرة

RangeElement - نتيجة بحث تشير إلى الموضع التالي لعنصر البحث

التفويض

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

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

findText(searchPattern)

للبحث في محتويات العنصر عن نمط النص المحدد باستخدام التعبيرات العادية.

هناك مجموعة فرعية من ميزات التعبير العادي في JavaScript غير متوافقة بالكامل، مثل مجموعات الالتقاط ومعدِّلات الأوضاع.

تتم مطابقة نمط التعبير العادي المقدّم بشكل مستقل مع كل كتلة نصية مضمَّنة في العنصر الحالي.

المَعلمات

الاسمTypeالوصف
searchPatternStringالنمط للبحث عن

استرجاع الكرة

RangeElement: نتيجة بحث تشير إلى موضع نص البحث، وتكون قيمة فارغة في حال عدم التطابق

التفويض

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

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

findText(searchPattern, from)

للبحث في محتوى العنصر عن نمط النص المحدد، بدءًا من نتيجة بحث معينة.

هناك مجموعة فرعية من ميزات التعبير العادي في JavaScript غير متوافقة بالكامل، مثل مجموعات الالتقاط ومعدِّلات الأوضاع.

تتم مطابقة نمط التعبير العادي المقدّم بشكل مستقل مع كل كتلة نصية مضمَّنة في العنصر الحالي.

المَعلمات

الاسمTypeالوصف
searchPatternStringالنمط للبحث عن
fromRangeElementنتيجة البحث للبحث منها

استرجاع الكرة

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 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

getChild(childIndex)

لاسترداد العنصر الفرعي في الفهرس الفرعي المحدد.

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().getBody();

// Obtain the first element in the document.
var firstChild = body.getChild(0);

// If it's a paragraph, set its contents.
if (firstChild.getType() == DocumentApp.ElementType.PARAGRAPH) {
  firstChild.asParagraph().setText("This is the first paragraph.");
}

المَعلمات

الاسمTypeالوصف
childIndexIntegerفهرس العنصر الفرعي لاسترداد

استرجاع الكرة

Element - العنصر الفرعي في الفهرس المحدد

التفويض

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

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

getChildIndex(child)

لاسترداد الفهرس الفرعي للعنصر الفرعي المحدد

المَعلمات

الاسمTypeالوصف
childElementالعنصر الفرعي المطلوب استرداد الفهرس له

استرجاع الكرة

Integer — الفهرس الفرعي

التفويض

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

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

getGlyphType()

لاسترداد GlyphType لعنصر القائمة.

استرجاع الكرة

GlyphType - نوع الحرف الرسومي

التفويض

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

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

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()

لاسترداد عدد الأطفال.

// Get the body section of the active document.
var body = DocumentApp.getActiveDocument().getBody();

// Log the number of elements in the document.
Logger.log("There are " + body.getNumChildren() +
    " elements in the document body.");

استرجاع الكرة

Integer - عدد الأطفال

التفويض

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

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

getParent()

لاسترداد العنصر الرئيسي للعنصر.

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

استرجاع الكرة

ContainerElement — العنصر الرئيسي

التفويض

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

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

getPositionedImage(id)

يحصل على PositionedImage من خلال رقم تعريف الصورة.

المَعلمات

الاسمTypeالوصف
idStringرقم تعريف الصورة

استرجاع الكرة

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 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

insertHorizontalRule(childIndex)

لإنشاء HorizontalRule وإدراجه في الفهرس المحدّد.

المَعلمات

الاسمTypeالوصف
childIndexIntegerالفهرس الذي يتم إدراج العنصر فيه

استرجاع الكرة

HorizontalRule: عنصر القاعدة الأفقية الجديد

التفويض

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

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

insertInlineImage(childIndex, image)

تنشئ هذه الدالة InlineImage وتدرجها من كائن فقاعة الصورة المحدد في الفهرس المحدد.

المَعلمات

الاسمTypeالوصف
childIndexIntegerالفهرس الذي يتم إدراج العنصر فيه
imageBlobSourceبيانات الصورة

استرجاع الكرة

InlineImage - عنصر الصورة المضمّنة الذي تم إدراجه

التفويض

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

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

insertInlineImage(childIndex, image)

لإدراج InlineImage المحدّد في الفهرس المحدّد.

المَعلمات

الاسمTypeالوصف
childIndexIntegerالفهرس الذي يتم إدراج العنصر فيه
imageInlineImageبيانات الصورة

استرجاع الكرة

InlineImage - عنصر الصورة المضمّنة الذي تم إدراجه

التفويض

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

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

insertPageBreak(childIndex)

لإنشاء PageBreak جديد وإدراجه في الفهرس المحدّد.

ملاحظة: قد لا تكون PageBreaks مدرَجة ضمن TableCells. إذا كان العنصر الحالي مضمنًا في خلية جدول، فسيتم طرح استثناء.

المَعلمات

الاسمTypeالوصف
childIndexIntegerالفهرس الذي يتم إدراج العنصر فيه

استرجاع الكرة

PageBreak - عنصر فاصل الصفحة الجديد

التفويض

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

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

insertPageBreak(childIndex, pageBreak)

لإدراج PageBreak المحدّد في الفهرس المحدّد.

ملاحظة: قد لا تكون PageBreaks مدرَجة ضمن TableCells. إذا كان العنصر الحالي مضمنًا في خلية جدول، فسيتم طرح استثناء.

المَعلمات

الاسمTypeالوصف
childIndexIntegerالفهرس الذي يتم إدراج العنصر فيه
pageBreakPageBreak[فواصل [page] لإدراج

استرجاع الكرة

PageBreak — عنصر فاصل الصفحة المدرج

التفويض

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

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

insertText(childIndex, text)

لإنشاء عنصر نصي جديد وإدراجه في الفهرس المحدّد

المَعلمات

الاسمTypeالوصف
childIndexIntegerالفهرس الذي يتم إدراج العنصر فيه
textStringمحتوى النص

استرجاع الكرة

Text - العنصر النصي الجديد

التفويض

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

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

insertText(childIndex, text)

يدرج عنصر Text المحدد في الفهرس المحدد، مع محتويات النص المحددة.

المَعلمات

الاسمTypeالوصف
childIndexIntegerالفهرس الذي يتم إدراج العنصر فيه
textTextالعنصر النصي لإدراج

استرجاع الكرة

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 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();

استرجاع الكرة

ListItem — العنصر المدمج

التفويض

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

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

removeChild(child)

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

المَعلمات

الاسمTypeالوصف
childElementالعنصر الفرعي لإزالتها

استرجاع الكرة

ListItem - العنصر الحالي

التفويض

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

  • 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();
}

استرجاع الكرة

ListItem — العنصر الذي تمت إزالته

التفويض

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

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

removePositionedImage(id)

لإزالة PositionedImage حسب رقم تعريف الصورة.

المَعلمات

الاسمTypeالوصف
idString

استرجاع الكرة

Boolean: ما إذا تمت إزالة الصورة المحددة أم لا

التفويض

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

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

replaceText(searchPattern, replacement)

لاستبدال جميع تكرارات نمط نص معين بسلسلة استبدال معينة، باستخدام تعبيرات عادية.

يتم تمرير نمط البحث كسلسلة، وليس ككائن تعبير عادي JavaScript. لهذا السبب، ستحتاج إلى تجنب أي شرطات مائلة للخلف في النمط.

تستخدم هذه الطريقة مكتبة التعبيرات العادية RE2 من Google، ما يحدّ من البنية المتوافقة.

تتم مطابقة نمط التعبير العادي المقدّم بشكل مستقل مع كل كتلة نصية مضمَّنة في العنصر الحالي.

var body = DocumentApp.getActiveDocument().getBody();

// Clear the text surrounding "Apps Script", with or without text.
body.replaceText("^.*Apps ?Script.*$", "Apps Script");

المَعلمات

الاسمTypeالوصف
searchPatternStringنمط التعبير العادي للبحث عن
replacementStringالنص المطلوب استخدامه كبديل

استرجاع الكرة

Element - العنصر الحالي

التفويض

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

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

setAlignment(alignment)

لضبط HorizontalAlignment.

المَعلمات

الاسمTypeالوصف
alignmentHorizontalAlignmentوالمحاذاة الأفقية

استرجاع الكرة

ListItem - العنصر الحالي

التفويض

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

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

setAttributes(attributes)

تعيّن سمات العنصر.

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

var body = DocumentApp.getActiveDocument().getBody();

// Define a custom paragraph style.
var style = {};
style[DocumentApp.Attribute.HORIZONTAL_ALIGNMENT] =
    DocumentApp.HorizontalAlignment.RIGHT;
style[DocumentApp.Attribute.FONT_FAMILY] = 'Calibri';
style[DocumentApp.Attribute.FONT_SIZE] = 18;
style[DocumentApp.Attribute.BOLD] = true;

// Append a plain paragraph.
var par = body.appendParagraph('A paragraph with custom style.');

// Apply the custom style.
par.setAttributes(style);

المَعلمات

الاسمTypeالوصف
attributesObjectتمثّل هذه السمة سمات العنصر.

استرجاع الكرة

ListItem - العنصر الحالي

التفويض

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

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

setGlyphType(glyphType)

لتعيين GlyphType لعنصر القائمة.

المَعلمات

الاسمTypeالوصف
glyphTypeGlyphTypeنوع الحرف الرسومي

استرجاع الكرة

ListItem - العنصر الحالي

التفويض

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

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

setHeading(heading)

لضبط ParagraphHeading.

المَعلمات

الاسمTypeالوصف
headingParagraphHeadingالعنوان

استرجاع الكرة

ListItem - العنصر الحالي

التفويض

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

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

setIndentEnd(indentEnd)

لضبط المسافة البادئة للنهاية بالنقاط

المَعلمات

الاسمTypeالوصف
indentEndNumberالمسافة البادئة للنهاية، بالنقاط

استرجاع الكرة

ListItem - العنصر الحالي

التفويض

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

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

setIndentFirstLine(indentFirstLine)

لتعيين المسافة البادئة للسطر الأول بالنقاط.

المَعلمات

الاسمTypeالوصف
indentFirstLineNumberالمسافة البادئة للسطر الأول بالنقاط

استرجاع الكرة

ListItem - العنصر الحالي

التفويض

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

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

setIndentStart(indentStart)

لضبط المسافة البادئة للبداية بالنقاط

المَعلمات

الاسمTypeالوصف
indentStartNumberالمسافة البادئة للبداية، بالنقاط

استرجاع الكرة

ListItem - العنصر الحالي

التفويض

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

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

setLeftToRight(leftToRight)

لتعيين الإعداد من اليسار إلى اليمين.

المَعلمات

الاسمTypeالوصف
leftToRightBooleanالإعداد من اليسار إلى اليمين

استرجاع الكرة

ListItem - العنصر الحالي

التفويض

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

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

setLineSpacing(multiplier)

لتعيين تباعد الأسطر، ككمية تشير إلى عدد الأسطر المطلوب استخدامها للتباعد.

المَعلمات

الاسمTypeالوصف
multiplierNumberعدد الأسطر

استرجاع الكرة

ListItem - العنصر الحالي

التفويض

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

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

setLinkUrl(url)

تُحدِّد عنوان URL للرابط.

المَعلمات

الاسمTypeالوصف
urlStringعنوان URL للرابط

استرجاع الكرة

ListItem - العنصر الحالي

التفويض

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

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

setListId(listItem)

تضبط رقم تعريف القائمة.

تم ضبط رقم تعريف القائمة على القيمة نفسها للسمة ListItem المحدّدة. سيتم التعامل مع ListItems كعضو في القائمة نفسها.

المَعلمات

الاسمTypeالوصف
listItemListItemعنصر القائمة الذي سيتم استخدام رقم تعريفه في القائمة

استرجاع الكرة

ListItem - العنصر الحالي

التفويض

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

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

setNestingLevel(nestingLevel)

لتعيين مستوى تداخل عنصر القائمة.

ويكون مستوى التداخل صفرًا بشكل تلقائي. يحدد مستوى التداخل الحرف الرسومي الذي يستخدمه عنصر القائمة.

المَعلمات

الاسمTypeالوصف
nestingLevelIntegerمستوى التداخل

استرجاع الكرة

ListItem - العنصر الحالي

التفويض

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

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

setSpacingAfter(spacingAfter)

لتعيين التباعد بعد العنصر، بالنقاط.

المَعلمات

الاسمTypeالوصف
spacingAfterNumberالتباعد بعد العنصر، بالنقاط

استرجاع الكرة

ListItem - العنصر الحالي

التفويض

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

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

setSpacingBefore(spacingBefore)

لتعيين التباعد قبل العنصر، بالنقاط.

المَعلمات

الاسمTypeالوصف
spacingBeforeNumberالتباعد قبل العنصر، بالنقاط

استرجاع الكرة

ListItem - العنصر الحالي

التفويض

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

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

setText(text)

لضبط محتوى عنصر القائمة كنص.

ملاحظة: تم محو المحتوى الحالي.

المَعلمات

الاسمTypeالوصف
textStringمحتوى النص الجديد

التفويض

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

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

setTextAlignment(textAlignment)

لضبط محاذاة النص أنواع المحاذاة المتاحة هي DocumentApp.TextAlignment.NORMAL وDocumentApp.TextAlignment.SUBSCRIPT وDocumentApp.TextAlignment.SUPERSCRIPT.

// Make the entire first paragraph be superscript.
var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(DocumentApp.TextAlignment.SUPERSCRIPT);

المَعلمات

الاسمTypeالوصف
textAlignmentTextAlignmentنوع محاذاة النص المراد تطبيقه

استرجاع الكرة

ListItem - العنصر الحالي

التفويض

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

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