تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

الإرجاع

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

يؤدي هذا الإجراء إلى محو النص الذي حدوده هذا النطاق.

نظرًا لأن النص بأكمله في شكل أو في 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 ضمن النطاق الحالي نطاق النص أو يتداخل مع نطاق النص الحالي.

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

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

// Accesses the first link on a TextRange object.
var linkTextRange = textRange.getLinks()[0];
var textStyle = linkTextRange.getTextStyle();
Logger.log(textStyle.hasLink()); // logs 'true'
var 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 فارغة لوضع المؤشر في الفهرس المطلوب.
```
var 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