Class TextStyle

نمطالنص

نمط النص

تعرض طرق القراءة في هذه الفئة القيمة null إذا كانت نطاقات TextRange المقابلة تمتد على عدة عمليات تشغيل نصية، وكانت عمليات التشغيل هذه تتضمّن قيمًا مختلفة لطريقة القراءة التي يتم استدعاؤها. لتجنُّب ذلك، ابحث عن أنماط النصوص باستخدام TextRange التي تعرضها الطريقة TextRange.getRuns().

إذا كنت تستخدم طرقًا لتعديل طريقة احتواء النص داخل شكل، سيتم إيقاف أي إعدادات احتواء تلقائي تم تطبيقها على أنماط النص.

الطُرق

الطريقةنوع القيمة التي تم إرجاعهاوصف قصير
getBackgroundColor()Color|nullتعرض هذه السمة لون خلفية النص، أو null إذا كانت هناك أنماط متعددة للنص.
getBaselineOffset()TextBaselineOffset|nullتعرض هذه السمة الإزاحة العمودية للنص من موضعه العادي، أو null إذا كان النص يتضمّن أنماطًا متعددة.
getFontFamily()String|nullتعرض هذه السمة مجموعة الخطوط الخاصة بالنص، أو null إذا كان النص يتضمّن أنماطًا متعددة.
getFontSize()Number|nullتعرض هذه السمة حجم خط النص بالنقاط، أو null إذا كانت هناك أنماط متعددة للنص.
getFontWeight()Integer|nullتعرض هذه السمة وزن خط النص، أو null إذا كانت هناك أنماط متعددة للنص.
getForegroundColor()Color|nullتعرض هذه السمة لون مقدّمة النص، أو null إذا كانت هناك أنماط متعدّدة للنص.
getLink()Link|nullتعرض هذه الدالة Link على النص، أو null إذا لم يكن هناك رابط أو إذا كان الرابط على جزء من النص أو إذا كانت هناك روابط متعددة.
hasLink()Boolean|nullتعرض true إذا كان النص يتضمّن رابطًا، أو false إذا لم يكن يتضمّن رابطًا، أو null إذا كان الرابط يتضمّن جزءًا من النص أو إذا كان النص يتضمّن روابط متعدّدة.
isBackgroundTransparent()Boolean|nullتعرض الدالة true إذا كانت خلفية النص شفافة، أو false إذا لم تكن شفافة، أو null إذا كان النص يتضمّن أنماطًا متعددة.
isBold()Boolean|nullتعرض true إذا تم عرض النص بخط غامق، أو false إذا لم يتم عرضه بخط غامق، أو null إذا كان النص يتضمّن أنماطًا متعدّدة.
isItalic()Boolean|nullتعرض الدالة true إذا كان النص مائلاً، أو false إذا لم يكن كذلك، أو null إذا كان النص يتضمّن أنماطًا متعدّدة.
isSmallCaps()Boolean|nullتعرض true إذا كان النص بأحرف استهلالية صغيرة، أو false إذا لم يكن كذلك، أو null إذا كان النص يتضمّن أنماطًا متعدّدة.
isStrikethrough()Boolean|nullتعرض الدالة true إذا كان النص مشطوبًا، أو false إذا لم يكن كذلك، أو null إذا كان النص يتضمّن أنماطًا متعدّدة.
isUnderline()Boolean|nullتعرض الدالة true إذا كان النص مسطرًا، أو false إذا لم يكن كذلك، أو null إذا كان النص يتضمّن أنماطًا متعددة.
removeLink()TextStyleتزيل هذه الطريقة Link.
setBackgroundColor(color)TextStyleتضبط هذه السمة لون خلفية النص.
setBackgroundColor(red, green, blue)TextStyleتضبط هذه السمة لون خلفية النص على قيم النموذج اللوني أحمر أخضر أزرق المحدّدة من 0 إلى 255.
setBackgroundColor(hexColor)TextStyleتضبط هذه السمة لون خلفية النص على سلسلة لون سداسي عشري معيّنة.
setBackgroundColor(color)TextStyleتضبط هذه السمة لون خلفية النص على القيمة ThemeColorType المحدّدة.
setBackgroundColorTransparent()TextStyleتضبط هذه السمة لون خلفية النص على شفاف.
setBaselineOffset(offset)TextStyleتضبط هذه السمة الإزاحة العمودية للنص بالنسبة إلى موضعه العادي.
setBold(bold)TextStyleتضبط هذه السمة ما إذا كان يجب عرض النص بخط غامق.
setFontFamily(fontFamily)TextStyleتضبط هذه السمة مجموعة خطوط النص .
setFontFamilyAndWeight(fontFamily, fontWeight)TextStyleتضبط هذه السمة مجموعة الخطوط ووزن النص.
setFontSize(fontSize)TextStyleتحدّد هذه السمة حجم خط النص بالنقاط.
setForegroundColor(foregroundColor)TextStyleتضبط هذه السمة لون مقدّمة النص.
setForegroundColor(red, green, blue)TextStyleتضبط هذه السمة لون مقدّمة النص على قيم الأحمر والأخضر والأزرق المحدّدة من 0 إلى 255.
setForegroundColor(hexColor)TextStyleتضبط هذه السمة لون مقدّمة النص على سلسلة لون سداسي عشري معيّنة.
setForegroundColor(color)TextStyleيضبط لون المقدّمة للنص على قيمة ThemeColorType المحدّدة.
setItalic(italic)TextStyleتضبط ما إذا كان النص مائلاً.
setLinkSlide(slideIndex)TextStyleيضبط Link على Slide المحدّد باستخدام الفهرس المستند إلى الصفر للشريحة.
setLinkSlide(slide)TextStyleيضبط هذا الإجراء Link على Slide المحدّد، ويتم ضبط الرابط حسب معرّف الشريحة المحدّد.
setLinkSlide(slidePosition)TextStyleيضبط Link على Slide المحدّد باستخدام الموضع النسبي للشريحة.
setLinkUrl(url)TextStyleيضبط Link على سلسلة عنوان URL غير فارغة.
setSmallCaps(smallCaps)TextStyleتضبط هذه السمة ما إذا كان سيتم عرض النص بأحرف استهلالية صغيرة.
setStrikethrough(strikethrough)TextStyleتضبط هذه السمة ما إذا كان النص مشطوبًا.
setUnderline(underline)TextStyleتضبط هذه السمة ما إذا كان النص تحته خط.

مستندات تفصيلية

getBackgroundColor()

تعرض هذه السمة لون خلفية النص، أو null إذا كانت هناك أنماط متعددة للنص.

الإرجاع

Color|null: لون خلفية النص

التفويض

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

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

getBaselineOffset()

تعرض هذه السمة الإزاحة العمودية للنص من موضعه العادي، أو null إذا كان النص يتضمّن أنماطًا متعددة.

الإرجاع

‫TextBaselineOffset|null: الإزاحة العمودية للنص من موضعه العادي

التفويض

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

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

getFontFamily()

تعرض هذه السمة مجموعة الخطوط الخاصة بالنص، أو null إذا كان النص يتضمّن أنماطًا متعددة.

الإرجاع

String|null: مجموعة خطوط النص

التفويض

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

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

getFontSize()

تعرض هذه السمة حجم خط النص بالنقاط، أو null إذا كانت هناك أنماط متعددة للنص.

الإرجاع

‫Number|null: حجم خط النص بالنقاط

التفويض

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

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

getFontWeight()

تعرض هذه السمة وزن خط النص، أو null إذا كانت هناك أنماط متعددة للنص.

الوزن هو مضاعف للعدد 100 بين 100 و900، بما في ذلك هذين الرقمين. يتوافق هذا النطاق مع القيم الرقمية الموضّحة في مواصفات CSS 2.1، الفقرة 15.6، مع عدم السماح بالقيم غير الرقمية. تُعتبر الأوزان الأكبر من 700 أو التي تساويها أوزانًا غامقة، وفي هذه الحالة تعرض الدالة isBold() القيمة true. القيمة التلقائية هي 400 ("عادي").

الإرجاع

‫Integer|null: سماكة خط النص

التفويض

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

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

getForegroundColor()

تعرض هذه السمة لون مقدّمة النص، أو null إذا كانت هناك أنماط متعدّدة للنص.

الإرجاع

Color|null: لون المقدمة للنص

التفويض

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

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

تعرض هذه الدالة Link على النص، أو null إذا لم يكن هناك رابط أو إذا كان الرابط على جزء من النص أو إذا كانت هناك روابط متعددة. اتّصِل بالرقم hasLink() لتحديد ما إذا كان النص لا يتضمّن رابطًا. 

const shape = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0];
const textLink = shape.getText().getTextStyle().getLink();
if (textLink != null) {
  Logger.log(`Shape text has a link of type: ${textLink.getLinkType()}`);
}

الإرجاع

Link|null: الرابط في النص

التفويض

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

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

تعرض true إذا كان النص يتضمّن رابطًا، أو false إذا لم يكن يتضمّن رابطًا، أو null إذا كان الرابط يتضمّن جزءًا من النص أو إذا كان النص يتضمّن روابط متعدّدة.

لا يمكن ضبط الروابط على أحرف سطر جديد. لذلك، إذا كان TextRange يحتوي على حرف سطر جديد، تعرض هذه الطريقة دائمًا إما null أو false.

الإرجاع

Boolean|null: تحدّد ما إذا كان النص يتضمّن رابطًا.

التفويض

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

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

isBackgroundTransparent()

تعرض الدالة true إذا كانت خلفية النص شفافة، أو false إذا لم تكن شفافة، أو null إذا كان النص يتضمّن أنماطًا متعددة.

الإرجاع

Boolean|null: لتحديد ما إذا كانت خلفية النص شفافة.

التفويض

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

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

isBold()

تعرض true إذا تم عرض النص بخط غامق، أو false إذا لم يتم عرضه بخط غامق، أو null إذا كان النص يتضمّن أنماطًا متعدّدة.

الإرجاع

‫Boolean|null: لتحديد ما إذا كان النص معروضًا بخط غامق.

التفويض

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

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

isItalic()

تعرض الدالة true إذا كان النص مائلاً، أو false إذا لم يكن كذلك، أو null إذا كان النص يتضمّن أنماطًا متعدّدة.

الإرجاع

Boolean|null: لتحديد ما إذا كان النص مائلاً.

التفويض

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

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

isSmallCaps()

تعرض true إذا كان النص بأحرف استهلالية صغيرة، أو false إذا لم يكن كذلك، أو null إذا كان النص يتضمّن أنماطًا متعدّدة.

الإرجاع

‫Boolean|null: ما إذا كان النص مكتوبًا بأحرف كبيرة صغيرة.

التفويض

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

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

isStrikethrough()

تعرض الدالة true إذا كان النص مشطوبًا، أو false إذا لم يكن كذلك، أو null إذا كان النص يتضمّن أنماطًا متعدّدة.

الإرجاع

Boolean|null: لتحديد ما إذا كان النص مشطوبًا.

التفويض

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

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

isUnderline()

تعرض الدالة true إذا كان النص مسطرًا، أو false إذا لم يكن كذلك، أو null إذا كان النص يتضمّن أنماطًا متعددة.

الإرجاع

Boolean|null: لتحديد ما إذا كان النص تحته خط.

التفويض

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

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

تزيل هذه الطريقة Link.

تؤدي إزالة الرابط إلى إزالة لون المقدمة ونمط التسطير للرابط التشعّبي من النص. إذا كان ذلك ممكنًا، يتم تطبيق هذه الأنماط لتتطابق مع النص الذي يسبق الرابط. 

const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().removeLink();

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

setBackgroundColor(color)

تضبط هذه السمة لون خلفية النص.

المعلمات

الاسمالنوعالوصف
colorColorلون الخلفية المطلوب ضبطه

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setBackgroundColor(red, green, blue)

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

المعلمات

الاسمالنوعالوصف
redIntegerتمثّل هذه السمة المكوّن الأحمر من اللون.
greenIntegerتمثّل هذه السمة المكوّن الأخضر من اللون.
blueIntegerتمثّل هذه السمة مكوّن اللون الأزرق.

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setBackgroundColor(hexColor)

تضبط هذه السمة لون خلفية النص على سلسلة لون سداسي عشري معيّنة.

يجب أن تكون سلسلة الأرقام الست عشرية بالتنسيق ‎#RRGGBB. على سبيل المثال، يتم تمثيل اللون الوردي على النحو التالي

المعلمات

الاسمالنوعالوصف
hexColorStringسلسلة اللون الست عشري

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setBackgroundColor(color)

تضبط هذه السمة لون خلفية النص على القيمة ThemeColorType المحدّدة.

المعلمات

الاسمالنوعالوصف
colorThemeColorTypeتمثّل هذه السمة نوع لون المظهر.

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setBackgroundColorTransparent()

تضبط هذه السمة لون خلفية النص على شفاف.

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setBaselineOffset(offset)

تضبط هذه السمة الإزاحة العمودية للنص بالنسبة إلى موضعه العادي.

المعلمات

الاسمالنوعالوصف
offsetTextBaselineOffsetإزاحة خط الأساس المطلوب ضبطها.

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setBold(bold)

تضبط هذه السمة ما إذا كان يجب عرض النص بخط غامق.

المعلمات

الاسمالنوعالوصف
boldBooleanلتحديد ما إذا كان سيتم عرض النص بخط غامق

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setFontFamily(fontFamily)

تضبط هذه السمة مجموعة خطوط النص .

المعلمات

الاسمالنوعالوصف
fontFamilyStringمجموعة الخطوط المطلوب ضبطها

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setFontFamilyAndWeight(fontFamily, fontWeight)

تضبط هذه السمة مجموعة الخطوط ووزن النص.

المعلمات

الاسمالنوعالوصف
fontFamilyStringمجموعة الخطوط
fontWeightIntegerتمثّل هذه السمة مدى ثِقل الخط.

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setFontSize(fontSize)

تحدّد هذه السمة حجم خط النص بالنقاط.

المعلمات

الاسمالنوعالوصف
fontSizeNumberحجم الخط بالنقاط

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setForegroundColor(foregroundColor)

تضبط هذه السمة لون مقدّمة النص.

المعلمات

الاسمالنوعالوصف
foregroundColorColorلون المقدّمة المطلوب ضبطه.

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setForegroundColor(red, green, blue)

تضبط هذه السمة لون مقدّمة النص على قيم الأحمر والأخضر والأزرق المحدّدة من 0 إلى 255.

المعلمات

الاسمالنوعالوصف
redIntegerتمثّل هذه السمة المكوّن الأحمر من اللون.
greenIntegerتمثّل هذه السمة المكوّن الأخضر من اللون.
blueIntegerتمثّل هذه السمة مكوّن اللون الأزرق.

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setForegroundColor(hexColor)

تضبط هذه السمة لون مقدّمة النص على سلسلة لون سداسي عشري معيّنة.

يجب أن تكون سلسلة الأرقام الست عشرية بالتنسيق ‎#RRGGBB. على سبيل المثال، يتم تمثيل اللون الوردي على النحو التالي

المعلمات

الاسمالنوعالوصف
hexColorStringسلسلة اللون الست عشري

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setForegroundColor(color)

يضبط لون المقدّمة للنص على قيمة ThemeColorType المحدّدة.

المعلمات

الاسمالنوعالوصف
colorThemeColorTypeتمثّل هذه السمة نوع لون المظهر.

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setItalic(italic)

تضبط ما إذا كان النص مائلاً.

المعلمات

الاسمالنوعالوصف
italicBooleanلتحديد ما إذا كان سيتم عرض النص بشكل مائل

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setLinkSlide(slideIndex)

يضبط Link على Slide المحدّد باستخدام الفهرس المستند إلى الصفر للشريحة.

يؤدي ضبط رابط إلى تغيير نمط النص ليصبح مسطّرًا وبلون مقدّمة ThemeColorType.HYPERLINK. يمكن تغيير هذا الإعداد من خلال setForegroundColor(hexColor) وsetUnderline(underline).

بما أنّه لا يمكن ضبط الروابط على أحرف سطر جديد، يتم تجاهل أحرف السطر الجديد في TextRange. 

// Set a link to the first slide of the presentation.
const presentation = SlidesApp.getActivePresentation();
const slide = presentation.getSlides()[0];
const textRange = slide.getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(0);

المعلمات

الاسمالنوعالوصف
slideIndexIntegerالفهرس الذي يبدأ من الصفر للشريحة

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setLinkSlide(slide)

يضبط هذا الإجراء Link على Slide المحدّد، ويتم ضبط الرابط حسب معرّف الشريحة المحدّد.

يؤدي ضبط رابط إلى تغيير نمط النص ليصبح مسطّرًا وبلون مقدّمة ThemeColorType.HYPERLINK. يمكن تغيير هذا الإعداد من خلال setForegroundColor(hexColor) وsetUnderline(underline).

بما أنّه لا يمكن ضبط الروابط على أحرف سطر جديد، يتم تجاهل أحرف السطر الجديد في TextRange. 

// Set a link to the first slide of the presentation.
const presentation = SlidesApp.getActivePresentation();
const slide = presentation.getSlides()[0];
const textRange = slide.getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(slide);

المعلمات

الاسمالنوعالوصف
slideSlideSlide المراد ربطه

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setLinkSlide(slidePosition)

يضبط Link على Slide المحدّد باستخدام الموضع النسبي للشريحة.

يؤدي ضبط رابط إلى تغيير نمط النص ليصبح مسطّرًا وبلون مقدّمة ThemeColorType.HYPERLINK. يمكن تغيير هذا الإعداد من خلال setForegroundColor(hexColor) وsetUnderline(underline).

بما أنّه لا يمكن ضبط الروابط على أحرف سطر جديد، يتم تجاهل أحرف السطر الجديد في TextRange. 

// Set a link to the first slide of the presentation.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);

المعلمات

الاسمالنوعالوصف
slidePositionSlidePositionتمثّل هذه السمة SlidePosition النسبي.

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setLinkUrl(url)

يضبط Link على سلسلة عنوان URL غير فارغة.

يؤدي ضبط رابط إلى تغيير نمط النص ليصبح مسطّرًا وبلون مقدّمة ThemeColorType.HYPERLINK. يمكن تغيير هذا الإعداد من خلال setForegroundColor(hexColor) وsetUnderline(underline).

بما أنّه لا يمكن ضبط الروابط على أحرف سطر جديد، يتم تجاهل أحرف السطر الجديد في TextRange. 

// Set a link to the URL.
const textRange = SlidesApp.getActivePresentation().getSlides()[0].getShapes()[0].getText();
textRange.getTextStyle().setLinkUrl('https://slides.google.com');

المعلمات

الاسمالنوعالوصف
urlStringسلسلة عنوان URL

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setSmallCaps(smallCaps)

تضبط هذه السمة ما إذا كان سيتم عرض النص بأحرف استهلالية صغيرة.

المعلمات

الاسمالنوعالوصف
smallCapsBooleanلتحديد ما إذا كان سيتم عرض النص بأحرف كبيرة صغيرة

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setStrikethrough(strikethrough)

تضبط هذه السمة ما إذا كان النص مشطوبًا.

المعلمات

الاسمالنوعالوصف
strikethroughBooleanلتحديد ما إذا كان سيتم التشطيب على النص.

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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

setUnderline(underline)

تضبط هذه السمة ما إذا كان النص تحته خط.

المعلمات

الاسمالنوعالوصف
underlineBooleanتُستخدَم لتحديد ما إذا كان سيتم تسطير النص أم لا.

الإرجاع

‫TextStyle: هذا TextStyle، للسلاسل.

التفويض

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

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