提供意見
Class Slicer
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
內容詳盡的說明文件
getBackgroundColorObject()
傳回篩選器控制項的背景 Color
。
回攻員
Color
— 這個篩選器控制項的背景顏色。如果沒有設定顏色,則傳回 null
。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
getColumnPosition()
傳回在篩選器器中套用篩選器的資料欄位置 (相對於篩選器器的資料範圍);如未設定資料欄位置,會傳回 null
。這個位置應為資料欄的 1 索引位置,類似於篩選器。
回攻員
Integer
— 這個篩選器控制項的資料欄位置。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
getContainerInfo()
取得篩選器控制項在工作表中的位置相關資訊。
回攻員
ContainerInfo
:包含篩選器控制項容器位置的物件。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
getFilterCriteria()
傳回篩選器控制項的篩選條件;如未設定篩選條件,則傳回 null
。
回攻員
FilterCriteria
:這個篩選器控制項的篩選條件。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
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
getTitle()
傳回篩選器控制項的標題。
回攻員
String
— 這個篩選器控制項,用於鏈結。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
getTitleHorizontalAlignment()
取得標題的水平對齊方式。
回攻員
String
:這個篩選器控制項標題的水平對齊方式。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
getTitleTextStyle()
傳回篩選器控制項標題的文字樣式。
回攻員
TextStyle
— 這個篩選器控制項標題的文字樣式。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
isAppliedToPivotTables()
傳回是否要將指定的篩選器控制項套用至資料透視表。
回攻員
Boolean
— 如果這個篩選器控制項套用至資料透視表,則設為 true
,否則為 false
。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
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
setApplyToPivotTables(applyToPivotTables)
設定是否要將指定篩選器控制項套用至工作表中的資料透視表。
參數
名稱 類型 說明
applyToPivotTables
Boolean
指定是否要將這個篩選器控制項套用至資料透視表。
回攻員
Slicer
— 這個篩選器控制項,用於鏈結。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setBackgroundColor(color)
設定篩選器控制項的背景顏色。null
值會重設背景顏色。
參數
名稱 類型 說明
color
String
這個篩選器控制項在 CSS 標記法 (例如「#ffffff」) 中的新背景顏色。
回攻員
Slicer
— 這個篩選器控制項,用於鏈結。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setBackgroundColorObject(color)
設定篩選器控制項的背景 Color
。null
值會重設背景顏色。
參數
名稱 類型 說明
color
Color
這個篩選器控制項的新背景顏色。
回攻員
Slicer
— 這個篩選器控制項,用於鏈結。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setColumnFilterCriteria(columnPosition, filterCriteria)
設定篩選器控制項的欄索引和篩選條件。null
值會重設篩選器控制項篩選器。
參數
名稱 類型 說明
columnPosition
Integer
這個篩選器控制項的新資料欄位置。
filterCriteria
FilterCriteria
這個篩選器控制項的新篩選條件。
回攻員
Slicer
— 這個篩選器控制項,用於鏈結。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)
設定篩選器控制項在工作表上的顯示位置。錨定列和欄位置索引會編入索引。
參數
名稱 類型 說明
anchorRowPos
Integer
篩選器控制項的頂端會固定在這個列中。
anchorColPos
Integer
在這個顏色中,篩選器控制項的頂部會固定於該欄。
offsetX
Integer
與儲存格角落的水平偏移 (以像素為單位)。
offsetY
Integer
與儲存格角落的垂直偏移 (以像素為單位)。
回攻員
Slicer
— 這個篩選器控制項,用於鏈結。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setRange(rangeApi)
設定要套用篩選器控制項的資料範圍。
參數
名稱 類型 說明
rangeApi
Range
這個篩選器控制項的新範圍。
回攻員
Slicer
— 這個篩選器控制項,用於鏈結。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setTitle(title)
設定篩選器控制項的標題。如果標題空白,系統會將標題重設為預設值。
參數
名稱 類型 說明
title
String
這個篩選器控制項的新標題。
回攻員
Slicer
— 這個篩選器控制項,用於鏈結。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setTitleHorizontalAlignment(horizontalAlignment)
設定篩選器控制項中標題的水平對齊方式。null
值會重設對齊。
參數
名稱 類型 說明
horizontalAlignment
String
這個篩選器控制項標題的新水平對齊方式。
回攻員
Slicer
— 這個篩選器控制項,用於鏈結。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
setTitleTextStyle(textStyle)
設定篩選器控制項的文字樣式。
參數
回攻員
Slicer
— 這個篩選器控制項,用於鏈結。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
已淘汰的方法
getBackgroundColor()
已淘汰。 替換為 getBackgroundColorObject()
傳回 CSS 標記法 (例如「#ffffff'」) 的篩選器控制項背景顏色。
回攻員
String
— 這個篩選器控制項的背景顏色。如果沒有設定顏色,則傳回 null
。
授權
使用這個方法的指令碼必須取得以下一或多個範圍 的授權:
https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets
提供意見
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權 ,程式碼範例則為阿帕契 2.0 授權 。詳情請參閱《Google Developers 網站政策 》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2023-12-01 (世界標準時間)。
想進一步說明嗎?
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2023-12-01 (世界標準時間)。"],[[["The `Slicer` class allows you to programmatically control slicers in Google Sheets, enabling you to filter data in ranges, charts, and pivot tables without collaboration."],["You can access and modify existing slicers or create new ones using the provided methods, such as setting the data range, background color, title, and position."],["The `Slicer` class offers various methods for customizing the slicer's appearance, including setting the background color, title alignment, and text style."],["To use the `Slicer` class effectively, you will need to authorize your script with the necessary scopes to access and modify spreadsheet data."],["Several methods are available for interacting with the slicer's filter criteria, allowing you to retrieve, set, and manipulate the filtering conditions applied to the data."]]],[]]