Class TextRange

النصالنطاق

جزء من محتوى النص في Shape أو TableCell

إذا كنت تستخدم طرقًا لتعديل طريقة احتواء النص داخل شكل، سيتم إيقاف أي إعدادات احتواء تلقائي تم تطبيقها على الشكل.

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
appendParagraph(text)Paragraphتضيف هذه الطريقة فقرة في نهاية النطاق النصي.
appendRange(textRange)TextRangeتُلحق نسخة من نطاق النص المقدَّم بنهاية نطاق النص الحالي.
appendRange(textRange, matchSourceFormatting)TextRangeتُلحق نسخة من نطاق النص المقدَّم بنهاية نطاق النص الحالي.
appendText(text)TextRangeتضيف هذه السمة نصًا في نهاية النطاق النصي.
asRenderedString()Stringتعرض هذه السمة النص المعروض ضمن هذا النطاق من الشكل المرتبط أو خلية الجدول بتنسيق مناسب لعرضه للمستخدمين النهائيين.
asString()Stringتعرض هذه الدالة النص الأولي المحصور بهذا النطاق من الشكل المرتبط أو خلية الجدول.
clear()voidيمحو النص الذي يحده هذا النطاق.
clear(startOffset, endOffset)voidيمحو النص المحصور بإزاحات البداية والنهاية في النطاق.
find(pattern)TextRange[]تعرض هذه الدالة جميع النطاقات المطابقة لنمط البحث في نطاق النص الحالي.
find(pattern, startOffset)TextRange[]تعرض هذه الطريقة جميع النطاقات التي تتطابق مع نمط البحث في نطاق النص الحالي بدءًا من إزاحة البداية.
getAutoTexts()AutoText[]تعرض هذه السمة النصوص التلقائية ضمن نطاق النص الحالي.
getEndIndex()Integerتعرض هذه السمة الفهرس الحصري الذي يبدأ من 0 للحرف الأخير في هذا النطاق.
getLength()Integerتعرض هذه السمة عدد الأحرف في هذا النطاق.
getLinks()TextRange[]تعرض هذه السمة مجموعة من نطاقات النص التي تتوافق مع جميع عناصر Link ضمن نطاق النص الحالي أو تتداخل معه.
getListParagraphs()Paragraph[]تعرض هذه السمة الفقرات في القوائم التي تتداخل مع نطاق النص الحالي.
getListStyle()ListStyleتعرض هذه الدالة ListStyle لنطاق النص الحالي.
getParagraphStyle()ParagraphStyleتعرض هذه الدالة ParagraphStyle لنطاق النص الحالي.
getParagraphs()Paragraph[]تعرض هذه السمة الفقرات التي تتداخل مع النطاق النصي الحالي.
getRange(startOffset, endOffset)TextRangeتعرِض هذه الدالة TextRange جديدًا يغطّي جزءًا من النطاق الذي تم استخراجه منه.
getRuns()TextRange[]تعرض هذه الطريقة أجزاء النص التي تتداخل مع نطاق النص الحالي.
getStartIndex()Integerتعرض هذه السمة الفهرس الشامل المستند إلى 0 للحرف الأول في هذا النطاق.
getTextStyle()TextStyle|nullتعرض هذه السمة نمط النص للنطاق، أو null إذا كان النطاق فارغًا.
insertParagraph(startOffset, text)Paragraphتُدرج هذه الطريقة فقرة في موضع الإزاحة عند البدء.
insertRange(startOffset, textRange)TextRangeتُدرج هذه الطريقة نسخة من نطاق النص المقدَّم في إزاحة البداية.
insertRange(startOffset, textRange, matchSourceFormatting)TextRangeتُدرج هذه الطريقة نسخة من نطاق النص المقدَّم في إزاحة البداية.
insertText(startOffset, text)TextRangeيُدرج النص عند الإزاحة في البداية.
isEmpty()Booleanتعرِض true إذا لم تكن هناك أحرف في هذا النطاق، وتعرض false في ما عدا ذلك.
replaceAllText(findText, replaceText)Integerيستبدل جميع مثيلات النص المطابق للنص المطلوب البحث عنه بالنص البديل.
replaceAllText(findText, replaceText, matchCase)Integerيستبدل جميع مثيلات النص المطابق للنص المطلوب البحث عنه بالنص البديل.
select()voidيحدّد هذا الخيار TextRange في العرض التقديمي النشط فقط ويزيل أي تحديد سابق.
setText(newText)TextRangeتضبط هذه السمة النص المحصور بهذا النطاق من الشكل المرتبط أو خلية الجدول.

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

appendParagraph(text)

تضيف هذه الطريقة فقرة في نهاية النطاق النصي. تحتفظ الفقرة بتنسيق نهاية النطاق النصي الحالي.

يتم إلحاق السلسلة النصية المقدَّمة كفقرة من خلال إضافة حرف سطر جديد واحد على الأقل إلى السلسلة.

عندما تحتوي سلسلة النص المقدَّمة على أحرف سطر جديد (وبالتالي تتألف من فقرات متعددة)، يتم عرض الفقرة الأخيرة التي تمت إضافتها.

المعلمات

الاسمالنوعالوصف
textStringالسلسلة المطلوب إلحاقها كفقرة

الإرجاع

Paragraph: Paragraph الملحق

التفويض

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

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

appendRange(textRange)

تُلحق نسخة من نطاق النص المقدَّم بنهاية نطاق النص الحالي.

يتطابق تنسيق النص المُدرَج مع تنسيق النص المصدر.

المعلمات

الاسمالنوعالوصف
textRangeTextRangeنطاق النص المطلوب إلحاقه.

الإرجاع

‫TextRange: نطاق النص الذي يمثّل النص الملحق.

التفويض

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

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

appendRange(textRange, matchSourceFormatting)

تُلحق نسخة من نطاق النص المقدَّم بنهاية نطاق النص الحالي.

إذا تم ضبطها لتتطابق مع تنسيق النص الوجهة، سيتم استبدال AutoText ضمن نطاق النص المقدَّم بقيمه المعروضة. بالإضافة إلى ذلك، لا تتم إضافة أي عناصر غير نصية ضمن نطاق النص المقدَّم.

المعلمات

الاسمالنوعالوصف
textRangeTextRangeنطاق النص المطلوب إلحاقه.
matchSourceFormattingBooleanإذا كانت القيمة true، يجب مطابقة تنسيق النص المصدر، وإذا كانت القيمة false، يجب مطابقة تنسيق النص الوجهة.

الإرجاع

‫TextRange: نطاق النص الذي يمثّل النص الملحق.

التفويض

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

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

appendText(text)

تضيف هذه السمة نصًا في نهاية النطاق النصي. يحتفظ النص بنمط نهاية النص الحالي.

المعلمات

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

الإرجاع

‫TextRange: نطاق النص الذي يمثّل النص الملحق.

التفويض

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

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

asRenderedString()

تعرض هذه السمة النص المعروض ضمن هذا النطاق من الشكل المرتبط أو خلية الجدول بتنسيق مناسب لعرضه للمستخدمين النهائيين.

يتم استبدال عناصر النص التلقائي، مثل أرقام الشرائح التي تم إنشاؤها، بقيمها المعروضة. يتم حذف أي عناصر غير نصية في النطاق.

الإرجاع

String: النص المعروض في النطاق.

التفويض

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

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

asString()

تعرض هذه الدالة النص الأولي المحصور بهذا النطاق من الشكل المرتبط أو خلية الجدول.

يتم استبدال عناصر النص التلقائي، مثل أرقام الشرائح التي تم إنشاؤها وأي عناصر غير نصية في النطاق، بالحرف U+E907 من Unicode.

الإرجاع

‫String: النص الأولي في النطاق.

التفويض

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

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

clear()

يمحو النص الذي يحده هذا النطاق.

بما أنّ النص الكامل في Shape أو TableCell يجب أن ينتهي بسطر جديد، لا تتم إزالة السطر الجديد الأخير في النص.

التفويض

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

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

clear(startOffset, endOffset)

يمحو النص المحصور بإزاحات البداية والنهاية في النطاق.

بما أنّ النص يجب أن ينتهي بسطر جديد، لن تتم إزالة السطر الجديد الأخير في النص حتى إذا كانت الإزاحات المحدّدة تغطّيه.

المعلمات

الاسمالنوعالوصف
startOffsetIntegerعدد الأحرف التي تتجاوز فهرس البداية لنطاق النص الحالي المستخدَم لتحديد فهرس البداية الشامل للنطاق المطلوب محوه يجب أن تكون إزاحة البداية أكبر من أو تساوي 0 وأقل من أو تساوي endOffset. يجب أن يكون startOffset أصغر أيضًا من طول النطاق الحالي.
endOffsetIntegerعدد الأحرف التي تتجاوز فهرس البداية لنطاق النص الحالي المستخدَم لتحديد فهرس النهاية الحصري للنطاق المطلوب محوه. يجب أن تكون قيمة endOffset أكبر من أو تساوي startOffset. يجب أن تكون قيمة endOffset أقل من أو تساوي طول النطاق الحالي.

التفويض

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

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

find(pattern)

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

المعلمات

الاسمالنوعالوصف
patternStringنمط التعبير العادي المطلوب البحث عنه، ويجب تخطّي أي شرطات مائلة عكسية في النمط.

الإرجاع

‫TextRange[]: قائمة بنطاقات النصوص

التفويض

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

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

find(pattern, startOffset)

تعرض هذه الطريقة جميع النطاقات التي تتطابق مع نمط البحث في نطاق النص الحالي بدءًا من إزاحة البداية. عملية البحث حسّاسة لحالة الأحرف.

المعلمات

الاسمالنوعالوصف
patternStringنمط التعبير العادي المطلوب البحث عنه، ويجب تخطّي أي شرطات مائلة عكسية في النمط.
startOffsetIntegerعدد الأحرف التي تتجاوز فهرس البداية لنطاق النص الحالي المستخدَم لتحديد فهرس البداية الشامل للنطاق المطلوب البحث فيه. يجب أن تكون قيمة startOffset أقل من طول النطاق الحالي.

الإرجاع

‫TextRange[]: قائمة بنطاقات النصوص

التفويض

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

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

getAutoTexts()

تعرض هذه السمة النصوص التلقائية ضمن نطاق النص الحالي.

الإرجاع

AutoText[]: قائمة بالنصوص التلقائية

التفويض

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

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

getEndIndex()

تعرض هذه السمة الفهرس الحصري الذي يبدأ من 0 للحرف الأخير في هذا النطاق. إذا كانت فهارس البداية والنهاية متساوية، يُعتبر النطاق فارغًا.

الإرجاع

Integer: فهرس نهاية النطاق.

التفويض

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

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

getLength()

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

الإرجاع

Integer: عدد الأحرف في هذا النطاق

التفويض

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

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

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

يُضمَن أنّ كل نطاق يتم عرضه يتضمّن رابطًا واحدًا عند إنشائه. قد تؤدي تعديلات النص إلى عدم تمثيله لرابط واحد بالضبط.

يمكن الوصول إلى كل Link في النطاقات التي تم إرجاعها من خلال TextStyle.getLink(). 

// Accesses the first link on a TextRange object.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
const linkTextRange = textRange.getLinks()[0];
const textStyle = linkTextRange.getTextStyle();
Logger.log(textStyle.hasLink());   // logs 'true'
const link = textStyle.getLink();  // Link object

الإرجاع

‫TextRange[]: قائمة بنطاقات النصوص

التفويض

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

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

getListParagraphs()

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

الإرجاع

‫Paragraph[]: قائمة الفقرات في القوائم

التفويض

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

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

getListStyle()

تعرض هذه الدالة ListStyle لنطاق النص الحالي.

الإرجاع

ListStyle: نمط القائمة لنطاق النص الحالي

التفويض

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

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

getParagraphStyle()

تعرض هذه الدالة ParagraphStyle لنطاق النص الحالي.

الإرجاع

‫ParagraphStyle: نمط الفقرة لنطاق النص الحالي

التفويض

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

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

getParagraphs()

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

الإرجاع

Paragraph[]: قائمة بالفقرات

التفويض

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

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

getRange(startOffset, endOffset)

تعرِض هذه الدالة TextRange جديدًا يغطّي جزءًا من النطاق الذي تم استخراجه منه.

المعلمات

الاسمالنوعالوصف
startOffsetIntegerعدد الأحرف التي تتجاوز فهرس البداية لنطاق النص الحالي المستخدَم لتحديد فهرس البداية الشامل للنطاق المعروض. يجب أن تكون إزاحة البداية أكبر من أو تساوي 0 وأقل من أو تساوي endOffset. يجب أن يكون startOffset أصغر أيضًا من طول النطاق الحالي.
endOffsetIntegerعدد الأحرف التي تتجاوز فهرس البداية لنطاق النص الحالي المستخدَم لتحديد فهرس النهاية الحصري للنطاق المعروض يجب أن تكون قيمة endOffset أكبر من أو تساوي startOffset. يجب أن تكون قيمة endOffset أقل من أو تساوي طول النطاق الحالي.

الإرجاع

‫TextRange: نطاق نصي جديد.

التفويض

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

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

getRuns()

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

لا يمكن ضمان أن يمتد كل نطاق معروض إلى أكثر من عملية تشغيل واحدة عند إنشائه. قد تؤدي التعديلات على النص أو النمط إلى عدم تمثيل عملية تشغيل واحدة بالضبط.

الإرجاع

‫TextRange[]: قائمة بنطاقات النصوص

التفويض

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

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

getStartIndex()

تعرض هذه السمة الفهرس الشامل المستند إلى 0 للحرف الأول في هذا النطاق. إذا كان مؤشرا البداية والنهاية متساويين، يُعتبر النطاق فارغًا.

الإرجاع

Integer: فهرس بداية النطاق

التفويض

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

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

getTextStyle()

تعرض هذه السمة نمط النص للنطاق، أو null إذا كان النطاق فارغًا.

الإرجاع

TextStyle|null: نمط النص في النطاق.

التفويض

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

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

insertParagraph(startOffset, text)

تُدرج هذه الطريقة فقرة في موضع الإزاحة عند البدء. تحتفظ الفقرة بنمط نطاق النص الحالي عند إزاحة البداية.

يتم إدراج سلسلة النص المقدَّمة كفقرة من خلال إضافة حرف سطر جديد واحد على الأقل إلى السلسلة.

عندما تحتوي سلسلة النص المقدَّمة على أحرف سطر جديد (وبالتالي تتألف من فقرات متعددة)، يتم عرض الفقرة الأخيرة التي تمت إضافتها.

المعلمات

الاسمالنوعالوصف
startOffsetIntegerعدد الأحرف التي تتجاوز فهرس البداية لنطاق النص الحالي المستخدَم لتحديد فهرس البداية الشامل للنص المطلوب إدراجه
textStringالسلسلة المطلوب إدراجها

الإرجاع

Paragraph: Paragraph الذي تم إدراجه

التفويض

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

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

insertRange(startOffset, textRange)

تُدرج هذه الطريقة نسخة من نطاق النص المقدَّم في إزاحة البداية.

يتطابق تنسيق النص المُدرَج مع تنسيق النص المصدر.

المعلمات

الاسمالنوعالوصف
startOffsetIntegerعدد الأحرف التي تتجاوز فهرس البداية لنطاق النص الحالي المستخدَم لتحديد فهرس البداية الشامل للنص المطلوب إدراجه
textRangeTextRangeنطاق النص المطلوب إدراجه.

الإرجاع

‫TextRange: نطاق النص الذي يمثّل النص المُدرَج

التفويض

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

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

insertRange(startOffset, textRange, matchSourceFormatting)

تُدرج هذه الطريقة نسخة من نطاق النص المقدَّم في إزاحة البداية.

إذا تم ضبطها لتتطابق مع تنسيق النص الوجهة، سيتم استبدال AutoText ضمن نطاق النص المقدَّم بقيمه المعروضة. بالإضافة إلى ذلك، لا يتم إدراج أي عناصر غير نصية ضمن نطاق النص المقدَّم.

المعلمات

الاسمالنوعالوصف
startOffsetIntegerعدد الأحرف التي تتجاوز فهرس البداية لنطاق النص الحالي المستخدَم لتحديد فهرس البداية الشامل للنص المطلوب إدراجه
textRangeTextRangeنطاق النص المطلوب إدراجه.
matchSourceFormattingBooleanإذا كانت القيمة true، يجب مطابقة تنسيق النص المصدر، وإذا كانت القيمة false، يجب مطابقة تنسيق النص الوجهة.

الإرجاع

‫TextRange: نطاق النص الذي يمثّل النص المُدرَج

التفويض

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

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

insertText(startOffset, text)

يُدرج النص عند الإزاحة في البداية. يحتفظ النص بنمط النص الحالي عند الإزاحة في البداية.

المعلمات

الاسمالنوعالوصف
startOffsetIntegerعدد الأحرف التي تتجاوز فهرس البداية لنطاق النص الحالي المستخدَم لتحديد فهرس البداية الشامل للنص المطلوب إدراجه
textStringالسلسلة المطلوب إدراجها

الإرجاع

‫TextRange: نطاق النص الذي يمثّل النص المُدرَج

التفويض

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

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

isEmpty()

تعرِض true إذا لم تكن هناك أحرف في هذا النطاق، وتعرض false في ما عدا ذلك.

الإرجاع

‫Boolean: تعرض true إذا لم تكن هناك أي أحرف في هذا النطاق، وتعرض false في الحالات الأخرى.

التفويض

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

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

replaceAllText(findText, replaceText)

يستبدل جميع مثيلات النص المطابق للنص المطلوب البحث عنه بالنص البديل. عملية البحث غير حسّاسة لحالة الأحرف.

المعلمات

الاسمالنوعالوصف
findTextStringالنص المطلوب البحث عنه.
replaceTextStringالنص الذي سيتم استخدامه بدلاً من النص المطابِق

الإرجاع

Integer — عدد مرات التكرار التي تم تغييرها

التفويض

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

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

replaceAllText(findText, replaceText, matchCase)

يستبدل جميع مثيلات النص المطابق للنص المطلوب البحث عنه بالنص البديل.

المعلمات

الاسمالنوعالوصف
findTextStringالنص المطلوب البحث عنه.
replaceTextStringالنص الذي سيتم استخدامه بدلاً من النص المطابِق
matchCaseBooleanإذا كانت القيمة true، تكون عملية البحث حساسة لحالة الأحرف، وإذا كانت القيمة false، تكون عملية البحث غير حساسة لحالة الأحرف.

الإرجاع

Integer — عدد مرات التكرار التي تم تغييرها

التفويض

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

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

select()

يحدّد هذا الخيار TextRange في العرض التقديمي النشط فقط ويزيل أي تحديد سابق.

لا يمكن للنص البرمجي الوصول إلى تحديد المستخدم الذي يشغّل النص البرمجي إلا إذا كان النص البرمجي مرتبطًا بالعرض التقديمي.

يتم ضبط Page العنصر الأصل Shape أو TableCell المقابلَين على أنّهما current page selection. يتم ضبط Shape أو TableCell كـ selected page element.

    يمكن أن يكون Selection من نوعَين:
    • 1- نطاق النص، استخدِم "اختيار" في TextRange غير فارغ لاختيار نطاق الأحرف.
    • 2. موضع المؤشر، استخدِم TextRange فارغًا لوضع المؤشر في الفهرس المطلوب. 
      const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
shape.getText().setText('Hello');
// Range selection: Select the text range "He".
shape.getText().getRange(0, 2).select();
// Cursor selection: Place the cursor after "H" like "H|ello".
shape.getText().getRange(1, 1).select();

      التفويض

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

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

    setText(newText)

    تضبط هذه السمة النص المحصور بهذا النطاق من الشكل المرتبط أو خلية الجدول. يحتفظ النص بتنسيق بداية النص الحالي.

    المعلمات

    الاسمالنوعالوصف
    newTextStringالسلسلة المطلوب ضبطها كنص جديد

    الإرجاع

    ‫TextRange: نطاق النص الذي يمثّل النص المضبوط.

    التفويض

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

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