عنصر يمثّل فقرة. قد يحتوي 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()
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