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 إذا كان النطاق فارغًا.
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()

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

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

الإرجاع

String

التفويض

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

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

asString()

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

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

الإرجاع

String

التفويض

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

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

clear()

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

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

التفويض

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

  • 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

التفويض

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

  • 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

التفويض

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

  • 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