جزء من المحتوى النصي لـ 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 | الوصف |
---|---|---|
text | String | السلسلة المطلوب إلحاقها كفقرة. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendRange(textRange)
لإلحاق نسخة من نطاق النص المقدَّم بنهاية نطاق النص الحالي
سيتطابق تنسيق النص المدرج مع تنسيق النص المصدر.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
textRange | TextRange | نطاق النص المطلوب إلحاقه |
استرجاع الكرة
TextRange
— نطاق النص الذي يمثل النص الملحق
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendRange(textRange, matchSourceFormatting)
لإلحاق نسخة من نطاق النص المقدَّم بنهاية نطاق النص الحالي
في حال ضبطها لمطابقة تنسيق النص الوجهة، يتم استبدال AutoText
ضمن نطاق النص المقدّم بالقيم المعروضة. علاوة على ذلك، لا يتم إلحاق أي عناصر غير نصية
داخل نطاق النص المقدم.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
textRange | TextRange | نطاق النص المطلوب إلحاقه |
matchSourceFormatting | Boolean | إذا كانت السمة true ، يجب مطابقة تنسيق النص المصدر، وإذا كانت السمة false ، يجب مطابقة تنسيق النص الوجهة. |
استرجاع الكرة
TextRange
— نطاق النص الذي يمثل النص الملحق
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
appendText(text)
لإلحاق النص بنهاية نطاق النص. يحافظ النص على نمط نهاية النص الحالي.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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)
لمحو النص المُحاط بإزاحة البداية والنهاية في النطاق.
نظرًا لأن النص يجب أن ينتهي بسطر جديد، لا تتم إزالة السطر الجديد الأخير في النص حتى لو كان مغطى بإزاحة محددة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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)
عرض جميع النطاقات المطابقة لنمط البحث في نطاق النص الحالي. البحث حساس لحالة الأحرف.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
pattern | String | نمط التعبير العادي للبحث، ويجب تخطي أي شرطات مائلة للخلف في النمط. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
find(pattern, startOffset)
لعرض جميع النطاقات المطابقة لنمط البحث في نطاق النص الحالي بدءًا من إزاحة البداية. البحث حسّاس لحالة الأحرف.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
pattern | String | نمط التعبير العادي للبحث، ويجب تخطي أي شرطات مائلة للخلف في النمط. |
startOffset | Integer | عدد الأحرف التي تتجاوز فهرس البدء لنطاق النص الحالي المستخدَم لتحديد فهرس البدء الشامل للنطاق المطلوب البحث فيه. ويجب أن يكون startOffset أيضًا أقل من طول النطاق الحالي. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getAutoTexts()
لعرض النصوص التلقائية ضمن نطاق النص الحالي.
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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. var linkTextRange = textRange.getLinks()[0]; var textStyle = linkTextRange.getTextStyle(); Logger.log(textStyle.hasLink()); // logs 'true' var link = textStyle.getLink(); // Link object
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getListParagraphs()
عرض الفقرات التي تتداخل مع النطاق النصي الحالي في القوائم.
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getListStyle()
getParagraphStyle()
تعرض ParagraphStyle
للنطاق النصي الحالي.
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getParagraphs()
لعرض الفقرات التي تتداخل مع نطاق النص الحالي.
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRange(startOffset, endOffset)
لعرض TextRange
جديد يغطي جزءًا من النطاق الذي يتم اشتقاقه منه.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
startOffset | Integer | عدد الأحرف التي تتجاوز فهرس البدء لنطاق النص الحالي المستخدَم لتحديد فهرس البدء الشامل للنطاق المعروض. يجب أن تكون إزاحة البداية مساوية لـ 0 أو أكبر منها وأقل من أو تساوي endOffset . يجب أن يكون startOffset أيضًا أقل من طول النطاق الحالي. |
endOffset | Integer | عدد الأحرف التي تتجاوز فهرس البداية لنطاق النص الحالي المستخدَم لتحديد فهرس النهاية الحصري للنطاق المعروض. ويجب أن تكون قيمة endOffset مساوية لـ startOffset أو أكبر منها. ويجب أن تكون قيمة endOffset أيضًا أقل من طول النطاق الحالي أو مساويًا له. |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getRuns()
لعرض عمليات تشغيل النص التي تتداخل مع نطاق النص الحالي. تشغيل النص هو جزء من النص تكون فيه جميع الأحرف لها نفس نمط النص.
ويضمن كل نطاق يتم عرضه أن يمتد مرة واحدة فقط عند إنشائه. يمكن أن تؤدي تعديلات النص أو النمط إلى عدم تمثيلهما مرة واحدة فقط.
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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()
insertParagraph(startOffset, text)
يدرج فقرة في إزاحة البداية. تحافظ الفقرة على نمط نطاق النص الحالي من إزاحة البداية.
يتم إدراج السلسلة النصية المقدمة كفقرة عن طريق إضافة حرف سطر جديد محيطي واحد على الأقل إلى السلسلة.
عندما تحتوي السلسلة النصية المقدمة على أحرف سطر جديد (وبالتالي تتكون من فقرات متعددة)، يتم عرض الفقرة الأخيرة المضافة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
startOffset | Integer | عدد الأحرف التي تتجاوز فهرس البدء لنطاق النص الحالي المستخدَم لتحديد فهرس البدء الشامل للنص المطلوب إدراجه. |
text | String | السلسلة المطلوب إدراجها. |
استرجاع الكرة
Paragraph
— تم إدراج Paragraph
.
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertRange(startOffset, textRange)
يدرج نسخة من نطاق النص المقدم في إزاحة البداية.
سيتطابق تنسيق النص المدرج مع تنسيق النص المصدر.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
startOffset | Integer | عدد الأحرف التي تتجاوز فهرس البدء لنطاق النص الحالي المستخدَم لتحديد فهرس البدء الشامل للنص المطلوب إدراجه. |
textRange | TextRange | نطاق النص المطلوب إدراجه. |
استرجاع الكرة
TextRange
: نطاق النص الذي يمثّل النص المُدرَج
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
insertRange(startOffset, textRange, matchSourceFormatting)
يدرج نسخة من نطاق النص المقدم في إزاحة البداية.
في حال ضبطها لمطابقة تنسيق النص الوجهة، يتم استبدال AutoText
ضمن نطاق النص المقدّم بالقيم المعروضة. علاوة على ذلك، لا يتم إدراج أي عناصر غير نصية
داخل نطاق النص المقدم.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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)
يدرج نصًا عند إزاحة البداية. يحافظ النص على نمط النص الحالي من إزاحة البداية.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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)
لاستبدال جميع تكرارات النص المطابق للبحث عن النص باستبدال النص. فإن البحث غير حساس لحالة الأحرف.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
findText | String | النص المطلوب البحث عنه |
replaceText | String | النص المطلوب استبدال النص المطابق له. |
استرجاع الكرة
Integer
- تم تغيير عدد التكرارات
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
replaceAllText(findText, replaceText, matchCase)
لاستبدال جميع تكرارات النص المطابق للبحث عن النص باستبدال النص.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
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)
لتعيين النص المُحاط بهذا النطاق من الشكل أو خلية الجدول المرتبطين. يحافظ النص على نمط بداية النص الحالي.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
newText | String | السلسلة المطلوب تعيينها كنص جديد. |
استرجاع الكرة
TextRange
— نطاق النص الذي يمثل النص المحدد
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations