Class TextStyle

نمط النص

نمط النص

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

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

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getBackgroundColor()Colorعرض لون خلفية النص، أو null إذا كانت هناك أنماط متعددة في النص
getBaselineOffset()TextBaselineOffsetتعرِض هذه السمة الإزاحة الرأسية للنص عن موضعه العادي، أو null إذا كانت هناك أنماط متعدّدة على النص.
getFontFamily()Stringتعرِض هذه السمة مجموعة خطوط النص، أو null إذا كان هناك أنماط متعددة للنص.
getFontSize()Numberتعرِض هذه الدالة حجم الخط للنص بالنقاط، أو null إذا كانت هناك أنماط متعدّدة في النص.
getFontWeight()Integerلعرض وزن الخط للنص، أو null إذا كانت هناك أنماط متعددة للنص.
getForegroundColor()Colorتعرِض هذه السمة لون المقدّمة للنص، أو null إذا كانت هناك أنماط متعدّدة في النص.
getLink()Linkتعرِض هذه الدالة الرمز Link على النص، أو null إذا لم يكن هناك رابط أو إذا كان الرابط في جزء من النص أو إذا كانت هناك روابط متعددة.
hasLink()Booleanتعرِض هذه الدالة القيمة true إذا كان هناك رابط في النص، أو القيمة false إذا لم يكن هناك رابط، أو القيمة null إذا كان الرابط في جزء من النص أو إذا كانت هناك روابط متعددة.
isBackgroundTransparent()Booleanتعرِض هذه السمة القيمة true إذا كانت خلفية النص شفافة، أو القيمة false إذا لم تكن شفافة، أو القيمة null إذا كانت هناك أنماط متعددة للنص.
isBold()Booleanيتم عرض القيمة true إذا كان النص معروضًا بخط غامق، أو القيمة false إذا لم يكن كذلك، أو القيمة null إذا كان هناك تصاميم متعددة للنص.
isItalic()Booleanتعرِض القيمة true إذا كان النص مائلًا، أو false إذا لم يكن مائلًا، أو null إذا كان هناك أنماط متعددة للنص.
isSmallCaps()Booleanتعرِض هذه الدالة القيمة true إذا كان النص مكتوبًا بأحرف صغيرة لاتّباع أسلوب الكتابة الكبير، أو القيمة false إذا لم يكن كذلك، أو القيمة null إذا كان هناك أنماط متعددة للنص.
isStrikethrough()Booleanتعرِض القيمة true إذا كان النص مشطوبًا، أو false إذا لم يكن مشطوبًا، أو null إذا كان هناك عدة أنماط للنص.
isUnderline()Booleanتعرِض القيمة true إذا كان النص مُخطَّطًا، أو false إذا لم يكن مُخطَّطًا، أو null إذا كان هناك أنماط متعددة على النص.
removeLink()TextStyleإزالة Link
setBackgroundColor(color)TextStyleلضبط لون خلفية النص
setBackgroundColor(red, green, blue)TextStyleلضبط لون خلفية النص على قيم RGB المحدّدة من 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

التفويض

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

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

getBaselineOffset()

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

الإرجاع

TextBaselineOffset

التفويض

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

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

getFontFamily()

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

الإرجاع

String

التفويض

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

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

getFontSize()

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

الإرجاع

Number

التفويض

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

  • 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

التفويض

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

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

getForegroundColor()

تعرِض هذه السمة لون المقدّمة للنص، أو null في حال توفّر أنماط متعدّدة في النص.

الإرجاع

Color

التفويض

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

  • 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

التفويض

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

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

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

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

الإرجاع

Boolean

التفويض

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

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

isBackgroundTransparent()

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

الإرجاع

Boolean

التفويض

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

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

isBold()

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

الإرجاع

Boolean

التفويض

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

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

isItalic()

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

الإرجاع

Boolean

التفويض

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

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

isSmallCaps()

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

الإرجاع

Boolean

التفويض

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

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

isStrikethrough()

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

الإرجاع

Boolean

التفويض

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

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

isUnderline()

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

الإرجاع

Boolean

التفويض

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

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

لضبط لون خلفية النص على قيم RGB المحدّدة من 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الفهرس الذي يبدأ من الصفر للشريحة

الإرجاع

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

التفويض

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

  • 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