Truy cập và sửa đổi các dải ô trong bảng tính. Dải ô có thể là một ô duy nhất trong một trang tính hoặc một nhóm các ô liền kề trong một trang tính.
Phương thức
Phương thức | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
activate() | Range | Đặt dải ô được chỉ định thành active range , với ô trên cùng bên trái trong dải ô là current cell . |
activateAsCurrentCell() | Range | Đặt ô được chỉ định làm current cell . |
addDeveloperMetadata(key) | Range | Thêm siêu dữ liệu nhà phát triển bằng khoá được chỉ định vào dải ô. |
addDeveloperMetadata(key, visibility) | Range | Thêm siêu dữ liệu nhà phát triển bằng khoá được chỉ định và chế độ hiển thị đối với phạm vi. |
addDeveloperMetadata(key, value) | Range | Thêm siêu dữ liệu nhà phát triển bằng khoá và giá trị được chỉ định vào dải ô. |
addDeveloperMetadata(key, value, visibility) | Range | Thêm siêu dữ liệu nhà phát triển bằng khoá, giá trị và chế độ hiển thị được chỉ định cho dải ô. |
applyColumnBanding() | Banding | Áp dụng giao diện dải cột mặc định cho dải ô. |
applyColumnBanding(bandingTheme) | Banding | Áp dụng giao diện dải cột được chỉ định cho dải ô. |
applyColumnBanding(bandingTheme, showHeader, showFooter) | Banding | Áp dụng giao diện dải cột đã chỉ định cho dải ô có chế độ cài đặt tiêu đề và chân trang được chỉ định. |
applyRowBanding() | Banding | Áp dụng giao diện dải hàng mặc định cho dải ô. |
applyRowBanding(bandingTheme) | Banding | Áp dụng giao diện dải hàng đã chỉ định cho dải ô. |
applyRowBanding(bandingTheme, showHeader, showFooter) | Banding | Áp dụng giao diện dải hàng đã chỉ định cho dải ô có chế độ cài đặt tiêu đề và chân trang được chỉ định. |
autoFill(destination, series) | void | Điền dữ liệu dựa trên dữ liệu trong dải ô này vào destinationRange . |
autoFillToNeighbor(series) | void | Tính toán một dải ô để điền dữ liệu mới dựa vào các ô lân cận và tự động điền giá trị mới cho dải ô đó dựa trên dữ liệu có trong dải ô này. |
breakApart() | Range | Chia nhỏ bất kỳ ô có nhiều cột nào trong dải ô thành các ô riêng lẻ. |
canEdit() | Boolean | Xác định xem người dùng có quyền chỉnh sửa mọi ô trong dải ô hay không. |
check() | Range | Thay đổi trạng thái của các hộp đánh dấu trong dải ô thành "đã đánh dấu". |
clear() | Range | Xoá phạm vi nội dung và định dạng. |
clear(options) | Range | Xoá phạm vi nội dung, định dạng, quy tắc xác thực dữ liệu và/hoặc nhận xét, như được chỉ định với các tuỳ chọn nâng cao nhất định. |
clearContent() | Range | Xoá nội dung của dải ô, giữ nguyên định dạng. |
clearDataValidations() | Range | Xoá các quy tắc xác thực dữ liệu cho dải ô. |
clearFormat() | Range | Xoá định dạng cho dải ô này. |
clearNote() | Range | Xoá ghi chú trong một hoặc nhiều ô đã cho. |
collapseGroups() | Range | Thu gọn tất cả các nhóm nằm hoàn toàn trong phạm vi. |
copyFormatToRange(gridId, column, columnEnd, row, rowEnd) | void | Sao chép định dạng của dải ô đến vị trí cụ thể. |
copyFormatToRange(sheet, column, columnEnd, row, rowEnd) | void | Sao chép định dạng của dải ô đến vị trí cụ thể. |
copyTo(destination) | void | Sao chép dữ liệu từ một dải ô sang một dải ô khác. |
copyTo(destination, copyPasteType, transposed) | void | Sao chép dữ liệu từ một dải ô sang một dải ô khác. |
copyTo(destination, options) | void | Sao chép dữ liệu từ một dải ô sang một dải ô khác. |
copyValuesToRange(gridId, column, columnEnd, row, rowEnd) | void | Sao chép nội dung của dải ô vào vị trí cụ thể. |
copyValuesToRange(sheet, column, columnEnd, row, rowEnd) | void | Sao chép nội dung của dải ô vào vị trí cụ thể. |
createDataSourcePivotTable(dataSource) | DataSourcePivotTable | Tạo một bảng tổng hợp nguồn dữ liệu trống từ nguồn dữ liệu, cố định tại ô đầu tiên trong dải ô này. |
createDataSourceTable(dataSource) | DataSourceTable | Tạo một bảng nguồn dữ liệu trống từ nguồn dữ liệu, cố định tại ô đầu tiên trong dải ô này. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Trả về DeveloperMetadataFinderApi để tìm siêu dữ liệu nhà phát triển trong phạm vi của phạm vi này. |
createFilter() | Filter | Tạo bộ lọc và áp dụng bộ lọc đó cho dải ô được chỉ định trên trang tính. |
createPivotTable(sourceData) | PivotTable | Tạo một bảng tổng hợp trống từ sourceData đã chỉ định neo tại ô đầu tiên
trong dải ô này. |
createTextFinder(findText) | TextFinder | Tạo trình tìm văn bản cho dải ô. Trình tìm kiếm này có thể tìm và thay thế văn bản trong dải ô này. |
deleteCells(shiftDimension) | void | Xoá dải ô này. |
expandGroups() | Range | Mở rộng các nhóm thu gọn có dải ô hoặc nút điều khiển giao cắt với dải ô này. |
getA1Notation() | String | Trả về chuỗi mô tả của dải ô, theo ký hiệu A1. |
getBackground() | String | Trả về màu nền của ô trên cùng bên trái trong dải ô (ví dụ: '#ffffff' ). |
getBackgroundObject() | Color | Trả về màu nền của ô trên cùng bên trái trong dải ô. |
getBackgroundObjects() | Color[][] | Trả về màu nền của các ô trong dải ô. |
getBackgrounds() | String[][] | Trả về màu nền của các ô trong dải ô (ví dụ: '#ffffff' ). |
getBandings() | Banding[] | Trả về tất cả dải được áp dụng cho ô bất kỳ trong dải ô này. |
getCell(row, column) | Range | Trả về một ô cho sẵn trong một dải ô. |
getColumn() | Integer | Trả về vị trí cột bắt đầu của dải ô này. |
getDataRegion() | Range | Trả về bản sao của dải ô được mở rộng trong bốn Direction chính để bao gồm tất cả
các ô liền kề có dữ liệu trong đó. |
getDataRegion(dimension) | Range | Trả về bản sao của dải ô đã mở rộng Direction.UP và Direction.DOWN nếu
thứ nguyên được chỉ định là Dimension.ROWS hoặc Direction.NEXT và Direction.PREVIOUS nếu thứ nguyên là Dimension.COLUMNS . |
getDataSourceFormula() | DataSourceFormula | Trả về DataSourceFormula cho ô đầu tiên trong dải ô hoặc null nếu ô không chứa công thức nguồn dữ liệu. |
getDataSourceFormulas() | DataSourceFormula[] | Trả về DataSourceFormula cho các ô trong dải ô. |
getDataSourcePivotTables() | DataSourcePivotTable[] | Lấy tất cả các bảng tổng hợp của nguồn dữ liệu giao với dải ô. |
getDataSourceTables() | DataSourceTable[] | Lấy tất cả các bảng nguồn dữ liệu giao với dải ô. |
getDataSourceUrl() | String | Trả về URL cho dữ liệu trong dải ô này, có thể được sử dụng để tạo biểu đồ và truy vấn. |
getDataTable() | DataTable | Trả về dữ liệu bên trong đối tượng này dưới dạng DataTable. |
getDataTable(firstRowIsHeader) | DataTable | Trả về dữ liệu bên trong dải ô này dưới dạng Bảng dữ liệu. |
getDataValidation() | DataValidation | Trả về quy tắc xác thực dữ liệu cho ô trên cùng bên trái trong dải ô. |
getDataValidations() | DataValidation[][] | Trả về quy tắc xác thực dữ liệu cho tất cả các ô trong dải ô. |
getDeveloperMetadata() | DeveloperMetadata[] | Lấy siêu dữ liệu nhà phát triển liên kết với dải ô này. |
getDisplayValue() | String | Trả về giá trị hiển thị của ô trên cùng bên trái trong dải ô. |
getDisplayValues() | String[][] | Trả về lưới hình chữ nhật của các giá trị cho dải ô này. |
getFilter() | Filter | Trả về bộ lọc trên trang tính chứa dải ô này hoặc null nếu không có bộ lọc nào trên trang tính. |
getFontColorObject() | Color | Trả về màu phông chữ của ô ở góc trên cùng bên trái của dải ô. |
getFontColorObjects() | Color[][] | Trả về màu phông chữ của các ô trong dải ô. |
getFontFamilies() | String[][] | Trả về họ phông chữ của các ô trong dải ô. |
getFontFamily() | String | Trả về bộ phông chữ của ô ở góc trên cùng bên trái của dải ô. |
getFontLine() | String | Lấy kiểu đường kẻ của ô ở góc trên cùng bên trái của dải ô ('underline' , 'line-through' hoặc 'none' ). |
getFontLines() | String[][] | Lấy kiểu đường kẻ của các ô trong dải ô ('underline' , 'line-through' hoặc 'none' ). |
getFontSize() | Integer | Trả về kích thước phông chữ theo kích thước điểm của ô ở góc trên cùng bên trái của dải ô. |
getFontSizes() | Integer[][] | Trả về kích thước phông chữ của các ô trong dải ô. |
getFontStyle() | String | Trả về kiểu phông chữ ('italic' hoặc 'normal' ) của ô ở góc trên cùng bên trái của dải ô. |
getFontStyles() | String[][] | Trả về kiểu phông chữ của các ô trong dải ô. |
getFontWeight() | String | Trả về độ đậm phông chữ (bình thường/đậm) của ô ở góc trên cùng bên trái của dải ô. |
getFontWeights() | String[][] | Trả về độ đậm phông chữ của các ô trong dải ô. |
getFormula() | String | Trả về công thức (ký hiệu A1) cho ô trên cùng bên trái của dải ô hoặc một chuỗi trống nếu ô trống hoặc không chứa công thức. |
getFormulaR1C1() | String | Trả về công thức (ký hiệu R1C1) của một ô nhất định hoặc null nếu không có. |
getFormulas() | String[][] | Trả về công thức (ký hiệu A1) cho các ô trong dải ô. |
getFormulasR1C1() | String[][] | Trả về công thức (ký hiệu R1C1) cho các ô trong dải ô. |
getGridId() | Integer | Trả về mã lưới của trang tính mẹ của dải ô. |
getHeight() | Integer | Trả về chiều cao của dải ô. |
getHorizontalAlignment() | String | Trả về cách căn chỉnh theo chiều ngang của văn bản (trái/giữa/phải) của ô ở góc trên cùng bên trái của dải ô. |
getHorizontalAlignments() | String[][] | Trả về cách căn chỉnh theo chiều ngang của các ô trong dải ô. |
getLastColumn() | Integer | Trả về vị trí cột kết thúc. |
getLastRow() | Integer | Trả về vị trí hàng kết thúc. |
getMergedRanges() | Range[] | Trả về một mảng các đối tượng Range đại diện cho các ô đã hợp nhất hoàn toàn nằm trong dải ô hiện tại hoặc chứa ít nhất một ô trong dải ô hiện tại. |
getNextDataCell(direction) | Range | Bắt đầu từ ô trong cột đầu tiên và hàng của dải ô, trả về ô tiếp theo theo hướng cho sẵn (là cạnh của một dải ô liền kề có dữ liệu trong đó hoặc ô ở cạnh của bảng tính theo hướng đó). |
getNote() | String | Trả về ghi chú liên kết với dải ô cho trước. |
getNotes() | String[][] | Trả về các ghi chú liên kết với các ô trong dải ô. |
getNumColumns() | Integer | Trả về số cột trong dải ô này. |
getNumRows() | Integer | Trả về số lượng hàng trong dải ô này. |
getNumberFormat() | String | Nhận định dạng số hoặc ngày của ô trên cùng bên trái của dải ô đã cho. |
getNumberFormats() | String[][] | Trả về định dạng số hoặc ngày cho các ô trong dải ô. |
getRichTextValue() | RichTextValue | Trả về giá trị Văn bản đa dạng thức cho ô trên cùng bên trái của dải ô hoặc null nếu giá trị của ô không phải là văn bản. |
getRichTextValues() | RichTextValue[][] | Trả về giá trị Văn bản đa dạng thức cho các ô trong dải ô. |
getRow() | Integer | Trả về vị trí hàng cho dải ô này. |
getRowIndex() | Integer | Trả về vị trí hàng cho dải ô này. |
getSheet() | Sheet | Trả về trang tính chứa dải ô này. |
getTextDirection() | TextDirection | Trả về hướng văn bản cho ô trên cùng bên trái của dải ô. |
getTextDirections() | TextDirection[][] | Trả về hướng văn bản cho các ô trong dải ô. |
getTextRotation() | TextRotation | Trả về chế độ cài đặt xoay văn bản cho ô trên cùng bên trái của dải ô. |
getTextRotations() | TextRotation[][] | Trả về chế độ cài đặt xoay văn bản cho các ô trong dải ô. |
getTextStyle() | TextStyle | Trả về kiểu văn bản cho ô trên cùng bên trái của dải ô. |
getTextStyles() | TextStyle[][] | Trả về kiểu văn bản cho các ô trong dải ô. |
getValue() | Object | Trả về giá trị của ô trên cùng bên trái trong dải ô. |
getValues() | Object[][] | Trả về lưới hình chữ nhật của các giá trị cho dải ô này. |
getVerticalAlignment() | String | Trả về cách căn chỉnh dọc (trên cùng/giữa/dưới cùng) của ô ở góc trên cùng bên trái của dải ô. |
getVerticalAlignments() | String[][] | Trả về cách căn chỉnh dọc của các ô trong dải ô. |
getWidth() | Integer | Trả về chiều rộng của dải ô trong cột. |
getWrap() | Boolean | Trả về việc văn bản trong ô có gói hay không. |
getWrapStrategies() | WrapStrategy[][] | Trả về chiến lược xuống dòng tự động cho các ô trong dải ô. |
getWrapStrategy() | WrapStrategy | Trả về chiến lược xuống dòng tự động cho ô trên cùng bên trái của dải ô. |
getWraps() | Boolean[][] | Trả về kết quả là văn bản trong các ô đã xuống dòng. |
insertCells(shiftDimension) | Range | Chèn các ô trống vào dải ô này. |
insertCheckboxes() | Range | Chèn các hộp đánh dấu vào mỗi ô trong dải ô, được định cấu hình bằng true nếu đã đánh dấu và false nếu đã bỏ đánh dấu. |
insertCheckboxes(checkedValue) | Range | Chèn các hộp đánh dấu vào mỗi ô trong dải ô, được định cấu hình với một giá trị tuỳ chỉnh cho đã đánh dấu và một chuỗi trống nếu đã bỏ đánh dấu. |
insertCheckboxes(checkedValue, uncheckedValue) | Range | Chèn các hộp đánh dấu vào mỗi ô trong dải ô, được định cấu hình bằng các giá trị tuỳ chỉnh cho trạng thái đã đánh dấu và đã bỏ đánh dấu. |
isBlank() | Boolean | Trả về true nếu dải ô hoàn toàn trống. |
isChecked() | Boolean | Trả về xem tất cả các ô trong dải ô có trạng thái hộp đánh dấu là "đã đánh dấu" hay không. |
isEndColumnBounded() | Boolean | Xác định xem điểm cuối của dải ô có được nối với một cột cụ thể hay không. |
isEndRowBounded() | Boolean | Xác định xem điểm kết thúc của dải ô có liên kết với một hàng cụ thể hay không. |
isPartOfMerge() | Boolean | Trả về true nếu các ô trong dải ô hiện tại chồng chéo lên bất kỳ ô đã hợp nhất nào. |
isStartColumnBounded() | Boolean | Xác định xem điểm bắt đầu của dải ô có được liên kết với một cột cụ thể hay không. |
isStartRowBounded() | Boolean | Xác định xem điểm bắt đầu của dải ô có được liên kết với một hàng cụ thể hay không. |
merge() | Range | Hợp nhất các ô trong dải ô với nhau thành một khối duy nhất. |
mergeAcross() | Range | Hợp nhất các ô trong dải ô trên các cột của dải ô. |
mergeVertically() | Range | Hợp nhất các ô trong dải ô với nhau. |
moveTo(target) | void | Cắt và dán (cả định dạng và giá trị) từ dải ô này vào dải ô mục tiêu. |
offset(rowOffset, columnOffset) | Range | Trả về một dải ô mới được bù trừ khỏi dải ô này bằng số hàng và cột đã cho (có thể là giá trị âm). |
offset(rowOffset, columnOffset, numRows) | Range | Trả về một dải ô mới tương đối so với dải ô hiện tại, có điểm trên bên trái bù trừ dải ô hiện tại với các hàng và cột đã cho, và với chiều cao đã cho trong các ô. |
offset(rowOffset, columnOffset, numRows, numColumns) | Range | Trả về một dải ô mới tương đối so với dải ô hiện tại, có điểm trên bên trái bù trừ khỏi dải ô hiện tại theo các hàng và cột đã cho, cũng như với chiều cao và chiều rộng đã cho trong các ô. |
protect() | Protection | Tạo một đối tượng có thể bảo vệ dải ô không bị chỉnh sửa ngoại trừ người dùng có quyền. |
randomize() | Range | Sắp xếp ngẫu nhiên thứ tự của các hàng trong dải ô đã cho. |
removeCheckboxes() | Range | Xoá tất cả các hộp đánh dấu khỏi dải ô. |
removeDuplicates() | Range | Xoá các hàng trong dải ô này chứa giá trị trùng lặp với các giá trị trong mọi hàng trước đó. |
removeDuplicates(columnsToCompare) | Range | Xoá các hàng trong dải ô này có chứa giá trị trong các cột được chỉ định là bản sao của các giá trị bất kỳ trước đó. |
setBackground(color) | Range | Đặt màu nền cho tất cả các ô trong dải ô trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white' ). |
setBackgroundObject(color) | Range | Đặt màu nền cho tất cả ô trong dải ô. |
setBackgroundObjects(color) | Range | Đặt một lưới hình chữ nhật gồm các màu nền (phải phù hợp với kích thước của dải ô này). |
setBackgroundRGB(red, green, blue) | Range | Đặt nền thành màu đã cho bằng cách sử dụng các giá trị RGB (số nguyên từ 0 đến 255). |
setBackgrounds(color) | Range | Đặt một lưới hình chữ nhật gồm các màu nền (phải phù hợp với kích thước của dải ô này). |
setBorder(top, left, bottom, right, vertical, horizontal) | Range | Đặt thuộc tính đường viền. |
setBorder(top, left, bottom, right, vertical, horizontal, color, style) | Range | Đặt thuộc tính đường viền bằng màu sắc và/hoặc kiểu. |
setDataValidation(rule) | Range | Đặt một quy tắc xác thực dữ liệu cho tất cả các ô trong dải ô. |
setDataValidations(rules) | Range | Đặt quy tắc xác thực dữ liệu cho tất cả các ô trong dải ô. |
setFontColor(color) | Range | Đặt màu phông chữ trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white' ). |
setFontColorObject(color) | Range | Đặt màu phông chữ của dải ô đã cho. |
setFontColorObjects(colors) | Range | Đặt một lưới hình chữ nhật gồm các màu phông chữ (phải phù hợp với kích thước của dải ô này). |
setFontColors(colors) | Range | Đặt một lưới hình chữ nhật gồm các màu phông chữ (phải phù hợp với kích thước của dải ô này). |
setFontFamilies(fontFamilies) | Range | Đặt một lưới hình chữ nhật gồm các bộ phông chữ (phải phù hợp với kích thước của dải ô này). |
setFontFamily(fontFamily) | Range | Đặt bộ phông chữ, chẳng hạn như "ví dụ" hoặc " rằng". |
setFontLine(fontLine) | Range | Đặt kiểu dòng phông chữ của dải ô đã cho ('underline' , 'line-through' hoặc 'none' ). |
setFontLines(fontLines) | Range | Đặt một lưới hình chữ nhật của các kiểu đường kẻ (phải phù hợp với kích thước của dải ô này). |
setFontSize(size) | Range | Đặt kích thước phông chữ, với kích thước là kích thước điểm sẽ sử dụng. |
setFontSizes(sizes) | Range | Đặt một lưới chữ nhật có kích thước phông chữ (phải phù hợp với kích thước của phạm vi này). |
setFontStyle(fontStyle) | Range | Đặt kiểu phông chữ cho dải ô đã cho ('italic' hoặc 'normal' ). |
setFontStyles(fontStyles) | Range | Đặt một lưới chữ nhật gồm các kiểu phông chữ (phải phù hợp với kích thước của dải ô này). |
setFontWeight(fontWeight) | Range | Đặt độ đậm phông chữ cho phạm vi đã cho (bình thường/in đậm). |
setFontWeights(fontWeights) | Range | Đặt lưới chữ nhật có độ đậm phông chữ (phải phù hợp với kích thước của dải ô này). |
setFormula(formula) | Range | Cập nhật công thức cho dải ô này. |
setFormulaR1C1(formula) | Range | Cập nhật công thức cho dải ô này. |
setFormulas(formulas) | Range | Thiết lập một lưới hình chữ nhật cho các công thức (phải phù hợp với kích thước của dải ô này). |
setFormulasR1C1(formulas) | Range | Thiết lập một lưới hình chữ nhật cho các công thức (phải phù hợp với kích thước của dải ô này). |
setHorizontalAlignment(alignment) | Range | Đặt căn chỉnh ngang (từ trái sang phải) cho dải ô đã cho (trái/giữa/phải). |
setHorizontalAlignments(alignments) | Range | Thiết lập một lưới hình chữ nhật gồm các căn chỉnh ngang. |
setNote(note) | Range | Đặt ghi chú thành giá trị đã cho. |
setNotes(notes) | Range | Đặt một lưới hình chữ nhật ghi chú (phải phù hợp với kích thước của dải ô này). |
setNumberFormat(numberFormat) | Range | Đặt định dạng số hoặc ngày thành chuỗi định dạng cho sẵn. |
setNumberFormats(numberFormats) | Range | Đặt một lưới hình chữ nhật có định dạng số hoặc ngày (phải phù hợp với kích thước của phạm vi này). |
setRichTextValue(value) | Range | Đặt giá trị Văn bản đa dạng thức cho các ô trong dải ô. |
setRichTextValues(values) | Range | Đặt một lưới hình chữ nhật gồm các giá trị của Văn bản đa dạng thức. |
setShowHyperlink(showHyperlink) | Range | Đặt xem dải ô có hiển thị siêu liên kết hay không. |
setTextDirection(direction) | Range | Đặt hướng văn bản cho các ô trong dải ô. |
setTextDirections(directions) | Range | Thiết lập một lưới hình chữ nhật cho hướng văn bản. |
setTextRotation(degrees) | Range | Đặt chế độ xoay văn bản cho các ô trong dải ô. |
setTextRotation(rotation) | Range | Đặt chế độ xoay văn bản cho các ô trong dải ô. |
setTextRotations(rotations) | Range | Thiết lập một lưới hình chữ nhật xoay văn bản. |
setTextStyle(style) | Range | Đặt kiểu văn bản cho các ô trong dải ô. |
setTextStyles(styles) | Range | Thiết lập các kiểu văn bản theo bố cục lưới hình chữ nhật. |
setValue(value) | Range | Đặt giá trị của dải ô. |
setValues(values) | Range | Đặt một lưới hình chữ nhật gồm các giá trị (phải khớp với kích thước của dải ô này). |
setVerticalAlignment(alignment) | Range | Đặt cách căn chỉnh dọc (trên cùng xuống dưới cùng) cho phạm vi đã cho (trên cùng/giữa/dưới cùng). |
setVerticalAlignments(alignments) | Range | Đặt một lưới hình chữ nhật gồm các căn chỉnh dọc (phải phù hợp với kích thước của dải ô này). |
setVerticalText(isVertical) | Range | Đặt xem có xếp chồng văn bản cho các ô trong dải ô hay không. |
setWrap(isWrapEnabled) | Range | Đặt gói ô của dải ô đã cho. |
setWrapStrategies(strategies) | Range | Thiết lập một lưới hình chữ nhật cho các chiến lược bao bọc. |
setWrapStrategy(strategy) | Range | Đặt chiến lược xuống dòng tự động cho các ô trong dải ô. |
setWraps(isWrapEnabled) | Range | Thiết lập một lưới hình chữ nhật gồm các chính sách xuống dòng tự động (phải khớp với kích thước của dải ô này). |
shiftColumnGroupDepth(delta) | Range | Thay đổi độ sâu nhóm cột của dải ô theo số lượng được chỉ định. |
shiftRowGroupDepth(delta) | Range | Thay đổi độ sâu nhóm hàng của dải ô theo số lượng được chỉ định. |
sort(sortSpecObj) | Range | Sắp xếp các ô trong dải ô cho trước, theo cột và thứ tự đã chỉ định. |
splitTextToColumns() | void | Tách một cột văn bản thành nhiều cột dựa trên dấu phân tách được phát hiện tự động. |
splitTextToColumns(delimiter) | void | Tách một cột văn bản thành nhiều cột bằng cách sử dụng chuỗi được chỉ định làm dấu phân cách tuỳ chỉnh. |
splitTextToColumns(delimiter) | void | Tách một cột văn bản thành nhiều cột dựa trên dấu phân cách được chỉ định. |
trimWhitespace() | Range | Cắt bỏ khoảng trắng (chẳng hạn như dấu cách, thẻ hoặc dòng mới) trong mỗi ô trong dải ô này. |
uncheck() | Range | Thay đổi trạng thái của các hộp đánh dấu trong dải ô thành "chưa đánh dấu". |
Tài liệu chi tiết
activate()
Đặt dải ô được chỉ định thành active range
, với ô trên cùng bên trái trong dải ô là current cell
.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange('A1:D10'); range.activate(); var selection = sheet.getSelection(); // Current cell: A1 var currentCell = selection.getCurrentCell(); // Active Range: A1:D10 var activeRange = selection.getActiveRange();
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
activateAsCurrentCell()
Đặt ô được chỉ định làm current cell
.
Nếu ô được chỉ định có trong một dải ô hiện có, thì dải ô đó sẽ trở thành dải ô đang hoạt động với ô là ô hiện tại.
Nếu ô được chỉ định không xuất hiện trong bất kỳ dải ô hiện có nào, thì lựa chọn hiện có sẽ bị xoá và ô sẽ trở thành ô hiện tại và dải ô đang hoạt động.
Lưu ý: Range
được chỉ định phải bao gồm một ô, nếu không sẽ xảy ra ngoại lệ.
// Gets the first sheet of the spreadsheet. var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Gets the cell B5 and sets it as the active cell. var range = sheet.getRange('B5'); var currentCell = range.activateAsCurrentCell(); // Logs the activated cell. console.log(currentCell.getA1Notation());
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key)
Thêm siêu dữ liệu nhà phát triển bằng khoá được chỉ định vào dải ô.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Adds the key 'NAME' to the developer metadata for row 2. range.addDeveloperMetadata('NAME'); // Gets the metadata and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
key | String | Chìa khoá cho siêu dữ liệu mới dành cho nhà phát triển. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
Thêm siêu dữ liệu nhà phát triển bằng khoá được chỉ định và chế độ hiển thị đối với phạm vi.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on Sheet1. const range = sheet.getRange('2:2'); // Adds the key 'NAME' and sets the developer metadata visibility to 'DOCUMENT' // for row 2 on Sheet1. range.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT); // Gets the updated metadata info and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getVisibility().toString());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
key | String | Chìa khoá cho siêu dữ liệu mới dành cho nhà phát triển. |
visibility | DeveloperMetadataVisibility | Chế độ hiển thị siêu dữ liệu mới dành cho nhà phát triển. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
Thêm siêu dữ liệu nhà phát triển bằng khoá và giá trị được chỉ định vào dải ô.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 of Sheet1. const range = sheet.getRange('2:2'); // Adds the key 'NAME' and sets the value to 'GOOGLE' for the metadata of row 2. range.addDeveloperMetadata('NAME', 'GOOGLE'); // Gets the metadata and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
key | String | Chìa khoá cho siêu dữ liệu mới dành cho nhà phát triển. |
value | String | Giá trị cho siêu dữ liệu mới dành cho nhà phát triển. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
Thêm siêu dữ liệu nhà phát triển bằng khoá, giá trị và chế độ hiển thị được chỉ định cho dải ô.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility // to PROJECT for row 2 on the sheet. range.addDeveloperMetadata( 'NAME', 'GOOGLE', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT); // Gets the updated metadata info and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue()); console.log(developerMetaData.getVisibility().toString());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
key | String | Chìa khoá cho siêu dữ liệu mới dành cho nhà phát triển. |
value | String | Giá trị cho siêu dữ liệu mới dành cho nhà phát triển. |
visibility | DeveloperMetadataVisibility | Chế độ hiển thị siêu dữ liệu mới dành cho nhà phát triển. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding()
Áp dụng giao diện dải cột mặc định cho dải ô. Theo mặc định, dải có màu đầu trang và không có màu chân trang.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Applies column banding to row 2. const colBanding = range.applyColumnBanding(); // Gets the first banding on the sheet and logs the color of the header column. console.log(sheet.getBandings()[0].getHeaderColumnColorObject().asRgbColor().asHexString()); // Gets the first banding on the sheet and logs the color of the second column. console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());
Cầu thủ trả bóng
Banding
– Dải mới.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding(bandingTheme)
Áp dụng giao diện dải cột được chỉ định cho dải ô. Theo mặc định, dải có màu đầu trang và không có màu chân trang.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Applies the INDIGO color banding theme to the columns in row 2. const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.INDIGO); // Gets the first banding on the sheet and logs the color of the second column. console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
bandingTheme | BandingTheme | Một giao diện màu để áp dụng cho các cột trong dải ô. |
Cầu thủ trả bóng
Banding
– Dải mới.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding(bandingTheme, showHeader, showFooter)
Áp dụng giao diện dải cột đã chỉ định cho dải ô có chế độ cài đặt tiêu đề và chân trang được chỉ định.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 12-22 on the sheet. const range = sheet.getRange('12:22'); // Applies the BLUE color banding theme to rows 12-22. // Sets the header visibility to false and the footer visibility to true. const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.BLUE, false, true); // Gets the banding color and logs it to the console. console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString()); // Gets the header color object and logs it to the console. Returns null because the header // visibility is set to false. console.log(sheet.getBandings()[0].getHeaderColumnColorObject()); // Gets the footer color and logs it to the console. console.log(sheet.getBandings()[0].getFooterColumnColorObject().asRgbColor().asHexString());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
bandingTheme | BandingTheme | Một giao diện màu để áp dụng cho các cột trong dải ô. |
showHeader | Boolean | Nếu là true , màu tiêu đề của giao diện dải sẽ được áp dụng cho cột đầu tiên. |
showFooter | Boolean | Nếu là true , màu chân trang của giao diện dải sẽ được áp dụng cho cột cuối cùng. |
Cầu thủ trả bóng
Banding
– Dải mới.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding()
Áp dụng giao diện dải hàng mặc định cho dải ô. Theo mặc định, dải có màu đầu trang và không có màu chân trang.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies row banding to rows 1-30. range.applyRowBanding(); // Gets the hex color of the second banded row. const secondRowColor = range.getBandings()[0] .getSecondRowColorObject() .asRgbColor() .asHexString(); // Logs the hex color to console. console.log(secondRowColor);
Cầu thủ trả bóng
Banding
– Dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme)
Áp dụng giao diện dải hàng đã chỉ định cho dải ô. Theo mặc định, dải có màu đầu trang và không có màu chân trang.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies the INDIGO row banding theme to rows 1-30. range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO); // Gets the hex color of the second banded row. const secondRowColor = range.getBandings()[0] .getSecondRowColorObject() .asRgbColor() .asHexString(); // Logs the hex color to console. console.log(secondRowColor);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
bandingTheme | BandingTheme | Một giao diện màu để áp dụng cho các hàng trong dải ô. |
Cầu thủ trả bóng
Banding
– Dải mới.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme, showHeader, showFooter)
Áp dụng giao diện dải hàng đã chỉ định cho dải ô có chế độ cài đặt tiêu đề và chân trang được chỉ định.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies the INDIGO row banding to rows 1-30 and // specifies to hide the header and show the footer. range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO, false, true);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
bandingTheme | BandingTheme | Một giao diện màu để áp dụng cho các hàng trong dải ô. |
showHeader | Boolean | Nếu là true , màu tiêu đề của giao diện dải sẽ được áp dụng cho hàng đầu tiên. |
showFooter | Boolean | Nếu là true , màu chân trang của giao diện dải sẽ áp dụng cho hàng cuối cùng. |
Cầu thủ trả bóng
Banding
– Dải mới.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoFill(destination, series)
Điền dữ liệu dựa trên dữ liệu trong dải ô này vào destinationRange
. Các giá trị mới cũng được xác định theo kiểu series
đã chỉ định. Dải ô đích đến phải chứa dải ô này và chỉ mở rộng theo một hướng. Ví dụ: nội dung sau đây điền vào A1:A20
bằng một chuỗi các số tăng dần dựa trên các giá trị hiện tại trong A1:A4
:
var sheet = SpreadsheetApp.getActiveSheet(); // Has values [1, 2, 3, 4]. var sourceRange = sheet.getRange("A1:A4"); // The range to fill with values. var destination = sheet.getRange("A1:A20"); // Inserts new values in A5:A20, continuing the pattern expressed in A1:A4 sourceRange.autoFill(destination, SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
destination | Range | Dải ô sẽ được tự động điền giá trị. Dải ô đích đến phải chứa dải ô này và chỉ mở rộng theo một hướng (hướng lên, xuống, sang trái hoặc sang phải). |
series | AutoFillSeries | Loại chuỗi tự động điền sẽ được dùng để tính các giá trị mới. Mức tác động của chuỗi dữ liệu này sẽ khác nhau tuỳ theo loại và lượng dữ liệu nguồn. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoFillToNeighbor(series)
Tính toán một dải ô để điền dữ liệu mới dựa vào các ô lân cận và tự động điền giá trị mới cho dải ô đó dựa trên dữ liệu có trong dải ô này. Các giá trị mới này cũng được
xác định theo kiểu series
đã chỉ định.
Phạm vi đích đến được tính toán sẽ xem xét dữ liệu xung quanh để xác định vị trí chèn các giá trị mới: nếu có dữ liệu ở ngay bên trái hoặc bên phải của một cột đang được tự động điền, thì các giá trị mới chỉ mở rộng đến tận dữ liệu liền kề này.
Ví dụ: nếu A1:A20
được điền bằng một chuỗi các số tăng dần và phương thức này được gọi trên dải ô B1:B4
chứa một chuỗi ngày, thì các giá trị mới chỉ được chèn vào B5:B20
. Bằng cách này, các giá trị mới này "gắn" vào các ô chứa giá trị trong cột A.
var sheet = SpreadsheetApp.getActiveSheet(); // A1:A20 has values [1, 2, 3, ... 20]. // B1:B4 has values [1/1/2017, 1/2/2017, ...] var sourceRange = sheet.getRange("B1:B4"); // Results in B5:B20 having values [1/5/2017, ... 1/20/2017] sourceRange.autoFillToNeighbor(SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
series | AutoFillSeries | Loại chuỗi tự động điền sẽ được dùng để tính các giá trị mới. Mức tác động của chuỗi dữ liệu này sẽ khác nhau tuỳ theo loại và lượng dữ liệu nguồn. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
breakApart()
Chia nhỏ bất kỳ ô có nhiều cột nào trong dải ô thành các ô riêng lẻ.
Việc gọi hàm này trên một dải ô tương đương với việc chọn một dải ô và nhấp vào Định dạng > Hợp nhất ô > Huỷ hợp nhất.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:C6 on Sheet1. const range = sheet.getRange('A1:C6'); // Unmerges the range A1:C6 into individual cells. range.breakApart();
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
canEdit()
Xác định xem người dùng có quyền chỉnh sửa mọi ô trong dải ô hay không. Chủ sở hữu bảng tính luôn có thể chỉnh sửa các dải ô và trang tính được bảo vệ.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:C6 on Sheet1. const range = sheet.getRange('A1:C6'); // Logs whether the user has permission to edit every cell in the range. console.log(range.canEdit());
Cầu thủ trả bóng
Boolean
– true
nếu người dùng có quyền chỉnh sửa mọi ô trong dải ô; nếu không, false
.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
check()
Thay đổi trạng thái của các hộp đánh dấu trong dải ô thành "đã đánh dấu". Bỏ qua các ô trong dải ô hiện không chứa giá trị đã đánh dấu hoặc bỏ đánh dấu được định cấu hình.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the range A1:B10 to 'checked'. var range = SpreadsheetApp.getActive().getRange('A1:B10'); range.check();
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
Xoá phạm vi nội dung và định dạng.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clear();
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Xoá phạm vi nội dung, định dạng, quy tắc xác thực dữ liệu và/hoặc nhận xét, như được chỉ định với các tuỳ chọn nâng cao nhất định. Theo mặc định, mọi dữ liệu đều bị xoá.
// The code below clears range C2:G7 in the active sheet, but preserves the format, // data validation rules, and comments. SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 5).clear({contentsOnly: true});
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
options | Object | Đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây. |
Thông số nâng cao
Tên | Loại | Nội dung mô tả |
---|---|---|
commentsOnly | Boolean | Liệu có chỉ xoá nhận xét hay không. |
contentsOnly | Boolean | Liệu có chỉ xoá nội dung hay không. |
formatOnly | Boolean | Liệu có chỉ xoá định dạng hay không; xin lưu ý rằng việc xoá định dạng cũng sẽ xoá các quy tắc xác thực dữ liệu. |
validationsOnly | Boolean | Liệu có chỉ xoá quy tắc xác thực dữ liệu hay không. |
skipFilteredRows | Boolean | Liệu có tránh xoá các hàng đã lọc hay không. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContent()
Xoá nội dung của dải ô, giữ nguyên định dạng.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearContent();
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearDataValidations()
Xoá các quy tắc xác thực dữ liệu cho dải ô.
// Clear the data validation rules for cells A1:B5. var range = SpreadsheetApp.getActive().getRange('A1:B5'); range.clearDataValidations();
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormat()
Xoá định dạng cho dải ô này.
Thao tác này sẽ xoá định dạng văn bản cho ô hoặc các ô trong dải ô nhưng không đặt lại bất kỳ quy tắc định dạng số nào.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearFormat();
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNote()
Xoá ghi chú trong một hoặc nhiều ô đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearNote();
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseGroups()
Thu gọn tất cả các nhóm nằm hoàn toàn trong phạm vi. Nếu không có nhóm nào nằm hoàn toàn trong phạm vi, thì nhóm mở rộng sâu nhất nằm trong phạm vi một phần sẽ được thu gọn.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are collapsed. range.collapseGroups();
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
Sao chép định dạng của dải ô đến vị trí cụ thể. Nếu đích đến lớn hơn hoặc nhỏ hơn phạm vi nguồn, thì nguồn sẽ được lặp lại hoặc bị cắt bớt tương ứng. Xin lưu ý rằng phương thức này chỉ sao chép định dạng.
Để biết nội dung mô tả chi tiết về tham sốgridId, hãy xem getGridId()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var range = source.getRange("B2:D4"); // This copies the formatting in B2:D4 in the source sheet to // D4:F6 in the sheet with gridId 1555299895. Note that you can get the gridId // of a sheet by calling sheet.getSheetId() or range.getGridId(). range.copyFormatToRange(1555299895, 4, 6, 4, 6);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
gridId | Integer | Mã nhận dạng duy nhất của trang tính trong bảng tính, bất kể vị trí. |
column | Integer | Cột đầu tiên của dải ô mục tiêu. |
columnEnd | Integer | Cột kết thúc của dải ô mục tiêu. |
row | Integer | Hàng bắt đầu của dải ô mục tiêu. |
rowEnd | Integer | Hàng kết thúc của dải ô mục tiêu. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Xem thêm
copyFormatToRange(sheet, column, columnEnd, row, rowEnd)
Sao chép định dạng của dải ô đến vị trí cụ thể. Nếu đích đến lớn hơn hoặc nhỏ hơn phạm vi nguồn, thì nguồn sẽ được lặp lại hoặc bị cắt bớt tương ứng. Xin lưu ý rằng phương thức này chỉ sao chép định dạng.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var destination = ss.getSheets()[1]; var range = source.getRange("B2:D4"); // This copies the formatting in B2:D4 in the source sheet to // D4:F6 in the second sheet range.copyFormatToRange(destination, 4, 6, 4, 6);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
sheet | Sheet | Trang tính đích. |
column | Integer | Cột đầu tiên của dải ô mục tiêu. |
columnEnd | Integer | Cột kết thúc của dải ô mục tiêu. |
row | Integer | Hàng bắt đầu của dải ô mục tiêu. |
rowEnd | Integer | Hàng kết thúc của dải ô mục tiêu. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination)
Sao chép dữ liệu từ một dải ô sang một dải ô khác. Cả giá trị và định dạng đều được sao chép.
// The code below copies the first 5 columns over to the 6th column. var sheet = SpreadsheetApp.getActiveSheet(); var rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5); rangeToCopy.copyTo(sheet.getRange(1, 6));
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
destination | Range | Một dải ô đích để sao chép vào; chỉ vị trí ô trên cùng bên trái là phù hợp. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination, copyPasteType, transposed)
Sao chép dữ liệu từ một dải ô sang một dải ô khác.
// The code below copies only the values of the first 5 columns over to the 6th column. var sheet = SpreadsheetApp.getActiveSheet(); sheet.getRange("A:E").copyTo(sheet.getRange("F1"), SpreadsheetApp.CopyPasteType.PASTE_VALUES, false);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
destination | Range | Một dải ô đích để sao chép vào; chỉ vị trí ô trên cùng bên trái là phù hợp. |
copyPasteType | CopyPasteType | Loại chỉ định cách dán nội dung của dải ô vào đích đến. |
transposed | Boolean | Liệu có nên dán dải ô theo hướng hoán vị hay không. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination, options)
Sao chép dữ liệu từ một dải ô sang một dải ô khác. Theo mặc định, cả giá trị và định dạng đều được sao chép, nhưng bạn có thể ghi đè giá trị này bằng cách sử dụng các đối số nâng cao.
// The code below copies only the values of the first 5 columns over to the 6th column. var sheet = SpreadsheetApp.getActiveSheet(); sheet.getRange("A:E").copyTo(sheet.getRange("F1"), {contentsOnly:true});
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
destination | Range | Một dải ô đích để sao chép vào; chỉ vị trí ô trên cùng bên trái là phù hợp. |
options | Object | Đối tượng JavaScript chỉ định các tham số nâng cao, như được liệt kê dưới đây. |
Thông số nâng cao
Tên | Loại | Nội dung mô tả |
---|---|---|
formatOnly | Boolean | chỉ định rằng chỉ định dạng được sao chép |
contentsOnly | Boolean | chỉ định rằng chỉ nội dung được sao chép |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyValuesToRange(gridId, column, columnEnd, row, rowEnd)
Sao chép nội dung của dải ô vào vị trí cụ thể. Nếu đích đến lớn hơn hoặc nhỏ hơn phạm vi nguồn, thì nguồn sẽ được lặp lại hoặc bị cắt bớt tương ứng.
Để biết nội dung mô tả chi tiết về tham sốgridId, hãy xem getGridId()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var range = source.getRange("B2:D4"); // This copies the data in B2:D4 in the source sheet to // D4:F6 in the sheet with gridId 0 range.copyValuesToRange(0, 4, 6, 4, 6);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
gridId | Integer | Mã nhận dạng duy nhất của trang tính trong bảng tính, bất kể vị trí. |
column | Integer | Cột đầu tiên của dải ô mục tiêu. |
columnEnd | Integer | Cột kết thúc của dải ô mục tiêu. |
row | Integer | Hàng bắt đầu của dải ô mục tiêu. |
rowEnd | Integer | Hàng kết thúc của dải ô mục tiêu. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Xem thêm
copyValuesToRange(sheet, column, columnEnd, row, rowEnd)
Sao chép nội dung của dải ô vào vị trí cụ thể. Nếu đích đến lớn hơn hoặc nhỏ hơn phạm vi nguồn, thì nguồn sẽ được lặp lại hoặc bị cắt bớt tương ứng.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var destination = ss.getSheets()[1]; var range = source.getRange("B2:D4"); // This copies the data in B2:D4 in the source sheet to // D4:F6 in the second sheet range.copyValuesToRange(destination, 4, 6, 4, 6);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
sheet | Sheet | Trang tính đích. |
column | Integer | Cột đầu tiên của dải ô mục tiêu. |
columnEnd | Integer | Cột kết thúc của dải ô mục tiêu. |
row | Integer | Hàng bắt đầu của dải ô mục tiêu. |
rowEnd | Integer | Hàng kết thúc của dải ô mục tiêu. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourcePivotTable(dataSource)
Tạo một bảng tổng hợp nguồn dữ liệu trống từ nguồn dữ liệu, cố định tại ô đầu tiên trong dải ô này.
Ví dụ này cho biết cách tạo và định cấu hình bảng tổng hợp nguồn dữ liệu mới.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var anchorCell = spreadsheet.getSheets()[0].getRange('A1'); var dataSource = spreadsheet.getDataSources()[0]; var pivotTable = anchorCell.createDataSourcePivotTable(dataSource); pivotTable.addRowGroup('dataColumnA'); pivotTable.addColumnGroup('dataColumnB'); pivotTable.addPivotValue('dataColumnC', SpreadsheetApp.PivotTableSummarizeFunction.SUM); pivotTable.addFilter('dataColumnA', SpreadsheetApp.newFilterCriteria().whenTextStartsWith('A').build());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
dataSource | DataSource | Nguồn dữ liệu để tạo bảng tổng hợp. |
Cầu thủ trả bóng
DataSourcePivotTable
— Bảng tổng hợp nguồn dữ liệu mới tạo.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourceTable(dataSource)
Tạo một bảng nguồn dữ liệu trống từ nguồn dữ liệu, cố định tại ô đầu tiên trong dải ô này.
Ví dụ này cho biết cách tạo và thiết lập bảng nguồn dữ liệu mới.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var anchorCell = spreadsheet.getSheets()[0].getRange('A1'); var dataSource = spreadsheet.getDataSources()[0]; var dataSourceTable = anchorCell.createDataSourceTable(dataSource); .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC') .addSortSpec('dataColumnA', /* ascending= *\/ true) .addSortSpec('dataColumnB', /* ascending= *\/ false);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
dataSource | DataSource | Nguồn dữ liệu để tạo bảng tổng hợp. |
Cầu thủ trả bóng
DataSourceTable
– Bảng nguồn dữ liệu mới tạo.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
Trả về DeveloperMetadataFinderApi để tìm siêu dữ liệu nhà phát triển trong phạm vi của phạm vi này. Siêu dữ liệu chỉ nằm trong phạm vi của phạm vi nếu nó hoàn toàn nằm trong phạm vi đó. Ví dụ: siêu dữ liệu liên kết với hàng "3:3" không nằm trong phạm vi dải "A1:D5" nhưng nằm trong phạm vi "1:5".
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:C6. const range = sheet.getRange('A1:C6'); // Creates a developer metadata finder to search for metadata in the scope of this range. const developerMetaDataFinder = range.createDeveloperMetadataFinder(); // Logs information about the developer metadata finder to the console. const developerMetaData = developerMetaDataFinder.find()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue()); console.log(developerMetaData.getVisibility().toString());
Cầu thủ trả bóng
DeveloperMetadataFinder
– Trình tìm siêu dữ liệu dành cho nhà phát triển để tìm siêu dữ liệu trong phạm vi của phạm vi này.
createFilter()
Tạo bộ lọc và áp dụng bộ lọc đó cho dải ô được chỉ định trên trang tính. Bạn không thể tạo nhiều bộ lọc trên một trang tính. Để truy cập và sửa đổi bộ lọc sau khi tạo, hãy sử dụng getFilter()
hoặc Sheet.getFilter()
.
let ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); // Creates a new filter and applies it to the range A1:C20 on the active sheet. function createFilter() { range.createFilter(); } // Gets the filter and applies criteria that only shows cells that aren't empty. function getFilterAddCriteria() { let filter = range.getFilter(); let criteria = SpreadsheetApp.newFilterCriteria() .whenCellNotEmpty() .build(); filter.setColumnFilterCriteria(2, criteria); }Dùng phương thức này để tạo bộ lọc cho trang tính
Grid
, loại trang tính mặc định.
Trang tính dạng lưới là các trang tính không kết nối với cơ sở dữ liệu. Để tạo các loại bộ lọc khác, hãy tham khảo những phần sau:- Tạo bộ lọc bảng tổng hợp bằng
PivotTable.addFilter(sourceDataColumn, filterCriteria)
- Tạo bộ lọc cho trang tính được kết nối với cơ sở dữ liệu bằng
DataSourceSheet.addFilter(columnName, filterCriteria)
- Tạo bộ lọc cho bảng tổng hợp đã kết nối với cơ sở dữ liệu bằng
DataSourcePivotTable.addFilter(columnName, filterCriteria)
Cầu thủ trả bóng
Filter
– Bộ lọc mới.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createPivotTable(sourceData)
Tạo một bảng tổng hợp trống từ sourceData
đã chỉ định neo tại ô đầu tiên
trong dải ô này.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A1 as a range in order to place the pivot table. const range = sheet.getRange('A1'); // Gets the range of the source data for the pivot table. const dataRange = sheet.getRange('E12:G20'); // Creates an empty pivot table from the specified source data. const pivotTable = range.createPivotTable(dataRange); // Logs the values from the pivot table's source data to the console. console.log(pivotTable.getSourceDataRange().getValues());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
sourceData | Range | Dữ liệu để tạo bảng tổng hợp. |
Cầu thủ trả bóng
PivotTable
– PivotTable
mới được tạo.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createTextFinder(findText)
Tạo trình tìm văn bản cho dải ô. Trình tìm kiếm này có thể tìm và thay thế văn bản trong dải ô này.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // Creates a text finder for the range. var textFinder = range.createTextFinder('dog'); // Returns the first occurrence of 'dog'. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = textFinder.replaceWith('cat');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
findText | String | Văn bản cần tìm kiếm. |
Cầu thủ trả bóng
TextFinder
– TextFinder
cho phạm vi
deleteCells(shiftDimension)
Xoá dải ô này. Dữ liệu hiện có trong trang tính dọc theo thứ nguyên đã cung cấp được dịch chuyển sang dải ô đã xóa.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
shiftDimension | Dimension | Phương diện mà theo đó thay đổi dữ liệu hiện có. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandGroups()
Mở rộng các nhóm thu gọn có dải ô hoặc nút điều khiển giao cắt với dải ô này. Vị trí bật/tắt điều khiển là chỉ mục mà tại đó nút điều khiển hiển thị, ngay trước hoặc sau nhóm, tuỳ thuộc vào chế độ cài đặt. Nếu có nhiều nhóm ở cùng một vị trí, thì nhóm nông nhất sẽ được mở rộng.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are expanded. range.expandGroups();
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getA1Notation()
Trả về chuỗi mô tả của dải ô, theo ký hiệu A1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange(1, 1, 2, 5); // Logs "A1:E2" Logger.log(range.getA1Notation());
Cầu thủ trả bóng
String
– Mô tả chuỗi của dải ô trong ký hiệu A1.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackground()
Trả về màu nền của ô trên cùng bên trái trong dải ô (ví dụ: '#ffffff'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackground());
Cầu thủ trả bóng
String
– Mã màu của nền.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObject()
Trả về màu nền của ô trên cùng bên trái trong dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());
Cầu thủ trả bóng
Color
— Màu nền của ô trên cùng bên trái trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObjects()
Trả về màu nền của các ô trong dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var bgColors = range.getBackgroundObjects(); for (var i in bgColors) { for (var j in bgColors[i]) { Logger.log(bgColors[i][j].asRgbColor().asHexString()); } }
Cầu thủ trả bóng
Color[][]
– Một mảng hai chiều gồm các màu nền.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgrounds()
Trả về màu nền của các ô trong dải ô (ví dụ: '#ffffff'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var bgColors = range.getBackgrounds(); for (var i in bgColors) { for (var j in bgColors[i]) { Logger.log(bgColors[i][j]); } }
Cầu thủ trả bóng
String[][]
– Một mảng hai chiều gồm các mã màu của nền.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBandings()
Trả về tất cả dải được áp dụng cho ô bất kỳ trong dải ô này.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Sets a range. const range = sheet.getRange('A1:K50'); // Gets the banding info for the range. const bandings = range.getBandings(); // Logs the second row color for each banding to the console. for (let banding of bandings) { console.log(banding.getSecondRowColor()); }
Cầu thủ trả bóng
Banding[]
– Tất cả dải được áp dụng cho ô bất kỳ trong dải ô này.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCell(row, column)
Trả về một ô cho sẵn trong một dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // The row and column here are relative to the range // getCell(1,1) in this code returns the cell at B2 var cell = range.getCell(1, 1); Logger.log(cell.getValue());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
row | Integer | Hàng của ô tương ứng với dải ô. |
column | Integer | Cột của ô tương ứng với dải ô. |
Cầu thủ trả bóng
Range
– Dải ô có chứa một ô tại toạ độ được chỉ định.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumn()
Trả về vị trí cột bắt đầu của dải ô này.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "2.0" Logger.log(range.getColumn());
Cầu thủ trả bóng
Integer
— Vị trí cột bắt đầu của dải ô trong bảng tính.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRegion()
Trả về bản sao của dải ô được mở rộng trong bốn Direction
chính để bao gồm tất cả
các ô liền kề có dữ liệu trong đó. Nếu dải ô được bao quanh bởi các ô trống không bao gồm các ô dọc theo đường chéo, thì chính dải ô đó sẽ được trả về. Điều này tương tự như việc chọn dải ô và nhập Ctrl+A
trong trình chỉnh sửa.
// Assume the active spreadsheet is blank. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange("C2").setValue(100); sheet.getRange("B3").setValue(100); sheet.getRange("D3").setValue(100); sheet.getRange("C4").setValue(100); // Logs "B2:D4" Logger.log(sheet.getRange("C3").getDataRegion().getA1Notation());
Cầu thủ trả bóng
Range
– Vùng dữ liệu của dải ô hoặc một dải ô cho toàn bộ bảng tính.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRegion(dimension)
Trả về bản sao của dải ô đã mở rộng Direction.UP
và Direction.DOWN
nếu
thứ nguyên được chỉ định là Dimension.ROWS
hoặc Direction.NEXT
và Direction.PREVIOUS
nếu thứ nguyên là Dimension.COLUMNS
. Việc mở rộng phạm vi dựa trên việc phát hiện dữ liệu bên cạnh dải ô được sắp xếp như bảng. Dải ô mở rộng bao gồm tất cả các ô liền kề có dữ liệu trong đó dọc theo kích thước được chỉ định, bao gồm cả ranh giới của bảng. Nếu dải ô ban đầu được bao quanh bởi các ô trống dọc theo kích thước đã chỉ định, thì chính dải ô đó sẽ được trả về. Phương thức này tương tự như cách chọn dải ô và nhập
Ctrl+Space
cho các cột hoặc Shift+Space
cho các hàng trong trình chỉnh sửa.
// Assume the active spreadsheet is blank. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange("C2").setValue(100); sheet.getRange("B3").setValue(100); sheet.getRange("D3").setValue(100); sheet.getRange("C4").setValue(100); // Logs "C2:C4" Logger.log(sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.ROWS).getA1Notation()); // Logs "B3:D3" Logger.log( sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.COLUMNS).getA1Notation());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
dimension | Dimension | Phương diện mà bạn dùng để mở rộng phạm vi. |
Cầu thủ trả bóng
Range
– Vùng dữ liệu của dải ô hoặc một dải ô bao gồm từng cột hoặc mỗi hàng được kéo dài bằng dải ô ban đầu.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormula()
Trả về DataSourceFormula
cho ô đầu tiên trong dải ô hoặc null
nếu ô không chứa công thức nguồn dữ liệu.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1 on Sheet1. const range = sheet.getRange('A1'); // Gets the data source formula from cell A1. const dataSourceFormula = range.getDataSourceFormula(); // Gets the formula. const formula = dataSourceFormula.getFormula(); // Logs the formula. console.log(formula);
Cầu thủ trả bóng
DataSourceFormula
– DataSourceFormula
của ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
Trả về DataSourceFormula
cho các ô trong dải ô.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:B5 on Sheet1. const range = sheet.getRange('A1:B5'); // Gets an array of the data source formulas in the range A1:B5. const dataSourceFormulas = range.getDataSourceFormulas(); // Logs the first formula in the array. console.log(dataSourceFormulas[0].getFormula());
Cầu thủ trả bóng
DataSourceFormula[]
– Một mảng DataSourceFormula
.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
Lấy tất cả các bảng tổng hợp của nguồn dữ liệu giao với dải ô.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:G50 on Sheet1. const range = sheet.getRange('A1:G50'); // Gets an array of the data source pivot tables in the range A1:G50. const dataSourcePivotTables = range.getDataSourcePivotTables(); // Logs the last time that the first pivot table in the array was refreshed. console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());
Cầu thủ trả bóng
DataSourcePivotTable[]
– Danh sách bảng tổng hợp về nguồn dữ liệu.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
Lấy tất cả các bảng nguồn dữ liệu giao với dải ô.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:G50 on Sheet1. const range = sheet.getRange('A1:G50'); // Gets the first data source table in the range A1:G50. const dataSourceTable = range.getDataSourceTables()[0]; // Logs the time of the last completed data execution on the data source table. console.log(dataSourceTable.getStatus().getLastExecutionTime());
Cầu thủ trả bóng
DataSourceTable[]
– Danh sách các bảng nguồn dữ liệu.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceUrl()
Trả về URL cho dữ liệu trong dải ô này, có thể được sử dụng để tạo biểu đồ và truy vấn.
Code.gs
function doGet() { var ss = SpreadsheetApp.openById('1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c'); var sheet = ss.getSheetByName('ContinentData'); var range = sheet.getRange('A1:B8'); var template = HtmlService.createTemplateFromFile('piechart'); template.dataSourceUrl = range.getDataSourceUrl(); return template.evaluate(); }
piechart.html
<!DOCTYPE html> <html> <head> <!--Load the AJAX API--> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> // Load the Visualization API and the corechart package. google.charts.load('current', {'packages': ['corechart']}); // Set a callback to run when the Google Visualization API is loaded. google.charts.setOnLoadCallback(queryData); function queryData() { var query = new google.visualization.Query('<?= dataSourceUrl ?>'); query.send(drawChart); } // Callback that creates and populates a data table, // instantiates the pie chart, passes in the data and // draws it. function drawChart(response) { if (response.isError()) { alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage()); return; } var data = response.getDataTable(); // Set chart options. var options = { title: 'Population by Continent', width: 400, height: 300 }; // Instantiate and draw the chart, passing in some options. var chart = new google.visualization.PieChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <!-- Div that holds the pie chart. --> <div id="chart_div"></div> </body> </html>
Cầu thủ trả bóng
String
– URL cho dải ô này dưới dạng nguồn dữ liệu có thể được truyền đến các API khác, chẳng hạn như biểu đồ.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataTable()
Trả về dữ liệu bên trong đối tượng này dưới dạng DataTable.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:B7 on Sheet1. const range = sheet.getRange('A1:B7'); // Gets the range A1:B7 as a data table. The values in each column must be of the same type. const datatable = range.getDataTable(); // Uses the Charts service to build a bar chart from the data table. // This doesn't build an embedded chart. To do that, use sheet.newChart().addRange() instead. const chart = Charts.newBarChart() .setDataTable(datatable) .setOption('title', 'Your Chart Title Here') .build();
Cầu thủ trả bóng
DataTable
– dữ liệu dưới dạng bảng dữ liệu.
getDataTable(firstRowIsHeader)
Trả về dữ liệu bên trong dải ô này dưới dạng Bảng dữ liệu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B7"); // Calling this method with "true" sets the first line to be the title of the axes var datatable = range.getDataTable(true); // Note that this doesn't build an EmbeddedChart, so you can't just use // Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead. var chart = Charts.newBarChart() .setDataTable(datatable) .setOption("title", "Your Title Here") .build();
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
firstRowIsHeader | Boolean | Liệu có coi hàng đầu tiên là tiêu đề hay không. |
Cầu thủ trả bóng
DataTable
– Dữ liệu dưới dạng bảng dữ liệu.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataValidation()
Trả về quy tắc xác thực dữ liệu cho ô trên cùng bên trái trong dải ô. Nếu chưa thiết lập tính năng xác thực dữ liệu trên ô, thì phương thức này sẽ trả về null
.
// Log information about the data validation rule for cell A1. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = cell.getDataValidation(); if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); Logger.log('The data validation rule is %s %s', criteria, args); } else { Logger.log('The cell does not have a data validation rule.') }
Cầu thủ trả bóng
DataValidation
— Quy tắc xác thực dữ liệu cho ô trên cùng bên trái trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataValidations()
Trả về quy tắc xác thực dữ liệu cho tất cả các ô trong dải ô. Nếu chưa thiết lập xác thực dữ liệu trên một ô nhất định, phương thức này sẽ trả về null
cho vị trí của ô đó trong mảng.
// Change existing data validation rules that require a date in 2013 to require a date in 2014. var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')]; var newDates = [new Date('1/1/2014'), new Date('12/31/2014')]; var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns()); var rules = range.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { var rule = rules[i][j]; if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN && args[0].getTime() == oldDates[0].getTime() && args[1].getTime() == oldDates[1].getTime()) { // Create a builder from the existing rule, then change the dates. rules[i][j] = rule.copy().withCriteria(criteria, newDates).build(); } } } } range.setDataValidations(rules);
Cầu thủ trả bóng
DataValidation[][]
– Một mảng hai chiều gồm các quy tắc xác thực dữ liệu liên kết với các ô trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
Lấy siêu dữ liệu nhà phát triển liên kết với dải ô này.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on Sheet1. const range = sheet.getRange('2:2'); // Adds metadata to row 2. range.addDeveloperMetadata('NAME', 'GOOGLE'); // Logs the metadata to console. for (const metadata of range.getDeveloperMetadata()) { console.log(`${metadata.getKey()}: ${metadata.getValue()}`); }
Cầu thủ trả bóng
DeveloperMetadata[]
– Siêu dữ liệu nhà phát triển liên kết với dải ô này.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValue()
Trả về giá trị hiển thị của ô trên cùng bên trái trong dải ô. Giá trị là một String
.
Giá trị hiển thị có tính đến định dạng ngày, giờ và tiền tệ, bao gồm cả những định dạng được chế độ cài đặt ngôn ngữ của bảng tính tự động áp dụng. Các ô trống sẽ trả về một chuỗi trống.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A30 and sets its value to 'Test code.' const cell = sheet.getRange('A30'); cell.setValue('Test code'); // Gets the value and logs it to the console. console.log(cell.getDisplayValue());
Cầu thủ trả bóng
String
– Giá trị hiển thị trong ô này.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValues()
Trả về lưới hình chữ nhật của các giá trị cho dải ô này.
Trả về một mảng hai chiều gồm các giá trị được hiển thị, được lập chỉ mục theo hàng, rồi đến cột. Giá trị là đối tượng String
. Giá trị hiển thị có tính đến định dạng ngày, giờ và đơn vị tiền tệ, bao gồm cả các định dạng được áp dụng tự động theo chế độ cài đặt ngôn ngữ của bảng tính. Các ô trống được biểu thị bằng một chuỗi trống trong mảng. Hãy nhớ rằng trong khi chỉ mục dải ô bắt đầu từ 1, 1
, mảng JavaScript được lập chỉ mục từ [0][0]
.
// The code below gets the displayed values for the range C2:G8 // in the active spreadsheet. Note that this is a JavaScript array. var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues(); Logger.log(values[0][0]);
Cầu thủ trả bóng
String[][]
– Mảng hai chiều của các giá trị.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilter()
Trả về bộ lọc trên trang tính chứa dải ô này hoặc null
nếu không có bộ lọc nào trên trang tính.
let ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); // Gets the existing filter on the sheet that the given range belongs to. let filter = range.getFilter();
Cầu thủ trả bóng
Filter
– Bộ lọc.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontColorObject()
Trả về màu phông chữ của ô ở góc trên cùng bên trái của dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontColorObject().asRgbColor().asHexString());
Cầu thủ trả bóng
Color
– Màu phông chữ của ô trên cùng bên trái trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontColorObjects()
Trả về màu phông chữ của các ô trong dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontColorObjects(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j].asRgbColor().asHexString()); } }
Cầu thủ trả bóng
Color[][]
– Một mảng màu phông chữ hai chiều liên kết với các ô trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontFamilies()
Trả về họ phông chữ của các ô trong dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontFamilies(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Cầu thủ trả bóng
String[][]
– Mảng hai chiều của các bộ phông chữ liên kết với các ô trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontFamily()
Trả về bộ phông chữ của ô ở góc trên cùng bên trái của dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontFamily());
Cầu thủ trả bóng
String
– Bộ phông chữ của ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontLine()
Lấy kiểu đường kẻ của ô ở góc trên cùng bên trái của dải ô ('underline'
, 'line-through'
hoặc 'none'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontLine());
Cầu thủ trả bóng
String
– Dòng phông chữ.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontLines()
Lấy kiểu đường kẻ của các ô trong dải ô ('underline'
, 'line-through'
hoặc 'none'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontLines(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Cầu thủ trả bóng
String[][]
– Một mảng hai chiều gồm các dòng phông chữ liên kết với các ô trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontSize()
Trả về kích thước phông chữ theo kích thước điểm của ô ở góc trên cùng bên trái của dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontSize());
Cầu thủ trả bóng
Integer
– Kích thước phông chữ theo kích thước một điểm.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontSizes()
Trả về kích thước phông chữ của các ô trong dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontSizes(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Cầu thủ trả bóng
Integer[][]
– Mảng hai chiều kích thước phông chữ của văn bản liên kết với các ô trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontStyle()
Trả về kiểu phông chữ ('italic'
hoặc 'normal'
) của ô ở góc trên cùng bên trái của dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontStyle());
Cầu thủ trả bóng
String
– Kiểu phông chữ của văn bản trong ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontStyles()
Trả về kiểu phông chữ của các ô trong dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontStyles(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Cầu thủ trả bóng
String[][]
– Một mảng văn bản hai chiều liên kết với các ô trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontWeight()
Trả về độ đậm phông chữ (bình thường/đậm) của ô ở góc trên cùng bên trái của dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontWeight());
Cầu thủ trả bóng
String
– Độ đậm phông chữ của văn bản trong ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontWeights()
Trả về độ đậm phông chữ của các ô trong dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontWeights(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Cầu thủ trả bóng
String[][]
– Một mảng hai chiều có độ đậm phông chữ của văn bản liên kết với các ô trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormula()
Trả về công thức (ký hiệu A1) cho ô trên cùng bên trái của dải ô hoặc một chuỗi trống nếu ô trống hoặc không chứa công thức.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This assumes you have a function in B5 that sums up // B2:B4 var range = sheet.getRange("B5"); // Logs the calculated value and the formula Logger.log("Calculated value: %s Formula: %s", range.getValue(), range.getFormula());
Cầu thủ trả bóng
String
– Công thức của ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulaR1C1()
Trả về công thức (ký hiệu R1C1) của một ô nhất định hoặc null
nếu không có.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5"); var formula = range.getFormulaR1C1(); Logger.log(formula);
Cầu thủ trả bóng
String
– Công thức trong ký hiệu R1C1.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulas()
Trả về công thức (ký hiệu A1) cho các ô trong dải ô. Các mục nhập trong mảng 2D là các chuỗi trống cho các ô không có công thức.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var formulas = range.getFormulas(); for (var i in formulas) { for (var j in formulas[i]) { Logger.log(formulas[i][j]); } }
Cầu thủ trả bóng
String[][]
– Một mảng công thức hai chiều ở định dạng chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulasR1C1()
Trả về công thức (ký hiệu R1C1) cho các ô trong dải ô. Các mục nhập trong mảng 2D là null
đối với các ô không có công thức.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var formulas = range.getFormulasR1C1(); for (var i in formulas) { for (var j in formulas[i]) { Logger.log(formulas[i][j]); } }
Cầu thủ trả bóng
String[][]
– Một mảng công thức hai chiều trong ký hiệu R1C1.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getGridId()
Trả về mã lưới của trang tính mẹ của dải ô. Mã nhận dạng là các giá trị int ngẫu nhiên không âm.
// Log the grid ID of the first sheet (by tab position) in the spreadsheet. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getGridId());
Cầu thủ trả bóng
Integer
– Mã lưới của trang tính mẹ.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHeight()
Trả về chiều cao của dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // logs 3.0 Logger.log(range.getHeight());
Cầu thủ trả bóng
Integer
– Chiều cao của dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHorizontalAlignment()
Trả về cách căn chỉnh theo chiều ngang của văn bản (trái/giữa/phải) của ô ở góc trên cùng bên trái của dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getHorizontalAlignment());
Cầu thủ trả bóng
String
– Căn chỉnh văn bản theo chiều ngang trong ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHorizontalAlignments()
Trả về cách căn chỉnh theo chiều ngang của các ô trong dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getHorizontalAlignments(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Cầu thủ trả bóng
String[][]
– Một mảng văn bản hai chiều căn chỉnh theo chiều ngang liên kết với các ô trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
Trả về vị trí cột kết thúc.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "4.0" Logger.log(range.getLastColumn());
Cầu thủ trả bóng
Integer
— Vị trí cột kết thúc của dải ô trong bảng tính.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
Trả về vị trí hàng kết thúc.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "4.0" Logger.log(range.getLastRow());
Cầu thủ trả bóng
Integer
– Vị trí hàng kết thúc của dải ô trong bảng tính.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMergedRanges()
Trả về một mảng các đối tượng Range
đại diện cho các ô đã hợp nhất hoàn toàn nằm trong dải ô hiện tại hoặc chứa ít nhất một ô trong dải ô hiện tại.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B3"); var mergedRanges = range.getMergedRanges(); for (var i = 0; i < mergedRanges.length; i++) { Logger.log(mergedRanges[i].getA1Notation()); Logger.log(mergedRanges[i].getDisplayValue()); }
Cầu thủ trả bóng
Range[]
– Một mảng gồm các đối tượng Range
, đại diện cho các ô đã hợp nhất chồng lên dải ô.
getNextDataCell(direction)
Bắt đầu từ ô trong cột đầu tiên và hàng của dải ô, trả về ô tiếp theo theo hướng cho sẵn (là cạnh của một dải ô liền kề có dữ liệu trong đó hoặc ô ở cạnh của bảng tính theo hướng đó). Điều này tương đương với việc nhập
Ctrl+[arrow key]
vào trình chỉnh sửa.
// Assume the active spreadsheet is blank. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("C3:E5"); // Logs "C1" Logger.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getA1Notation());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
direction | Direction | Hướng tìm ô cạnh của khu vực dữ liệu tiếp theo. |
Cầu thủ trả bóng
Range
– Ô cạnh của khu vực lưu trữ dữ liệu hoặc ô ở cạnh của bảng tính.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNote()
Trả về ghi chú liên kết với dải ô cho trước.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getNote());
Cầu thủ trả bóng
String
– Ghi chú liên kết với ô được cho.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNotes()
Trả về các ghi chú liên kết với các ô trong dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getNotes(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Cầu thủ trả bóng
String[][]
– Mảng hai chiều gồm các ghi chú liên kết với các ô trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumColumns()
Trả về số cột trong dải ô này.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); Logger.log(range.getNumColumns());
Cầu thủ trả bóng
Integer
– Số cột trong dải ô này.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumRows()
Trả về số lượng hàng trong dải ô này.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); Logger.log(range.getNumRows());
Cầu thủ trả bóng
Integer
– Số hàng trong dải ô này.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumberFormat()
Nhận định dạng số hoặc ngày của ô trên cùng bên trái của dải ô đã cho. Các mẫu định dạng trả về được mô tả trong tài liệu về API Trang tính.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("C4"); Logger.log(cell.getNumberFormat());
Cầu thủ trả bóng
String
– Định dạng số của ô trên cùng bên trái của dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumberFormats()
Trả về định dạng số hoặc ngày cho các ô trong dải ô. Các mẫu định dạng được trả về được mô tả trong tài liệu về API Trang tính.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var formats = range.getNumberFormats(); for (var i in formats) { for (var j in formats[i]) { Logger.log(formats[i][j]); } }
Cầu thủ trả bóng
String[][]
– Mảng hai chiều của các định dạng số.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRichTextValue()
Trả về giá trị Văn bản đa dạng thức cho ô trên cùng bên trái của dải ô hoặc null
nếu giá trị của ô không phải là văn bản.
// Gets the Rich Text value of cell D4. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("D4:F6"); var richText = range.getRichTextValue(); console.log(richText.getText());
Cầu thủ trả bóng
RichTextValue
– Giá trị Văn bản đa dạng thức của ô trên cùng bên trái trong dải ô hoặc null
nếu giá trị của ô không phải là văn bản.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRichTextValues()
Trả về giá trị Văn bản đa dạng thức cho các ô trong dải ô.
// Gets the Rich Text values for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var values = range.getRichTextValues(); for (var i = 0; i < values.length; i++) { for (var j = 0; j < values[i].length; j++) { console.log(values[i][j].getText()); } }
Cầu thủ trả bóng
RichTextValue[][]
– Mảng hai chiều của các giá trị Văn bản đa dạng thức.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRow()
Trả về vị trí hàng cho dải ô này. Giống hệt với getRowIndex().
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2"); Logger.log(range.getRow());
Cầu thủ trả bóng
Integer
– Vị trí hàng của dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowIndex()
Trả về vị trí hàng cho dải ô này. Giống hệt với getRow().
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2"); Logger.log(range.getRowIndex());
Cầu thủ trả bóng
Integer
– Vị trí hàng của dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Xem thêm
getSheet()
Trả về trang tính chứa dải ô này.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the sheet that the range belongs to. const rangeSheet = range.getSheet(); // Gets the sheet name and logs it to the console. console.log(rangeSheet.getName());
Cầu thủ trả bóng
Sheet
– Trang tính chứa dải ô này.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextDirection()
Trả về hướng văn bản cho ô trên cùng bên trái của dải ô. Trả về null
nếu hướng văn bản của ô được xác định bằng tính năng tự động phát hiện.
// Get the text direction of cell B1. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B1:D4"); Logger.log(range.getTextDirection());
Cầu thủ trả bóng
TextDirection
– Hướng văn bản của ô trên cùng bên trái trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextDirections()
Trả về hướng văn bản cho các ô trong dải ô. Các mục nhập trong mảng 2D là null
đối với các ô sử dụng tính năng phát hiện tự động.
// Get the text directions for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var directions = range.getTextDirections(); for (var i = 0; i < directions.length; i++) { for (var j = 0; j < directions[i].length; j++) { Logger.log(directions[i][j]); } }
Cầu thủ trả bóng
TextDirection[][]
– Mảng hai chiều của hướng văn bản.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextRotation()
Trả về chế độ cài đặt xoay văn bản cho ô trên cùng bên trái của dải ô.
// Log the text rotation settings for a cell. var sheet = SpreadsheetApp.getActiveSheet(); var cell = sheet.getRange("A1"); Logger.log(cell.getTextRotation());
Cầu thủ trả bóng
TextRotation
– Chế độ cài đặt xoay văn bản.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextRotations()
Trả về chế độ cài đặt xoay văn bản cho các ô trong dải ô.
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); var results = range.getTextRotations(); for (var i in results) { for (var j in results[i]) { var rotation = results[i][j]; Logger.log("Cell [%s, %s] has text rotation: %v", i, j, rotation); } }
Cầu thủ trả bóng
TextRotation[][]
– Một mảng xoay văn bản hai chiều liên kết với các ô trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextStyle()
Trả về kiểu văn bản cho ô trên cùng bên trái của dải ô.
// Get the text style of cell D4. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("D4:F6"); var style = range.getTextStyle(); Logger.log(style);
Cầu thủ trả bóng
TextStyle
– Kiểu văn bản của ô trên cùng bên trái trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextStyles()
Trả về kiểu văn bản cho các ô trong dải ô.
// Get the text styles for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var styles = range.getTextStyles(); for (var i = 0; i < styles.length; i++) { for (var j = 0; j < styles[i].length; j++) { Logger.log(styles[i][j]); } }
Cầu thủ trả bóng
TextStyle[][]
– Mảng hai chiều của các kiểu văn bản.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getValue()
Trả về giá trị của ô trên cùng bên trái trong dải ô. Giá trị có thể thuộc loại Number
, Boolean
, Date
hoặc String
tuỳ thuộc vào giá trị của ô. Các ô trống sẽ trả về một chuỗi trống.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the value of the top-left cell in the range and logs it to the console. console.log(range.getValue());
Cầu thủ trả bóng
Object
– Giá trị trong ô này.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getValues()
Trả về lưới hình chữ nhật của các giá trị cho dải ô này.
Trả về một mảng các giá trị hai chiều, được lập chỉ mục theo hàng, rồi đến cột. Giá trị có thể thuộc loại Number
, Boolean
, Date
hoặc String
, tuỳ thuộc vào giá trị của ô. Các ô trống được biểu thị bằng một chuỗi trống trong mảng. Hãy nhớ rằng trong khi chỉ mục phạm vi bắt đầu từ 1, 1
, mảng JavaScript được lập chỉ mục từ [0][0]
.
// The code below gets the values for the range C2:G8 // in the active spreadsheet. Note that this is a JavaScript array. var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues(); Logger.log(values[0][0]);Trong các ứng dụng web, giá trị
Date
không phải là một thông số pháp lý. getValues()
không thể trả về dữ liệu cho ứng dụng web nếu dải ô chứa một ô có giá trị Date
. Thay vào đó, hãy biến đổi tất cả giá trị được truy xuất từ trang tính sang dữ liệu gốc JavaScript được hỗ trợ như Number
, Boolean
hoặc String
.Cầu thủ trả bóng
Object[][]
– Mảng hai chiều của các giá trị.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getVerticalAlignment()
Trả về cách căn chỉnh dọc (trên cùng/giữa/dưới cùng) của ô ở góc trên cùng bên trái của dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getVerticalAlignment());
Cầu thủ trả bóng
String
– Căn chỉnh văn bản theo chiều dọc trong ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getVerticalAlignments()
Trả về cách căn chỉnh dọc của các ô trong dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getVerticalAlignments(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Cầu thủ trả bóng
String[][]
– Một mảng văn bản hai chiều căn chỉnh dọc được liên kết với các ô trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWidth()
Trả về chiều rộng của dải ô trong cột.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the width of the range in number of columns and logs it to the console. console.log(range.getWidth());
Cầu thủ trả bóng
Integer
– Số cột trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrap()
Trả về việc văn bản trong ô có gói hay không. Để xem chiến lược bao bọc chi tiết hơn, hãy sử dụng getWrapStrategy()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getWrap());
Cầu thủ trả bóng
Boolean
– Liệu văn bản trong ô này có xuống dòng tự động hay không.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrapStrategies()
Trả về chiến lược xuống dòng tự động cho các ô trong dải ô.
// Get the text wrapping strategies for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var strategies = range.getWrapStrategies(); for (var i = 0; i < strategies.length; i++) { for (var j = 0; j < strategies[i].length; j++) { Logger.log(strategies[i][j]); } }
Cầu thủ trả bóng
WrapStrategy[][]
– Mảng hai chiều của các chiến lược xuống dòng tự động.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrapStrategy()
Trả về chiến lược xuống dòng tự động cho ô trên cùng bên trái của dải ô.
// Get the text wrapping strategy of cell B1. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B1:D4"); Logger.log(range.getWrapStrategy());
Cầu thủ trả bóng
WrapStrategy
– Chiến lược xuống dòng tự động của ô trên cùng bên trái trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWraps()
Trả về kết quả là văn bản trong các ô đã xuống dòng. Để xem chiến lược bao bọc chi tiết hơn, hãy sử dụng getWrapStrategies()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getVerticalAlignments(); for (var i in results) { for (var j in results[i]) { var isWrapped = results[i][j]; if (isWrapped) { Logger.log("Cell [%s, %s] has wrapped text", i, j); } } }
Cầu thủ trả bóng
Boolean[][]
– Một mảng văn bản hai chiều căn chỉnh dọc được liên kết với các ô trong dải ô.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCells(shiftDimension)
Chèn các ô trống vào dải ô này. Các ô mới giữ lại mọi định dạng có trong các ô đã chiếm dải ô này trước đó. Dữ liệu hiện có trong trang tính dọc theo kích thước được cung cấp sẽ di chuyển ra khỏi dải ô được chèn.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.insertCells(SpreadsheetApp.Dimension.COLUMNS);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
shiftDimension | Dimension | Phương diện mà theo đó thay đổi dữ liệu hiện có. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes()
Chèn các hộp đánh dấu vào mỗi ô trong dải ô, được định cấu hình bằng true
nếu đã đánh dấu và false
nếu đã bỏ đánh dấu. Đặt giá trị của mọi ô trong dải ô thành false
.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'true' for checked // and 'false' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'false'. range.insertCheckboxes();
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes(checkedValue)
Chèn các hộp đánh dấu vào mỗi ô trong dải ô, được định cấu hình với một giá trị tuỳ chỉnh cho đã đánh dấu và một chuỗi trống nếu đã bỏ đánh dấu. Đặt giá trị của mỗi ô trong dải ô thành chuỗi trống.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked // and the empty string for unchecked. Also, sets the value of each cell in the range A1:B10 to // the empty string. range.insertCheckboxes('yes');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
checkedValue | Object | Giá trị đã chọn cho xác thực dữ liệu hộp kiểm. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes(checkedValue, uncheckedValue)
Chèn các hộp đánh dấu vào mỗi ô trong dải ô, được định cấu hình bằng các giá trị tuỳ chỉnh cho trạng thái đã đánh dấu và đã bỏ đánh dấu. Đặt giá trị của mỗi ô trong dải ô thành giá trị tuỳ chỉnh được bỏ đánh dấu.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked // and 'no' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'no'. range.insertCheckboxes('yes', 'no');
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
checkedValue | Object | Giá trị đã chọn cho xác thực dữ liệu hộp kiểm. |
uncheckedValue | Object | Giá trị đã bỏ đánh dấu để xác thực dữ liệu hộp đánh dấu. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isBlank()
Trả về true
nếu dải ô hoàn toàn trống.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.isBlank());
Cầu thủ trả bóng
Boolean
– true
nếu dải ô trống; nếu không thì là false
.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isChecked()
Trả về xem tất cả các ô trong dải ô có trạng thái hộp đánh dấu là "đã đánh dấu" hay không. Trả về null
nếu bạn đánh dấu vào một số ô và bỏ đánh dấu các ô còn lại, hoặc nếu một số ô không có xác thực dữ liệu hộp đánh dấu.
var range = SpreadsheetApp.getActive().getRange('A1:A3'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:A3. range.insertCheckboxes('yes', 'no'); var range1 = SpreadsheetApp.getActive().getRange('A1'); range1.setValue('yes'); // Sets the value of isRange1Checked as true as it contains the checked value. var isRange1Checked = range1.isChecked(); var range2 = SpreadsheetApp.getActive().getRange('A2'); range2.setValue('no'); // Sets the value of isRange2Checked as false as it contains the unchecked value. var isRange2Checked = range2.isChecked(); var range3 = SpreadsheetApp.getActive().getRange('A3'); range3.setValue('random'); // Sets the value of isRange3Checked as null, as it contains an invalid checkbox value. var isRange3Checked = range3.isChecked();
Cầu thủ trả bóng
Boolean
– true
, nếu tất cả các ô trong dải ô đều được đánh dấu, false
nếu tất cả các ô trong dải ô chưa được đánh dấu, hoặc null
nếu bất kỳ ô nào được bỏ đánh dấu hoặc không có xác thực dữ liệu hộp đánh dấu.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isEndColumnBounded()
Xác định xem điểm cuối của dải ô có được nối với một cột cụ thể hay không. Ví dụ: đối với các dải ô A1:B10
hoặc B:B
được liên kết với các cột ở cuối dải ô, phương thức này sẽ trả về true
; đối với các dải ô 3:7
hoặc A1:5
chỉ được liên kết với các hàng cụ thể ở cuối dải ô, phương thức này sẽ trả về false
.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the end of the range is bound to a particular column and logs it to the // console. console.log(range.isEndColumnBounded());
Cầu thủ trả bóng
Boolean
– true
nếu điểm kết thúc của dải ô được liên kết với một cột cụ thể; nếu không, false
.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isEndRowBounded()
Xác định xem điểm kết thúc của dải ô có liên kết với một hàng cụ thể hay không. Ví dụ: đối với các dải ô A1:B10
hoặc 3:7
được liên kết với các hàng ở cuối dải ô, phương thức này sẽ trả về true
; đối với các dải ô B:B
hoặc A1:C
chỉ được liên kết với các cột cụ thể ở cuối dải ô, phương thức này sẽ trả về false
.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the end of the range is bound to a particular row and logs it to the console. console.log(range.isEndRowBounded());
Cầu thủ trả bóng
Boolean
– true
nếu điểm kết thúc của dải ô được liên kết với một hàng cụ thể; nếu không thì là false
.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isPartOfMerge()
Trả về true
nếu các ô trong dải ô hiện tại chồng chéo lên bất kỳ ô đã hợp nhất nào.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B3"); // True if any of the cells in A1:B3 is included in a merge. var isPartOfMerge = range.isPartOfMerge();
Cầu thủ trả bóng
Boolean
– true
nếu dải ô chồng chéo lên bất kỳ ô nào đã hợp nhất, nếu không sẽ trả về false
.
isStartColumnBounded()
Xác định xem điểm bắt đầu của dải ô có được liên kết với một cột cụ thể hay không. Ví dụ: đối với dải ô A1:B10
hoặc B:B
được liên kết với các cột ở đầu dải ô, phương thức này sẽ trả về true
; đối với dải ô 3:7
, chỉ được liên kết với một hàng ở đầu dải ô, phương thức này sẽ trả về false
.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the start of the range is bound to a particular column and logs it to the // console. console.log(range.isStartColumnBounded());
Cầu thủ trả bóng
Boolean
– true
nếu điểm bắt đầu của dải ô được liên kết với một cột cụ thể; nếu không, false
.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isStartRowBounded()
Xác định xem điểm bắt đầu của dải ô có được liên kết với một hàng cụ thể hay không. Ví dụ: đối với dải ô A1:B10
hoặc 3:7
được liên kết với các hàng ở đầu dải ô, phương thức này sẽ trả về true
; đối với dải ô B:B
, chỉ liên kết với một cột cụ thể ở đầu dải ô, phương thức này sẽ trả về false
.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the start of the range is bound to a particular row and logs it to the // console. console.log(range.isStartRowBounded());
Cầu thủ trả bóng
Boolean
– true
nếu điểm bắt đầu của dải ô được liên kết với một hàng cụ thể; nếu không thì là false
.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
merge()
Hợp nhất các ô trong dải ô với nhau thành một khối duy nhất.
var sheet = SpreadsheetApp.getActiveSheet(); // The code below 2-dimensionally merges the cells in A1 to B3 sheet.getRange('A1:B3').merge();
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
mergeAcross()
Hợp nhất các ô trong dải ô trên các cột của dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The code below merges cells C5:E5 into one cell var range1 = sheet.getRange("C5:E5"); range1.mergeAcross(); // The code below creates 2 horizontal cells, F5:H5 and F6:H6 var range2 = sheet.getRange("F5:H6"); range2.mergeAcross();
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
mergeVertically()
Hợp nhất các ô trong dải ô với nhau.
var sheet = SpreadsheetApp.getActiveSheet(); // The code below vertically merges the cells in A1 to A10 sheet.getRange('A1:A10').mergeVertically(); // The code below creates 3 merged columns: B1 to B10, C1 to C10, and D1 to D10 sheet.getRange('B1:D10').mergeVertically();
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveTo(target)
Cắt và dán (cả định dạng và giá trị) từ dải ô này vào dải ô mục tiêu.
// The code below moves the first 5 columns over to the 6th column var sheet = SpreadsheetApp.getActiveSheet() sheet.getRange("A1:E").moveTo(sheet.getRange("F1"));
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
target | Range | Một dải ô đích để sao chép dải ô này vào; chỉ vị trí ô trên cùng bên trái là phù hợp. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
offset(rowOffset, columnOffset)
Trả về một dải ô mới được bù trừ khỏi dải ô này bằng số hàng và cột đã cho (có thể là giá trị âm). Dải ô mới có kích thước giống với dải ô ban đầu.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1"); // newCell references B2 var newCell = cell.offset(1, 1);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
rowOffset | Integer | Số hàng xuống từ ô trên cùng bên trái của dải ô; giá trị âm biểu thị các hàng lên từ ô trên cùng bên trái của dải ô. |
columnOffset | Integer | Số lượng cột ngay từ ô trên cùng bên trái của dải ô; giá trị âm biểu thị các cột bên trái từ ô trên cùng bên trái của dải ô. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
offset(rowOffset, columnOffset, numRows)
Trả về một dải ô mới tương đối so với dải ô hiện tại, có điểm trên bên trái bù trừ dải ô hiện tại với các hàng và cột đã cho, và với chiều cao đã cho trong các ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1"); // newCell references B2:B3 var newRange = cell.offset(1, 1, 2);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
rowOffset | Integer | Số hàng xuống từ ô trên cùng bên trái của dải ô; giá trị âm biểu thị các hàng lên từ ô trên cùng bên trái của dải ô. |
columnOffset | Integer | Số lượng cột ngay từ ô trên cùng bên trái của dải ô; giá trị âm biểu thị các cột bên trái từ ô trên cùng bên trái của dải ô. |
numRows | Integer | Chiều cao theo hàng của dải ô mới. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
offset(rowOffset, columnOffset, numRows, numColumns)
Trả về một dải ô mới tương đối so với dải ô hiện tại, có điểm trên bên trái bù trừ khỏi dải ô hiện tại theo các hàng và cột đã cho, cũng như với chiều cao và chiều rộng đã cho trong các ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1"); // newCell references B2:C3 var newRange = cell.offset(1, 1, 2, 2);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
rowOffset | Integer | Số hàng xuống từ ô trên cùng bên trái của dải ô; giá trị âm biểu thị các hàng lên từ ô trên cùng bên trái của dải ô. |
columnOffset | Integer | Số lượng cột ngay từ ô trên cùng bên trái của dải ô; giá trị âm biểu thị các cột bên trái từ ô trên cùng bên trái của dải ô. |
numRows | Integer | Chiều cao theo hàng của dải ô mới. |
numColumns | Integer | Chiều rộng theo cột của dải ô mới. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
protect()
Tạo một đối tượng có thể bảo vệ dải ô không bị chỉnh sửa ngoại trừ người dùng có quyền. Cho đến khi tập lệnh thực sự thay đổi danh sách trình chỉnh sửa cho dải ô (bằng cách gọi Protection.removeEditor(emailAddress)
, Protection.removeEditor(user)
, Protection.removeEditors(emailAddresses)
, Protection.addEditor(emailAddress)
, Protection.addEditor(user)
, Protection.addEditors(emailAddresses)
hoặc đặt một giá trị mới cho Protection.setDomainEdit(editable)
), các quyền đó sẽ phản ánh các quyền của chính bảng tính, điều này có nghĩa là dải ô vẫn không được bảo vệ. Nếu dải ô đã được bảo vệ, phương thức này sẽ tạo một dải ô được bảo vệ mới chồng lên dải ô hiện có. Nếu một ô được bảo vệ bằng nhiều dải ô được bảo vệ và bất kỳ dải ô nào trong số đó ngăn một người dùng cụ thể chỉnh sửa ô, thì người dùng đó không được phép chỉnh sửa ô.
// Protect range A1:B10, then remove all other users from the list of editors. var ss = SpreadsheetApp.getActive(); var range = ss.getRange('A1:B10'); var protection = range.protect().setDescription('Sample protected range'); // Ensure the current user is an editor before removing others. Otherwise, if the user's edit // permission comes from a group, the script throws an exception upon removing the group. var me = Session.getEffectiveUser(); protection.addEditor(me); protection.removeEditors(protection.getEditors()); if (protection.canDomainEdit()) { protection.setDomainEdit(false); }
Cầu thủ trả bóng
Protection
– Đối tượng đại diện cho các chế độ cài đặt bảo vệ.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
randomize()
Sắp xếp ngẫu nhiên thứ tự của các hàng trong dải ô đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:C7"); // Randomizes the range range.randomize();
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeCheckboxes()
Xoá tất cả các hộp đánh dấu khỏi dải ô. Xoá tính năng xác thực dữ liệu của từng ô và xoá thêm giá trị của ô đó nếu ô chứa giá trị đã đánh dấu hoặc đã bỏ đánh dấu.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:B10. range.insertCheckboxes('yes', 'no'); var range1 = SpreadsheetApp.getActive().getRange('A1'); range1.setValue('yes'); // Removes the checkbox data validation in cell A1 and clears its value. range1.removeCheckboxes(); var range2 = SpreadsheetApp.getActive().getRange('A2'); range2.setValue('random'); // Removes the checkbox data validation in cell A2 but does not clear its value. range2.removeCheckboxes();
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeDuplicates()
Xoá các hàng trong dải ô này chứa giá trị trùng lặp với các giá trị trong mọi hàng trước đó. Các hàng có giá trị giống nhau nhưng khác kiểu chữ, định dạng hoặc công thức thì được coi là trùng lặp. Phương thức này cũng xoá các hàng trùng lặp bị ẩn khỏi chế độ xem (ví dụ: do bộ lọc). Nội dung nằm ngoài phạm vi này sẽ không bị xoá.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B1:D7"); // Remove duplicate rows in the range. range.removeDuplicates();
Cầu thủ trả bóng
Range
— Dải ô thu được sau khi xoá các ô trùng lặp. Kích thước của dải ô được giảm đi một hàng cho mỗi hàng bị xoá.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeDuplicates(columnsToCompare)
Xoá các hàng trong dải ô này có chứa giá trị trong các cột được chỉ định là bản sao của các giá trị bất kỳ trước đó. Các hàng có giá trị giống nhau nhưng kiểu chữ, định dạng hoặc công thức khác nhau thì được coi là trùng lặp. Phương thức này cũng xoá các hàng trùng lặp bị ẩn khỏi khung hiển thị (ví dụ: do bộ lọc). Nội dung nằm ngoài phạm vi này sẽ không bị xoá.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B1:D7"); // Remove rows which have duplicate values in column B. range.removeDuplicates([2]); // Remove rows which have duplicate values in both columns B and D. range.removeDuplicates([2,4]);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
columnsToCompare | Integer[] | Các cột cần phân tích để tìm giá trị trùng lặp. Nếu không cung cấp cột nào, thì tất cả các cột sẽ được phân tích để tìm bản sao. |
Cầu thủ trả bóng
Range
— Dải ô thu được sau khi xoá các ô trùng lặp. Kích thước của dải ô được giảm đi một hàng cho mỗi hàng bị xoá.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackground(color)
Đặt màu nền cho tất cả các ô trong dải ô trong ký hiệu CSS (chẳng hạn như '#ffffff'
hoặc 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); range.setBackground("red");
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
color | String | Mã màu trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white' ); giá trị null sẽ đặt lại màu sắc. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundObject(color)
Đặt màu nền cho tất cả ô trong dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var bgColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); var range = sheet.getRange("B2:D5"); range.setBackgroundObject(bgColor);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
color | Color | Màu nền cần đặt; giá trị null sẽ đặt lại màu nền. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundObjects(color)
Đặt một lưới hình chữ nhật gồm các màu nền (phải phù hợp với kích thước của dải ô này).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colorAccent1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var colorAccent2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var colorAccent3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var colorAccent4 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4) .build(); var colors = [ [colorAccent1, colorAccent2], [colorAccent3, colorAccent4] ]; var cell = sheet.getRange("B5:C6"); cell.setBackgroundObjects(colors);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
color | Color[][] | Một mảng màu hai chiều; các giá trị null sẽ đặt lại màu. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundRGB(red, green, blue)
Đặt nền thành màu đã cho bằng cách sử dụng các giá trị RGB (số nguyên từ 0 đến 255).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Sets the background to white cell.setBackgroundRGB(255, 255, 255); // Sets the background to red cell.setBackgroundRGB(255, 0, 0);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
red | Integer | Giá trị màu đỏ trong ký hiệu RGB. |
green | Integer | Giá trị màu xanh lục trong ký hiệu RGB. |
blue | Integer | Giá trị màu xanh dương trong ký hiệu RGB. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgrounds(color)
Đặt một lưới hình chữ nhật gồm các màu nền (phải phù hợp với kích thước của dải ô này). Màu sắc nằm trong ký hiệu CSS (chẳng hạn như '#ffffff'
hoặc 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colors = [ ["red", "white", "blue"], ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents ]; var cell = sheet.getRange("B5:D6"); cell.setBackgrounds(colors);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
color | String[][] | Một mảng màu hai chiều trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white' ); các giá trị null sẽ đặt lại màu sắc. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal)
Đặt thuộc tính đường viền. Các giá trị hợp lệ là true
(bật), false
(tắt) và null
(không thay đổi).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Sets borders on the top and bottom, but leaves the left and right unchanged cell.setBorder(true, null, true, null, false, false);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
top | Boolean | true cho đường viền, false cho không có, null nếu không thay đổi. |
left | Boolean | true cho đường viền, false cho không có, null nếu không thay đổi. |
bottom | Boolean | true cho đường viền, false cho không có, null nếu không thay đổi. |
right | Boolean | true cho đường viền, false cho không có, null nếu không thay đổi. |
vertical | Boolean | true cho đường viền dọc nội bộ, false cho không có, null không thay đổi. |
horizontal | Boolean | true cho đường viền ngang nội bộ, false cho không có, null nếu không thay đổi. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal, color, style)
Đặt thuộc tính đường viền bằng màu sắc và/hoặc kiểu. Các giá trị hợp lệ là true
(bật), false
(tắt) và null
(không thay đổi). Đối với màu sắc, hãy sử dụng Màu trong ký hiệu CSS (chẳng hạn như '#ffffff'
hoặc 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Sets borders on the top and bottom, but leaves the left and right unchanged // Also sets the color to "red", and the border to "DASHED". cell.setBorder(true, null, true, null, false, false, "red", SpreadsheetApp.BorderStyle.DASHED);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
top | Boolean | true cho đường viền, false cho không có, null nếu không thay đổi. |
left | Boolean | true cho đường viền, false cho không có, null nếu không thay đổi. |
bottom | Boolean | true cho đường viền, false cho không có, null nếu không thay đổi. |
right | Boolean | true cho đường viền, false cho không có, null nếu không thay đổi. |
vertical | Boolean | true cho đường viền dọc nội bộ, false cho không có, null không thay đổi. |
horizontal | Boolean | true cho đường viền ngang nội bộ, false cho không có, null nếu không thay đổi. |
color | String | Một màu trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white' ), null cho màu mặc định (đen). |
style | BorderStyle | Kiểu đường viền, null cho kiểu mặc định (đồng nhất). |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDataValidation(rule)
Đặt một quy tắc xác thực dữ liệu cho tất cả các ô trong dải ô.
// Set the data validation rule for cell A1 to require a value from B1:B10. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build(); cell.setDataValidation(rule);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
rule | DataValidation | Quy tắc xác thực dữ liệu cần đặt, hoặc null để xoá tính năng xác thực dữ liệu. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDataValidations(rules)
Đặt quy tắc xác thực dữ liệu cho tất cả các ô trong dải ô. Phương thức này sử dụng một mảng xác thực dữ liệu hai chiều, lập chỉ mục theo hàng rồi đến cột. Kích thước mảng phải tương ứng với kích thước dải ô.
// Set the data validation rules for Sheet1!A1:B5 to require a value from Sheet2!A1:A10. var destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5'); var sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build(); var rules = destinationRange.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { rules[i][j] = rule; } } destinationRange.setDataValidations(rules);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
rules | DataValidation[][] | Một mảng hai chiều gồm các quy tắc xác thực dữ liệu cần thiết lập; các giá trị null sẽ xoá phương thức xác thực dữ liệu. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColor(color)
Đặt màu phông chữ trong ký hiệu CSS (chẳng hạn như '#ffffff'
hoặc 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontColor("red");
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
color | String | Màu phông chữ trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white' ); giá trị null sẽ đặt lại màu sắc. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColorObject(color)
Đặt màu phông chữ của dải ô đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); var cell = sheet.getRange("B2"); cell.setFontColor(color);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
color | Color | Màu phông chữ cần đặt; giá trị null sẽ đặt lại màu. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColorObjects(colors)
Đặt một lưới hình chữ nhật gồm các màu phông chữ (phải phù hợp với kích thước của dải ô này).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colorAccent1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var colorAccent2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var colorAccent3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var colorAccent4 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4) .build(); var colors = [ [colorAccent1, colorAccent2], [colorAccent3, colorAccent4] ]; var cell = sheet.getRange("B5:C6"); cell.setFontColorObjects(colors);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
colors | Color[][] | Một mảng màu hai chiều; các giá trị null đặt lại màu phông chữ. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColors(colors)
Đặt một lưới hình chữ nhật gồm các màu phông chữ (phải phù hợp với kích thước của dải ô này). Màu sẽ được thể hiện trong ký hiệu CSS (chẳng hạn như '#ffffff'
hoặc 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colors = [ ["red", "white", "blue"], ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents ]; var cell = sheet.getRange("B5:D6"); cell.setFontColors(colors);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
colors | Object[][] | Một mảng màu hai chiều trong ký hiệu CSS (chẳng hạn như '#ffffff' hoặc 'white' ); các giá trị null sẽ đặt lại màu sắc. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontFamilies(fontFamilies)
Đặt một lưới hình chữ nhật gồm các bộ phông chữ (phải phù hợp với kích thước của dải ô này). Ví dụ về bộ phông chữ là "Gradle" hoặc "Negative".
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var fonts = [ ["Arial", "Helvetica", "Verdana"], ["Courier New", "Arial", "Helvetica] ]; var cell = sheet.getRange("B2:D3"); cell.setFontFamilies(fonts);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
fontFamilies | Object[][] | Một mảng hai chiều của các bộ phông chữ; các giá trị null sẽ đặt lại bộ phông chữ. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontFamily(fontFamily)
Đặt bộ phông chữ, chẳng hạn như "ví dụ" hoặc " rằng".
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontFamily("Helvetica");
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
fontFamily | String | Bộ phông chữ cần đặt; giá trị null sẽ đặt lại bộ phông chữ. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontLine(fontLine)
Đặt kiểu dòng phông chữ của dải ô đã cho ('underline'
, 'line-through'
hoặc 'none'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontLine("line-through");
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
fontLine | String | Kiểu dòng phông chữ, 'underline' , 'line-through' hoặc 'none' ; giá trị null sẽ đặt lại kiểu dòng phông chữ. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontLines(fontLines)
Đặt một lưới hình chữ nhật của các kiểu đường kẻ (phải phù hợp với kích thước của dải ô này).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontLines = [ ["underline", "line-through", "none"] ]; var range = sheet.getRange("B2:D2"); range.setFontLines(fontLines);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
fontLines | Object[][] | Một mảng hai chiều gồm các kiểu dòng phông chữ ('underline' , 'line-through' hoặc 'none' ); giá trị null sẽ đặt lại kiểu dòng phông chữ. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontSize(size)
Đặt kích thước phông chữ, với kích thước là kích thước điểm sẽ sử dụng.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontSize(20);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
size | Integer | Cỡ chữ bằng cỡ chữ. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontSizes(sizes)
Đặt một lưới chữ nhật có kích thước phông chữ (phải phù hợp với kích thước của phạm vi này). Kích thước được tính theo điểm.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontSizes = [ [16, 20, 24] ]; var range = sheet.getRange("B2:D2"); range.setFontSizes(fontSizes);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
sizes | Object[][] | Mảng hai chiều có kích thước. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontStyle(fontStyle)
Đặt kiểu phông chữ cho dải ô đã cho ('italic'
hoặc 'normal'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontStyle("italic");
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
fontStyle | String | Kiểu phông chữ, 'italic' hoặc 'normal' ; giá trị null sẽ đặt lại kiểu phông chữ. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontStyles(fontStyles)
Đặt một lưới chữ nhật gồm các kiểu phông chữ (phải phù hợp với kích thước của dải ô này).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontStyles = [ ["italic", "normal"] ]; var range = sheet.getRange("B2:C2"); range.setFontStyles(fontStyles);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
fontStyles | Object[][] | Một mảng hai chiều các kiểu phông chữ, 'italic' hoặc 'normal' ; các giá trị null sẽ đặt lại kiểu phông chữ. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontWeight(fontWeight)
Đặt độ đậm phông chữ cho phạm vi đã cho (bình thường/in đậm).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontWeight("bold");
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
fontWeight | String | Độ đậm phông chữ, 'bold' hoặc 'normal' ; giá trị null sẽ đặt lại độ đậm phông chữ. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontWeights(fontWeights)
Đặt lưới chữ nhật có độ đậm phông chữ (phải phù hợp với kích thước của dải ô này). Một ví dụ về độ đậm phông chữ là "in đậm".
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontStyles = [ [ "bold", "bold", "normal" ] ]; var range = sheet.getRange("B2:D2"); range.setFontWeights(fontStyles);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
fontWeights | Object[][] | Một mảng hai chiều có độ đậm phông chữ, 'bold' hoặc 'normal' ; các giá trị null sẽ đặt lại độ đậm phông chữ. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormula(formula)
Cập nhật công thức cho dải ô này. Công thức đã cho phải ở dạng ký hiệu A1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); cell.setFormula("=SUM(B3:B4)");
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
formula | String | Một chuỗi đại diện cho công thức cần đặt cho ô. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulaR1C1(formula)
Cập nhật công thức cho dải ô này. Công thức đã cho phải ở dạng ký hiệu R1C1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); // This sets the formula to be the sum of the 3 rows above B5 cell.setFormulaR1C1("=SUM(R[-3]C[0]:R[-1]C[0])");
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
formula | String | Công thức chuỗi. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulas(formulas)
Thiết lập một lưới hình chữ nhật cho các công thức (phải phù hợp với kích thước của dải ô này). Các công thức đã cho phải ở dạng ký hiệu A1. Phương thức này sử dụng một mảng công thức hai chiều, được lập chỉ mục theo hàng, sau đó là cột. Các kích thước mảng phải tương ứng với các kích thước của dải ô.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This sets the formulas to be a row of sums, followed by a row of averages right below. // The size of the two-dimensional array must match the size of the range. var formulas = [ ["=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"], ["=AVERAGE(B2:B4)", "=AVERAGE(C2:C4)", "=AVERAGE(D2:D4)"] ]; var cell = sheet.getRange("B5:D6"); cell.setFormulas(formulas);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
formulas | String[][] | Một mảng chuỗi hai chiều của các công thức. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulasR1C1(formulas)
Thiết lập một lưới hình chữ nhật cho các công thức (phải phù hợp với kích thước của dải ô này). Các công thức đã cho phải ở dạng ký hiệu R1C1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This creates formulas for a row of sums, followed by a row of averages. var sumOfRowsAbove = "=SUM(R[-3]C[0]:R[-1]C[0])"; var averageOfRowsAbove = "=AVERAGE(R[-4]C[0]:R[-2]C[0])"; // The size of the two-dimensional array must match the size of the range. var formulas = [ [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove], [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove] ]; var cell = sheet.getRange("B5:D6"); // This sets the formula to be the sum of the 3 rows above B5. cell.setFormulasR1C1(formulas);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
formulas | String[][] | Một mảng công thức hai chiều ở định dạng R1C1. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHorizontalAlignment(alignment)
Đặt căn chỉnh ngang (từ trái sang phải) cho dải ô đã cho (trái/giữa/phải).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setHorizontalAlignment("center");
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
alignment | String | Cách căn chỉnh, 'left' , 'center' hoặc 'normal' ; giá trị null sẽ đặt lại cách căn chỉnh. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHorizontalAlignments(alignments)
Thiết lập một lưới hình chữ nhật gồm các căn chỉnh ngang. xem setHorizontalAlignment(alignment)
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var horizontalAlignments = [ [ "left", "right", "center" ] ]; var range = sheet.getRange("B2:D2"); range.setHorizontalAlignments(horizontalAlignments);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
alignments | Object[][] | Một mảng hai chiều của căn chỉnh, 'left' , 'center' hoặc 'normal' ; giá trị null sẽ đặt lại cách căn chỉnh. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Xem thêm
setNote(note)
Đặt ghi chú thành giá trị đã cho.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setNote("This is a note");
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
note | String | Giá trị ghi chú cần đặt cho dải ô; giá trị null sẽ xoá ghi chú. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNotes(notes)
Đặt một lưới hình chữ nhật ghi chú (phải phù hợp với kích thước của dải ô này).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var notes = [ ["it goes", "like this", "the fourth, the fifth"], ["the minor fall", "and the", "major lift"] ]; var cell = sheet.getRange("B2:D3"); cell.setNotes(notes)
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
notes | Object[][] | Một mảng ghi chú hai chiều; giá trị null sẽ xoá ghi chú. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Xem thêm
setNumberFormat(numberFormat)
Đặt định dạng số hoặc ngày thành chuỗi định dạng cho sẵn. Các mẫu định dạng được chấp nhận được mô tả trong tài liệu về API Trang tính.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Always show 3 decimal points cell.setNumberFormat("0.000");
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
numberFormat | String | Chuỗi định dạng số. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNumberFormats(numberFormats)
Đặt một lưới hình chữ nhật có định dạng số hoặc ngày (phải phù hợp với kích thước của phạm vi này). Các giá trị là các chuỗi mẫu định dạng như mô tả trong tài liệu về API Trang tính.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var formats = [ [ "0.000", "0,000,000", "$0.00" ] ]; var range = sheet.getRange("B2:D2"); range.setNumberFormats(formats);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
numberFormats | Object[][] | Mảng hai chiều của các định dạng số. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRichTextValue(value)
Đặt giá trị Văn bản đa dạng thức cho các ô trong dải ô.
// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello" bolded. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); var bold = SpreadsheetApp.newTextStyle() .setBold(true) .build(); var richText = SpreadsheetApp.newRichTextValue() .setText("Hello world") .setTextStyle(0, 5, bold) .build(); range.setRichTextValue(richText);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
value | RichTextValue | Giá trị Văn bản đa dạng thức mong muốn. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRichTextValues(values)
Đặt một lưới hình chữ nhật gồm các giá trị của Văn bản đa dạng thức.
// Sets the cells in range A1:A2 to have Rich Text values. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:A2"); var bold = SpreadsheetApp.newTextStyle() .setBold(true) .build(); var italic = SpreadsheetApp.newTextStyle() .setItalic(true) .build(); var richTextA1 = SpreadsheetApp.newRichTextValue() .setText("This cell is bold") .setTextStyle(bold) .build(); var richTextA2 = SpreadsheetApp.newRichTextValue() .setText("bold words, italic words") .setTextStyle(0, 11, bold) .setTextStyle(12, 24, italic) .build(); range.setRichTextValues([[richTextA1], [richTextA2]]);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
values | RichTextValue[][] | Giá trị Văn bản đa dạng thức mong muốn. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setShowHyperlink(showHyperlink)
Đặt xem dải ô có hiển thị siêu liên kết hay không.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A30 and sets its hyperlink value. const range = sheet.getRange('A30'); range.setValue('https://www.example.com'); // Sets cell A30 to show hyperlinks. range.setShowHyperlink(true);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
showHyperlink | Boolean | Có hiển thị siêu liên kết hay không. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextDirection(direction)
Đặt hướng văn bản cho các ô trong dải ô. Nếu hướng được chỉ định là null
, thì hướng sẽ được dự đoán và sau đó đặt.
// Sets right-to-left text direction for the range. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
direction | TextDirection | Hướng văn bản mong muốn; nếu null thì hướng được dự đoán trước khi đặt. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextDirections(directions)
Thiết lập một lưới hình chữ nhật cho hướng văn bản. Nếu một hướng đã chỉ định là null
, thì hướng đó sẽ được dự đoán và sau đó được đặt.
// Copies all of the text directions from range A1:B2 over to range C5:D6. var sheet = SpreadsheetApp.getActiveSheet(); var range1 = sheet.getRange("A1:B2"); var range2 = sheet.getRange("C5:D6"); range2.setTextRotations(range1.getTextDirections());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
directions | TextDirection[][] | Hướng văn bản mong muốn; nếu một hướng được chỉ định là null , thì hướng này sẽ được dự đoán trước khi đặt. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotation(degrees)
Đặt chế độ xoay văn bản cho các ô trong dải ô. Đầu vào tương ứng với góc giữa hướng văn bản chuẩn và hướng mong muốn. Giá trị đầu vào là 0 cho biết văn bản được đặt theo hướng chuẩn.
Đối với hướng văn bản từ trái sang phải, các góc dương sẽ ngược chiều kim đồng hồ, còn đối với văn bản từ phải sang trái thì theo chiều kim đồng hồ.
// Sets all cell's in range B2:D4 to have text rotated up 45 degrees. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); range.setTextRotation(45);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
degrees | Integer | Góc mong muốn giữa hướng chuẩn và hướng mong muốn. Đối với văn bản từ trái sang phải, các góc dương ngược chiều kim đồng hồ. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotation(rotation)
Đặt chế độ xoay văn bản cho các ô trong dải ô.
// Sets all cell's in range B2:D4 to have the same text rotation settings as cell A1. var sheet = SpreadsheetApp.getActiveSheet(); var rotation = sheet.getRange("A1").getTextRotation(); sheet.getRange("B2:D4").setTextRotation(rotation);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
rotation | TextRotation | Chế độ cài đặt xoay văn bản mong muốn. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotations(rotations)
Thiết lập một lưới hình chữ nhật xoay văn bản.
// Copies all of the text rotations from range A1:B2 over to range C5:D6. var sheet = SpreadsheetApp.getActiveSheet(); var range1 = sheet.getRange("A1:B2"); var range2 = sheet.getRange("C5:D6"); range2.setTextRotations(range1.getTextRotations());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
rotations | TextRotation[][] | Chế độ cài đặt xoay văn bản mong muốn. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextStyle(style)
Đặt kiểu văn bản cho các ô trong dải ô.
// Sets the cells in range C5:D6 to have underlined size 15 font. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("C5:D6"); var style = SpreadsheetApp.newTextStyle() .setFontSize(15) .setUnderline(true) .build(); range.setTextStyle(style);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
style | TextStyle | Kiểu văn bản mong muốn. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextStyles(styles)
Thiết lập các kiểu văn bản theo bố cục lưới hình chữ nhật.
// Sets text styles for cells in range A1:B2 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B2"); var bold = SpreadsheetApp.newTextStyle() .setBold(true) .build(); var otherStyle = SpreadsheetApp.newTextStyle() .setBold(true) .setUnderline(true) .setItalic(true) .setForegroundColor("#335522") .setFontSize(44) .build(); range.setTextStyles([[bold, otherStyle], [otherStyle, bold]]);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
styles | TextStyle[][] | Kiểu văn bản mong muốn. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setValue(value)
Đặt giá trị của dải ô. Giá trị có thể là số, chuỗi, boolean hoặc ngày. Nếu bắt đầu bằng '='
, thì hệ thống sẽ hiểu đó là một công thức.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setValue(100);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
value | Object | Giá trị của dải ô. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setValues(values)
Đặt một lưới hình chữ nhật gồm các giá trị (phải khớp với kích thước của dải ô này). Nếu một giá trị bắt đầu bằng =
, giá trị đó được hiểu là một công thức.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var values = [ [ "2.000", "1,000,000", "$2.99" ] ]; var range = sheet.getRange("B2:D2"); range.setValues(values);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
values | Object[][] | Một mảng giá trị hai chiều. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalAlignment(alignment)
Đặt cách căn chỉnh dọc (trên cùng xuống dưới cùng) cho phạm vi đã cho (trên cùng/giữa/dưới cùng).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setVerticalAlignment("middle");
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
alignment | String | Cách căn chỉnh, 'top' , 'middle' hoặc 'bottom' ; giá trị null sẽ đặt lại cách căn chỉnh. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalAlignments(alignments)
Đặt một lưới hình chữ nhật gồm các căn chỉnh dọc (phải phù hợp với kích thước của dải ô này).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var alignments = [ [ "top", "middle", "bottom" ] ]; var range = sheet.getRange("B2:D2"); range.setVerticalAlignments(alignments);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
alignments | Object[][] | Một mảng hai chiều căn chỉnh, 'top' , 'middle' hoặc 'bottom' ; giá trị null sẽ đặt lại cách căn chỉnh. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Xem thêm
setVerticalText(isVertical)
Đặt xem có xếp chồng văn bản cho các ô trong dải ô hay không. Nếu văn bản được xếp chồng theo chiều dọc, thì chế độ cài đặt xoay văn bản độ sẽ bị bỏ qua.
// Sets all cell's in range B2:D4 to have vertically stacked text. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); range.setVerticalText(true);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
isVertical | Boolean | Liệu có nên xếp chồng văn bản hay không. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrap(isWrapEnabled)
Đặt gói ô của dải ô đã cho.
Các ô có bật tính năng bao bọc (mặc định) sẽ đổi kích thước để hiển thị toàn bộ nội dung. Các ô có chế độ bao bọc bị vô hiệu hoá sẽ hiển thị nhiều nhất có thể trong ô mà không cần đổi kích thước hoặc chạy sang nhiều dòng.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setWrap(true);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
isWrapEnabled | Boolean | Có nên xuống dòng tự động hay không. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrapStrategies(strategies)
Thiết lập một lưới hình chữ nhật cho các chiến lược bao bọc.
// Copies all of the wrap strategies from range A1:B2 over to range C5:D6. var sheet = SpreadsheetApp.getActiveSheet(); var range1 = sheet.getRange("A1:B2"); var range2 = sheet.getRange("C5:D6"); range2.setWrapStrategies(range1.getWrapStrategies());
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
strategies | WrapStrategy[][] | Chiến lược gói mong muốn. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrapStrategy(strategy)
Đặt chiến lược xuống dòng tự động cho các ô trong dải ô.
// Sets all cells in range B2:D4 to use the clip wrap strategy. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
strategy | WrapStrategy | Chiến lược xuống dòng mong muốn. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWraps(isWrapEnabled)
Thiết lập một lưới hình chữ nhật gồm các chính sách xuống dòng tự động (phải khớp với kích thước của dải ô này). Các ô đã bật tính năng bao bọc (mặc định) sẽ đổi kích thước để hiển thị toàn bộ nội dung của ô. Các ô bị vô hiệu hoá tính năng bao bọc sẽ hiển thị nhiều nhất có thể trong ô mà không cần đổi kích thước hoặc chạy lên nhiều dòng.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var wraps = [ [ true, true, false ] ]; var range = sheet.getRange("B2:D2"); range.setWraps(wraps);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
isWrapEnabled | Object[][] | Một mảng 2 chiều các biến gói giúp xác định xem có nên gói văn bản trong một ô hay không. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Xem thêm
shiftColumnGroupDepth(delta)
Thay đổi độ sâu nhóm cột của dải ô theo số lượng được chỉ định.
Điều này có tác dụng tạo, sửa đổi hoặc xoá các nhóm giao nhau với dải ô. Đối với delta dương, các nhóm được tạo và/hoặc sửa đổi; đối với delta âm, các nhóm bị huỷ bỏ và/hoặc sửa đổi.
Việc này không có tác dụng khi giảm độ sâu của nhóm xuống dưới 0 hoặc trên 8.
Nếu column group control position
là BEFORE
, lỗi này sẽ xảy ra khi cố gắng di chuyển độ sâu của hàng đầu tiên.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // The column grouping depth is increased by 1. range.shiftColumnGroupDepth(1); // The column grouping depth is decreased by 1. range.shiftColumnGroupDepth(-1);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
delta | Integer | Số lượng cần thay đổi độ sâu nhóm cột của dải ô này. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Gửi
Error
– khi cố gắng thay đổi độ sâu của cột đầu tiên khi vị trí điều khiển là GroupControlTogglePosition.BEFORE
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
shiftRowGroupDepth(delta)
Thay đổi độ sâu nhóm hàng của dải ô theo số lượng được chỉ định.
Điều này có tác dụng tạo, sửa đổi hoặc xoá các nhóm giao nhau với dải ô. Đối với delta dương, các nhóm được tạo và/hoặc sửa đổi; đối với delta âm, các nhóm bị huỷ bỏ và/hoặc sửa đổi.
Việc này không có tác dụng khi giảm độ sâu của nhóm xuống dưới 0 hoặc trên 8.
Nếu row group control position
là BEFORE
, lỗi này sẽ xảy ra khi cố gắng di chuyển độ sâu của hàng đầu tiên.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // The row grouping depth is increased by 1. range.shiftRowGroupDepth(1); // The row grouping depth is decreased by 1. range.shiftRowGroupDepth(-1);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
delta | Integer | Số lượng cần thay đổi chiều sâu nhóm hàng của phạm vi này. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Gửi
Error
– khi bạn cố gắng thay đổi độ sâu của hàng đầu tiên khi vị trí điều khiển là GroupControlTogglePosition.BEFORE
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(sortSpecObj)
Sắp xếp các ô trong dải ô cho trước, theo cột và thứ tự đã chỉ định.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:C7"); // Sorts by the values in the first column (A) range.sort(1); // Sorts by the values in the second column (B) range.sort(2); // Sorts descending by column B range.sort({column: 2, ascending: false}); // Sorts descending by column B, then ascending by column A // Note the use of an array range.sort([{column: 2, ascending: false}, {column: 1, ascending: true}]); // For rows that are sorted in ascending order, the "ascending" parameter is // optional, and just an integer with the column can be used instead. Note that // in general, keeping the sort specification consistent results in more readable // code. You can express the earlier sort as: range.sort([{column: 2, ascending: false}, 1]); // Alternatively, if you want all columns to be in ascending order, you can use // the following (this makes column 2 ascending) range.sort([2, 1]); // ... which is equivalent to range.sort([{column: 2, ascending: true}, {column: 1, ascending: true}]);
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
sortSpecObj | Object | Các cột cần sắp xếp. |
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
splitTextToColumns()
Tách một cột văn bản thành nhiều cột dựa trên dấu phân tách được phát hiện tự động.
// A1:A3 has the following values: // A B C // 1 |one,one,one | | | // 2 |two,two,two | | | // 3 |three,three,three| | | var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3"); range.splitTextToColumns(); // Result after spliting the text to columns: // A B C // 1 |one |one |one | // 2 |two |two |two | // 3 |three |three |three |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
splitTextToColumns(delimiter)
Tách một cột văn bản thành nhiều cột bằng cách sử dụng chuỗi được chỉ định làm dấu phân cách tuỳ chỉnh.
// A1:A3 has the following values: // A B C // 1 |one#one#one | | | // 2 |two#two#two | | | // 3 |three#three#three| | | var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3"); range.splitTextToColumns('#'); // Result after spliting the text to columns: // A B C // 1 |one |one |one | // 2 |two |two |two | // 3 |three |three |three |
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
delimiter | String | Dấu phân cách tuỳ chỉnh để tách. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
splitTextToColumns(delimiter)
Tách một cột văn bản thành nhiều cột dựa trên dấu phân cách được chỉ định.
// A1:A3 has the following values: // A B C // 1 |one;one;one | | | // 2 |two;two;two | | | // 3 |three;three;three| | | var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3"); range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON); // Result after spliting the text to columns: // A B C // 1 |one |one |one | // 2 |two |two |two | // 3 |three |three |three |
Các tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
delimiter | TextToColumnsDelimiter | Dấu phân cách đặt trước để tách. |
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
trimWhitespace()
Cắt bỏ khoảng trắng (chẳng hạn như dấu cách, thẻ hoặc dòng mới) trong mỗi ô trong dải ô này. Xoá mọi khoảng trắng ở đầu và cuối văn bản của mỗi ô, đồng thời giảm mọi ký tự còn lại của khoảng trắng còn lại thành một khoảng trắng.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange('A1:A4'); range.activate(); range.setValues( [' preceding space', 'following space ', 'two middle spaces', ' =SUM(1,2)']) range.trimWhitespace(); var values = range.getValues(); // Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
uncheck()
Thay đổi trạng thái của hộp đánh dấu trong dải ô thành "chưa đánh dấu". Bỏ qua các ô trong dải ô hiện không chứa giá trị đã đánh dấu hoặc bỏ đánh dấu.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the range A1:B10 to 'unchecked'. var range = SpreadsheetApp.getActive().getRange('A1:B10'); range.uncheck();
Cầu thủ trả bóng
Range
– Dải ô này để tạo chuỗi.
Ủy quyền
Tập lệnh sử dụng phương thức này cần được uỷ quyền với một hoặc nhiều phạm vi sau:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets