Class TextStyle
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
سبک متن سبک رندر شده متن در یک سلول.
سبک‌های متن می‌توانند دارای Rich Text Value متناظر باشند. اگر Rich Text Value شامل چندین اجرای متنی باشد که مقادیر متفاوتی برای یک روش خواندنی سبک متن خاص دارند، متد null برمی‌گرداند. برای جلوگیری از این امر، با استفاده از مقادیر Rich Text که توسط روش Rich Text Value.getRuns() بازگردانده شده است، استایل های متن را جستجو کنید.
مستندات دقیق
copy()
یک سازنده سبک متن ایجاد می کند که با مقادیر این سبک متن مقداردهی شده است.
بازگشت
Text Style Builder - سازنده ای از این سبک متن.
get Font Family()
خانواده فونت متن را دریافت می کند. اگر خانواده فونت تنظیم نشده باشد یا Rich Text Value متناظر دارای چندین اجرا با خانواده فونت‌های مختلف باشد، null برمی‌گرداند.
بازگشت
String - خانواده فونت متن (به عنوان مثال، "Arial") یا null .
get Font Size()
اندازه فونت متن را بر حسب امتیاز می گیرد. اگر اندازه قلم تنظیم نشده باشد یا Rich Text Value متناظر دارای چندین اجرا با اندازه فونت های مختلف باشد، null برمی گرداند.
بازگشت
Integer - اندازه فونت متن یا null .
get Foreground Color Object()
رنگ فونت متن را دریافت می کند. اگر رنگ فونت تنظیم نشده باشد یا Rich Text Value متناظر دارای چندین اجرا با رنگ فونت های مختلف باشد، null برمی گرداند.
بازگشت
Color - رنگ فونت متن یا null .
is Bold()
متوجه می شود که آیا متن پررنگ است یا نه. اگر پررنگ تنظیم نشده باشد یا Rich Text Value متناظر دارای چندین اجرا با تنظیمات پررنگ متفاوت باشد null برمی‌گرداند.
بازگشت
Boolean - چه سلول پررنگ باشد یا null .
is Italic()
ایتالیک بودن یا نبودن سلول را مشخص می کند. اگر ایتالیک تنظیم نشده باشد یا Rich Text Value متناظر دارای چندین اجرا با تنظیمات کج متفاوت باشد، null برمی‌گرداند.
بازگشت
Boolean - این که آیا سلول مورب است یا null .
is Strikethrough()
متوجه می شود که سلول دارای خط عبور است یا خیر. اگر خط خطی تنظیم نشده باشد یا Rich Text Value متناظر دارای چندین اجرا با تنظیمات خط‌مشی مختلف باشد null می‌شود.
بازگشت
Boolean - آیا سلول خط خطی یا null دارد یا خیر.
is Underline()
نشان می دهد که آیا سلول زیر خط کشیده شده است یا خیر. اگر زیرخط تنظیم نشده باشد یا Rich Text Value متناظر دارای چندین اجرا با تنظیمات زیرخط متفاوت باشد null برمی‌گرداند.
بازگشت
Boolean - اینکه آیا سلول زیر خط کشیده شده باشد یا null .
روش های منسوخ شده
get Foreground Color()
منسوخ شده است. با get Foreground Color Object() جایگزین شد
رنگ فونت متن را دریافت می کند. اگر رنگ فونت تنظیم نشده باشد یا Rich Text Value متناظر دارای چندین اجرا با رنگ فونت های مختلف باشد، null برمی گرداند.
بازگشت
String - رنگ فونت متن به عنوان یک مقدار CSS هگزا (به عنوان مثال، "#ff0000") یا null .
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003e\u003ccode\u003eTextStyle\u003c/code\u003e defines the rendered style of text within a cell in Google Sheets, encompassing attributes like font family, size, color, and formatting.\u003c/p\u003e\n"],["\u003cp\u003eIt can be linked to a \u003ccode\u003eRichTextValue\u003c/code\u003e for more complex formatting but may return \u003ccode\u003enull\u003c/code\u003e for style properties if the \u003ccode\u003eRichTextValue\u003c/code\u003e has multiple runs with differing styles.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use methods like \u003ccode\u003egetFontFamily()\u003c/code\u003e, \u003ccode\u003egetFontSize()\u003c/code\u003e, \u003ccode\u003eisBold()\u003c/code\u003e, etc., to retrieve specific style attributes of the text.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003eTextStyleBuilder\u003c/code\u003e can be created using the \u003ccode\u003ecopy()\u003c/code\u003e method to facilitate the construction of new text styles based on existing ones.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egetForegroundColor()\u003c/code\u003e method is deprecated and should be replaced with \u003ccode\u003egetForegroundColorObject()\u003c/code\u003e to retrieve the font color as a \u003ccode\u003eColor\u003c/code\u003e object.\u003c/p\u003e\n"]]],["TextStyle defines the visual styling of text within a cell. It interacts with RichTextValue, which handles text segments with varied styles. Core actions include: `copy()` which creates a new TextStyleBuilder with the current style, and getter methods such as `getFontFamily()`, `getFontSize()`, `getForegroundColorObject()`, `isBold()`, `isItalic()`, `isStrikethrough()`, and `isUnderline()`, that each retrieve a specific text style property. Most getter methods may return `null` if the property is not set or varies within a RichTextValue.\n"],null,["# Class TextStyle\n\nTextStyle\n\nThe rendered style of text in a cell.\n\nText styles can have a corresponding [RichTextValue](/apps-script/reference/spreadsheet/rich-text-value). If the [RichTextValue](/apps-script/reference/spreadsheet/rich-text-value) spans multiple text runs that have different values for a given text style read\nmethod, the method returns `null`. To avoid this, query for text styles using the Rich Text\nvalues returned by the [RichTextValue.getRuns()](/apps-script/reference/spreadsheet/rich-text-value#getRuns()) method. \n\n### Methods\n\n| Method | Return type | Brief description |\n|-----------------------------------------------------------|---------------------------------------------------------------------------|------------------------------------------------------------------------------|\n| [copy()](#copy()) | [TextStyleBuilder](/apps-script/reference/spreadsheet/text-style-builder) | Creates a text style builder initialized with the values of this text style. |\n| [getFontFamily()](#getFontFamily()) | `String` | Gets the font family of the text. |\n| [getFontSize()](#getFontSize()) | `Integer` | Gets the font size of the text in points. |\n| [getForegroundColorObject()](#getForegroundColorObject()) | [Color](/apps-script/reference/spreadsheet/color) | Gets the font color of the text. |\n| [isBold()](#isBold()) | `Boolean` | Gets whether or not the text is bold. |\n| [isItalic()](#isItalic()) | `Boolean` | Gets whether or not the cell is italic. |\n| [isStrikethrough()](#isStrikethrough()) | `Boolean` | Gets whether or not the cell has strikethrough. |\n| [isUnderline()](#isUnderline()) | `Boolean` | Gets whether or not the cell is underlined. |\n\n### Deprecated methods\n\n| Method | Return type | Brief description |\n|-----------------------------------------------|-------------|----------------------------------|\n| [getForegroundColor()](#getForegroundColor()) | `String` | Gets the font color of the text. |\n\nDetailed documentation\n----------------------\n\n### `copy()`\n\nCreates a text style builder initialized with the values of this text style.\n\n#### Return\n\n\n[TextStyleBuilder](/apps-script/reference/spreadsheet/text-style-builder) --- A builder from this text style.\n\n*** ** * ** ***\n\n### `get``Font``Family()`\n\nGets the font family of the text. Returns `null` if the font family isn't set or the\ncorresponding [RichTextValue](/apps-script/reference/spreadsheet/rich-text-value) has multiple runs with different font\nfamilies.\n\n#### Return\n\n\n`String` --- The font family of the text (for example, \"Arial\") or `null`.\n\n*** ** * ** ***\n\n### `get``Font``Size()`\n\nGets the font size of the text in points. Returns `null` if the font size isn't set or\nthe corresponding [RichTextValue](/apps-script/reference/spreadsheet/rich-text-value) has multiple runs with different font\nsizes.\n\n#### Return\n\n\n`Integer` --- The font size of the text or `null`.\n\n*** ** * ** ***\n\n### `get``Foreground``Color``Object()`\n\nGets the font color of the text. Returns `null` if the font color isn't set or the\ncorresponding [RichTextValue](/apps-script/reference/spreadsheet/rich-text-value) has multiple runs with different font\ncolors.\n\n#### Return\n\n\n[Color](/apps-script/reference/spreadsheet/color) --- The font color of the text or `null`.\n\n*** ** * ** ***\n\n### `is``Bold()`\n\nGets whether or not the text is bold. Returns `null` if bold isn't set or the\ncorresponding [RichTextValue](/apps-script/reference/spreadsheet/rich-text-value) has multiple runs with different bold\nsettings.\n\n#### Return\n\n\n`Boolean` --- Whether or not the cell is bold, or `null`.\n\n*** ** * ** ***\n\n### `is``Italic()`\n\nGets whether or not the cell is italic. Returns `null` if italic isn't set or the\ncorresponding [RichTextValue](/apps-script/reference/spreadsheet/rich-text-value) has multiple runs with different italic\nsettings.\n\n#### Return\n\n\n`Boolean` --- Whether or not the cell is italic, or `null`.\n\n*** ** * ** ***\n\n### `is``Strikethrough()`\n\nGets whether or not the cell has strikethrough. Returns `null` if strikethrough isn't set\nor the corresponding [RichTextValue](/apps-script/reference/spreadsheet/rich-text-value) has multiple runs with different\nstrikethrough settings.\n\n#### Return\n\n\n`Boolean` --- Whether or not the cell has strikethrough, or `null`.\n\n*** ** * ** ***\n\n### `is``Underline()`\n\nGets whether or not the cell is underlined. Returns `null` if underline isn't set or the\ncorresponding [RichTextValue](/apps-script/reference/spreadsheet/rich-text-value) has multiple runs with different underline\nsettings.\n\n#### Return\n\n\n`Boolean` --- Whether or not the cell is underlined, or `null`.\n\nDeprecated methods\n------------------\n\n### `get``Foreground``Color()`\n\n\n**Deprecated.** Replaced by [getForegroundColorObject()](#getForegroundColorObject())\n\nGets the font color of the text. Returns `null` if the font color isn't set or the\ncorresponding [RichTextValue](/apps-script/reference/spreadsheet/rich-text-value) has multiple runs with different font\ncolors.\n\n#### Return\n\n\n`String` --- The font color of the text as a hex CSS value (for example, \"#ff0000\") or `null`."]]
