此页面由 Cloud Translation API 翻译。

Class Banding

访问和修改条带，即应用于范围中行或列的颜色模式。每个条带由一个范围以及行、列、页眉和页脚的一组颜色组成。

方法

方法	返回类型	简介
`copyTo(range)`	`Banding`	将此条带复制到其他范围。
`getFirstColumnColorObject()`	`Color`	返回条带中的第一个交替列颜色，如果未设置颜色，则返回 `null`。
`getFirstRowColorObject()`	`Color`	返回第一个交替行颜色，如果未设置颜色，则返回 `null`。
`getFooterColumnColorObject()`	`Color`	返回条带中最后一列的颜色，如果未设置颜色，则返回 `null`。
`getFooterRowColorObject()`	`Color`	返回条带中的最后一个行颜色，如果未设置颜色，则返回 `null`。
`getHeaderColumnColorObject()`	`Color`	返回条带中第一列的颜色，如果未设置颜色，则返回 `null`。
`getHeaderRowColorObject()`	`Color`	返回标题行的颜色，如果未设置颜色，则返回 `null`。
`getRange()`	`Range`	返回此条带的范围。
`getSecondColumnColorObject()`	`Color`	返回条带中的第二个交替列颜色，如果未设置颜色，则返回 `null`。
`getSecondRowColorObject()`	`Color`	返回第二个交替行颜色，如果未设置颜色，则返回 `null`。
`remove()`	`void`	移除此条带。
`setFirstColumnColor(color)`	`Banding`	设置第一列的颜色（交替显示）。
`setFirstColumnColorObject(color)`	`Banding`	设置条带中的第一个交替列颜色。
`setFirstRowColor(color)`	`Banding`	设置交替的第一行颜色。
`setFirstRowColorObject(color)`	`Banding`	设置条带中的第一个交替行颜色。
`setFooterColumnColor(color)`	`Banding`	设置最后一列的颜色。
`setFooterColumnColorObject(color)`	`Banding`	设置条带中最后一列的颜色。
`setFooterRowColor(color)`	`Banding`	设置最后一行的颜色。
`setFooterRowColorObject(color)`	`Banding`	设置条带中页脚行的颜色。
`setHeaderColumnColor(color)`	`Banding`	设置标题列的颜色。
`setHeaderColumnColorObject(color)`	`Banding`	设置标题列的颜色。
`setHeaderRowColor(color)`	`Banding`	设置标题行的颜色。
`setHeaderRowColorObject(color)`	`Banding`	设置标题行的颜色。
`setRange(range)`	`Banding`	设置此条带的范围。
`setSecondColumnColor(color)`	`Banding`	设置交替的第二列颜色。
`setSecondColumnColorObject(color)`	`Banding`	设置条带中的第二个交替列颜色。
`setSecondRowColor(color)`	`Banding`	设置交替的第二行颜色。
`setSecondRowColorObject(color)`	`Banding`	设置条带中的第二个交替颜色。

已废弃的方法

方法	返回类型	简介
`getFirstColumnColor()`	`String`	返回第一列交替颜色，如果未设置颜色，则返回 `null`。
`getFirstRowColor()`	`String`	返回第一行交替颜色，如果未设置颜色，则返回 `null`。
`getFooterColumnColor()`	`String`	返回最后一列的颜色，如果未设置颜色，则返回 `null`。
`getFooterRowColor()`	`String`	返回最后一行的颜色，如果未设置颜色，则返回 `null`。
`getHeaderColumnColor()`	`String`	返回标题列的颜色，如果未设置颜色，则返回 `null`。
`getHeaderRowColor()`	`String`	返回标题行的颜色，如果未设置颜色，则返回 `null`。
`getSecondColumnColor()`	`String`	返回第二列颜色（交替使用），如果未设置颜色，则返回 `null`。
`getSecondRowColor()`	`String`	返回第二行颜色（交替使用），如果未设置颜色，则返回 `null`。

详细文档

`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

`getFooterColumnColorObject()`

返回条带中最后一列的颜色，如果未设置颜色，则返回 null。

弃踢回攻

Color - 频带中的最后一个列颜色，如果未设置颜色，则为 null。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFooterRowColorObject()`

返回条带中的最后一个行颜色，如果未设置颜色，则返回 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

`getHeaderRowColorObject()`

返回标题行的颜色，如果未设置颜色，则返回 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

`setFooterColumnColor(color)`

设置最后一列的颜色。

参数

名称	类型	说明
`color`	`String`	CSS 表示法的颜色代码（例如 `'#ffffff'` 或 `'white'`），或用于清除颜色的 `null`。

弃踢回攻

Banding - 此条带，用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFooterColumnColorObject(color)`

设置条带中最后一列的颜色。

参数

名称	类型	说明
`color`	`Color`	条带中最后一列的新颜色；设置为 `null` 会清除颜色。

弃踢回攻

Banding - 此条带，用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFooterRowColor(color)`

设置最后一行的颜色。

参数

名称	类型	说明
`color`	`String`	CSS 表示法的颜色代码（例如 `'#ffffff'` 或 `'white'`），或用于清除颜色的 `null`。

弃踢回攻

Banding - 此条带，用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFooterRowColorObject(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

`setHeaderRowColor(color)`

设置标题行的颜色。

参数

名称	类型	说明
`color`	`String`	CSS 表示法的颜色代码（例如 `'#ffffff'` 或 `'white'`），或用于清除颜色的 `null`。

弃踢回攻

Banding - 此条带，用于链接。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setHeaderRowColorObject(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

`getFooterColumnColor()`

已弃用。已替换为 getFooterColumnColorObject()

返回最后一列的颜色，如果未设置颜色，则返回 null。

弃踢回攻

String - 采用 CSS 表示法的颜色代码（例如 '#ffffff' 或 'white'），如果未设置颜色，则为 null。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFooterRowColor()`

已弃用。已替换为 getFooterRowColorObject()

返回最后一行的颜色，如果未设置颜色，则返回 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

`getHeaderRowColor()`

已弃用。已替换为 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