Class TextStyle
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
TextStil
Der gerenderte Stil des Texts in einer Zelle.
Textstile können eine entsprechende RichTextValue
haben. Wenn RichTextValue
mehrere Textabläufe umfasst, die für eine bestimmte Lesemethode für den Textstil unterschiedliche Werte haben, gibt die Methode null
zurück. Um dies zu vermeiden, sollten Sie Textstile anhand der von der Methode RichTextValue.getRuns()
zurückgegebenen Rich-Text-Werte abfragen.
Detaillierte Dokumentation
copy()
Erstellt einen Textstil-Builder, der mit den Werten dieses Textstils initialisiert wird.
Rückflug
TextStyleBuilder
– ein Builder aus diesem Textstil.
getFontFamily()
Ruft die Schriftfamilie des Texts ab. Gibt null
zurück, wenn die Schriftfamilie nicht festgelegt ist oder die entsprechende RichTextValue
mehrere Läufe mit unterschiedlichen Schriftfamilien enthält.
Rückflug
String
: Die Schriftfamilie des Texts (z. B. „Arial“) oder null
.
getFontSize()
Ruft die Schriftgröße des Texts in Punkten ab. Gibt null
zurück, wenn die Schriftgröße nicht festgelegt ist oder die entsprechende RichTextValue
mehrere Durchläufe mit unterschiedlichen Schriftgrößen hat.
Rückflug
Integer
: Schriftgröße des Texts oder null
.
getForegroundColorObject()
Ruft die Schriftfarbe des Texts ab. Gibt null
zurück, wenn die Schriftfarbe nicht festgelegt ist oder die entsprechende RichTextValue
mehrere Durchläufe mit unterschiedlichen Schriftfarben hat.
Rückflug
Color
: Schriftfarbe des Textes oder null
.
isBold()
Gibt an, ob der Text fett formatiert ist. Gibt null
zurück, wenn „fett“ nicht festgelegt ist oder die entsprechende RichTextValue
mehrere Durchläufe mit unterschiedlichen Fettdruckeinstellungen hat.
Rückflug
Boolean
: Gibt an, ob die Zelle fett formatiert ist (Boolean
) oder nicht.null
isItalic()
Gibt an, ob die Schrift in der Zelle kursiv ist. Gibt null
zurück, wenn „kursiv“ nicht festgelegt ist oder die entsprechende RichTextValue
mehrere Segmente mit unterschiedlichen Einstellungen für Kursivschrift hat.
Rückflug
Boolean
: Gibt an, ob die Zelle kursiv formatiert ist, oder null
.
isStrikethrough()
Gibt an, ob die Zelle durchgestrichen ist. Gibt null
zurück, wenn die Durchstreichung nicht festgelegt ist oder die entsprechende RichTextValue
mehrere Durchläufe mit unterschiedlichen Durchstreichungseinstellungen hat.
Rückflug
Boolean
: Gibt an, ob die Zelle durchgestrichen ist, oder null
.
isUnderline()
Gibt an, ob die Zelle unterstrichen ist. Gibt null
zurück, wenn „unterstreichen“ nicht festgelegt ist oder die entsprechende RichTextValue
mehrere Segmente mit unterschiedlichen Unterstreichungseinstellungen hat.
Rückflug
Boolean
: Gibt an, ob die Zelle unterstrichen ist, oder null
.
Eingestellte Methoden
getForegroundColor()
Veraltet. Ersetzt durch getForegroundColorObject()
Ruft die Schriftfarbe des Texts ab. Gibt null
zurück, wenn die Schriftfarbe nicht festgelegt ist oder die entsprechende RichTextValue
mehrere Durchläufe mit unterschiedlichen Schriftfarben hat.
Rückflug
String
: Schriftfarbe des Texts als Hexadezimal-CSS-Wert (z. B. „#ff0000“) oder null
.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-26 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\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`."]]