本頁面由 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