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。
[null,null,["最后更新时间 (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."]]],[]]