Class Text

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
النص

عنصر يمثل منطقة نص منسّقة. النص الموجود في Document مضمّن في عناصر Text. يمكن تضمين أحد عناصر Text في Equation أو EquationFunction أو ListItem أو Paragraph، ولكن لا يمكن أن يحتوي العنصر نفسه على أي عنصر آخر. لمزيد من المعلومات حول بنية المستند، يمكنك الاطّلاع على دليل توسيع مستندات Google.

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

// Use editAsText to obtain a single text element containing
// all the characters in the document.
var text = body.editAsText();

// Insert text at the beginning of the document.
text.insertText(0, 'Inserted text.\n');

// Insert text at the end of the document.
text.appendText('\nAppended text.');

// Make the first half of the document blue.
text.setForegroundColor(0, text.getText().length / 2, '#00FFFF');

الطُرق

الطريقةنوع الإرجاعوصف قصير
appendText(text)Textلإضافة النص المحدد إلى نهاية هذه المنطقة النصية.
copy()Textعرض نسخة منفصلة من العنصر الحالي بشكل منفصل.
deleteText(startOffset, endOffsetInclusive)Textحذف نطاق نصي.
editAsText()Textللحصول على نسخة Text من العنصر الحالي للتعديل.
findText(searchPattern)RangeElementيبحث في محتوى العنصر عن نمط النص المحدّد باستخدام التعبيرات العادية.
findText(searchPattern, from)RangeElementيبحث في محتوى العنصر عن نمط النص المحدَّد، بدءًا من نتيجة بحث معيّنة.
getAttributes()Objectلاسترداد سمات العنصر\u39s.
getAttributes(offset)Objectاسترداد السمات عند إزاحة الأحرف المحددة.
getBackgroundColor()Stringاسترداد إعداد لون الخلفية.
getBackgroundColor(offset)Stringاسترداد لون الخلفية عند إزاحة الحرف المحددة.
getFontFamily()Stringلاسترداد إعداد مجموعة الخطوط.
getFontFamily(offset)Stringاسترداد مجموعة الخطوط عند إزاحة الحرف المحددة.
getFontSize()Numberلاسترداد إعداد حجم الخط.
getFontSize(offset)Numberاسترداد حجم الخط عند إزاحة الحرف المحددة.
getForegroundColor()Stringاسترداد إعداد لون الواجهة
getForegroundColor(offset)Stringاسترداد لون الواجهة عند إزاحة الحرف المحددة.
getLinkUrl()Stringلاسترداد عنوان URL للرابط.
getLinkUrl(offset)Stringلاسترداد عنوان URL للرابط عند إزاحة الحرف المحددة.
getNextSibling()Elementلاسترداد العنصر التالي.
getParent()ContainerElementلاسترداد العنصر الرئيسي للعنصر.
getPreviousSibling()Elementلاسترجاع العنصر السابق الذي يشبه العنصر نفسه.
getText()Stringلاسترداد محتوى العنصر كسلسلة نصية.
getTextAlignment()TextAlignmentلمحاذاة النص.
getTextAlignment(offset)TextAlignmentمحاذاة النص إلى حرف واحد.
getTextAttributeIndices()Integer[]لاسترداد مجموعة فهارس النصوص التي تتوافق مع بداية تشغيل تنسيق النص المميز.
getType()ElementTypeلاسترداد العنصر ElementType's.
insertText(offset, text)Textإدراج النص المحدد عند إزاحة الحرف المحددة.
isAtDocumentEnd()Booleanتحدِّد هذه السياسة ما إذا كان العنصر سيكون في نهاية Document.
isBold()Booleanاسترداد الإعداد الغامق.
isBold(offset)Booleanاسترداد الإعداد الغامق عند إزاحة الحرف المحددة.
isItalic()Booleanاسترداد الإعداد المائل.
isItalic(offset)Booleanاسترداد الإعداد المائل عند إزاحة الحرف المحددة.
isStrikethrough()Booleanاسترداد إعداد يتوسطه خط
isStrikethrough(offset)Booleanاسترداد إعداد يتوسطه خط عند إزاحة الحرف المحددة.
isUnderline()Booleanلاسترداد إعداد التسطير.
isUnderline(offset)Booleanاسترداد إعداد التسطير عند إزاحة الحرف المحددة.
merge()Textلدمج العنصر مع العنصر التابع السابق من النوع نفسه.
removeFromParent()Textإزالة العنصر من العنصر الرئيسي.
replaceText(searchPattern, replacement)Elementاستبدال جميع تكرارات نمط نص معين بسلسلة استبدال محددة، باستخدام التعبيرات العادية.
setAttributes(startOffset, endOffsetInclusive, attributes)Textيتم تطبيق السمات المحدّدة على نطاق الأحرف المحدّد.
setAttributes(attributes)Textتحدد سمات العنصر\u39;s.
setBackgroundColor(startOffset, endOffsetInclusive, color)Textلضبط لون الخلفية لنطاق الأحرف المحدد.
setBackgroundColor(color)Textلضبط لون الخلفية.
setBold(bold)Textلضبط الإعداد بالخط الغامق.
setBold(startOffset, endOffsetInclusive, bold)Textلضبط الإعداد بالخط الغامق لنطاق الأحرف المحدّد.
setFontFamily(startOffset, endOffsetInclusive, fontFamilyName)Textلضبط مجموعة الخطوط لنطاق الأحرف المحدّد.
setFontFamily(fontFamilyName)Textلضبط مجموعة الخطوط.
setFontSize(startOffset, endOffsetInclusive, size)Textلتحديد حجم الخط لنطاق الأحرف المحدد.
setFontSize(size)Textلضبط حجم الخط.
setForegroundColor(startOffset, endOffsetInclusive, color)Textتعمل هذه السياسة على ضبط لون المقدّمة لنطاق الأحرف المحدّد.
setForegroundColor(color)Textضبط لون الواجهة
setItalic(italic)Textلضبط الإعداد المائل.
setItalic(startOffset, endOffsetInclusive, italic)Textلضبط الإعداد المائل لنطاق الأحرف المحدّد.
setLinkUrl(startOffset, endOffsetInclusive, url)Textلضبط عنوان URL للرابط لنطاق الأحرف المحدّد.
setLinkUrl(url)Textلضبط عنوان URL للرابط.
setStrikethrough(strikethrough)Textلضبط إعداد النص الذي يتوسطه خط.
setStrikethrough(startOffset, endOffsetInclusive, strikethrough)Textلضبط إعداد النص الذي يتوسطه خط لنطاق الأحرف المحدد.
setText(text)Textلضبط محتوى النص.
setTextAlignment(startOffset, endOffsetInclusive, textAlignment)Textلضبط محاذاة النص لنطاق أحرف معيّن.
setTextAlignment(textAlignment)Textلضبط محاذاة النص.
setUnderline(underline)Textلضبط إعداد التسطير.
setUnderline(startOffset, endOffsetInclusive, underline)Textلضبط إعداد التسطير لنطاق الأحرف المحدّد.

المستندات التفصيلية

appendText(text)

لإضافة النص المحدد إلى نهاية هذه المنطقة النصية.

المعلّمات

الاسمالنوعالوصف
textStringالنص الذي تريد إلحاقه

تذكرة ذهاب وعودة

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

التفويض

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

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

copy()

عرض نسخة منفصلة من العنصر الحالي بشكل منفصل.

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

تذكرة ذهاب وعودة

Text — النسخة الجديدة:

التفويض

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

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

deleteText(startOffset, endOffsetInclusive)

حذف نطاق نصي.

المعلّمات

الاسمالنوعالوصف
startOffsetIntegerإزاحة الحرف الأول للحذف
endOffsetInclusiveIntegerإزاحة الحرف الأخير للحذف

تذكرة ذهاب وعودة

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

التفويض

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

  • 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 — نسخة نصية من العنصر الحالي


findText(searchPattern)

يبحث في محتوى العنصر عن نمط النص المحدّد باستخدام التعبيرات العادية.

لا تتوفّر مجموعة فرعية من ميزات التعبير العادي في JavaScript بشكل كامل، مثل مجموعات الالتقاط ومفاتيح تعديل الوضع.

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

المعلّمات

الاسمالنوعالوصف
searchPatternStringالنمط المطلوب البحث عنه

تذكرة ذهاب وعودة

RangeElement - نتيجة بحث تشير إلى موضع نص البحث، أو قيمة فارغة في حال عدم التطابق

التفويض

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

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

findText(searchPattern, from)

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

لا تتوفّر مجموعة فرعية من ميزات التعبير العادي في JavaScript بشكل كامل، مثل مجموعات الالتقاط ومفاتيح تعديل الوضع.

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

المعلّمات

الاسمالنوعالوصف
searchPatternStringالنمط المطلوب البحث عنه
fromRangeElementنتيجة البحث للبحث من

تذكرة ذهاب وعودة

RangeElement - نتيجة بحث تشير إلى الموضع التالي لنص البحث، أو قيمة فارغة في حال عدم وجود مطابقة

التفويض

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

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

getAttributes()

لاسترداد سمات العنصر\u39s.

النتيجة هي كائن يحتوي على خاصية لكل سمة عنصر صالحة حيث يتوافق كل اسم سمة مع عنصر في تعداد 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

getAttributes(offset)

استرداد السمات عند إزاحة الأحرف المحددة.

النتيجة هي كائن يحتوي على سمة لكل سمة نصية صالحة حيث يتوافق كل اسم خاصية مع عنصر في تعداد DocumentApp.Attribute.

المعلّمات

الاسمالنوعالوصف
offsetIntegerإزاحة الحرف

تذكرة ذهاب وعودة

Object — سمات item's

التفويض

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

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

getBackgroundColor()

استرداد إعداد لون الخلفية.

تذكرة ذهاب وعودة

String: لون الخلفية، بتنسيق تدوين CSS (مثل '#ffffff')، أو قيمة فارغة إذا كان العنصر يحتوي على قيم متعددة لهذه السمة

التفويض

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

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

getBackgroundColor(offset)

استرداد لون الخلفية عند إزاحة الحرف المحددة.

المعلّمات

الاسمالنوعالوصف
offsetIntegerإزاحة الحرف

تذكرة ذهاب وعودة

String - لون الخلفية، بتنسيق تدوين CSS (مثل '#ffffff')

التفويض

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

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

getFontFamily()

لاسترداد إعداد مجموعة الخطوط. يمكن أن يكون الاسم أي خط من قائمة الخطوط في "مستندات Google" أو Google Fonts وهو حسّاس لحالة الأحرف. تستخدم الطُرق getFontFamily() وsetFontFamily(fontFamilyName) الآن أسماء السلاسل للخطوط بدلاً من تعداد FontFamily. على الرغم من إيقاف العمل بهذا التعداد، سيظل متاحًا للتوافق مع النصوص البرمجية القديمة.

تذكرة ذهاب وعودة

String: مجموعة الخطوط أو القيمة الفارغة إذا كان العنصر يحتوي على قيم متعدّدة لهذه السمة

التفويض

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

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

getFontFamily(offset)

استرداد مجموعة الخطوط عند إزاحة الحرف المحددة. يمكن أن يكون الاسم أي خط من قائمة الخطوط في "مستندات Google" أو خطوط Google، ويجب أن يكون حساسًا لحالة الأحرف. تستخدم الطُرق getFontFamily() وsetFontFamily(fontFamilyName) الآن أسماء السلاسل للخطوط بدلاً من تعداد FontFamily. على الرغم من إيقاف العمل بهذا التعداد، سيظل متاحًا للتوافق مع النصوص البرمجية القديمة.

المعلّمات

الاسمالنوعالوصف
offsetIntegerإزاحة الحرف

تذكرة ذهاب وعودة

String: مجموعة الخطوط

التفويض

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

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

getFontSize()

لاسترداد إعداد حجم الخط.

تذكرة ذهاب وعودة

Number - حجم الخط أو قيمة فارغة إذا كان العنصر يحتوي على قيم متعدّدة لهذه السمة

التفويض

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

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

getFontSize(offset)

استرداد حجم الخط عند إزاحة الحرف المحددة.

المعلّمات

الاسمالنوعالوصف
offsetIntegerإزاحة الحرف

تذكرة ذهاب وعودة

Number - حجم الخط

التفويض

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

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

getForegroundColor()

استرداد إعداد لون الواجهة

تذكرة ذهاب وعودة

String: لون الواجهة، بتنسيق بتنسيق CSS (مثل '#ffffff')، أو قيمة فارغة إذا كان العنصر يحتوي على قيم متعددة لهذه السمة

التفويض

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

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

getForegroundColor(offset)

استرداد لون الواجهة عند إزاحة الحرف المحددة.

المعلّمات

الاسمالنوعالوصف
offsetIntegerإزاحة الحرف

تذكرة ذهاب وعودة

String - لون الواجهة، بتنسيق بتنسيق CSS (مثل '#ffffff')

التفويض

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

  • 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

getLinkUrl(offset)

لاسترداد عنوان URL للرابط عند إزاحة الحرف المحددة.

المعلّمات

الاسمالنوعالوصف
offsetIntegerإزاحة الحرف

تذكرة ذهاب وعودة

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

getParent()

لاسترداد العنصر الرئيسي للعنصر.

يحتوي العنصر الرئيسي على العنصر الحالي.

تذكرة ذهاب وعودة

ContainerElement — العنصر الرئيسي

التفويض

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

  • 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

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

getTextAlignment(offset)

محاذاة النص إلى حرف واحد. أنواع التوافق المتاحة هي DocumentApp.TextAlignment.NORMAL وDocumentApp.TextAlignment.SUBSCRIPT وDocumentApp.TextAlignment.SUPERSCRIPT.

المعلّمات

الاسمالنوعالوصف
offsetIntegerإزاحة الحرف

تذكرة ذهاب وعودة

TextAlignment: نوع محاذاة النص، أو null إذا لم يتم ضبط محاذاة النص مطلقًا

التفويض

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

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

getTextAttributeIndices()

لاسترداد مجموعة فهارس النصوص التي تتوافق مع بداية تشغيل تنسيق النص المميز.

تذكرة ذهاب وعودة

Integer[]: مجموعة فهارس النصوص التي يتغيّر تنسيق النص فيها

التفويض

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

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

getType()

لاسترداد العنصر ElementType's.

استخدِم 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

insertText(offset, text)

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

المعلّمات

الاسمالنوعالوصف
offsetIntegerإزاحة الأحرف التي يمكن إدراجها
textStringالنص المطلوب إدراجه

تذكرة ذهاب وعودة

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

isBold()

استرداد الإعداد الغامق.

تذكرة ذهاب وعودة

Boolean: سواء كان النص غامقًا أو فارغًا إذا كان العنصر يحتوي على قيم متعددة لهذه السمة

التفويض

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

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

isBold(offset)

استرداد الإعداد الغامق عند إزاحة الحرف المحددة.

المعلّمات

الاسمالنوعالوصف
offsetIntegerإزاحة الحرف

تذكرة ذهاب وعودة

Boolean — الإعداد الغامق

التفويض

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

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

isItalic()

استرداد الإعداد المائل.

تذكرة ذهاب وعودة

Boolean: سواء كان النص مائلاً أو فارغًا إذا كان العنصر يحتوي على قيم متعددة لهذه السمة

التفويض

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

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

isItalic(offset)

استرداد الإعداد المائل عند إزاحة الحرف المحددة.

المعلّمات

الاسمالنوعالوصف
offsetIntegerإزاحة الحرف

تذكرة ذهاب وعودة

Boolean — الإعداد المائل

التفويض

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

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

isStrikethrough()

استرداد إعداد يتوسطه خط

تذكرة ذهاب وعودة

Boolean: سواء كان النص يتوسطه خط أو يكون فارغًا إذا كان العنصر يحتوي على قيم متعددة لهذه السمة

التفويض

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

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

isStrikethrough(offset)

استرداد إعداد يتوسطه خط عند إزاحة الحرف المحددة.

المعلّمات

الاسمالنوعالوصف
offsetIntegerإزاحة الحرف

تذكرة ذهاب وعودة

Boolean — إعداد يتوسطه خط

التفويض

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

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

isUnderline()

لاسترداد إعداد التسطير.

تذكرة ذهاب وعودة

Boolean: سواء كان النص تحته خط أو فارغًا إذا كان العنصر يحتوي على قيم متعددة لهذه السمة

التفويض

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

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

isUnderline(offset)

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

المعلّمات

الاسمالنوعالوصف
offsetIntegerإزاحة الحرف

تذكرة ذهاب وعودة

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

تذكرة ذهاب وعودة

Text — العنصر المُدمج

التفويض

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

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

تذكرة ذهاب وعودة

Text - العنصر الذي تمت إزالته

التفويض

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

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

replaceText(searchPattern, replacement)

استبدال جميع تكرارات نمط نص معين بسلسلة استبدال محددة، باستخدام التعبيرات العادية.

يتم تمرير نمط البحث كسلسلة، وليس كائن تعبير عادي في JavaScript. ونتيجةً لذلك، ستحتاج إلى تخطي أي شرطة مائلة للخلف في النمط.

تستخدم هذه الطرق مكتبة التعبيرات العادية RE2 الخاصة بـ Google\u39; ، ما يحدّ من البنية المتوافقة.

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

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

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

المعلّمات

الاسمالنوعالوصف
searchPatternStringنمط التعبير العادي للبحث عن
replacementStringالنص المطلوب استخدامه كبديل

تذكرة ذهاب وعودة

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

التفويض

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

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

setAttributes(startOffset, endOffsetInclusive, attributes)

يتم تطبيق السمات المحدّدة على نطاق الأحرف المحدّد.

يجب أن تكون معلّمة السمات المحدّدة عنصرًا يكون فيه كل اسم موقع عنصرًا في تعداد DocumentApp.Attribute وتكون كل قيمة سمة هي القيمة الجديدة التي سيتم تطبيقها.

المعلّمات

الاسمالنوعالوصف
startOffsetIntegerإزاحة نطاق النص
endOffsetInclusiveIntegerإزاحة نهاية النص
attributesObjectسمات العنصر\39

تذكرة ذهاب وعودة

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

التفويض

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

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

setAttributes(attributes)

تحدد سمات العنصر\u39;s.

يجب أن تكون معلّمة السمات المحدّدة عنصرًا يكون فيه كل اسم موقع عنصرًا في تعداد 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);

المعلّمات

الاسمالنوعالوصف
attributesObjectسمات العنصر\39;s.

تذكرة ذهاب وعودة

Text — العنصر الحالي.

التفويض

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

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

setBackgroundColor(startOffset, endOffsetInclusive, color)

لضبط لون الخلفية لنطاق الأحرف المحدد.

المعلّمات

الاسمالنوعالوصف
startOffsetIntegerإزاحة نطاق النص
endOffsetInclusiveIntegerإزاحة نهاية النص
colorStringلون الخلفية، منسَّق بتدوين CSS (مثل '#ffffff')

تذكرة ذهاب وعودة

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

التفويض

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

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

setBackgroundColor(color)

لضبط لون الخلفية.

المعلّمات

الاسمالنوعالوصف
colorStringلون الخلفية، منسَّق بتدوين CSS (مثل '#ffffff')

تذكرة ذهاب وعودة

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

التفويض

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

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

setBold(bold)

لضبط الإعداد بالخط الغامق.

المعلّمات

الاسمالنوعالوصف
boldBooleanالإعداد الغامق

تذكرة ذهاب وعودة

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

التفويض

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

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

setBold(startOffset, endOffsetInclusive, bold)

لضبط الإعداد بالخط الغامق لنطاق الأحرف المحدّد.

المعلّمات

الاسمالنوعالوصف
startOffsetIntegerإزاحة نطاق النص
endOffsetInclusiveIntegerإزاحة نهاية النص
boldBooleanالإعداد الغامق

تذكرة ذهاب وعودة

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

التفويض

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

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

setFontFamily(startOffset, endOffsetInclusive, fontFamilyName)

لضبط مجموعة الخطوط لنطاق الأحرف المحدّد. يمكن أن يكون الاسم أي خط من قائمة الخطوط في "مستندات Google" أو Google Fonts وهو حسّاس لحالة الأحرف. سيتم عرض أسماء الخطوط التي لم يتم التعرّف عليها كـ التعري. تستخدم الطُرق getFontFamily(offset) وsetFontFamily(fontFamilyName) الآن أسماء السلاسل للخطوط بدلاً من تعداد FontFamily. على الرغم من إيقاف العمل بهذا التعداد، سيظل متاحًا للتوافق مع النصوص البرمجية القديمة.

المعلّمات

الاسمالنوعالوصف
startOffsetIntegerإزاحة نطاق النص
endOffsetInclusiveIntegerإزاحة نهاية النص
fontFamilyNameStringاسم مجموعة الخطوط، من قائمة "الخط" في "مستندات Google" أو Google Fonts

تذكرة ذهاب وعودة

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

التفويض

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

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

setFontFamily(fontFamilyName)

لضبط مجموعة الخطوط. يمكن أن يكون الاسم أي خط من قائمة الخطوط في "مستندات Google" أو Google Fonts وهو حسّاس لحالة الأحرف. سيتم عرض أسماء الخطوط غير المعروفة كـ التعري. تستخدم الطُرق getFontFamily() وsetFontFamily(fontFamilyName) الآن أسماء السلاسل للخطوط بدلاً من تعداد FontFamily. على الرغم من إيقاف العمل بهذا التعداد، سيظل متاحًا للتوافق مع النصوص البرمجية القديمة.

المعلّمات

الاسمالنوعالوصف
fontFamilyNameStringاسم مجموعة الخطوط، من قائمة "الخط" في "مستندات Google" أو Google Fonts

تذكرة ذهاب وعودة

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

التفويض

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

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

setFontSize(startOffset, endOffsetInclusive, size)

لتحديد حجم الخط لنطاق الأحرف المحدد.

المعلّمات

الاسمالنوعالوصف
startOffsetIntegerإزاحة نطاق النص
endOffsetInclusiveIntegerإزاحة نهاية النص
sizeNumberحجم الخط

تذكرة ذهاب وعودة

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

التفويض

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

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

setFontSize(size)

لضبط حجم الخط.

المعلّمات

الاسمالنوعالوصف
sizeNumberحجم الخط

تذكرة ذهاب وعودة

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

التفويض

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

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

setForegroundColor(startOffset, endOffsetInclusive, color)

تعمل هذه السياسة على ضبط لون المقدّمة لنطاق الأحرف المحدّد.

المعلّمات

الاسمالنوعالوصف
startOffsetIntegerإزاحة نطاق النص
endOffsetInclusiveIntegerإزاحة نهاية النص
colorStringلون الواجهة، بتنسيق بتنسيق CSS (مثل '#ffffff')

تذكرة ذهاب وعودة

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

التفويض

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

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

setForegroundColor(color)

ضبط لون الواجهة

المعلّمات

الاسمالنوعالوصف
colorStringلون الواجهة، بتنسيق بتنسيق CSS (مثل '#ffffff')

تذكرة ذهاب وعودة

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

التفويض

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

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

setItalic(italic)

لضبط الإعداد المائل.

المعلّمات

الاسمالنوعالوصف
italicBooleanإعدادات الخط المائل

تذكرة ذهاب وعودة

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

التفويض

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

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

setItalic(startOffset, endOffsetInclusive, italic)

لضبط الإعداد المائل لنطاق الأحرف المحدّد.

المعلّمات

الاسمالنوعالوصف
startOffsetIntegerإزاحة نطاق النص
endOffsetInclusiveIntegerإزاحة نهاية النص
italicBooleanإعدادات الخط المائل

تذكرة ذهاب وعودة

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

التفويض

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

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

setLinkUrl(startOffset, endOffsetInclusive, url)

لضبط عنوان URL للرابط لنطاق الأحرف المحدّد.

المعلّمات

الاسمالنوعالوصف
startOffsetIntegerإزاحة نطاق النص
endOffsetInclusiveIntegerإزاحة نهاية النص
urlStringعنوان URL للرابط

تذكرة ذهاب وعودة

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

التفويض

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

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

setLinkUrl(url)

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

المعلّمات

الاسمالنوعالوصف
urlStringعنوان URL للرابط

تذكرة ذهاب وعودة

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

التفويض

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

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

setStrikethrough(strikethrough)

لضبط إعداد النص الذي يتوسطه خط.

المعلّمات

الاسمالنوعالوصف
strikethroughBooleanالإعداد الذي يتوسطه خط

تذكرة ذهاب وعودة

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

التفويض

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

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

setStrikethrough(startOffset, endOffsetInclusive, strikethrough)

لضبط إعداد النص الذي يتوسطه خط لنطاق الأحرف المحدد.

المعلّمات

الاسمالنوعالوصف
startOffsetIntegerإزاحة نطاق النص
endOffsetInclusiveIntegerإزاحة نهاية النص
strikethroughBooleanالإعداد الذي يتوسطه خط

تذكرة ذهاب وعودة

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

التفويض

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

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

setText(text)

لضبط محتوى النص.

المعلّمات

الاسمالنوعالوصف
textStringالمحتوى النصي الجديد

تذكرة ذهاب وعودة

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

التفويض

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

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

setTextAlignment(startOffset, endOffsetInclusive, textAlignment)

لضبط محاذاة النص لنطاق أحرف معيّن. إنّ أنواع التوافق المتاحة هي DocumentApp.TextAlignment.NORMAL وDocumentApp.TextAlignment.SUBSCRIPT وDocumentApp.TextAlignment.SUPERSCRIPT.

// Make the first character in the first paragraph be superscript.
var text = DocumentApp.getActiveDocument().getBody().getParagraphs()[0].editAsText();
text.setTextAlignment(0, 0, DocumentApp.TextAlignment.SUPERSCRIPT);

المعلّمات

الاسمالنوعالوصف
startOffsetIntegerإزاحة البداية لنطاق الأحرف
endOffsetInclusiveIntegerالإزاحة النهائية لنطاق الأحرف (شاملة)
textAlignmentTextAlignmentنوع محاذاة النص المراد تطبيقه

تذكرة ذهاب وعودة

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

التفويض

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

  • 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);

المعلّمات

الاسمالنوعالوصف
textAlignmentTextAlignmentنوع محاذاة النص المراد تطبيقه

تذكرة ذهاب وعودة

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

التفويض

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

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

setUnderline(underline)

لضبط إعداد التسطير.

المعلّمات

الاسمالنوعالوصف
underlineBooleanإعداد التسطير

تذكرة ذهاب وعودة

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

التفويض

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

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

setUnderline(startOffset, endOffsetInclusive, underline)

لضبط إعداد التسطير لنطاق الأحرف المحدّد.

المعلّمات

الاسمالنوعالوصف
startOffsetIntegerإزاحة نطاق النص
endOffsetInclusiveIntegerإزاحة نهاية النص
underlineBooleanإعداد التسطير

تذكرة ذهاب وعودة

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

التفويض

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

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