Class ListStyle
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
详细文档
applyListPreset(listPreset)
将指定的 ListPreset 应用于与文本重叠的所有段落。
每个段落的嵌套级别取决于每个段落前面的制表符数量。为避免字符和相应段落之间出现多余的空格，此方法会移除这些前导制表符。
如果要更新的段落前面的段落位于具有匹配列表预设的 List 中，并且要更新的段落尚未位于其他列表中，则系统会将要更新的段落添加到该前面的列表中。
参数
返回
ListStyle
授权
使用此方法的脚本需要获得以下一个或多个范围的授权：
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getGlyph()
返回文本的渲染字形。如果文本跨多个段落或不在列表中，则返回 null。
返回
String
授权
使用此方法的脚本需要获得以下一个或多个范围的授权：
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getList()
返回文本所在的 List；如果文本均不属于任何列表，或者文本的一部分属于某个列表，或者文本属于多个列表，则返回 null。调用 isInList() 以确定文本是否在列表中。
返回
List
授权
使用此方法的脚本需要获得以下一个或多个范围的授权：
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
getNestingLevel()
返回文本的嵌套级别（从 0 开始）。如果文本不在列表中或存在混合值，则返回 null。
返回
Integer
授权
使用此方法的脚本需要获得以下一个或多个范围的授权：
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
isInList()
如果文本只在一个列表中，则返回 true；如果文本不在任何列表中，则返回 false；如果只有部分文本在列表中，或者文本在多个列表中，则返回 null。
返回
Boolean
授权
使用此方法的脚本需要获得以下一个或多个范围的授权：
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
removeFromList()
从任何列表中移除与文本重叠的段落。
通过在相应段落的开头添加缩进，可在视觉上保留每个段落的嵌套级别。
返回
ListStyle
授权
使用此方法的脚本需要获得以下一个或多个范围的授权：
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-07-26。
[null,null,["最后更新时间 (UTC)：2025-07-26。"],[[["\u003cp\u003e\u003ccode\u003eListStyle\u003c/code\u003e encompasses methods to manipulate the styling and structure of lists within text ranges in Google Slides.\u003c/p\u003e\n"],["\u003cp\u003eIt provides functionalities to apply list presets, determine nesting levels, and check if text resides within a list.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve the rendered glyph or the associated \u003ccode\u003eList\u003c/code\u003e object for further manipulation.\u003c/p\u003e\n"],["\u003cp\u003eMethods are available to remove text from lists while preserving visual indentation.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization with specific scopes is required to utilize these methods in your scripts.\u003c/p\u003e\n"]]],["The `ListStyle` object manages text list formatting. Key actions include: applying a `ListPreset` to paragraphs, which also adjusts nesting levels by removing leading tabs; retrieving the rendered glyph, the associated `List` object, or the nesting level. It can also check if the text is within a list, and remove text from any existing list. Additionally, removing text from a list visually preserves nesting through indenting. Each method requires specific authorization scopes.\n"],null,["# Class ListStyle\n\nListStyle\n\nThe list styling for a range of text. \n\n### Methods\n\n| Method | Return type | Brief description |\n|-------------------------------------------------------------|--------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [applyListPreset(listPreset)](#applyListPreset(ListPreset)) | [ListStyle](#) | Applies the specified [ListPreset](/apps-script/reference/slides/list-preset) to all of the paragraphs that overlap with the text. |\n| [getGlyph()](#getGlyph()) | `String` | Returns the rendered glyph for the text. |\n| [getList()](#getList()) | [List](/apps-script/reference/slides/list) | Returns the [List](/apps-script/reference/slides/list) the text is in, or `null` if none of the text is in a list, or part of the text is in a list, or the text is in multiple lists. |\n| [getNestingLevel()](#getNestingLevel()) | `Integer` | Returns the 0-based nesting level of the text. |\n| [isInList()](#isInList()) | `Boolean` | Returns `true` if the text is in exactly one list, `false` if none of the text is in a list, and `null` if only some of the text is in a list or if the text is in multiple lists. |\n| [removeFromList()](#removeFromList()) | [ListStyle](#) | Removes the paragraphs that overlap with the text from any lists. |\n\nDetailed documentation\n----------------------\n\n### `apply``List``Preset(listPreset)`\n\nApplies the specified [ListPreset](/apps-script/reference/slides/list-preset) to all of the paragraphs that overlap with the text.\n\nThe nesting level of each paragraph is determined by counting leading tabs in front of each\nparagraph. To avoid excess space between the glyphs and the corresponding paragraph, these\nleading tabs are removed by this method.\n\nIf the paragraph immediately before paragraphs being updated is in a [List](/apps-script/reference/slides/list) with a\nmatching list preset and the paragraphs being updated are not already in a different list, the\nparagraphs being updated are added to that preceding list.\n\n#### Parameters\n\n| Name | Type | Description |\n|----------------|---------------------------------------------------------|-------------|\n| `list``Preset` | [ListPreset](/apps-script/reference/slides/list-preset) | |\n\n#### Return\n\n\n[ListStyle](#)\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `get``Glyph()`\n\nReturns the rendered glyph for the text. Returns `null` if the text spans more than one\nparagraph or the text is not in a list.\n\n#### Return\n\n\n`String`\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `get``List()`\n\nReturns the [List](/apps-script/reference/slides/list) the text is in, or `null` if none of the text is in a list, or\npart of the text is in a list, or the text is in multiple lists. Call [isInList()](#isInList()) to\ndetermine whether the text is in a list.\n\n#### Return\n\n\n[List](/apps-script/reference/slides/list)\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `get``Nesting``Level()`\n\nReturns the 0-based nesting level of the text. Returns `null` if the text is not in a\nlist or there are mixed values.\n\n#### Return\n\n\n`Integer`\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `is``In``List()`\n\nReturns `true` if the text is in exactly one list, `false` if none of the text is\nin a list, and `null` if only some of the text is in a list or if the text is in multiple\nlists.\n\n#### Return\n\n\n`Boolean`\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`\n\n*** ** * ** ***\n\n### `remove``From``List()`\n\nRemoves the paragraphs that overlap with the text from any lists.\n\nThe nesting level of each paragraph is visually preserved by adding indent to the start of\nthe corresponding paragraph.\n\n#### Return\n\n\n[ListStyle](#)\n\n#### Authorization\n\nScripts that use this method require authorization with one or more of the following [scopes](/apps-script/concepts/scopes#setting_explicit_scopes):\n\n- `https://www.googleapis.com/auth/presentations.currentonly`\n- `https://www.googleapis.com/auth/presentations`"]]
