发送反馈
Class Banding
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
频段
访问和修改条带,即应用于范围中行或列的颜色模式。每个条带由一个范围以及行、列、页眉和页脚的一组颜色组成。
详细文档
copyTo(range)
将此条带复制到其他范围。
参数
名称 类型 说明
range
Range
要将此条带复制到的范围。
弃踢回攻
Banding
- 新条带。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
getFirstColumnColorObject()
返回条带中的第一个交替列颜色,如果未设置颜色,则返回 null
。
弃踢回攻
Color
- 频带中的第一个交替列颜色,如果未设置颜色,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
getFirstRowColorObject()
返回第一个交替行颜色,如果未设置颜色,则返回 null
。
弃踢回攻
Color
- 频带中的第一个交替行颜色,如果未设置颜色,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
getHeaderColumnColorObject()
返回条带中第一列的颜色,如果未设置颜色,则返回 null
。
弃踢回攻
Color
- 条带中第一列的颜色,如果未设置颜色,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
getRange()
返回此条带的范围。
弃踢回攻
Range
- 此条带的范围。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
getSecondColumnColorObject()
返回条带中的第二个交替列颜色,如果未设置颜色,则返回 null
。
弃踢回攻
Color
- 频带中的第二个交替列颜色,如果未设置颜色,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
getSecondRowColorObject()
返回第二个交替行颜色,如果未设置颜色,则返回 null
。
弃踢回攻
Color
- 频带中的第二个交替行颜色,如果未设置颜色,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
remove()
移除此条带。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setFirstColumnColor(color)
设置第一列的颜色(交替显示)。
参数
名称 类型 说明
color
String
CSS 表示法的颜色代码(例如 '#ffffff'
或 'white'
),或用于清除颜色的 null
。
弃踢回攻
Banding
- 此条带,用于链接。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setFirstColumnColorObject(color)
设置条带中的第一个交替列颜色。
参数
名称 类型 说明
color
Color
条带中新的第一个交替列颜色;设置为 null
会清除颜色。
弃踢回攻
Banding
- 此条带,用于链接。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setFirstRowColor(color)
设置交替的第一行颜色。
参数
名称 类型 说明
color
String
CSS 表示法的颜色代码(例如 '#ffffff'
或 'white'
),或用于清除颜色的 null
。
弃踢回攻
Banding
- 此条带,用于链接。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setFirstRowColorObject(color)
设置条带中的第一个交替行颜色。
参数
名称 类型 说明
color
Color
条带中新的第一个交替颜色;设置为 null
会清除颜色。
弃踢回攻
Banding
- 此条带,用于链接。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setHeaderColumnColor(color)
设置标题列的颜色。
参数
名称 类型 说明
color
String
CSS 表示法的颜色代码(例如 '#ffffff'
或 'white'
),或用于清除颜色的 null
。
弃踢回攻
Banding
- 此条带,用于链接。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setHeaderColumnColorObject(color)
设置标题列的颜色。
参数
名称 类型 说明
color
Color
新的标题列颜色;设置为 null
会清除该颜色。
弃踢回攻
Banding
- 此条带,用于链接。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setRange(range)
设置此条带的范围。
参数
名称 类型 说明
range
Range
此条带的新范围。
弃踢回攻
Banding
- 此条带,用于链接。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setSecondColumnColor(color)
设置交替的第二列颜色。
参数
名称 类型 说明
color
String
CSS 表示法的颜色代码(例如 '#ffffff'
或 'white'
),或用于清除颜色的 null
。
弃踢回攻
Banding
- 此条带,用于链接。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setSecondColumnColorObject(color)
设置条带中的第二个交替列颜色。
参数
名称 类型 说明
color
Color
条带中新的第二个交替列颜色;设置为 null
会清除颜色。
弃踢回攻
Banding
- 此条带,用于链接。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setSecondRowColor(color)
设置交替的第二行颜色。
参数
名称 类型 说明
color
String
CSS 表示法的颜色代码(例如 '#ffffff'
或 'white'
),或用于清除颜色的 null
。
弃踢回攻
Banding
- 此条带,用于链接。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setSecondRowColorObject(color)
设置条带中的第二个交替颜色。
参数
名称 类型 说明
color
Color
条带中新的第二个交替颜色;设置为 null
会清除颜色。
弃踢回攻
Banding
- 此条带,用于链接。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
已废弃的方法
getFirstColumnColor()
已弃用 。已替换为 getFirstColumnColorObject()
返回第一列交替颜色,如果未设置颜色,则返回 null
。
弃踢回攻
String
- 采用 CSS 表示法的颜色代码(例如 '#ffffff'
或 'white'
),如果未设置颜色,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
getFirstRowColor()
已弃用 。已替换为 getFirstRowColorObject()
返回第一行交替颜色,如果未设置颜色,则返回 null
。
弃踢回攻
String
- 采用 CSS 表示法的颜色代码(例如 '#ffffff'
或 'white'
),如果未设置颜色,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
getHeaderColumnColor()
已弃用 。已替换为 getHeaderColumnColorObject()
返回标题列的颜色,如果未设置颜色,则返回 null
。
弃踢回攻
String
- 采用 CSS 表示法的颜色代码(例如 '#ffffff'
或 'white'
),如果未设置颜色,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
已弃用 。已替换为 getHeaderRowColorObject()
返回标题行的颜色,如果未设置颜色,则返回 null
。
弃踢回攻
String
- 采用 CSS 表示法的颜色代码(例如 '#ffffff'
或 'white'
),如果未设置颜色,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
getSecondColumnColor()
已弃用 。已替换为 getSecondColumnColorObject()
返回第二列颜色(交替使用),如果未设置颜色,则返回 null
。
弃踢回攻
String
- 十六进制颜色或 null
(如果未设置颜色)。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
getSecondRowColor()
已弃用 。已替换为 getSecondRowColorObject()
返回第二行颜色(交替使用),如果未设置颜色,则返回 null
。
弃踢回攻
String
- 采用 CSS 表示法的颜色代码(例如 '#ffffff'
或 'white'
),如果未设置颜色,则为 null
。
授权
使用此方法的脚本需要获得以下一个或多个范围 的授权:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
发送反馈
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可 获得了许可,并且代码示例已根据 Apache 2.0 许可 获得了许可。有关详情,请参阅 Google 开发者网站政策 。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2023-12-02。
需要向我们提供更多信息?
[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["没有我需要的信息","missingTheInformationINeed","thumb-down"],["太复杂/步骤太多","tooComplicatedTooManySteps","thumb-down"],["内容需要更新","outOfDate","thumb-down"],["翻译问题","translationIssue","thumb-down"],["示例/代码问题","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2023-12-02。"],[[["The `Banding` class in Google Apps Script controls color banding for rows or columns within a Google Sheet range."],["It provides methods for setting colors of alternating rows/columns, headers, and footers using color codes or `Color` objects."],["You can manage the range associated with the banding, including copying it to a new range or removing it entirely."],["Several methods returning color values as strings are deprecated; use the corresponding `Color` object methods instead."],["All methods require authorization with specific scopes to access and modify the spreadsheet's banding."]]],[]]