Class TextStyle

نمطالنص

نمط النص

تعرض طرق القراءة في هذه الفئة القيمة null إذا كانت نطاقات TextRange المقابلة تمتد على عدة عمليات تشغيل نصية، وكانت عمليات التشغيل هذه تتضمّن قيمًا مختلفة لطريقة القراءة التي يتم استدعاؤها. لتجنُّب ذلك، ابحث عن أنماط النصوص باستخدام TextRanges التي تعرضها الطريقة 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تضبط هذه السمة لون مقدّمة النص على قيم RGB المحدّدة من 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

setBackgroundColor(color)

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

المعلمات

الاسمالنوعالوصف
colorColor

الإرجاع

TextStyle

التفويض

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

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

setBackgroundColor(red, green, blue)

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

المعلمات

الاسمالنوعالوصف
redInteger
greenInteger
blueInteger

الإرجاع

TextStyle

التفويض

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

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

setBackgroundColor(hexColor)

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

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

المعلمات

الاسمالنوعالوصف
hexColorString

الإرجاع

TextStyle

التفويض

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

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

setBackgroundColor(color)

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

المعلمات

الاسمالنوعالوصف
colorThemeColorType

الإرجاع

TextStyle

التفويض

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

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

setBackgroundColorTransparent()

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

الإرجاع

TextStyle

التفويض

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

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

setBaselineOffset(offset)

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

المعلمات

الاسمالنوعالوصف
offsetTextBaselineOffset

الإرجاع

TextStyle

التفويض

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

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

setBold(bold)

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

يؤدي تغيير كثافة النص إلى تعديل كثافة الخط المستخدَمة لعرض النص.

المعلمات

الاسمالنوعالوصف
boldBoolean

الإرجاع

TextStyle

التفويض

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

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

setFontFamily(fontFamily)

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

المعلمات

الاسمالنوعالوصف
fontFamilyString

الإرجاع

TextStyle

التفويض

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

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

setFontFamilyAndWeight(fontFamily, fontWeight)

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

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

المعلمات

الاسمالنوعالوصف
fontFamilyString
fontWeightInteger

الإرجاع

TextStyle

التفويض

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

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

setFontSize(fontSize)

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

المعلمات

الاسمالنوعالوصف
fontSizeNumber

الإرجاع

TextStyle

التفويض

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

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

setForegroundColor(foregroundColor)

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

المعلمات

الاسمالنوعالوصف
foregroundColorColor

الإرجاع

TextStyle

التفويض

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

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

setForegroundColor(red, green, blue)

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

المعلمات

الاسمالنوعالوصف
redInteger
greenInteger
blueInteger

الإرجاع

TextStyle

التفويض

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

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

setForegroundColor(hexColor)

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

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

المعلمات

الاسمالنوعالوصف
hexColorString

الإرجاع

TextStyle

التفويض

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

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

setForegroundColor(color)

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

المعلمات

الاسمالنوعالوصف
colorThemeColorType

الإرجاع

TextStyle

التفويض

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

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

setItalic(italic)

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

المعلمات

الاسمالنوعالوصف
italicBoolean

الإرجاع

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الفهرس الذي يبدأ من 0 للشريحة

الإرجاع

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

المعلمات

الاسمالنوعالوصف
slideSlideتمثّل Slide الحساب المطلوب ربطه.

الإرجاع

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

التفويض

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

  • 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

التفويض

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

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

setSmallCaps(smallCaps)

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

المعلمات

الاسمالنوعالوصف
smallCapsBoolean

الإرجاع

TextStyle

التفويض

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

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

setStrikethrough(strikethrough)

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

المعلمات

الاسمالنوعالوصف
strikethroughBoolean

الإرجاع

TextStyle

التفويض

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

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

setUnderline(underline)

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

المعلمات

الاسمالنوعالوصف
underlineBoolean

الإرجاع

TextStyle

التفويض

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

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