نمط النص.
تعرض طُرق القراءة في هذه الفئة 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()
getBaselineOffset()
لعرض الإزاحة الرأسية للنص من موضعه العادي أو null
إذا كانت هناك
أنماط متعددة على النص.
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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()
getLink()
عرض Link
في النص أو عرض null
في حالة عدم وجود رابط أو إذا كان الرابط قيد التفعيل
من النص أو إذا كانت هناك روابط متعددة. يمكنك الاتصال بالرقم hasLink()
لتحديد ما إذا كان
النص لا يحتوي على رابط.
var textLink = shape.getText().getTextStyle().getLink(); if (textLink != null) { Logger.log('Shape text has a link of type: ' + textLink.getLinkType()); }
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
hasLink()
عرض 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
removeLink()
setBackgroundColor(color)
setBackgroundColor(red, green, blue)
لضبط لون خلفية النص على قيم النموذج اللوني أحمر أخضر أزرق (RGB) محددة من 0 إلى 255.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBackgroundColor(hexColor)
لضبط لون خلفية النص على سلسلة اللون السداسية العشرية المحددة
يجب أن تكون السلسلة السداسية العشرية بالتنسيق "#RRGGBB". على سبيل المثال، سيتم تمثيل اللون الوردي على أنه " #FFC0CB".
المعلمات
الاسم | النوع | الوصف |
---|---|---|
hexColor | String |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBackgroundColor(color)
لضبط لون خلفية النص على سمة ThemeColorType
المحدّدة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
color | ThemeColorType |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBackgroundColorTransparent()
setBaselineOffset(offset)
لضبط الإزاحة الرأسية للنص بالنسبة إلى موضعه العادي.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
offset | TextBaselineOffset |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setBold(bold)
لضبط ما إذا كان يجب عرض النص بالخط الغامق.
يؤدي تغيير درجة سطوع النص إلى تعديل عرض الخط المستخدَم لعرض النص.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
bold | Boolean |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setFontFamily(fontFamily)
setFontFamilyAndWeight(fontFamily, fontWeight)
لتعيين مجموعة الخطوط وحجم النص.
ويكون الوزن مضاعفًا لـ 100 بين 100 و900، بشكل شامل. يتجاوب هذا النطاق مع
القيم الرقمية الموضحة في مواصفات CSS 2.1، القسم 15.6، مع
القيم غير الرقمية غير مسموح بها. تعتبر الأوزان التي تزيد عن 700 أو تساويها بخط غامق،
وفي هذه الحالة، تعرض الدالة isBold()
القيمة true
. القيمة التلقائية هي 400.
("عادي").
المعلمات
الاسم | النوع | الوصف |
---|---|---|
fontFamily | String | |
fontWeight | Integer |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setFontSize(fontSize)
setForegroundColor(foregroundColor)
setForegroundColor(red, green, blue)
لضبط لون المقدّمة للنص على قيم النموذج اللوني أحمر أخضر أزرق (RGB) محددة من 0 إلى 255.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
red | Integer | |
green | Integer | |
blue | Integer |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setForegroundColor(hexColor)
لضبط لون المقدّمة للنص على سلسلة اللون السداسية العشرية المحدّدة.
يجب أن تكون السلسلة السداسية العشرية بالتنسيق "#RRGGBB". على سبيل المثال، سيتم تمثيل اللون الوردي على أنه " #FFC0CB".
المعلمات
الاسم | النوع | الوصف |
---|---|---|
hexColor | String |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setForegroundColor(color)
تضبط هذه السياسة لون المقدّمة للنص على سمة ThemeColorType
المحدّدة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
color | ThemeColorType |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setItalic(italic)
لتعيين ما إذا كان النص مائلاً أم لا.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
italic | Boolean |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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. text.getTextStyle().setLinkSlide(0);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
slideIndex | Integer | الفهرس القائم على صفر للشريحة. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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. var slide = presentation.getSlides()[0]; text.getTextStyle().setLinkSlide(slide);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
slide | Slide | Slide المطلوب ربطه |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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. text.getTextStyle().setLinkSlide(SlidesApp.SlidePosition.FIRST_SLIDE);
المعلمات
الاسم | النوع | الوصف |
---|---|---|
slidePosition | SlidePosition | تمثّل هذه السمة SlidePosition النسبي. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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. text.getTextStyle().setLinkUrl("https://slides.google.com");
المعلمات
الاسم | النوع | الوصف |
---|---|---|
url | String | سلسلة عنوان URL. |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setSmallCaps(smallCaps)
لتحديد ما إذا كان سيتم عرض النص بأحرف كبيرة صغيرة.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
smallCaps | Boolean |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setStrikethrough(strikethrough)
لتعيين ما إذا كان النص يتوسطه خط.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
strikethrough | Boolean |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
setUnderline(underline)
لتعيين ما إذا كان النص مسطرًا أم لا.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
underline | Boolean |
الإرجاع
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations