此页面由 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