تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class ListItem

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

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

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` جديد وإدراجه من الكائن الثنائي الكبير (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`	لاسترداد سمات العنصر\u39s.
`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`'s.
`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`	تحدد سمات العنصر\u39;s.
`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()`

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

تذكرة ذهاب وعودة

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

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

المعلّمات

الاسم	النوع	الوصف
`elementType`	`ElementType`	نوع العنصر المطلوب البحث عنه

تذكرة ذهاب وعودة

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

المعلّمات

الاسم	النوع	الوصف
`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()`

لاسترداد سمات العنصر\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

`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.");
}

المعلّمات

الاسم	النوع	الوصف
`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()`

لاسترداد عنصر القائمة 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 من خلال رقم تعريف الصورة.

المعلّمات

الاسم	النوع	الوصف
`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'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

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

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

المعلّمات

الاسم	النوع	الوصف
`child`	`Element`	العنصر الفرعي المطلوب إزالته

تذكرة ذهاب وعودة

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 بواسطة رقم تعريف الصورة.

المعلّمات

الاسم	النوع	الوصف
`id`	`String`

تذكرة ذهاب وعودة

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

التفويض

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

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

`replaceText(searchPattern, replacement)`

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

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

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

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

var body = DocumentApp.getActiveDocument().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)`

تحدد سمات العنصر\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.

تذكرة ذهاب وعودة

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 be superscript.
var text = DocumentApp.getActiveDocument().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