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)

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

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

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

المعلَمات

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

الإرجاع

Paragraph: العنصر Paragraph المُضاف.

التفويض

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

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

---

appendRange(textRange)

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

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

المعلَمات

الاسم	النوع	الوصف
textRange	TextRange	نطاق النص المطلوب إلحاقه

الإرجاع

TextRange: نطاق النص الذي يمثّل النص المُضاف

التفويض

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

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

---

appendRange(textRange, matchSourceFormatting)

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

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

المعلَمات

الاسم	النوع	الوصف
textRange	TextRange	نطاق النص المطلوب إلحاقه.
matchSourceFormatting	Boolean	إذا كان الخيار true، يجب مطابقة تنسيق النص المصدر. وإذا كان الخيار false، يجب مطابقة تنسيق النص الوجهة.

الإرجاع

TextRange: نطاق النص الذي يمثّل النص المُضاف

التفويض

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

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

---

appendText(text)

إلحاق نص في نهاية نطاق النص يحافظ النص على النمط في نهاية النص الحالي.

المعلَمات

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

الإرجاع

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)

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

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

المعلَمات

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

التفويض

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

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

---

find(pattern)

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

المعلَمات

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

الإرجاع

TextRange[]

التفويض

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

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

---

find(pattern, startOffset)

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

المعلَمات

الاسم	النوع	الوصف
pattern	String	نمط التعبير العادي الذي سيتم البحث عنه، ويجب تخطّي أيّ شرطات مائلة للخلف في النمط.
startOffset	Integer	عدد الأحرف التي تتجاوز فهرس بداية نطاق النص الحالي المستخدَم لتحديد فهرس البداية الشامل للنطاق المطلوب البحث فيه يجب أن يكون 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

---

getLinks()

تُرجِع مجموعة من نطاقات النصوص التي تتوافق مع كل 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 جديدة تغطي جزءًا من النطاق الذي تم اشتقاقها منه.

المعلَمات

الاسم	النوع	الوصف
startOffset	Integer	عدد الأحرف التي تتجاوز فهرس بداية نطاق النص الحالي المستخدَم لتحديد فهرس البداية الشامل للنطاق المعروض. يجب أن تكون إزاحة البداية مساوية أو أكبر من 0 وأقل من أو تساوي endOffset. startOffset يجب أن يكون أيضًا أقصر من طول النطاق الحالي.
endOffset	Integer	عدد الأحرف التي تتجاوز فهرس بداية نطاق النص الحالي المستخدَم لتحديد فهرس النهاية الحصري للنطاق المعروض يجب أن تكون قيمة 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)

تُدرج فقرة في موضع البداية المُعدَّل. تحافظ الفقرة على تنسيق نطاق النص الحالي عند إزاحة البداية.

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

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

المعلَمات

الاسم	النوع	الوصف
startOffset	Integer	عدد الأحرف التي تتجاوز فهرس بداية نطاق النص الحالي المستخدَم لتحديد فهرس البداية الشامل للنص الذي سيتم إدراجه.
text	String	السلسلة المطلوب إدراجها.

الإرجاع

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

التفويض

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

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

---

insertRange(startOffset, textRange)

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

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

المعلَمات

الاسم	النوع	الوصف
startOffset	Integer	عدد الأحرف التي تتجاوز فهرس بداية نطاق النص الحالي المستخدَم لتحديد فهرس البداية الشامل للنص الذي سيتم إدراجه.
textRange	TextRange	نطاق النص المطلوب إدراجه.

الإرجاع

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

التفويض

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

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

---

insertRange(startOffset, textRange, matchSourceFormatting)

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

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

المعلَمات

الاسم	النوع	الوصف
startOffset	Integer	عدد الأحرف التي تتجاوز فهرس بداية نطاق النص الحالي المستخدَم لتحديد فهرس البداية الشامل للنص الذي سيتم إدراجه.
textRange	TextRange	نطاق النص المطلوب إدراجه.
matchSourceFormatting	Boolean	إذا كان الخيار true، يجب مطابقة تنسيق النص المصدر. وإذا كان الخيار false، يجب مطابقة تنسيق النص الوجهة.

الإرجاع

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

التفويض

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

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

---

insertText(startOffset, text)

تُدرج النص في بداية الإزاحة. يحافظ النص على تنسيق النص الحالي عند موضع البداية.

المعلَمات

الاسم	النوع	الوصف
startOffset	Integer	عدد الأحرف التي تتجاوز فهرس بداية نطاق النص الحالي المستخدَم لتحديد فهرس البداية الشامل للنص الذي سيتم إدراجه.
text	String	السلسلة المطلوب إدراجها.

الإرجاع

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)

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

المعلَمات

الاسم	النوع	الوصف
findText	String	النص المطلوب البحث عنه.
replaceText	String	النص الذي سيتم استبدال النص المطابق به.

الإرجاع

Integer - تم تغيير عدد مرات التكرار

التفويض

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

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

---

replaceAllText(findText, replaceText, matchCase)

استبدال جميع تكرارات النص الذي يتطابق مع النص المراد البحث عنه بالنص البديل

المعلَمات

الاسم	النوع	الوصف
findText	String	النص المطلوب البحث عنه.
replaceText	String	النص الذي سيتم استبدال النص المطابق به.
matchCase	Boolean	إذا كان الخيار 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)

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

المعلَمات

الاسم	النوع	الوصف
newText	String	السلسلة التي سيتم ضبطها على أنّها النص الجديد.

الإرجاع

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

التفويض

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

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