Class TextRange

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

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

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

الإرجاع

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)

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

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

المعلمات

الاسم	النوع	الوصف
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: تعرض true إذا لم تكن هناك أي أحرف في هذا النطاق، وتعرض false في ما عدا ذلك.

التفويض

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

• 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 العنصر الأصل Page الخاص بـ Shape أو TableCell المقابلَين كـ current page selection. يتم ضبط Shape أو TableCell كـ selected page element.

يمكن أن يكون Selection من نوعَين:

• 1. نطاق النص، استخدِم select على 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