Class TextStyle

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	تضبط هذه السمة لون مقدّمة النص على قيم 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

---

getLink()

تعرض هذه الدالة 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

---

hasLink()

تعرض 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

---

removeLink()

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

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

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

الإرجاع

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

---

setBackgroundColor(color)

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

المَعلمات

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

الإرجاع

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

التفويض

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

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

---

setBackgroundColor(red, green, blue)

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

المَعلمات

الاسم	النوع	الوصف
red	Integer	تمثّل هذه السمة المكوّن الأحمر من اللون.
green	Integer	مكوّن اللون الأخضر.
blue	Integer	تمثّل هذه السمة مكوّن اللون الأزرق.

الإرجاع

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

التفويض

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

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

---

setBackgroundColor(hexColor)

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

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

المَعلمات

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

الإرجاع

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

التفويض

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

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

---

setBackgroundColor(color)

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

المَعلمات

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

الإرجاع

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

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

المَعلمات

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

الإرجاع

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

التفويض

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

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

---

setBold(bold)

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

المَعلمات

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

الإرجاع

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

التفويض

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

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

---

setFontFamily(fontFamily)

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

المَعلمات

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

الإرجاع

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

التفويض

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

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

---

setFontFamilyAndWeight(fontFamily, fontWeight)

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

المَعلمات

الاسم	النوع	الوصف
fontFamily	String	مجموعة الخطوط
fontWeight	Integer	تمثّل هذه السمة مدى ثِقل الخط.

الإرجاع

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

التفويض

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

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

---

setFontSize(fontSize)

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

المَعلمات

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

الإرجاع

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

التفويض

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

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

---

setForegroundColor(foregroundColor)

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

المَعلمات

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

الإرجاع

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

التفويض

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

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

---

setForegroundColor(red, green, blue)

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

المَعلمات

الاسم	النوع	الوصف
red	Integer	تمثّل هذه السمة المكوّن الأحمر من اللون.
green	Integer	مكوّن اللون الأخضر.
blue	Integer	تمثّل هذه السمة مكوّن اللون الأزرق.

الإرجاع

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

التفويض

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

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

---

setForegroundColor(hexColor)

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

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

المَعلمات

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

الإرجاع

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

التفويض

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

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

---

setForegroundColor(color)

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

المَعلمات

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

الإرجاع

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

التفويض

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

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

---

setItalic(italic)

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

المَعلمات

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

الإرجاع

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

المَعلمات

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

الإرجاع

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

المَعلمات

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

الإرجاع

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

المَعلمات

الاسم	النوع	الوصف
slidePosition	SlidePosition	تمثّل هذه السمة 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');

المَعلمات

الاسم	النوع	الوصف
url	String	سلسلة عنوان URL

الإرجاع

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

التفويض

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

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

---

setSmallCaps(smallCaps)

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

المَعلمات

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

الإرجاع

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

التفويض

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

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

---

setStrikethrough(strikethrough)

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

المَعلمات

الاسم	النوع	الوصف
strikethrough	Boolean	تُستخدَم لتحديد ما إذا كان يجب وضع خط يتوسط النص.

الإرجاع

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

التفويض

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

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

---

setUnderline(underline)

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

المَعلمات

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

الإرجاع

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

التفويض

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

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