يشير ذلك المصطلح إلى عنصر يمثّل قائمة. علامة ListItem
هي سمة Paragraph
مرتبطة برقم تعريف قائمة. قد تحتوي السمة ListItem
على عناصر Equation
وFootnote
وHorizontalRule
وInlineDrawing
وInlineImage
وPageBreak
وText
. لمزيد من المعلومات حول بنية المستند، راجع دليل توسيع نطاق مستندات Google.
لا يمكن أن يحتوي ListItems
على أحرف سطر جديد. يتم تحويل أحرف الأسطر الجديدة ("\n") إلى
أحرف فواصل أسطر ("\r").
ListItems
برقم تعريف القائمة نفسه ينتمي إلى القائمة نفسها ويتم ترقيمها وفقًا لذلك.
ليس من الضروري أن تكون السمة ListItems
الخاصة بقائمة معيّنة مجاورة في المستند أو تحتوي على العنصر الرئيسي نفسه. قد يتوفّر عنصران ينتميان إلى القائمة نفسها في أي مكان في المستند مع الحفاظ على الترقيم المتتالي، كما هو موضّح في المثال التالي:
var body = DocumentApp.getActiveDocument().getBody(); // Append a new list item to the body. var item1 = body.appendListItem('Item 1'); // Log the new list item's list ID. Logger.log(item1.getListId()); // Append a table after the list item. body.appendTable([ ['Cell 1', 'Cell 2'] ]); // Append a second list item with the same list ID. The two items are treated as the same list, // despite not being consecutive. var item2 = body.appendListItem('Item 2'); item2.setListId(item1);
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
addPositionedImage(image) | PositionedImage | تنشئ وتدرج PositionedImage جديدة من النقطة المحددة للصورة. |
appendHorizontalRule() | HorizontalRule | لإنشاء HorizontalRule جديد وإلحاقه به. |
appendInlineImage(image) | InlineImage | تنشئ هذه الدالة InlineImage جديدًا وتُلحقه من كائن الصورة الثنائي المحدد. |
appendInlineImage(image) | InlineImage | لإلحاق InlineImage المقدَّمة |
appendPageBreak() | PageBreak | لإنشاء PageBreak جديد وإلحاقه به. |
appendPageBreak(pageBreak) | PageBreak | لإلحاق PageBreak المقدَّمة |
appendText(text) | Text | لإنشاء عنصر Text جديد وإلحاقه بالمحتوى المحدّد |
appendText(text) | Text | لإلحاق عنصر Text المحدّد |
clear() | ListItem | لمحو محتوى العنصر. |
copy() | ListItem | لعرض نسخة عميقة منفصلة من العنصر الحالي. |
editAsText() | Text | الحصول على نسخة Text من العنصر الحالي، للتعديل. |
findElement(elementType) | RangeElement | للبحث في محتوى العنصر عن عنصر تابع من النوع المحدد. |
findElement(elementType, from) | RangeElement | للبحث في محتوى العنصر عن عنصر تابع من النوع المحدّد، بدءًا من سمة RangeElement المحدّدة |
findText(searchPattern) | RangeElement | للبحث في محتويات العنصر عن نمط النص المحدد باستخدام التعبيرات العادية. |
findText(searchPattern, from) | RangeElement | للبحث في محتوى العنصر عن نمط النص المحدد، بدءًا من نتيجة بحث معينة. |
getAlignment() | HorizontalAlignment | استرداد HorizontalAlignment . |
getAttributes() | Object | لاسترداد سمات العنصر. |
getChild(childIndex) | Element | لاسترداد العنصر الفرعي في الفهرس الفرعي المحدد. |
getChildIndex(child) | Integer | لاسترداد الفهرس الفرعي للعنصر الفرعي المحدد |
getGlyphType() | GlyphType | لاسترداد GlyphType لعنصر القائمة. |
getHeading() | ParagraphHeading | استرداد ParagraphHeading . |
getIndentEnd() | Number | لاسترداد المسافة البادئة للنهاية بالنقاط. |
getIndentFirstLine() | Number | لاسترداد المسافة البادئة للسطر الأول بالنقاط. |
getIndentStart() | Number | لاسترداد المسافة البادئة للبداية. |
getLineSpacing() | Number | لاسترداد تباعد الأسطر بالنقاط. |
getLinkUrl() | String | لاسترداد عنوان URL للرابط. |
getListId() | String | لاسترداد رقم تعريف القائمة. |
getNestingLevel() | Integer | لاسترداد مستوى تداخل عنصر القائمة. |
getNextSibling() | Element | لاسترداد العنصر الشقيق التالي للعنصر. |
getNumChildren() | Integer | لاسترداد عدد الأطفال. |
getParent() | ContainerElement | لاسترداد العنصر الرئيسي للعنصر. |
getPositionedImage(id) | PositionedImage | يحصل على PositionedImage من خلال رقم تعريف الصورة. |
getPositionedImages() | PositionedImage[] | ربط جميع عناصر PositionedImage بالفقرة |
getPreviousSibling() | Element | لاسترداد العنصر الشقيق السابق للعنصر. |
getSpacingAfter() | Number | لاسترداد التباعد بعد العنصر بالنقاط. |
getSpacingBefore() | Number | لاسترداد التباعد قبل العنصر، بالنقاط. |
getText() | String | لاسترداد محتويات العنصر كسلسلة نصية. |
getTextAlignment() | TextAlignment | لمحاذاة النص. |
getType() | ElementType | لاسترداد ElementType للعنصر. |
insertHorizontalRule(childIndex) | HorizontalRule | لإنشاء HorizontalRule وإدراجه في الفهرس المحدّد. |
insertInlineImage(childIndex, image) | InlineImage | تنشئ هذه الدالة InlineImage وتدرجها من كائن فقاعة الصورة المحدد في الفهرس المحدد. |
insertInlineImage(childIndex, image) | InlineImage | لإدراج InlineImage المحدّد في الفهرس المحدّد. |
insertPageBreak(childIndex) | PageBreak | لإنشاء PageBreak جديد وإدراجه في الفهرس المحدّد. |
insertPageBreak(childIndex, pageBreak) | PageBreak | لإدراج PageBreak المحدّد في الفهرس المحدّد. |
insertText(childIndex, text) | Text | لإنشاء عنصر نصي جديد وإدراجه في الفهرس المحدّد |
insertText(childIndex, text) | Text | يدرج عنصر Text المحدد في الفهرس المحدد، مع محتويات النص المحددة. |
isAtDocumentEnd() | Boolean | تحدِّد هذه السياسة ما إذا كان العنصر في نهاية Document . |
isLeftToRight() | Boolean | لاسترداد الإعداد من اليسار إلى اليمين. |
merge() | ListItem | يدمج العنصر مع العنصر التابع السابق من النوع نفسه. |
removeChild(child) | ListItem | لإزالة العنصر الفرعي المحدد. |
removeFromParent() | ListItem | لإزالة العنصر من الأصل. |
removePositionedImage(id) | Boolean | لإزالة PositionedImage حسب رقم تعريف الصورة. |
replaceText(searchPattern, replacement) | Element | لاستبدال جميع تكرارات نمط نص معين بسلسلة استبدال معينة، باستخدام تعبيرات عادية. |
setAlignment(alignment) | ListItem | لضبط HorizontalAlignment . |
setAttributes(attributes) | ListItem | تعيّن سمات العنصر. |
setGlyphType(glyphType) | ListItem | لتعيين GlyphType لعنصر القائمة. |
setHeading(heading) | ListItem | لضبط ParagraphHeading . |
setIndentEnd(indentEnd) | ListItem | لضبط المسافة البادئة للنهاية بالنقاط |
setIndentFirstLine(indentFirstLine) | ListItem | لتعيين المسافة البادئة للسطر الأول بالنقاط. |
setIndentStart(indentStart) | ListItem | لضبط المسافة البادئة للبداية بالنقاط |
setLeftToRight(leftToRight) | ListItem | لتعيين الإعداد من اليسار إلى اليمين. |
setLineSpacing(multiplier) | ListItem | لتعيين تباعد الأسطر، ككمية تشير إلى عدد الأسطر المطلوب استخدامها للتباعد. |
setLinkUrl(url) | ListItem | تُحدِّد عنوان URL للرابط. |
setListId(listItem) | ListItem | تضبط رقم تعريف القائمة. |
setNestingLevel(nestingLevel) | ListItem | لتعيين مستوى تداخل عنصر القائمة. |
setSpacingAfter(spacingAfter) | ListItem | لتعيين التباعد بعد العنصر، بالنقاط. |
setSpacingBefore(spacingBefore) | ListItem | لتعيين التباعد قبل العنصر، بالنقاط. |
setText(text) | void | لضبط محتوى عنصر القائمة كنص. |
setTextAlignment(textAlignment) | ListItem | لضبط محاذاة النص |
الوثائق التفصيلية
addPositionedImage(image)
تنشئ وتدرج PositionedImage
جديدة من النقطة المحددة للصورة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
image | BlobSource | بيانات الصورة |
استرجاع الكرة
PositionedImage
- الصورة الجديدة في الموضع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendHorizontalRule()
لإنشاء HorizontalRule
جديد وإلحاقه به.
استرجاع الكرة
HorizontalRule
- القاعدة الأفقية الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendInlineImage(image)
تنشئ هذه الدالة InlineImage
جديدًا وتُلحقه من كائن الصورة الثنائي المحدد.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
image | BlobSource | بيانات الصورة |
استرجاع الكرة
InlineImage
— الصورة الملحقة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendInlineImage(image)
لإلحاق InlineImage
المقدَّمة
المَعلمات
الاسم | Type | الوصف |
---|---|---|
image | InlineImage | بيانات الصورة |
استرجاع الكرة
InlineImage
— الصورة الملحقة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendPageBreak()
لإنشاء PageBreak
جديد وإلحاقه به.
ملاحظة: قد لا تكون PageBreaks
مدرَجة ضمن TableCells
.
إذا كان العنصر الحالي مضمنًا في خلية جدول، فسيتم طرح استثناء.
استرجاع الكرة
PageBreak
- عنصر فاصل الصفحة الجديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendPageBreak(pageBreak)
لإلحاق PageBreak
المقدَّمة
ملاحظة: قد لا تكون PageBreaks
مدرَجة ضمن TableCells
.
إذا كان العنصر الحالي مضمنًا في خلية جدول، فسيتم طرح استثناء.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
pageBreak | PageBreak | فاصل الصفحة لإلحاقه |
استرجاع الكرة
PageBreak
— عنصر فاصل الصفحة الملحق
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendText(text)
لإنشاء عنصر Text
جديد وإلحاقه بالمحتوى المحدّد
المَعلمات
الاسم | Type | الوصف |
---|---|---|
text | String | محتوى النص |
استرجاع الكرة
Text
- العنصر النصي الجديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
appendText(text)
لإلحاق عنصر Text
المحدّد
المَعلمات
الاسم | Type | الوصف |
---|---|---|
text | Text | العنصر النصي لإلحاقه |
استرجاع الكرة
Text
- العنصر النصي الملحق
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
clear()
copy()
لعرض نسخة عميقة منفصلة من العنصر الحالي.
يتم أيضًا نسخ أي عناصر فرعية موجودة في العنصر. العنصر الجديد ليس له أصل.
استرجاع الكرة
ListItem
— النسخة الجديدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
editAsText()
الحصول على نسخة Text
من العنصر الحالي، للتعديل.
ويمكنك استخدام editAsText
لمعالجة محتوى العناصر كنص منسَّق. يتجاهل الوضع editAsText
العناصر غير النصية (مثل InlineImage
وHorizontalRule
).
تتم إزالة العناصر الثانوية الموجودة بالكامل داخل نطاق نصي محذوف من العنصر.
var body = DocumentApp.getActiveDocument().getBody(); // Insert two paragraphs separated by a paragraph containing an // horizontal rule. body.insertParagraph(0, "An editAsText sample."); body.insertHorizontalRule(0); body.insertParagraph(0, "An example."); // Delete " sample.\n\n An" removing the horizontal rule in the process. body.editAsText().deleteText(14, 25);
استرجاع الكرة
Text
- نسخة نصية من العنصر الحالي
findElement(elementType)
للبحث في محتوى العنصر عن عنصر تابع من النوع المحدد.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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; } }
المَعلمات
الاسم | Type | الوصف |
---|---|---|
elementType | ElementType | نوع العنصر للبحث عنه |
from | RangeElement | نتيجة البحث للبحث منها |
استرجاع الكرة
RangeElement
- نتيجة بحث تشير إلى الموضع التالي لعنصر البحث
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findText(searchPattern)
للبحث في محتويات العنصر عن نمط النص المحدد باستخدام التعبيرات العادية.
هناك مجموعة فرعية من ميزات التعبير العادي في JavaScript غير متوافقة بالكامل، مثل مجموعات الالتقاط ومعدِّلات الأوضاع.
تتم مطابقة نمط التعبير العادي المقدّم بشكل مستقل مع كل كتلة نصية مضمَّنة في العنصر الحالي.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
searchPattern | String | النمط للبحث عن |
استرجاع الكرة
RangeElement
: نتيجة بحث تشير إلى موضع نص البحث، وتكون قيمة فارغة في حال عدم التطابق
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
findText(searchPattern, from)
للبحث في محتوى العنصر عن نمط النص المحدد، بدءًا من نتيجة بحث معينة.
هناك مجموعة فرعية من ميزات التعبير العادي في JavaScript غير متوافقة بالكامل، مثل مجموعات الالتقاط ومعدِّلات الأوضاع.
تتم مطابقة نمط التعبير العادي المقدّم بشكل مستقل مع كل كتلة نصية مضمَّنة في العنصر الحالي.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
searchPattern | String | النمط للبحث عن |
from | RangeElement | نتيجة البحث للبحث منها |
استرجاع الكرة
RangeElement
: نتيجة بحث تشير إلى الموضع التالي لنص البحث، أو قيمة فارغة في حال عدم التطابق
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getAlignment()
استرداد HorizontalAlignment
.
استرجاع الكرة
HorizontalAlignment
— المحاذاة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getAttributes()
لاسترداد سمات العنصر.
والنتيجة هي كائن يحتوي على سمة لكل سمة عنصر صالحة حيث يتجاوب كل اسم خاصية مع عنصر في التعداد DocumentApp.Attribute
.
var 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."); }
المَعلمات
الاسم | Type | الوصف |
---|---|---|
childIndex | Integer | فهرس العنصر الفرعي لاسترداد |
استرجاع الكرة
Element
- العنصر الفرعي في الفهرس المحدد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getChildIndex(child)
لاسترداد الفهرس الفرعي للعنصر الفرعي المحدد
المَعلمات
الاسم | Type | الوصف |
---|---|---|
child | Element | العنصر الفرعي المطلوب استرداد الفهرس له |
استرجاع الكرة
Integer
— الفهرس الفرعي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getGlyphType()
getHeading()
استرداد ParagraphHeading
.
استرجاع الكرة
ParagraphHeading
: العنوان
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getIndentEnd()
لاسترداد المسافة البادئة للنهاية بالنقاط.
استرجاع الكرة
Number
- المسافة البادئة للنهاية، بالنقاط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getIndentFirstLine()
لاسترداد المسافة البادئة للسطر الأول بالنقاط.
استرجاع الكرة
Number
- المسافة البادئة للسطر الأول بالنقاط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getIndentStart()
لاسترداد المسافة البادئة للبداية.
استرجاع الكرة
Number
- المسافة البادئة للبداية
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLineSpacing()
لاسترداد تباعد الأسطر بالنقاط.
استرجاع الكرة
Number
— تباعد الأسطر، بالنقاط
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getLinkUrl()
لاسترداد عنوان URL للرابط.
استرجاع الكرة
String
: عنوان URL للرابط أو قيمة فارغة إذا كان العنصر يحتوي على قيم متعدّدة لهذه السمة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getListId()
لاسترداد رقم تعريف القائمة.
استرجاع الكرة
String
- رقم تعريف القائمة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getNestingLevel()
لاسترداد مستوى تداخل عنصر القائمة.
ويكون مستوى التداخل صفرًا بشكل تلقائي. يحدد مستوى التداخل الحرف الرسومي الذي يستخدمه عنصر القائمة.
استرجاع الكرة
Integer
- مستوى التداخل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getNextSibling()
لاسترداد العنصر الشقيق التالي للعنصر.
الشقيق التالي له نفس الأصل ويتبع العنصر الحالي.
استرجاع الكرة
Element
- العنصر الشقيق التالي.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getNumChildren()
لاسترداد عدد الأطفال.
// Get the body section of the active document. var body = DocumentApp.getActiveDocument().getBody(); // Log the number of elements in the document. Logger.log("There are " + body.getNumChildren() + " elements in the document body.");
استرجاع الكرة
Integer
- عدد الأطفال
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getParent()
لاسترداد العنصر الرئيسي للعنصر.
يحتوي العنصر الأصلي على العنصر الحالي.
استرجاع الكرة
ContainerElement
— العنصر الرئيسي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getPositionedImage(id)
يحصل على PositionedImage
من خلال رقم تعريف الصورة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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
وإدراجه في الفهرس المحدّد.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي يتم إدراج العنصر فيه |
استرجاع الكرة
HorizontalRule
: عنصر القاعدة الأفقية الجديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertInlineImage(childIndex, image)
تنشئ هذه الدالة InlineImage
وتدرجها من كائن فقاعة الصورة المحدد في الفهرس المحدد.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي يتم إدراج العنصر فيه |
image | BlobSource | بيانات الصورة |
استرجاع الكرة
InlineImage
- عنصر الصورة المضمّنة الذي تم إدراجه
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertInlineImage(childIndex, image)
لإدراج InlineImage
المحدّد في الفهرس المحدّد.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي يتم إدراج العنصر فيه |
image | InlineImage | بيانات الصورة |
استرجاع الكرة
InlineImage
- عنصر الصورة المضمّنة الذي تم إدراجه
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertPageBreak(childIndex)
لإنشاء PageBreak
جديد وإدراجه في الفهرس المحدّد.
ملاحظة: قد لا تكون PageBreaks
مدرَجة ضمن TableCells
.
إذا كان العنصر الحالي مضمنًا في خلية جدول، فسيتم طرح استثناء.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي يتم إدراج العنصر فيه |
استرجاع الكرة
PageBreak
- عنصر فاصل الصفحة الجديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertPageBreak(childIndex, pageBreak)
لإدراج PageBreak
المحدّد في الفهرس المحدّد.
ملاحظة: قد لا تكون PageBreaks
مدرَجة ضمن TableCells
.
إذا كان العنصر الحالي مضمنًا في خلية جدول، فسيتم طرح استثناء.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي يتم إدراج العنصر فيه |
pageBreak | PageBreak | [فواصل [page] لإدراج |
استرجاع الكرة
PageBreak
— عنصر فاصل الصفحة المدرج
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertText(childIndex, text)
لإنشاء عنصر نصي جديد وإدراجه في الفهرس المحدّد
المَعلمات
الاسم | Type | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي يتم إدراج العنصر فيه |
text | String | محتوى النص |
استرجاع الكرة
Text
- العنصر النصي الجديد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertText(childIndex, text)
يدرج عنصر Text
المحدد في الفهرس المحدد، مع محتويات النص المحددة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
childIndex | Integer | الفهرس الذي يتم إدراج العنصر فيه |
text | Text | العنصر النصي لإدراج |
استرجاع الكرة
Text
— العنصر النصي المدرج
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isAtDocumentEnd()
تحدِّد هذه السياسة ما إذا كان العنصر في نهاية Document
.
استرجاع الكرة
Boolean
: يشير إلى ما إذا كان العنصر في نهاية المستند.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
isLeftToRight()
لاسترداد الإعداد من اليسار إلى اليمين.
استرجاع الكرة
Boolean
- الإعداد من اليسار إلى اليمين
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
merge()
يدمج العنصر مع العنصر التابع السابق من النوع نفسه.
يمكن دمج العناصر من ElementType
نفسه فقط. يتم نقل أي عناصر فرعية مضمنة في العنصر الحالي إلى العنصر التابع السابق.
تتم إزالة العنصر الحالي من المستند.
var body = DocumentApp.getActiveDocument().getBody(); // Example 1: Merge paragraphs // Append two paragraphs to the document. var par1 = body.appendParagraph('Paragraph 1.'); var par2 = body.appendParagraph('Paragraph 2.'); // Merge the newly added paragraphs into a single paragraph. par2.merge(); // Example 2: Merge table cells // Create a two-dimensional array containing the table's cell contents. var cells = [ ['Row 1, Cell 1', 'Row 1, Cell 2'], ['Row 2, Cell 1', 'Row 2, Cell 2'] ]; // Build a table from the array. var table = body.appendTable(cells); // Get the first row in the table. var row = table.getRow(0); // Get the two cells in this row. var cell1 = row.getCell(0); var cell2 = row.getCell(1); // Merge the current cell into its preceding sibling element. var merged = cell2.merge();
استرجاع الكرة
ListItem
— العنصر المدمج
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
removeChild(child)
لإزالة العنصر الفرعي المحدد.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
child | Element | العنصر الفرعي لإزالتها |
استرجاع الكرة
ListItem
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
removeFromParent()
لإزالة العنصر من الأصل.
var body = DocumentApp.getActiveDocument().getBody(); // Remove all images in the document body. var imgs = body.getImages(); for (var i = 0; i < imgs.length; i++) { imgs[i].removeFromParent(); }
استرجاع الكرة
ListItem
— العنصر الذي تمت إزالته
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
removePositionedImage(id)
لإزالة PositionedImage
حسب رقم تعريف الصورة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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().getBody(); // Clear the text surrounding "Apps Script", with or without text. body.replaceText("^.*Apps ?Script.*$", "Apps Script");
المَعلمات
الاسم | Type | الوصف |
---|---|---|
searchPattern | String | نمط التعبير العادي للبحث عن |
replacement | String | النص المطلوب استخدامه كبديل |
استرجاع الكرة
Element
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setAlignment(alignment)
لضبط HorizontalAlignment
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
alignment | HorizontalAlignment | والمحاذاة الأفقية |
استرجاع الكرة
ListItem
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
attributes | Object | تمثّل هذه السمة سمات العنصر. |
استرجاع الكرة
ListItem
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setGlyphType(glyphType)
لتعيين GlyphType
لعنصر القائمة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
glyphType | GlyphType | نوع الحرف الرسومي |
استرجاع الكرة
ListItem
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setHeading(heading)
لضبط ParagraphHeading
.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
heading | ParagraphHeading | العنوان |
استرجاع الكرة
ListItem
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setIndentEnd(indentEnd)
لضبط المسافة البادئة للنهاية بالنقاط
المَعلمات
الاسم | Type | الوصف |
---|---|---|
indentEnd | Number | المسافة البادئة للنهاية، بالنقاط |
استرجاع الكرة
ListItem
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setIndentFirstLine(indentFirstLine)
لتعيين المسافة البادئة للسطر الأول بالنقاط.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
indentFirstLine | Number | المسافة البادئة للسطر الأول بالنقاط |
استرجاع الكرة
ListItem
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setIndentStart(indentStart)
لضبط المسافة البادئة للبداية بالنقاط
المَعلمات
الاسم | Type | الوصف |
---|---|---|
indentStart | Number | المسافة البادئة للبداية، بالنقاط |
استرجاع الكرة
ListItem
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLeftToRight(leftToRight)
لتعيين الإعداد من اليسار إلى اليمين.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
leftToRight | Boolean | الإعداد من اليسار إلى اليمين |
استرجاع الكرة
ListItem
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLineSpacing(multiplier)
لتعيين تباعد الأسطر، ككمية تشير إلى عدد الأسطر المطلوب استخدامها للتباعد.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
multiplier | Number | عدد الأسطر |
استرجاع الكرة
ListItem
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setLinkUrl(url)
تُحدِّد عنوان URL للرابط.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
url | String | عنوان URL للرابط |
استرجاع الكرة
ListItem
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setListId(listItem)
تضبط رقم تعريف القائمة.
تم ضبط رقم تعريف القائمة على القيمة نفسها للسمة ListItem
المحدّدة. سيتم التعامل مع ListItems
كعضو في القائمة نفسها.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
listItem | ListItem | عنصر القائمة الذي سيتم استخدام رقم تعريفه في القائمة |
استرجاع الكرة
ListItem
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setNestingLevel(nestingLevel)
لتعيين مستوى تداخل عنصر القائمة.
ويكون مستوى التداخل صفرًا بشكل تلقائي. يحدد مستوى التداخل الحرف الرسومي الذي يستخدمه عنصر القائمة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
nestingLevel | Integer | مستوى التداخل |
استرجاع الكرة
ListItem
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setSpacingAfter(spacingAfter)
لتعيين التباعد بعد العنصر، بالنقاط.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
spacingAfter | Number | التباعد بعد العنصر، بالنقاط |
استرجاع الكرة
ListItem
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setSpacingBefore(spacingBefore)
لتعيين التباعد قبل العنصر، بالنقاط.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
spacingBefore | Number | التباعد قبل العنصر، بالنقاط |
استرجاع الكرة
ListItem
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
setText(text)
لضبط محتوى عنصر القائمة كنص.
ملاحظة: تم محو المحتوى الحالي.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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);
المَعلمات
الاسم | Type | الوصف |
---|---|---|
textAlignment | TextAlignment | نوع محاذاة النص المراد تطبيقه |
استرجاع الكرة
ListItem
- العنصر الحالي
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents