Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Kiểuvăn bản
Kiểu văn bản được kết xuất trong một ô.
Kiểu văn bản có thể có RichTextValue tương ứng. Nếu RichTextValue trải dài trên nhiều dòng văn bản có các giá trị khác nhau cho một phương thức đọc kiểu văn bản nhất định, thì phương thức này sẽ trả về null. Để tránh điều này, hãy truy vấn kiểu văn bản bằng cách sử dụng các giá trị Văn bản đa dạng thức do phương thức RichTextValue.getRuns() trả về.
Lấy bộ phông chữ của văn bản. Trả về null nếu bạn chưa đặt bộ phông chữ hoặc RichTextValue tương ứng có nhiều lần chạy với các bộ phông chữ khác nhau.
Cầu thủ trả bóng
String – Bộ phông chữ của văn bản (ví dụ: "Arial") hoặc null.
getFontSize()
Lấy cỡ chữ của văn bản theo điểm. Trả về null nếu kích thước phông chữ không được đặt hoặc RichTextValue tương ứng có nhiều lần chạy với các kích thước phông chữ khác nhau.
Cầu thủ trả bóng
Integer – Kích thước phông chữ của văn bản hoặc null.
getForegroundColorObject()
Lấy màu phông chữ của văn bản. Trả về null nếu bạn không đặt màu phông chữ hoặc RichTextValue tương ứng có nhiều lần chạy với các màu phông chữ khác nhau.
Xem liệu văn bản có in đậm hay không. Trả về null nếu không đặt in đậm hoặc RichTextValue tương ứng có nhiều lần chạy với các chế độ cài đặt in đậm khác nhau.
Cầu thủ trả bóng
Boolean – Liệu ô có in đậm hay không hoặc null.
isItalic()
Lấy thông tin về việc ô có in nghiêng hay không. Trả về null nếu không đặt in nghiêng hoặc RichTextValue tương ứng có nhiều lần chạy với các chế độ cài đặt in nghiêng khác nhau.
Cầu thủ trả bóng
Boolean – Liệu ô có được in nghiêng hay không hoặc null.
isStrikethrough()
Lấy thông tin về việc ô có bị gạch ngang hay không. Trả về null nếu không đặt dấu gạch ngang hoặc RichTextValue tương ứng có nhiều lần chạy với các chế độ cài đặt dấu gạch ngang khác nhau.
Cầu thủ trả bóng
Boolean – Liệu ô có bị gạch ngang hay không, hoặc null.
isUnderline()
Lấy thông tin về việc ô có được gạch chân hay không. Trả về null nếu không đặt đường gạch dưới hoặc RichTextValue tương ứng có nhiều lần chạy với các chế độ cài đặt đường gạch dưới khác nhau.
Cầu thủ trả bóng
Boolean – Liệu ô có được gạch chân hay không, hoặc null.
Lấy màu phông chữ của văn bản. Trả về null nếu bạn không đặt màu phông chữ hoặc RichTextValue tương ứng có nhiều lần chạy với các màu phông chữ khác nhau.
Cầu thủ trả bóng
String – Màu phông chữ của văn bản dưới dạng giá trị CSS thập lục phân (ví dụ: "#ff0000") hoặc null.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 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`."]]
