Class Slicer

Công cụ cắt

Biểu thị một bộ cắt. Bộ cắt này được dùng để lọc các dải ô, biểu đồ và bảng tổng hợp theo cách không cộng tác. Lớp này chứa các phương thức để truy cập và sửa đổi các bộ cắt hiện có. Để tạo một bộ chọn mới, hãy sử dụng Sheet.insertSlicer(range, anchorRowPos, anchorColPos).

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
getBackgroundColorObject()Color|nullTrả về nền Color của bộ chọn lát cắt.
getColumnPosition()Integer|nullTrả về vị trí cột (tương ứng với dải ô dữ liệu của bộ lọc) mà bộ lọc được áp dụng trong bộ lọc, hoặc null nếu vị trí cột chưa được đặt.
getContainerInfo()ContainerInfoLấy thông tin về vị trí của bộ chọn trên trang tính.
getFilterCriteria()FilterCriteria|nullTrả về tiêu chí lọc của bộ cắt hoặc null nếu tiêu chí lọc chưa được đặt.
getRange()RangeLấy phạm vi dữ liệu mà bộ cắt được áp dụng.
getTitle()StringTrả về tiêu đề của bộ chọn.
getTitleHorizontalAlignment()StringLấy chế độ căn chỉnh ngang của tiêu đề.
getTitleTextStyle()TextStyleTrả về kiểu văn bản của tiêu đề bộ chọn.
isAppliedToPivotTables()BooleanTrả về liệu bộ chọn được chỉ định có được áp dụng cho bảng tổng hợp hay không.
remove()voidXoá bộ cắt.
setApplyToPivotTables(applyToPivotTables)SlicerĐặt xem có nên áp dụng bộ cắt đã cho vào bảng tổng hợp trong trang tính hay không.
setBackgroundColor(color)SlicerĐặt màu nền của bộ cắt.
setBackgroundColorObject(color)SlicerĐặt Color nền của bộ chọn lát.
setColumnFilterCriteria(columnPosition, filterCriteria)SlicerĐặt chỉ mục cột và tiêu chí lọc của bộ cắt.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)SlicerĐặt vị trí mà bộ chọn lát sẽ xuất hiện trên trang tính.
setRange(rangeApi)SlicerĐặt phạm vi dữ liệu mà bộ chọn lát sẽ được áp dụng.
setTitle(title)SlicerĐặt tiêu đề của bộ chọn.
setTitleHorizontalAlignment(horizontalAlignment)SlicerĐặt chế độ căn chỉnh ngang của tiêu đề trong bộ chọn.
setTitleTextStyle(textStyle)SlicerĐặt kiểu văn bản của bộ chọn.

Tài liệu chi tiết

getBackgroundColorObject()

Trả về nền Color của bộ chọn lát cắt.

Cầu thủ trả bóng

Color|null – Màu nền của bộ chọn này. Trả về null nếu không có màu nào được đặt.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getColumnPosition()

Trả về vị trí cột (tương ứng với dải ô dữ liệu của bộ lọc) mà bộ lọc được áp dụng trong bộ lọc, hoặc null nếu vị trí cột chưa được đặt. Đây phải là vị trí được lập chỉ mục từ 1 của cột, tương tự như bộ lọc.

Cầu thủ trả bóng

Integer|null – Vị trí cột của bộ cắt này.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getContainerInfo()

Lấy thông tin về vị trí của bộ chọn trên trang tính.

Cầu thủ trả bóng

ContainerInfo – Một đối tượng chứa vị trí vùng chứa của bộ cắt.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getFilterCriteria()

Trả về tiêu chí lọc của bộ cắt hoặc null nếu tiêu chí lọc chưa được đặt.

Cầu thủ trả bóng

FilterCriteria|null – Tiêu chí lọc của bộ cắt này.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getRange()

Lấy phạm vi dữ liệu mà bộ cắt được áp dụng.

Cầu thủ trả bóng

Range – Dải ô của bộ cắt.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getTitle()

Trả về tiêu đề của bộ chọn.

Cầu thủ trả bóng

String – Bộ phân chia này, để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getTitleHorizontalAlignment()

Lấy chế độ căn chỉnh ngang của tiêu đề.

Cầu thủ trả bóng

String – Chế độ căn chỉnh ngang của tiêu đề bộ chọn này.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getTitleTextStyle()

Trả về kiểu văn bản của tiêu đề bộ chọn.

Cầu thủ trả bóng

TextStyle – Kiểu văn bản của tiêu đề bộ chọn này.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

isAppliedToPivotTables()

Trả về liệu bộ chọn được chỉ định có được áp dụng cho bảng tổng hợp hay không.

Cầu thủ trả bóng

Booleantrue nếu bộ cắt này được áp dụng cho bảng tổng hợp, nếu không thì false.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

remove()

Xoá bộ cắt.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setApplyToPivotTables(applyToPivotTables)

Đặt xem có nên áp dụng bộ cắt đã cho vào bảng tổng hợp trong trang tính hay không.

Thông số

TênLoạiMô tả
applyToPivotTablesBooleanChỉ định xem bộ chọn này có áp dụng cho bảng tổng hợp hay không.

Cầu thủ trả bóng

Slicer – Bộ phân chia này, để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setBackgroundColor(color)

Đặt màu nền của bộ cắt. Giá trị null sẽ đặt lại màu nền.

Thông số

TênLoạiMô tả
colorStringMàu nền mới của bộ chọn này theo ký hiệu CSS (chẳng hạn như "#ffffff").

Cầu thủ trả bóng

Slicer – Bộ phân chia này, để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setBackgroundColorObject(color)

Đặt Color nền của bộ chọn lát. Giá trị null sẽ đặt lại màu nền.

Thông số

TênLoạiMô tả
colorColorMàu nền mới của bộ chọn lát này.

Cầu thủ trả bóng

Slicer – Bộ phân chia này, để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setColumnFilterCriteria(columnPosition, filterCriteria)

Đặt chỉ mục cột và tiêu chí lọc của bộ cắt. Giá trị null sẽ đặt lại bộ lọc của slicer.

Thông số

TênLoạiMô tả
columnPositionIntegerVị trí cột mới của bộ chọn này.
filterCriteriaFilterCriteriaTiêu chí lọc mới của bộ cắt này.

Cầu thủ trả bóng

Slicer – Bộ phân chia này, để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

Đặt vị trí mà bộ chọn lát sẽ xuất hiện trên trang tính. Chỉ mục vị trí hàng và cột của ô neo được lập chỉ mục từ 1.

Thông số

TênLoạiMô tả
anchorRowPosIntegerPhía trên của bộ chọn lát được cố định trong hàng này.
anchorColPosIntegerMặt trên của bộ lọc được cố định trong cột này.
offsetXIntegerĐộ lệch ngang so với góc ô, tính bằng pixel.
offsetYIntegerĐộ lệch dọc so với góc ô, tính bằng pixel.

Cầu thủ trả bóng

Slicer – Bộ phân chia này, để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setRange(rangeApi)

Đặt phạm vi dữ liệu mà bộ chọn lát sẽ được áp dụng.

Thông số

TênLoạiMô tả
rangeApiRangePhạm vi mới cho bộ chọn này.

Cầu thủ trả bóng

Slicer – Bộ phân chia này, để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTitle(title)

Đặt tiêu đề của bộ chọn. Tiêu đề trống sẽ đặt lại tiêu đề về giá trị mặc định.

Thông số

TênLoạiMô tả
titleStringTiêu đề mới của bộ chọn lát này.

Cầu thủ trả bóng

Slicer – Bộ phân chia này, để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTitleHorizontalAlignment(horizontalAlignment)

Đặt chế độ căn chỉnh ngang của tiêu đề trong bộ chọn. Giá trị null sẽ đặt lại chế độ căn chỉnh.

Thông số

TênLoạiMô tả
horizontalAlignmentStringCăn chỉnh ngang mới của tiêu đề của bộ chọn này.

Cầu thủ trả bóng

Slicer – Bộ phân chia này, để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTitleTextStyle(textStyle)

Đặt kiểu văn bản của bộ chọn.

Thông số

TênLoạiMô tả
textStyleTextStyleKiểu văn bản mới của tiêu đề bộ chọn.

Cầu thủ trả bóng

Slicer – Bộ phân chia này, để liên kết.

Ủy quyền

Các tập lệnh sử dụng phương thức này cần được uỷ quyền bằng một hoặc nhiều phạm vi sau đây:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

Các phương thức ngừng hoạt động