Class ParagraphStyle

ParagraphStyle

أنماط النص التي تنطبق على الفقرات بأكملها

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

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

الطُرق

الطريقةنوع القيمة التي تم إرجاعهاوصف قصير
getIndentEnd()Number|nullتعرض هذه السمة مقدار المسافة البادئة لنهاية النص في الفقرات في TextRange بالنقاط، أو null إذا كانت هناك أنماط فقرات متعددة في النص المحدد.
getIndentFirstLine()Number|nullتعرض هذه السمة المسافة البادئة للسطر الأول من الفقرات في TextRange بالنقاط، أو null إذا كانت هناك أنماط فقرات متعددة في النص المحدّد.
getIndentStart()Number|nullتعرض هذه السمة مسافة بادئة لبداية النص في الفقرات ضمن TextRange بالنقاط، أو null إذا كانت هناك أنماط فقرات متعددة في النص المحدّد.
getLineSpacing()Number|nullتعرض هذه السمة تباعد الأسطر، أو null إذا كانت هناك أنماط فقرات متعددة في النص المحدّد.
getParagraphAlignment()ParagraphAlignment|nullتعرض هذه السمة ParagraphAlignment الفقرات في TextRange، أو null إذا كانت هناك أنماط فقرات متعددة في النص المحدد.
getSpaceAbove()Number|nullتعرض هذه السمة المسافة الإضافية فوق الفقرات في TextRange بالنقاط، أو null إذا كان هناك أنماط فقرات متعددة في النص المحدّد.
getSpaceBelow()Number|nullتعرض هذه السمة المسافة الإضافية أسفل الفقرات في TextRange بالنقاط، أو null إذا كانت هناك أنماط فقرات متعددة في النص المحدّد.
getSpacingMode()SpacingMode|nullتعرض هذه السمة SpacingMode للفقرات في TextRange، أو null إذا كانت هناك أنماط فقرات متعددة في النص المحدد.
getTextDirection()TextDirection|nullتعرض هذه السمة TextDirection للفقرات في TextRange، أو null إذا كانت هناك أنماط فقرات متعددة في النص المحدد.
setIndentEnd(indent)ParagraphStyleتضبط هذه السمة المسافة البادئة لنهاية الفقرات في TextRange بالنقاط.
setIndentFirstLine(indent)ParagraphStyleتضبط هذه السمة المسافة البادئة للسطر الأول من الفقرات في TextRange بالنقاط.
setIndentStart(indent)ParagraphStyleتضبط هذه السمة المسافة البادئة لبداية الفقرات في TextRange بالنقاط.
setLineSpacing(spacing)ParagraphStyleتضبط هذه السمة تباعد الأسطر.
setParagraphAlignment(alignment)ParagraphStyleتضبط هذه السمة ParagraphAlignment الفقرات في TextRange.
setSpaceAbove(space)ParagraphStyleتضبط هذه السمة المسافة الإضافية فوق الفقرات في TextRange بالنقاط.
setSpaceBelow(space)ParagraphStyleتضبط هذه السمة المسافة الإضافية أسفل الفقرات في TextRange بالنقاط.
setSpacingMode(mode)ParagraphStyleتضبط هذه السمة SpacingMode للفقرات في TextRange.
setTextDirection(direction)ParagraphStyleتضبط هذه السمة TextDirection للفقرات في TextRange.

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

getIndentEnd()

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

يعتمد الجانب الذي يتوافق مع نهاية النص على اتجاه النص الحالي.

الإرجاع

Number|null

التفويض

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

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

getIndentFirstLine()

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

الإرجاع

Number|null

التفويض

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

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

getIndentStart()

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

يعتمد الجانب الذي يتوافق مع بداية النص على اتجاه النص الحالي.

الإرجاع

Number|null

التفويض

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

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

getLineSpacing()

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

هذه قيمة تتوافق مع المسافة بين الأسطر، كنسبة مئوية من الوضع العادي. يتم تمثيل القيمة العادية بـ 100.0.

الإرجاع

Number|null

التفويض

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

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

getParagraphAlignment()

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

الإرجاع

ParagraphAlignment|null

التفويض

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

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

getSpaceAbove()

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

الإرجاع

Number|null

التفويض

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

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

getSpaceBelow()

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

الإرجاع

Number|null

التفويض

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

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

getSpacingMode()

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

الإرجاع

SpacingMode|null

التفويض

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

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

getTextDirection()

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

الإرجاع

TextDirection|null

التفويض

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

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

setIndentEnd(indent)

تضبط هذه السمة المسافة البادئة لنهاية الفقرات في TextRange بالنقاط.

المَعلمات

الاسمالنوعالوصف
indentNumberالمسافة البادئة المطلوب ضبطها

الإرجاع

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

التفويض

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

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

setIndentFirstLine(indent)

تضبط هذه السمة المسافة البادئة للسطر الأول من الفقرات في TextRange بالنقاط.

المَعلمات

الاسمالنوعالوصف
indentNumberالمسافة البادئة المطلوب ضبطها

الإرجاع

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

التفويض

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

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

setIndentStart(indent)

تضبط هذه السمة المسافة البادئة لبداية الفقرات في TextRange بالنقاط.

المَعلمات

الاسمالنوعالوصف
indentNumberالمسافة البادئة المطلوب ضبطها

الإرجاع

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

التفويض

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

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

setLineSpacing(spacing)

تضبط هذه السمة تباعد الأسطر.

هذه قيمة تتوافق مع المسافة بين الأسطر، كنسبة مئوية من الوضع العادي.

المَعلمات

الاسمالنوعالوصف
spacingNumberالمسافة المطلوب ضبطها

الإرجاع

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

التفويض

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

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

setParagraphAlignment(alignment)

تضبط هذه السمة ParagraphAlignment الفقرات في TextRange.

المَعلمات

الاسمالنوعالوصف
alignmentParagraphAlignmentالمحاذاة المطلوب ضبطها

الإرجاع

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

التفويض

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

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

setSpaceAbove(space)

تضبط هذه السمة المسافة الإضافية فوق الفقرات في TextRange بالنقاط.

المَعلمات

الاسمالنوعالوصف
spaceNumberالمساحة أعلاه لضبطها

الإرجاع

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

التفويض

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

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

setSpaceBelow(space)

تضبط هذه السمة المسافة الإضافية أسفل الفقرات في TextRange بالنقاط.

المَعلمات

الاسمالنوعالوصف
spaceNumberالمساحة أدناه لضبطها

الإرجاع

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

التفويض

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

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

setSpacingMode(mode)

تضبط هذه السمة SpacingMode للفقرات في TextRange.

المَعلمات

الاسمالنوعالوصف
modeSpacingModeوضع التباعد المطلوب ضبطه.

الإرجاع

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

التفويض

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

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

setTextDirection(direction)

تضبط هذه السمة TextDirection للفقرات في TextRange.

المَعلمات

الاسمالنوعالوصف
directionTextDirectionتمثّل هذه السمة اتجاه النص المطلوب ضبطه.

الإرجاع

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

التفويض

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

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