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

Class ListItem

يشير ذلك المصطلح إلى عنصر يمثّل عنصر قائمة. 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 المحدّدة.

المعلمات

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

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

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

المعلمات

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

لاسترداد 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()`

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

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 جديدة وإدراجها في الفهرس المحدّد.

المعلمات

الاسم	النوع	الوصف
`childIndex`	`Integer`	الفهرس الذي يتم عنده إدراج العنصر

الإرجاع

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

التفويض

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

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

`insertPageBreak(childIndex, pageBreak)`

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

المعلمات

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