Class RichTextValue

RichTextValue

سلسلة نصية منمّقة تُستخدَم لتمثيل نص الخلية. يمكن أن تتضمّن السلاسل الفرعية من النص أنماطًا مختلفة.

التشغيل هو أطول سلسلة فرعية متواصلة لها نمط النص نفسه. على سبيل المثال، تحتوي الجملة "هذا الطفل يحمل تفاحًا" على 4 عمليات تشغيل: ['This ', 'child ', 'is carrying ', 'apples'].

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
copy()RichTextValueBuilderتعرض هذه الدالة أداة إنشاء لقيمة نص منسّق تمّت تهيئتها باستخدام قيم هذه القيمة.
getEndIndex()Integerتعرض هذه الدالة فهرس نهاية هذه القيمة في الخلية.
getLinkUrl()String|nullتعرض هذه السمة عنوان URL للرابط الخاص بهذه القيمة.
getLinkUrl(startOffset, endOffset)String|nullتعرض هذه السمة عنوان URL للرابط الخاص بالنص من startOffset إلى endOffset.
getRuns()RichTextValue[]تعرض هذه الطريقة سلسلة Rich Text مقسّمة إلى مصفوفة من عمليات التشغيل، حيث تكون كل عملية تشغيل هي أطول سلسلة فرعية ممكنة لها نمط نصي متسق.
getStartIndex()Integerتعرض هذه الدالة فهرس بداية هذه القيمة في الخلية.
getText()Stringتعرض هذه السمة نص القيمة.
getTextStyle()TextStyleتعرض هذه السمة نمط النص لهذه القيمة.
getTextStyle(startOffset, endOffset)TextStyleتعرض هذه السمة نمط النص من startOffset إلى endOffset.

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

copy()

تعرض هذه الدالة أداة إنشاء لقيمة نص منسّق تمّت تهيئتها باستخدام قيم هذه القيمة.

الإرجاع

RichTextValueBuilder: أداة إنشاء لقيمة نص منسّق.

getEndIndex()

تعرض هذه الدالة فهرس نهاية هذه القيمة في الخلية.

الإرجاع

‫Integer: فهرس نهاية هذه القيمة في الخلية.

getLinkUrl()

تعرض هذه السمة عنوان URL للرابط الخاص بهذه القيمة.

الإرجاع

String|null: عنوان URL للرابط الخاص بهذه القيمة، أو null إذا لم يكن هناك رابط أو إذا كانت هناك روابط مختلفة متعددة.

getLinkUrl(startOffset, endOffset)

تعرض هذه السمة عنوان URL للرابط الخاص بالنص من startOffset إلى endOffset. تكون الإزاحات مستندة إلى 0 ومرتبطة بنص الخلية، مع تضمين إزاحة البداية واستبعاد إزاحة النهاية.

المعلمات

الاسمالنوعالوصف
startOffsetIntegerإزاحة البداية
endOffsetIntegerإزاحة النهاية

الإرجاع

String|null: عنوان URL للرابط الخاص بهذه القيمة، أو null إذا لم يكن هناك رابط أو إذا كانت هناك روابط متعددة مختلفة في النطاق المحدّد.

getRuns()

تعرض هذه السمة سلسلة Rich Text مقسّمة إلى مصفوفة من عمليات التشغيل، حيث تكون كل عملية تشغيل هي أطول سلسلة فرعية ممكنة لها نمط نصي متسق.

الإرجاع

RichTextValue[]: مصفوفة من عمليات التشغيل.

getStartIndex()

تعرض هذه الدالة فهرس بداية هذه القيمة في الخلية.

الإرجاع

Integer: فهرس بداية هذه القيمة في الخلية.

getText()

تعرض هذه السمة نص القيمة.

الإرجاع

String: نص هذه القيمة.

getTextStyle()

تعرض هذه السمة نمط النص لهذه القيمة.

الإرجاع

TextStyle: نمط النص لهذه القيمة.

getTextStyle(startOffset, endOffset)

تعرض هذه السمة نمط النص من startOffset إلى endOffset. تكون الإزاحات مستندة إلى 0 ومرتبطة بنص الخلية، مع تضمين إزاحة البداية واستبعاد إزاحة النهاية.

المعلمات

الاسمالنوعالوصف
startOffsetIntegerإزاحة البداية
endOffsetIntegerإزاحة النهاية

الإرجاع

TextStyle: نمط النص الخاص بالسلسلة الفرعية المحدّدة من هذه القيمة.