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