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)

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

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

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

المَعلمات

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

استرجاع الكرة

Paragraph — الملحق Paragraph.

التفويض

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

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

appendRange(textRange)

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

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

المَعلمات

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

استرجاع الكرة

TextRange — نطاق النص الذي يمثل النص الملحق

التفويض

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

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

appendRange(textRange, matchSourceFormatting)

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

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

المَعلمات

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

استرجاع الكرة

TextRange — نطاق النص الذي يمثل النص الملحق

التفويض

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

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

appendText(text)

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

المَعلمات

الاسمTypeالوصف
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()

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

ويتم استبدال عناصر النص التلقائي مثل أرقام الشرائح التي تم إنشاؤها وأي عناصر غير نصية في النطاق بحرف 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)

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

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

المَعلمات

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

التفويض

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

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

find(pattern)

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

المَعلمات

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

استرجاع الكرة

TextRange[]

التفويض

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

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

find(pattern, startOffset)

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

المَعلمات

الاسمTypeالوصف
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.
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 جديد يغطي جزءًا من النطاق الذي يتم اشتقاقه منه.

المَعلمات

الاسمTypeالوصف
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)

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

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

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

المَعلمات

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

استرجاع الكرة

Paragraph — تم إدراج Paragraph.

التفويض

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

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

insertRange(startOffset, textRange)

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

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

insertRange(startOffset, textRange, matchSourceFormatting)

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

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

insertText(startOffset, text)

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

المَعلمات

الاسمTypeالوصف
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)

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

المَعلمات

الاسمTypeالوصف
findTextStringالنص المطلوب البحث عنه
replaceTextStringالنص المطلوب استبدال النص المطابق له.

استرجاع الكرة

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

التفويض

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

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

replaceAllText(findText, replaceText, matchCase)

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

المَعلمات

الاسمTypeالوصف
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 فارغًا لوضع المؤشر في الفهرس المطلوب.
      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)

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

    المَعلمات

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

    استرجاع الكرة

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

    التفويض

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

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