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 - HEX 颜色，如果未设置颜色，则为 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