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

Class Paragraph

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

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

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

// Append a tab header paragraph.
var header = body.appendParagraph("A Document");
header.setHeading(DocumentApp.ParagraphHeading.HEADING1);

// Append a section header paragraph.
var section = body.appendParagraph("Section 1");
section.setHeading(DocumentApp.ParagraphHeading.HEADING2);

// Append a regular paragraph.
body.appendParagraph("This is a typical paragraph.");

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`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()`	`Paragraph`	يؤدي إلى محو محتوى العنصر.
`copy()`	`Paragraph`	لعرض نسخة منفصلة عميقة من العنصر الحالي.
`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`	استرداد الفهرس الفرعي للعنصر الفرعي المحدد.
`getHeading()`	`ParagraphHeading`	لاسترداد `ParagraphHeading`.
`getIndentEnd()`	`Number`	لاسترداد المسافة البادئة للنهاية بالنقاط.
`getIndentFirstLine()`	`Number`	لاسترداد المسافة البادئة للسطر الأول بالنقاط.
`getIndentStart()`	`Number`	استرداد المسافة البادئة للبدء.
`getLineSpacing()`	`Number`	لاسترداد تباعد الأسطر بالنقاط.
`getLinkUrl()`	`String`	يسترد عنوان URL للرابط.
`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()`	`Paragraph`	تدمج العنصر مع العنصر التابع السابق من النوع نفسه.
`removeChild(child)`	`Paragraph`	إزالة العنصر الفرعي المحدد
`removeFromParent()`	`Paragraph`	إزالة العنصر من عنصره الأساسي
`removePositionedImage(id)`	`Boolean`	ستتم إزالة `PositionedImage` من خلال رقم تعريف الصورة.
`replaceText(searchPattern, replacement)`	`Element`	لاستبدال جميع ورود نمط نص معين بسلسلة استبدال معينة، باستخدام والتعبيرات.
`setAlignment(alignment)`	`Paragraph`	لضبط `HorizontalAlignment`.
`setAttributes(attributes)`	`Paragraph`	يعيّن سمات العنصر.
`setHeading(heading)`	`Paragraph`	لضبط `ParagraphHeading`.
`setIndentEnd(indentEnd)`	`Paragraph`	لتعيين المسافة البادئة للنهاية بالنقاط.
`setIndentFirstLine(indentFirstLine)`	`Paragraph`	لضبط المسافة البادئة للسطر الأول بالنقاط.
`setIndentStart(indentStart)`	`Paragraph`	لتعيين المسافة البادئة للبداية بالنقاط.
`setLeftToRight(leftToRight)`	`Paragraph`	لتعيين الإعداد من اليسار إلى اليمين.
`setLineSpacing(multiplier)`	`Paragraph`	لضبط تباعد الأسطر، ككمية تشير إلى عدد الأسطر المستخدمة في التباعد.
`setLinkUrl(url)`	`Paragraph`	لضبط عنوان URL للرابط.
`setSpacingAfter(spacingAfter)`	`Paragraph`	لضبط التباعد بعد العنصر بالنقاط.
`setSpacingBefore(spacingBefore)`	`Paragraph`	لتعيين التباعد قبل العنصر، بالنقاط.
`setText(text)`	`void`	لتعيين محتوى الفقرة كنص.
`setTextAlignment(textAlignment)`	`Paragraph`	لضبط محاذاة النص.

الوثائق التفصيلية

`addPositionedImage(image)`

لإنشاء PositionedImage جديد وإدراجه من الكائن الثنائي الكبير (blob) للصورة المحدد.

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById(DOCUMENT_ID);

// Gets the body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab(TAB_ID).asDocumentTab().getBody();

// Gets the first paragraph from the body.
const paragraph = body.getParagraphs()[0];

// Fetches the specified image URL.
const image =
  UrlFetchApp.fetch('https://fonts.gstatic.com/s/i/productlogos/apps_script/v10/web-24dp/logo_apps_script_color_1x_web_24dp.png');

// Adds the image to the tab, anchored to the first paragraph.
paragraph.addPositionedImage(image);

المعلمات

الاسم	النوع	الوصف
`image`	`BlobSource`	بيانات الصورة.

الإرجاع

PositionedImage — الصورة الجديدة التي تم تحديد موضعها

التفويض

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

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

`appendHorizontalRule()`

تنشئ سمة HorizontalRule جديدة وتلحقها

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById(DOCUMENT_ID);

// Gets the body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab(TAB_ID).asDocumentTab().getBody();

// Gets the first paragraph from the body.
const paragraph = body.getParagraphs()[0];

// Adds a horizontal line under the first paragraph.
paragraph.appendHorizontalRule();

الإرجاع

HorizontalRule — القاعدة الأفقية الجديدة

التفويض

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

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

`appendInlineImage(image)`

تنشئ هذه الدالة InlineImage جديدًا وتلحقه من الكائن الثنائي الكبير المحدّد للصورة.

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById(DOCUMENT_ID);

// Gets the body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab(TAB_ID).asDocumentTab().getBody();

// Gets the first paragraph from the body.
const paragraph = body.getParagraphs()[0];

// Fetches the image from the specified image URL.
const image = UrlFetchApp
  .fetch('https://fonts.gstatic.com/s/i/productlogos/apps_script/v10/web-96dp/logo_apps_script_color_1x_web_96dp.png');

// Adds the image to the first paragraph.
paragraph.appendInlineImage(image);

المعلمات

الاسم	النوع	الوصف
`image`	`BlobSource`	بيانات الصورة.

الإرجاع

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

التفويض

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

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

`appendInlineImage(image)`

تُرفِق السمة InlineImage المحدّدة.

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById(DOCUMENT_ID);

// Gets the body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab(TAB_ID).asDocumentTab().getBody();

// Gets the first paragraph from the body.
const paragraph = body.getParagraphs()[0];

// Makes a copy of the first image in the body.
const image = body.getImages()[0].copy();;

// Adds the image to the first paragraph.
paragraph.appendInlineImage(image);

المعلمات

الاسم	النوع	الوصف
`image`	`InlineImage`	بيانات الصورة.

الإرجاع

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

التفويض

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

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

`appendPageBreak()`

تنشئ سمة PageBreak جديدة وتلحقها

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

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById(DOCUMENT_ID);

// Gets the body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab(TAB_ID).asDocumentTab().getBody();

// Gets the first paragraph from the body.
const paragraph = body.getParagraphs()[0];

// Adds a page break after the first paragraph.
paragraph.appendPageBreak();

الإرجاع

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

التفويض

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

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

`appendPageBreak(pageBreak)`

تُرفِق السمة PageBreak المحدّدة.

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

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById(DOCUMENT_ID);

// Gets the body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab(TAB_ID).asDocumentTab().getBody();

// Gets the first paragraph from the body.
const paragraph = body.getParagraphs()[0];

// Adds a page break after the first paragraph.
const pageBreak = paragraph.appendPageBreak();

// Makes a copy of the page break.
const newPageBreak = pageBreak.copy();

// Adds the copied page break to the paragraph.
paragraph.appendPageBreak(newPageBreak);

المعلمات

الاسم	النوع	الوصف
`pageBreak`	`PageBreak`	فاصل الصفحة المطلوب إلحاقه.

الإرجاع

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

التفويض

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

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

`appendText(text)`

تنشئ هذه الطريقة عنصر Text جديدًا وتتضمّن المحتوى المحدّد وتُلحقه.

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById(DOCUMENT_ID);

// Gets the body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab(TAB_ID).asDocumentTab().getBody();

// Gets the first paragraph from the body.
const paragraph = body.getParagraphs()[0];

// Adds a string to the paragraph.
paragraph.appendText('This is a new sentence.');

المعلمات

الاسم	النوع	الوصف
`text`	`String`	المحتوى النصي.

الإرجاع

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

التفويض

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

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

`appendText(text)`

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

 // Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById(DOCUMENT_ID);

// Gets the body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab(TAB_ID).asDocumentTab().getBody();

// Gets the text from the first paragraph in the body.
const paragraph1 = body.getParagraphs()[0];
const text = paragraph1.getText();

// Gets the third paragraph in the body.
const paragraph3 = body.getParagraphs()[2];

// Adds the text from the first paragraph to the third paragraph.
paragraph3.appendText(text);

المعلمات

الاسم	النوع	الوصف
`text`	`Text`	العنصر النصي المطلوب إلحاقه.

الإرجاع

Text — عنصر النص الملحق

التفويض

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

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

`clear()`

يؤدي إلى محو محتوى العنصر.

الإرجاع

Paragraph — العنصر الحالي

`copy()`

لعرض نسخة منفصلة عميقة من العنصر الحالي.

ويتم أيضًا نسخ أي عناصر فرعية موجودة في العنصر. لا يحتوي العنصر الجديد على أحد الوالدين.

الإرجاع

Paragraph: النسخة الجديدة

التفويض

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

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.

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById(DOCUMENT_ID);

// Gets the body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab(TAB_ID).asDocumentTab().getBody();

// Gets the first paragraph from the body.
const paragraph = body.getParagraphs()[0];

// Sets the horizontal alignment to left for the first paragraph.
paragraph.setAlignment(DocumentApp.HorizontalAlignment.LEFT);

// Gets the horizontal alignment of the first paragraph and logs it to the console.
console.log(paragraph.getAlignment().toString());

الإرجاع

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

`getHeading()`

لاسترداد ParagraphHeading.

// Opens the Docs file by its ID. If you created your script from within
// a Google Docs file, you can use DocumentApp.getActiveDocument() instead.
// TODO(developer): Replace the ID with your own.
const doc = DocumentApp.openById(DOCUMENT_ID);

// Gets the body contents of the tab by its ID.
// TODO(developer): Replace the ID with your own.
const body = doc.getTab(TAB_ID).asDocumentTab().getBody();

// Adds a paragraph to the body.
const paragraph = body.appendParagraph('Title heading');

// Sets the paragraph heading style to 'Title.'
paragraph.setHeading(DocumentApp.ParagraphHeading.TITLE);

// Gets the heading style and logs it to the console.
console.log(paragraph.getHeading().toString());

الإرجاع

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

`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 المحدّد في الفهرس المحدّد

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

المعلمات

الاسم	النوع	الوصف
`childIndex`	`Integer`	الفهرس الذي يتم عنده إدراج العنصر
`pageBreak`	`PageBreak`	[الفئة العمرية التي تؤديها هذه الكلمة في سن

الإرجاع

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

التفويض

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

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

`insertText(childIndex, text)`

تنشئ عنصرًا نصيًا جديدًا وإدراجه في الفهرس المحدد.

المعلمات

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

الإرجاع

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

التفويض

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

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

`insertText(childIndex, text)`

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`isAtDocumentEnd()`

وتحدِّد ما إذا كان العنصر في نهاية Document.

الإرجاع

Boolean: ما إذا كان العنصر في نهاية علامة التبويب.

التفويض

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

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

`isLeftToRight()`

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

الإرجاع

Boolean - الإعداد من اليسار إلى اليمين

التفويض

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

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

`merge()`

تدمج العنصر مع العنصر التابع السابق من النوع نفسه.

ويمكن دمج عناصر من ElementType نفسها فقط. أي عناصر فرعية مضمنة في يتم نقل العنصر الحالي إلى العنصر الشقيق السابق.

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

var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var body = documentTab.getBody();

// Example 1: Merge paragraphs
// Append two paragraphs to the document's active tab.
var par1 = body.appendParagraph('Paragraph 1.');
var par2 = body.appendParagraph('Paragraph 2.');
// Merge the newly added paragraphs into a single paragraph.
par2.merge();

// Example 2: Merge table cells
// Create a two-dimensional array containing the table's cell contents.
var cells = [
['Row 1, Cell 1', 'Row 1, Cell 2'],
['Row 2, Cell 1', 'Row 2, Cell 2']
];
// Build a table from the array.
var table = body.appendTable(cells);
// Get the first row in the table.
 var row = table.getRow(0);
// Get the two cells in this row.
var cell1 = row.getCell(0);
var cell2 = row.getCell(1);
// Merge the current cell into its preceding sibling element.
var merged = cell2.merge();

الإرجاع

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

التفويض

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

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

`removeChild(child)`

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

المعلمات

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

الإرجاع

Paragraph — العنصر الحالي

التفويض

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

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

الإرجاع

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

التفويض

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

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`	المحاذاة الأفقية

الإرجاع

Paragraph — العنصر الحالي

التفويض

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

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

الإرجاع

Paragraph — العنصر الحالي

التفويض

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

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

`setHeading(heading)`

لضبط ParagraphHeading.

المعلمات

الاسم	النوع	الوصف
`heading`	`ParagraphHeading`	العنوان

الإرجاع

Paragraph — العنصر الحالي

التفويض

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

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

`setIndentEnd(indentEnd)`

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

المعلمات

الاسم	النوع	الوصف
`indentEnd`	`Number`	المسافة البادئة للنهاية، بالنقاط

الإرجاع

Paragraph — العنصر الحالي

التفويض

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

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

`setIndentFirstLine(indentFirstLine)`

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

المعلمات

الاسم	النوع	الوصف
`indentFirstLine`	`Number`	المسافة البادئة للسطر الأول، بالنقاط

الإرجاع

Paragraph — العنصر الحالي

التفويض

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

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

`setIndentStart(indentStart)`

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

المعلمات

الاسم	النوع	الوصف
`indentStart`	`Number`	المسافة البادئة للبداية، بالنقاط

الإرجاع

Paragraph — العنصر الحالي

التفويض

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

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

`setLeftToRight(leftToRight)`

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

المعلمات

الاسم	النوع	الوصف
`leftToRight`	`Boolean`	الإعداد من اليسار إلى اليمين

الإرجاع

Paragraph — العنصر الحالي

التفويض

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

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

`setLineSpacing(multiplier)`

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

المعلمات

الاسم	النوع	الوصف
`multiplier`	`Number`	عدد الأسطر

الإرجاع

Paragraph — العنصر الحالي

التفويض

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

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

`setLinkUrl(url)`

لضبط عنوان URL للرابط.

المعلمات

الاسم	النوع	الوصف
`url`	`String`	عنوان URL للرابط

الإرجاع

Paragraph — العنصر الحالي

التفويض

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

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

`setSpacingAfter(spacingAfter)`

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

المعلمات

الاسم	النوع	الوصف
`spacingAfter`	`Number`	التباعد بعد العنصر، بالنقاط

الإرجاع

Paragraph — العنصر الحالي

التفويض

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

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

`setSpacingBefore(spacingBefore)`

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

المعلمات

الاسم	النوع	الوصف
`spacingBefore`	`Number`	التباعد قبل العنصر، بالنقاط

الإرجاع

Paragraph — العنصر الحالي

التفويض

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

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`	نوع محاذاة النص لتطبيقه

الإرجاع

Paragraph — العنصر الحالي

التفويض

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

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