Class Paragraph

الفقرة

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

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

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

// Append a document 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 جديدة وتُلحِقها من حجم الكائن الثنائي الكبير (blob) المحدّد.
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('abc123456');

// Gets the document body.
const body = doc.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 document, 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('abc123456');

// Gets the document body.
const body = doc.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 جديدة وتُلحِقها من حجم الكائن الثنائي الكبير (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('abc123456');

// Gets the document body.
const body = doc.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('abc123456');

// Gets the document body.
const body = doc.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('abc123456');

// Gets the document body.
const body = doc.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('abc123456');

// Gets the document body.
const body = doc.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('abc123456');

// Gets the document body.
const body = doc.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('abc123456');

// Gets the document body.
const body = doc.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().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.

// 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('abc123456');

// Gets the document body.
const body = doc.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 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

---

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

// Gets the document body.
const body = doc.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()

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

// 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 للعنصر.

يمكنك استخدام 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();

رحلة العودة

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

رحلة العودة

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 التي تفرض قيودًا على البنية المتوافقة.

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

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

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

المَعلمات

الاسم	النوع	الوصف
searchPattern	String	نمط regex للبحث عن
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 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	سمات العنصر.

رحلة العودة

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