เข้าถึงและแก้ไขช่วงของสเปรดชีต ช่วงหนึ่งอาจเป็นเซลล์เดียวในชีตหรือกลุ่มเซลล์ที่ใกล้เคียงกันในชีต
วิธีการ
วิธีการ | ประเภทการแสดงผล | รายละเอียดแบบย่อ |
---|---|---|
activate() | Range | ตั้งค่าช่วงที่ระบุเป็น active range โดยที่เซลล์ซ้ายบนสุดของช่วงเป็น current cell |
activateAsCurrentCell() | Range | ตั้งค่าเซลล์ที่ระบุเป็น current cell |
addDeveloperMetadata(key) | Range | เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่มีคีย์ที่ระบุไปยังช่วง |
addDeveloperMetadata(key, visibility) | Range | เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์พร้อมคีย์และระดับการเข้าถึงที่ระบุไปยังช่วง |
addDeveloperMetadata(key, value) | Range | เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่มีคีย์และค่าที่ระบุลงในช่วง |
addDeveloperMetadata(key, value, visibility) | Range | เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่มีคีย์ ค่า และระดับการเข้าถึงที่ระบุไปยังช่วง |
applyColumnBanding() | Banding | ใช้ธีมแถบสีเริ่มต้นของคอลัมน์กับช่วง |
applyColumnBanding(bandingTheme) | Banding | ใช้ธีมแถบสีของคอลัมน์ที่ระบุกับช่วง |
applyColumnBanding(bandingTheme, showHeader, showFooter) | Banding | ใช้ธีมแถบคอลัมน์ที่ระบุกับช่วงที่มีการตั้งค่าส่วนหัวและส่วนท้ายที่ระบุไว้ |
applyRowBanding() | Banding | ใช้ธีมแถบแถวตามค่าเริ่มต้นกับช่วง |
applyRowBanding(bandingTheme) | Banding | ใช้ธีมแถบแถวที่ระบุกับช่วง |
applyRowBanding(bandingTheme, showHeader, showFooter) | Banding | ใช้ธีมแถบสีแถวที่ระบุกับช่วงที่มีการตั้งค่าส่วนหัวและส่วนท้ายที่ระบุไว้ |
autoFill(destination, series) | void | เติม destinationRange ด้วยข้อมูลตามข้อมูลในช่วงนี้ |
autoFillToNeighbor(series) | void | คำนวณช่วงที่จะเติมข้อมูลใหม่ตามเซลล์ข้างเคียง และเติมค่าใหม่ในช่วงนั้นโดยอัตโนมัติตามข้อมูลที่มีในช่วงนี้ |
breakApart() | Range | แบ่งเซลล์ที่มีหลายคอลัมน์ในช่วงให้เป็นเซลล์เดี่ยวอีกครั้ง |
canEdit() | Boolean | กำหนดว่าผู้ใช้มีสิทธิ์แก้ไขทุกเซลล์ในช่วงหรือไม่ |
check() | Range | เปลี่ยนสถานะของช่องทำเครื่องหมายในช่วงเป็น "ทำเครื่องหมายแล้ว" |
clear() | Range | ล้างช่วงเนื้อหาและรูปแบบ |
clear(options) | Range | ล้างช่วงของเนื้อหา รูปแบบ กฎการตรวจสอบข้อมูล และ/หรือความคิดเห็นตามที่ระบุด้วยตัวเลือกขั้นสูงที่มีให้ |
clearContent() | Range | ล้างเนื้อหาของช่วง โดยคงการจัดรูปแบบเดิมไว้ |
clearDataValidations() | Range | ล้างกฎการตรวจสอบข้อมูลสำหรับช่วง |
clearFormat() | Range | ล้างการจัดรูปแบบสำหรับช่วงนี้ |
clearNote() | Range | ล้างบันทึกในเซลล์ที่ระบุ |
collapseGroups() | Range | ยุบกลุ่มทั้งหมดที่อยู่ในช่วง |
copyFormatToRange(gridId, column, columnEnd, row, rowEnd) | void | คัดลอกการจัดรูปแบบของช่วงไปยังตำแหน่งที่กำหนด |
copyFormatToRange(sheet, column, columnEnd, row, rowEnd) | void | คัดลอกการจัดรูปแบบของช่วงไปยังตำแหน่งที่กำหนด |
copyTo(destination) | void | คัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงของเซลล์อื่น |
copyTo(destination, copyPasteType, transposed) | void | คัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงของเซลล์อื่น |
copyTo(destination, options) | void | คัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงของเซลล์อื่น |
copyValuesToRange(gridId, column, columnEnd, row, rowEnd) | void | คัดลอกเนื้อหาของช่วงไปยังตำแหน่งที่กำหนด |
copyValuesToRange(sheet, column, columnEnd, row, rowEnd) | void | คัดลอกเนื้อหาของช่วงไปยังตำแหน่งที่กำหนด |
createDataSourcePivotTable(dataSource) | DataSourcePivotTable | สร้างตาราง Pivot ของแหล่งข้อมูลที่ว่างเปล่าจากแหล่งข้อมูล โดยตรึงไว้ที่เซลล์แรกของช่วงนี้ |
createDataSourceTable(dataSource) | DataSourceTable | สร้างตารางแหล่งข้อมูลว่างจากแหล่งข้อมูล โดยตรึงไว้ที่เซลล์แรกของช่วงนี้ |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | แสดงผล DeveloperMetadataFinderApi สำหรับการค้นหาข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ภายในขอบเขตของช่วงนี้ |
createFilter() | Filter | สร้างตัวกรองและนำไปใช้กับช่วงที่ระบุในชีต |
createPivotTable(sourceData) | PivotTable | สร้างตาราง Pivot เปล่าจาก sourceData ที่ระบุโดยตรึงไว้ที่เซลล์แรกของช่วงนี้ |
createTextFinder(findText) | TextFinder | สร้างโปรแกรมค้นหาข้อความสำหรับช่วง ซึ่งสามารถค้นหาและแทนที่ข้อความในช่วงนี้ได้ |
deleteCells(shiftDimension) | void | ลบช่วงของเซลล์นี้ |
expandGroups() | Range | ขยายกลุ่มที่ยุบซึ่งมีช่วงหรือปุ่มสลับการควบคุมตัดกับช่วงนี้ |
getA1Notation() | String | แสดงผลคำอธิบายสตริงของช่วงในรูปแบบ A1 |
getBackground() | String | แสดงผลสีพื้นหลังของเซลล์ซ้ายบนของช่วง (เช่น '#ffffff' ) |
getBackgroundObject() | Color | แสดงผลสีพื้นหลังของเซลล์ซ้ายบนของช่วง |
getBackgroundObjects() | Color[][] | แสดงผลสีพื้นหลังของเซลล์ในช่วง |
getBackgrounds() | String[][] | แสดงผลสีพื้นหลังของเซลล์ในช่วง (เช่น '#ffffff' ) |
getBandings() | Banding[] | แสดงผลแถบสีทั้งหมดที่ใช้กับเซลล์ในช่วงนี้ |
getCell(row, column) | Range | แสดงผลเซลล์ที่ระบุภายในช่วง |
getColumn() | Integer | แสดงตำแหน่งคอลัมน์เริ่มต้นสำหรับช่วงนี้ |
getDataRegion() | Range | แสดงผลสำเนาของช่วงที่ขยายใน Direction คาร์ดินัลทั้ง 4 เซลล์ให้ครอบคลุมเซลล์ที่ใกล้เคียงกันทั้งหมดที่มีข้อมูลอยู่ภายใน |
getDataRegion(dimension) | Range | แสดงผลสำเนาของช่วงที่ขยาย Direction.UP และ Direction.DOWN หากมิติข้อมูลที่ระบุคือ Dimension.ROWS หรือ Direction.NEXT และ Direction.PREVIOUS หากมิติข้อมูลเป็น Dimension.COLUMNS |
getDataSourceFormula() | DataSourceFormula | แสดงผล DataSourceFormula สำหรับเซลล์แรกของช่วง หรือ null หากเซลล์ไม่มีสูตรแหล่งข้อมูล |
getDataSourceFormulas() | DataSourceFormula[] | แสดงผล DataSourceFormula ของเซลล์ในช่วง |
getDataSourcePivotTables() | DataSourcePivotTable[] | รับตาราง Pivot ของแหล่งข้อมูลทั้งหมดที่ตัดกับช่วง |
getDataSourceTables() | DataSourceTable[] | รับตารางแหล่งข้อมูลทั้งหมดที่ตัดกับช่วง |
getDataSourceUrl() | String | แสดง URL สำหรับข้อมูลในช่วงนี้ ซึ่งสามารถใช้เพื่อสร้างแผนภูมิและข้อความค้นหา |
getDataTable() | DataTable | แสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น DataTable |
getDataTable(firstRowIsHeader) | DataTable | แสดงผลข้อมูลในช่วงนี้เป็น DataTable |
getDataValidation() | DataValidation | แสดงผลกฎการตรวจสอบข้อมูลสำหรับเซลล์ซ้ายบนของช่วง |
getDataValidations() | DataValidation[][] | แสดงผลกฎการตรวจสอบข้อมูลสำหรับทุกเซลล์ในช่วง |
getDeveloperMetadata() | DeveloperMetadata[] | รับข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับช่วงนี้ |
getDisplayValue() | String | แสดงผลค่าที่แสดงของเซลล์ซ้ายบนของช่วง |
getDisplayValues() | String[][] | แสดงผลตารางค่าเป็นรูปสี่เหลี่ยมผืนผ้าสำหรับช่วงนี้ |
getFilter() | Filter | แสดงผลตัวกรองในชีตที่เป็นช่วงนี้ หรือ "null " หากไม่มีตัวกรองในชีต |
getFontColorObject() | Color | แสดงผลสีแบบอักษรของเซลล์ที่มุมซ้ายบนของช่วง |
getFontColorObjects() | Color[][] | แสดงผลสีแบบอักษรของเซลล์ในช่วง |
getFontFamilies() | String[][] | แสดงผลชุดแบบอักษรของเซลล์ในช่วง |
getFontFamily() | String | แสดงผลชุดแบบอักษรของเซลล์ที่มุมบนซ้ายของช่วง |
getFontLine() | String | รับรูปแบบเส้นของเซลล์ที่มุมบนซ้ายของช่วง ('underline' , 'line-through' หรือ 'none' ) |
getFontLines() | String[][] | รับรูปแบบเส้นของเซลล์ในช่วง ('underline' , 'line-through' หรือ 'none' ) |
getFontSize() | Integer | แสดงขนาดแบบอักษรในขนาดจุดของเซลล์ที่มุมบนซ้ายของช่วง |
getFontSizes() | Integer[][] | แสดงผลขนาดแบบอักษรของเซลล์ในช่วง |
getFontStyle() | String | แสดงผลรูปแบบแบบอักษร ('italic' หรือ 'normal' ) ของเซลล์ที่มุมซ้ายบนของช่วง |
getFontStyles() | String[][] | แสดงผลรูปแบบตัวอักษรของเซลล์ในช่วง |
getFontWeight() | String | แสดงน้ำหนักแบบอักษร (ปกติ/ตัวหนา) ของเซลล์ที่มุมบนซ้ายของช่วง |
getFontWeights() | String[][] | แสดงผลน้ำหนักแบบอักษรของเซลล์ในช่วง |
getFormula() | String | แสดงผลสูตร (สัญลักษณ์ A1) สำหรับเซลล์ด้านบนซ้ายของช่วง หรือสตริงว่างหากเซลล์ว่างเปล่าหรือไม่มีสูตร |
getFormulaR1C1() | String | จะแสดงผลสูตร (สัญลักษณ์ R1C1) สำหรับเซลล์หนึ่งๆ หรือ null หากไม่มี |
getFormulas() | String[][] | แสดงผลสูตร (หมายเหตุ A1) สำหรับเซลล์ในช่วง |
getFormulasR1C1() | String[][] | แสดงผลสูตร (สัญลักษณ์ R1C1) สำหรับเซลล์ในช่วง |
getGridId() | Integer | แสดงผลรหัสตารางกริดของชีตระดับบนสุดของช่วง |
getHeight() | Integer | แสดงผลความสูงของช่วง |
getHorizontalAlignment() | String | แสดงผลการจัดข้อความแนวนอน (ซ้าย/กลาง/ขวา) ของเซลล์ที่มุมซ้ายบนของช่วง |
getHorizontalAlignments() | String[][] | ส่งคืนการจัดข้อความแนวนอนของเซลล์ในช่วง |
getLastColumn() | Integer | แสดงผลตำแหน่งคอลัมน์สิ้นสุด |
getLastRow() | Integer | แสดงผลตำแหน่งของแถวสิ้นสุด |
getMergedRanges() | Range[] | แสดงผลอาร์เรย์ของออบเจ็กต์ Range ที่แสดงถึงเซลล์ที่ผสานซึ่งอยู่ในช่วงปัจจุบันอย่างสมบูรณ์ หรือมีเซลล์อย่างน้อย 1 เซลล์ในช่วงปัจจุบัน |
getNextDataCell(direction) | Range | เริ่มต้นที่เซลล์ในคอลัมน์และแถวแรกของช่วง จะแสดงผลเซลล์ถัดไปในทิศทางที่กำหนดซึ่งเป็นขอบของช่วงที่อยู่ติดกันของเซลล์ที่มีข้อมูลอยู่ หรือเซลล์ที่ขอบของสเปรดชีตในทิศทางนั้น |
getNote() | String | แสดงผลบันทึกที่เชื่อมโยงกับช่วงที่ระบุ |
getNotes() | String[][] | แสดงผลบันทึกที่เชื่อมโยงกับเซลล์ในช่วง |
getNumColumns() | Integer | แสดงผลจำนวนคอลัมน์ในช่วงนี้ |
getNumRows() | Integer | แสดงผลจำนวนแถวในช่วงนี้ |
getNumberFormat() | String | ดูการจัดรูปแบบตัวเลขหรือวันที่ของเซลล์ซ้ายบนของช่วงที่ต้องการ |
getNumberFormats() | String[][] | แสดงผลรูปแบบตัวเลขหรือวันที่สำหรับเซลล์ในช่วง |
getRichTextValue() | RichTextValue | แสดงผลค่า Rich Text สำหรับเซลล์ซ้ายบนของช่วง หรือ null หากค่าของเซลล์ไม่ใช่ข้อความ |
getRichTextValues() | RichTextValue[][] | แสดงผลค่า Rich Text สำหรับเซลล์ในช่วง |
getRow() | Integer | แสดงตำแหน่งแถวสำหรับช่วงนี้ |
getRowIndex() | Integer | แสดงตำแหน่งแถวสำหรับช่วงนี้ |
getSheet() | Sheet | แสดงผลชีตช่วงนี้ |
getTextDirection() | TextDirection | แสดงทิศทางข้อความสำหรับเซลล์ซ้ายบนของช่วง |
getTextDirections() | TextDirection[][] | แสดงผลทิศทางข้อความสำหรับเซลล์ในช่วง |
getTextRotation() | TextRotation | แสดงการตั้งค่าการหมุนข้อความสำหรับเซลล์ซ้ายบนของช่วง |
getTextRotations() | TextRotation[][] | แสดงผลการตั้งค่าการหมุนข้อความสำหรับเซลล์ในช่วง |
getTextStyle() | TextStyle | แสดงรูปแบบข้อความสำหรับเซลล์ซ้ายบนของช่วง |
getTextStyles() | TextStyle[][] | แสดงผลรูปแบบข้อความสำหรับเซลล์ในช่วง |
getValue() | Object | แสดงผลค่าของเซลล์ด้านบนซ้ายของช่วง |
getValues() | Object[][] | แสดงผลตารางค่าเป็นรูปสี่เหลี่ยมผืนผ้าสำหรับช่วงนี้ |
getVerticalAlignment() | String | ส่งคืนการจัดข้อความแนวตั้ง (บน/กลาง/ล่าง) ของเซลล์ที่มุมซ้ายบนของช่วง |
getVerticalAlignments() | String[][] | ส่งคืนการจัดแนวแนวตั้งของเซลล์ในช่วง |
getWidth() | Integer | แสดงผลความกว้างของช่วงในคอลัมน์ |
getWrap() | Boolean | แสดงผลว่าข้อความในเซลล์ตัดข้อความหรือไม่ |
getWrapStrategies() | WrapStrategy[][] | แสดงกลยุทธ์การตัดข้อความสำหรับเซลล์ในช่วง |
getWrapStrategy() | WrapStrategy | แสดงกลยุทธ์การตัดข้อความสำหรับเซลล์ซ้ายบนของช่วง |
getWraps() | Boolean[][] | แสดงผลว่าข้อความในเซลล์ตัดข้อความหรือไม่ |
insertCells(shiftDimension) | Range | แทรกเซลล์ว่างในช่วงนี้ |
insertCheckboxes() | Range | แทรกช่องทำเครื่องหมายในแต่ละเซลล์ในช่วง โดยกำหนดค่าด้วย true สำหรับการเลือกและ false สำหรับการเลือก |
insertCheckboxes(checkedValue) | Range | แทรกช่องทำเครื่องหมายในแต่ละเซลล์ในช่วง โดยกำหนดค่าด้วยค่าที่กำหนดเองสำหรับทำเครื่องหมายแล้วและสตริงว่างสำหรับยกเลิกการเลือก |
insertCheckboxes(checkedValue, uncheckedValue) | Range | แทรกช่องทำเครื่องหมายในแต่ละเซลล์ในช่วง โดยกำหนดค่าด้วยค่าที่กำหนดเองสำหรับสถานะที่เลือกและยกเลิกการเลือก |
isBlank() | Boolean | แสดงผล true ถ้าช่วงนั้นว่างเปล่าทั้งหมด |
isChecked() | Boolean | แสดงผลว่าเซลล์ทั้งหมดในช่วงมีสถานะช่องทำเครื่องหมายเป็น "ทำเครื่องหมายแล้ว" หรือไม่ |
isEndColumnBounded() | Boolean | ระบุว่าจุดสิ้นสุดของช่วงเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่งหรือไม่ |
isEndRowBounded() | Boolean | ระบุว่าจุดสิ้นสุดของช่วงเชื่อมโยงกับแถวใดแถวหนึ่งหรือไม่ |
isPartOfMerge() | Boolean | แสดงผล true หากเซลล์ในช่วงปัจจุบันทับซ้อนเซลล์ที่ผสาน |
isStartColumnBounded() | Boolean | ระบุว่าจุดเริ่มต้นของช่วงเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่งหรือไม่ |
isStartRowBounded() | Boolean | กำหนดว่าจุดเริ่มต้นของช่วงเชื่อมโยงกับแถวใดแถวหนึ่งหรือไม่ |
merge() | Range | ผสานเซลล์ในช่วงเข้าด้วยกันเป็นบล็อกเดียว |
mergeAcross() | Range | ผสานเซลล์ในช่วงระหว่างคอลัมน์ต่างๆ ของช่วง |
mergeVertically() | Range | ผสานเซลล์ในช่วงเข้าด้วยกัน |
moveTo(target) | void | ตัดและวาง (ทั้งรูปแบบและค่า) จากช่วงนี้ไปยังช่วงเป้าหมาย |
offset(rowOffset, columnOffset) | Range | แสดงผลช่วงใหม่ที่มีออฟเซ็ตจากช่วงนี้ตามจำนวนแถวและคอลัมน์ที่กำหนด (ซึ่งอาจเป็นค่าลบ) |
offset(rowOffset, columnOffset, numRows) | Range | แสดงผลช่วงใหม่ที่สัมพันธ์กับช่วงปัจจุบัน โดยที่จุดด้านซ้ายบนมีออฟเซ็ตจากช่วงปัจจุบันโดยแถวและคอลัมน์ที่ระบุ และแสดงความสูงที่ระบุในเซลล์ |
offset(rowOffset, columnOffset, numRows, numColumns) | Range | แสดงผลช่วงใหม่ที่สัมพันธ์กับช่วงปัจจุบัน โดยที่จุดด้านซ้ายบนมีออฟเซ็ตจากช่วงปัจจุบันด้วยแถวและคอลัมน์ที่ระบุ และด้วยความสูงและความกว้างที่กำหนดในเซลล์ |
protect() | Protection | สร้างออบเจ็กต์ที่ป้องกันไม่ให้แก้ไขช่วงได้ ยกเว้นผู้ใช้ที่มีสิทธิ์ |
randomize() | Range | สุ่มลำดับของแถวในช่วงที่ระบุ |
removeCheckboxes() | Range | นำช่องทำเครื่องหมายทั้งหมดออกจากช่วง |
removeDuplicates() | Range | นำแถวภายในช่วงนี้ที่มีค่าซ้ำกับค่าในแถวก่อนหน้าออก |
removeDuplicates(columnsToCompare) | Range | ลบแถวในช่วงนี้ที่มีค่าในคอลัมน์ที่ระบุซึ่งซ้ำกับค่าในแถวก่อนหน้า |
setBackground(color) | Range | ตั้งค่าสีพื้นหลังของทุกเซลล์ในช่วงในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white' ) |
setBackgroundObject(color) | Range | ตั้งค่าสีพื้นหลังของทุกเซลล์ในช่วง |
setBackgroundObjects(color) | Range | ตั้งค่าตารางสีพื้นหลังเป็นสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) |
setBackgroundRGB(red, green, blue) | Range | ตั้งค่าพื้นหลังเป็นสีที่ระบุโดยใช้ค่า RGB (จำนวนเต็มระหว่าง 0 ถึง 255) |
setBackgrounds(color) | Range | ตั้งค่าตารางสีพื้นหลังเป็นสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) |
setBorder(top, left, bottom, right, vertical, horizontal) | Range | ตั้งค่าคุณสมบัติเส้นขอบ |
setBorder(top, left, bottom, right, vertical, horizontal, color, style) | Range | ตั้งค่าคุณสมบัติเส้นขอบด้วยสีและ/หรือรูปแบบ |
setDataValidation(rule) | Range | ตั้งค่ากฎการตรวจสอบข้อมูล 1 ข้อให้กับทุกเซลล์ในช่วง |
setDataValidations(rules) | Range | ตั้งค่ากฎการตรวจสอบข้อมูลให้กับทุกเซลล์ในช่วง |
setFontColor(color) | Range | ตั้งค่าสีแบบอักษรในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white' ) |
setFontColorObject(color) | Range | ตั้งค่าสีแบบอักษรของช่วงที่ระบุ |
setFontColorObjects(colors) | Range | ตั้งค่าสีแบบอักษรเป็นตารางสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) |
setFontColors(colors) | Range | ตั้งค่าสีแบบอักษรเป็นตารางสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) |
setFontFamilies(fontFamilies) | Range | ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของชุดแบบอักษร (ต้องตรงกับขนาดของช่วงนี้) |
setFontFamily(fontFamily) | Range | ตั้งค่าชุดแบบอักษร เช่น "Arial" หรือ "Helvetica" |
setFontLine(fontLine) | Range | ตั้งค่ารูปแบบบรรทัดแบบอักษรของช่วงที่ระบุ ('underline' , 'line-through' หรือ 'none' ) |
setFontLines(fontLines) | Range | ตั้งค่าตารางรูปสี่เหลี่ยมผืนผ้าของรูปแบบเส้น (ต้องตรงกับขนาดของช่วงนี้) |
setFontSize(size) | Range | ตั้งค่าขนาดแบบอักษร โดยขนาดเท่ากับขนาดของจุดที่จะใช้ |
setFontSizes(sizes) | Range | ตั้งค่าขนาดแบบอักษรเป็นรูปสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) |
setFontStyle(fontStyle) | Range | กำหนดรูปแบบตัวอักษรสำหรับช่วงที่ระบุ ('italic' หรือ 'normal' ) |
setFontStyles(fontStyles) | Range | ตั้งค่าตารางสี่เหลี่ยมผืนผ้าในรูปแบบตัวอักษร (ต้องตรงกับขนาดของช่วงนี้) |
setFontWeight(fontWeight) | Range | ตั้งค่าน้ำหนักแบบอักษรสำหรับช่วงที่ระบุ (ปกติ/ตัวหนา) |
setFontWeights(fontWeights) | Range | ตั้งค่าน้ำหนักแบบอักษรเป็นตารางสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) |
setFormula(formula) | Range | อัปเดตสูตรสำหรับช่วงนี้ |
setFormulaR1C1(formula) | Range | อัปเดตสูตรสำหรับช่วงนี้ |
setFormulas(formulas) | Range | ตั้งค่าตารางสูตรเป็นรูปสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) |
setFormulasR1C1(formulas) | Range | ตั้งค่าตารางสูตรเป็นรูปสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) |
setHorizontalAlignment(alignment) | Range | ตั้งค่าการจัดข้อความแนวนอน (ซ้ายไปขวา) สำหรับช่วงที่ระบุ (ซ้าย/กลาง/ขวา) |
setHorizontalAlignments(alignments) | Range | ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของการจัดแนวแนวนอน |
setNote(note) | Range | ตั้งค่าโน้ตตามค่าที่กำหนด |
setNotes(notes) | Range | ตั้งค่าตารางบันทึกสี่เหลี่ยมผืนผ้า (ต้องตรงกับมิติของช่วงนี้) |
setNumberFormat(numberFormat) | Range | ตั้งค่ารูปแบบตัวเลขหรือวันที่เป็นสตริงการจัดรูปแบบที่กำหนด |
setNumberFormats(numberFormats) | Range | ตั้งค่าตารางรูปแบบตัวเลขหรือวันที่เป็นรูปสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) |
setRichTextValue(value) | Range | กำหนดค่า Rich Text สำหรับเซลล์ในช่วง |
setRichTextValues(values) | Range | ตั้งค่าตาราง Rich Text เป็นรูปสี่เหลี่ยมผืนผ้า |
setShowHyperlink(showHyperlink) | Range | ตั้งค่าว่าช่วงควรแสดงไฮเปอร์ลิงก์หรือไม่ |
setTextDirection(direction) | Range | ตั้งค่าทิศทางข้อความสำหรับเซลล์ในช่วง |
setTextDirections(directions) | Range | ตั้งค่าตารางสี่เหลี่ยมผืนผ้าของเส้นทางของข้อความ |
setTextRotation(degrees) | Range | ตั้งค่าการหมุนข้อความสำหรับเซลล์ในช่วง |
setTextRotation(rotation) | Range | ตั้งค่าการหมุนข้อความสำหรับเซลล์ในช่วง |
setTextRotations(rotations) | Range | ตั้งค่าการหมุนข้อความเป็นตารางสี่เหลี่ยมผืนผ้า |
setTextStyle(style) | Range | ตั้งค่ารูปแบบข้อความสำหรับเซลล์ในช่วง |
setTextStyles(styles) | Range | ตั้งค่ารูปแบบข้อความเป็นตารางสี่เหลี่ยมผืนผ้า |
setValue(value) | Range | กำหนดค่าของช่วง |
setValues(values) | Range | ตั้งค่าตารางค่าเป็นรูปสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) |
setVerticalAlignment(alignment) | Range | ตั้งค่าการจัดข้อความแนวตั้ง (บนลงล่าง) สำหรับช่วงที่ระบุ (บน/กลาง/ล่าง) |
setVerticalAlignments(alignments) | Range | ตั้งค่าตารางสี่เหลี่ยมผืนผ้าของการจัดแนวแนวตั้ง (ต้องตรงกับขนาดของช่วงนี้) |
setVerticalText(isVertical) | Range | ตั้งค่าว่าจะซ้อนข้อความสำหรับเซลล์ในช่วงหรือไม่ |
setWrap(isWrapEnabled) | Range | ตั้งค่าการตัดเซลล์ของช่วงที่ระบุ |
setWrapStrategies(strategies) | Range | ตั้งค่าตารางกลยุทธ์การตัดข้อความเป็นสี่เหลี่ยมผืนผ้า |
setWrapStrategy(strategy) | Range | ตั้งค่ากลยุทธ์การตัดข้อความสำหรับเซลล์ในช่วง |
setWraps(isWrapEnabled) | Range | ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของนโยบายการตัดคำ (ต้องตรงกับมิติข้อมูลของช่วงนี้) |
shiftColumnGroupDepth(delta) | Range | เปลี่ยนความลึกในการจัดกลุ่มคอลัมน์ของช่วงตามจำนวนที่ระบุ |
shiftRowGroupDepth(delta) | Range | เปลี่ยนความลึกในการจัดกลุ่มแถวของช่วงตามจำนวนที่ระบุ |
sort(sortSpecObj) | Range | จัดเรียงเซลล์ในช่วงที่กำหนดตามคอลัมน์และลำดับที่ระบุ |
splitTextToColumns() | void | แบ่งคอลัมน์ของข้อความออกเป็นหลายคอลัมน์ตามตัวคั่นที่ตรวจพบอัตโนมัติ |
splitTextToColumns(delimiter) | void | แบ่งคอลัมน์ของข้อความออกเป็นหลายคอลัมน์โดยใช้สตริงที่ระบุเป็นตัวคั่นที่กำหนดเอง |
splitTextToColumns(delimiter) | void | แบ่งคอลัมน์ข้อความออกเป็นหลายคอลัมน์ตามตัวคั่นที่ระบุ |
trimWhitespace() | Range | ตัดการเว้นวรรค (เช่น เว้นวรรค แท็บ หรือบรรทัดใหม่) ในทุกเซลล์ในช่วงนี้ |
uncheck() | Range | เปลี่ยนสถานะของช่องทำเครื่องหมายในช่วงเป็น "ยกเลิกการเลือกแล้ว" |
เอกสารประกอบโดยละเอียด
activate()
ตั้งค่าช่วงที่ระบุเป็น active range
โดยที่เซลล์ซ้ายบนสุดของช่วงเป็น 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();
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
activateAsCurrentCell()
ตั้งค่าเซลล์ที่ระบุเป็น current cell
ถ้าเซลล์ที่ระบุอยู่ในช่วงที่มีอยู่ ช่วงนั้นจะกลายเป็นช่วงที่มีการใช้งานโดยมีเซลล์นั้นเป็นเซลล์ปัจจุบัน
หากเซลล์ที่ระบุไม่อยู่ในช่วงที่มีอยู่ ระบบจะนำการเลือกที่มีอยู่ออกและเซลล์จะกลายเป็นเซลล์ปัจจุบันและช่วงที่มีการใช้งาน
หมายเหตุ: Range
ที่ระบุต้องประกอบด้วยเซลล์เดียว มิฉะนั้นจะมีข้อยกเว้น
// 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());
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key)
เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่มีคีย์ที่ระบุไปยังช่วง
// 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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
key | String | คีย์สำหรับข้อมูลเมตาใหม่ของนักพัฒนาซอฟต์แวร์ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์พร้อมคีย์และระดับการเข้าถึงที่ระบุไปยังช่วง
// 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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
key | String | คีย์สำหรับข้อมูลเมตาใหม่ของนักพัฒนาซอฟต์แวร์ |
visibility | DeveloperMetadataVisibility | ระดับการเข้าถึงข้อมูลเมตาใหม่ของนักพัฒนาซอฟต์แวร์ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่มีคีย์และค่าที่ระบุลงในช่วง
// 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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
key | String | คีย์สำหรับข้อมูลเมตาใหม่ของนักพัฒนาซอฟต์แวร์ |
value | String | ค่าสำหรับข้อมูลเมตาใหม่ของนักพัฒนาซอฟต์แวร์ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
เพิ่มข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่มีคีย์ ค่า และระดับการเข้าถึงที่ระบุไปยังช่วง
// 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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
key | String | คีย์สำหรับข้อมูลเมตาใหม่ของนักพัฒนาซอฟต์แวร์ |
value | String | ค่าสำหรับข้อมูลเมตาใหม่ของนักพัฒนาซอฟต์แวร์ |
visibility | DeveloperMetadataVisibility | ระดับการเข้าถึงข้อมูลเมตาใหม่ของนักพัฒนาซอฟต์แวร์ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding()
ใช้ธีมแถบสีเริ่มต้นของคอลัมน์กับช่วง แถบสีจะมีส่วนหัวและไม่มีสีส่วนท้ายโดยค่าเริ่มต้น
// 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());
ขากลับ
Banding
— แถบแถบสีใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding(bandingTheme)
ใช้ธีมแถบสีของคอลัมน์ที่ระบุกับช่วง โดยค่าเริ่มต้น แถบสีจะมีส่วนหัวและไม่มีสีส่วนท้าย
// 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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
bandingTheme | BandingTheme | ธีมสีที่จะใช้กับคอลัมน์ในช่วง |
ขากลับ
Banding
— แถบแถบสีใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding(bandingTheme, showHeader, showFooter)
ใช้ธีมแถบคอลัมน์ที่ระบุกับช่วงที่มีการตั้งค่าส่วนหัวและส่วนท้ายที่ระบุไว้
// 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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
bandingTheme | BandingTheme | ธีมสีที่จะใช้กับคอลัมน์ในช่วง |
showHeader | Boolean | หากเป็น true สีส่วนหัวของธีมแถบสีจะมีผลกับคอลัมน์แรก |
showFooter | Boolean | หากเป็น true สีส่วนท้ายของธีมแถบสีจะมีผลกับคอลัมน์สุดท้าย |
ขากลับ
Banding
— แถบแถบสีใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding()
ใช้ธีมแถบแถวตามค่าเริ่มต้นกับช่วง แถบสีจะมีส่วนหัวและไม่มีสีส่วนท้ายโดยค่าเริ่มต้น
// 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);
ขากลับ
Banding
— แถบสี
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme)
ใช้ธีมแถบแถวที่ระบุกับช่วง แถบสีจะมีส่วนหัวและไม่มีสีส่วนท้ายโดยค่าเริ่มต้น
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
bandingTheme | BandingTheme | ธีมสีที่จะใช้กับแถวในช่วง |
ขากลับ
Banding
— แถบแถบสีใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme, showHeader, showFooter)
ใช้ธีมแถบสีแถวที่ระบุกับช่วงที่มีการตั้งค่าส่วนหัวและส่วนท้ายที่ระบุไว้
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
bandingTheme | BandingTheme | ธีมสีที่จะใช้กับแถวในช่วง |
showHeader | Boolean | หากเป็น true สีส่วนหัวของธีมแถบสีจะมีผลกับแถวแรก |
showFooter | Boolean | หากเป็น true สีส่วนท้ายของธีมแถบสีจะมีผลกับแถวสุดท้าย |
ขากลับ
Banding
— แถบแถบสีใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoFill(destination, series)
เติม destinationRange
ด้วยข้อมูลตามข้อมูลในช่วงนี้ ค่าใหม่จะกำหนดโดยประเภท series
ที่ระบุด้วย ช่วงปลายทางต้องมีช่วงนี้และขยายออกไปในทิศทางเดียวเท่านั้น ตัวอย่างเช่น ตัวอย่างต่อไปนี้จะเติม A1:A20
ด้วยชุดตัวเลขที่เพิ่มขึ้นตามค่าปัจจุบันใน 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
destination | Range | ช่วงที่จะกรอกค่าโดยอัตโนมัติ ช่วงปลายทางควรมีช่วงนี้และขยายออกไปในทิศทางเดียวเท่านั้น (ขึ้น ลง ซ้าย หรือขวา) |
series | AutoFillSeries | ประเภทของชุดการป้อนอัตโนมัติที่ควรใช้เพื่อคำนวณค่าใหม่ ผลลัพธ์ของชุดเนื้อหานี้จะแตกต่างกันไปตามประเภทและปริมาณข้อมูลต้นทาง |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoFillToNeighbor(series)
คำนวณช่วงที่จะเติมข้อมูลใหม่ตามเซลล์ข้างเคียง และเติมค่าใหม่ในช่วงนั้นโดยอัตโนมัติตามข้อมูลที่มีในช่วงนี้ ค่าใหม่เหล่านี้จะกำหนดโดยประเภท series
ที่ระบุด้วย
ช่วงปลายทางที่คำนวณจะพิจารณาข้อมูลแวดล้อมเพื่อพิจารณาว่าควรแทรกค่าใหม่ไว้ที่ใด หากมีข้อมูลอยู่ทางซ้ายหรือขวาทันทีของคอลัมน์ที่มีการป้อนอัตโนมัติ ค่าใหม่จะขยายเท่าข้อมูลที่อยู่ติดกันนี้เท่านั้น
เช่น หาก A1:A20
เต็มไปด้วยชุดตัวเลขที่เพิ่มขึ้นและมีการเรียกเมธอดนี้ในช่วง B1:B4
ซึ่งมีชุดวันที่ ระบบจะแทรกค่าใหม่ลงใน B5:B20
เท่านั้น ด้วยวิธีนี้ ค่าใหม่เหล่านี้จะ "คงที่" อยู่กับเซลล์ที่มีค่าในคอลัมน์ 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
series | AutoFillSeries | ประเภทของชุดการป้อนอัตโนมัติที่ควรใช้เพื่อคำนวณค่าใหม่ ผลลัพธ์ของชุดเนื้อหานี้จะแตกต่างกันไปตามประเภทและปริมาณข้อมูลต้นทาง |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
breakApart()
แบ่งเซลล์ที่มีหลายคอลัมน์ในช่วงให้เป็นเซลล์เดี่ยวอีกครั้ง
การเรียกใช้ฟังก์ชันนี้บนช่วงเทียบเท่ากับการเลือกช่วงและคลิก จัดรูปแบบ > ผสานเซลล์ > ยกเลิกการผสาน
// 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();
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
canEdit()
กำหนดว่าผู้ใช้มีสิทธิ์แก้ไขทุกเซลล์ในช่วงหรือไม่ เจ้าของสเปรดชีตจะสามารถแก้ไขช่วงและชีตที่มีการป้องกันได้ตลอดเวลา
// 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());
ขากลับ
Boolean
— true
หากผู้ใช้มีสิทธิ์แก้ไขทุกเซลล์ในช่วง มิเช่นนั้นจะเป็น false
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
check()
เปลี่ยนสถานะของช่องทำเครื่องหมายในช่วงเป็น "ทำเครื่องหมายแล้ว" ไม่สนใจเซลล์ในช่วงที่ไม่มีการกำหนดค่าที่เลือกหรือไม่ได้กำหนดค่าไว้
// 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();
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
ล้างช่วงเนื้อหาและรูปแบบ
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clear();
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
ล้างช่วงของเนื้อหา รูปแบบ กฎการตรวจสอบข้อมูล และ/หรือความคิดเห็นตามที่ระบุด้วยตัวเลือกขั้นสูงที่มีให้ ระบบจะล้างข้อมูลทั้งหมดโดยค่าเริ่มต้น
// 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});
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
options | Object | ออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูงดังที่แสดงด้านล่าง |
พารามิเตอร์ขั้นสูง
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
commentsOnly | Boolean | ล้างเฉพาะความคิดเห็นไหม |
contentsOnly | Boolean | ต้องการล้างเฉพาะเนื้อหาหรือไม่ |
formatOnly | Boolean | ไม่ว่าจะล้างเฉพาะรูปแบบใด โปรดทราบว่าการล้างข้อมูลรูปแบบจะล้างกฎการตรวจสอบข้อมูลด้วย |
validationsOnly | Boolean | ต้องการล้างเฉพาะกฎการตรวจสอบข้อมูลหรือไม่ |
skipFilteredRows | Boolean | ต้องการหลีกเลี่ยงการล้างแถวที่กรองหรือไม่ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContent()
ล้างเนื้อหาของช่วง โดยคงการจัดรูปแบบเดิมไว้
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearContent();
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearDataValidations()
ล้างกฎการตรวจสอบข้อมูลสำหรับช่วง
// Clear the data validation rules for cells A1:B5. var range = SpreadsheetApp.getActive().getRange('A1:B5'); range.clearDataValidations();
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormat()
ล้างการจัดรูปแบบสำหรับช่วงนี้
การดำเนินการนี้จะล้างการจัดรูปแบบข้อความของเซลล์ในช่วง แต่จะไม่รีเซ็ตกฎการจัดรูปแบบตัวเลขใดๆ
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearFormat();
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNote()
ล้างบันทึกในเซลล์ที่ระบุ
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearNote();
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseGroups()
ยุบกลุ่มทั้งหมดที่อยู่ในช่วง ถ้าไม่มีกลุ่มที่อยู่ในช่วงอย่างสมบูรณ์ ระบบจะยุบกลุ่มที่ขยายลึกที่สุดที่อยู่ในช่วงบางส่วน
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are collapsed. range.collapseGroups();
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
คัดลอกการจัดรูปแบบของช่วงไปยังตำแหน่งที่กำหนด หากปลายทางมีขนาดใหญ่กว่าหรือเล็กกว่าช่วงต้นทาง ต้นทางจะถูกทำซ้ำหรือตัดให้สั้นลง โปรดทราบว่าวิธีนี้จะคัดลอกเฉพาะการจัดรูปแบบเท่านั้น
ดูคำอธิบายโดยละเอียดของพารามิเตอร์ gridId ที่ 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
gridId | Integer | รหัสที่ไม่ซ้ำกันของแผ่นงานในสเปรดชีต โดยไม่คำนึงถึงตำแหน่ง |
column | Integer | คอลัมน์แรกของช่วงเป้าหมาย |
columnEnd | Integer | คอลัมน์สุดท้ายของช่วงเป้าหมาย |
row | Integer | แถวเริ่มต้นของช่วงเป้าหมาย |
rowEnd | Integer | แถวสุดท้ายของช่วงเป้าหมาย |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
ดูเพิ่มเติม
copyFormatToRange(sheet, column, columnEnd, row, rowEnd)
คัดลอกการจัดรูปแบบของช่วงไปยังตำแหน่งที่กำหนด หากปลายทางมีขนาดใหญ่กว่าหรือเล็กกว่าช่วงต้นทาง ต้นทางจะถูกทำซ้ำหรือตัดให้สั้นลง โปรดทราบว่าวิธีนี้จะคัดลอกเฉพาะการจัดรูปแบบเท่านั้น
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
sheet | Sheet | ชีตเป้าหมาย |
column | Integer | คอลัมน์แรกของช่วงเป้าหมาย |
columnEnd | Integer | คอลัมน์สุดท้ายของช่วงเป้าหมาย |
row | Integer | แถวเริ่มต้นของช่วงเป้าหมาย |
rowEnd | Integer | แถวสุดท้ายของช่วงเป้าหมาย |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination)
คัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงของเซลล์อื่น ระบบจะคัดลอกทั้งค่าและการจัดรูปแบบ
// 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));
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
destination | Range | ช่วงปลายทางที่ต้องการคัดลอก เฉพาะตำแหน่งเซลล์ด้านบนซ้ายเท่านั้นที่เกี่ยวข้อง |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination, copyPasteType, transposed)
คัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงของเซลล์อื่น
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
destination | Range | ช่วงปลายทางที่ต้องการคัดลอก เฉพาะตำแหน่งเซลล์ด้านบนซ้ายเท่านั้นที่เกี่ยวข้อง |
copyPasteType | CopyPasteType | ประเภทที่ระบุวิธีวางเนื้อหาของช่วงไปยังปลายทาง |
transposed | Boolean | ควรวางช่วงในการวางแนวที่สลับกันหรือไม่ |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination, options)
คัดลอกข้อมูลจากช่วงของเซลล์ไปยังช่วงของเซลล์อื่น โดยค่าเริ่มต้น ระบบจะคัดลอกทั้งค่าและการจัดรูปแบบ แต่สามารถลบล้างได้โดยใช้อาร์กิวเมนต์ขั้นสูง
// 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});
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
destination | Range | ช่วงปลายทางที่ต้องการคัดลอก เฉพาะตำแหน่งเซลล์ด้านบนซ้ายเท่านั้นที่เกี่ยวข้อง |
options | Object | ออบเจ็กต์ JavaScript ที่ระบุพารามิเตอร์ขั้นสูงดังที่แสดงด้านล่าง |
พารามิเตอร์ขั้นสูง
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
formatOnly | Boolean | ระบุว่าควรคัดลอกเฉพาะรูปแบบเท่านั้น |
contentsOnly | Boolean | ระบุว่าควรคัดลอกเฉพาะเนื้อหาเท่านั้น |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyValuesToRange(gridId, column, columnEnd, row, rowEnd)
คัดลอกเนื้อหาของช่วงไปยังตำแหน่งที่กำหนด หากปลายทางมีขนาดใหญ่กว่าหรือเล็กกว่าช่วงต้นทาง ต้นทางจะถูกทำซ้ำหรือตัดให้สั้นลง
ดูคำอธิบายโดยละเอียดของพารามิเตอร์ gridId ที่ 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
gridId | Integer | รหัสที่ไม่ซ้ำกันของแผ่นงานในสเปรดชีต โดยไม่คำนึงถึงตำแหน่ง |
column | Integer | คอลัมน์แรกของช่วงเป้าหมาย |
columnEnd | Integer | คอลัมน์สุดท้ายของช่วงเป้าหมาย |
row | Integer | แถวเริ่มต้นของช่วงเป้าหมาย |
rowEnd | Integer | แถวสุดท้ายของช่วงเป้าหมาย |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
ดูเพิ่มเติม
copyValuesToRange(sheet, column, columnEnd, row, rowEnd)
คัดลอกเนื้อหาของช่วงไปยังตำแหน่งที่กำหนด หากปลายทางมีขนาดใหญ่กว่าหรือเล็กกว่าช่วงต้นทาง ต้นทางจะถูกทำซ้ำหรือตัดให้สั้นลง
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
sheet | Sheet | ชีตเป้าหมาย |
column | Integer | คอลัมน์แรกของช่วงเป้าหมาย |
columnEnd | Integer | คอลัมน์สุดท้ายของช่วงเป้าหมาย |
row | Integer | แถวเริ่มต้นของช่วงเป้าหมาย |
rowEnd | Integer | แถวสุดท้ายของช่วงเป้าหมาย |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourcePivotTable(dataSource)
สร้างตาราง Pivot ของแหล่งข้อมูลที่ว่างเปล่าจากแหล่งข้อมูล โดยตรึงไว้ที่เซลล์แรกของช่วงนี้
ตัวอย่างนี้แสดงวิธีสร้างและกำหนดค่าตาราง Pivot ของแหล่งข้อมูลใหม่
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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
dataSource | DataSource | แหล่งข้อมูลที่ใช้สร้างตาราง Pivot |
ขากลับ
DataSourcePivotTable
— ตาราง Pivot ของแหล่งข้อมูลที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourceTable(dataSource)
สร้างตารางแหล่งข้อมูลว่างจากแหล่งข้อมูล โดยตรึงไว้ที่เซลล์แรกของช่วงนี้
ตัวอย่างนี้แสดงวิธีสร้างและกำหนดค่าตารางแหล่งข้อมูลใหม่
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
dataSource | DataSource | แหล่งข้อมูลที่ใช้สร้างตาราง Pivot |
ขากลับ
DataSourceTable
— ตารางแหล่งข้อมูลที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
แสดงผล DeveloperMetadataFinderApi สำหรับการค้นหาข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ภายในขอบเขตของช่วงนี้ ข้อมูลเมตาจะอยู่ภายในขอบเขตของช่วงก็ต่อเมื่อข้อมูลเมตานั้นอยู่ภายในช่วงดังกล่าวทั้งหมดเท่านั้น เช่น ข้อมูลเมตาที่เชื่อมโยงกับแถว "3:3" ไม่อยู่ในขอบเขตของช่วง "A1:D5" แต่อยู่ภายในขอบเขตของช่วง "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());
ขากลับ
DeveloperMetadataFinder
— เครื่องมือค้นหาข้อมูลเมตาของนักพัฒนาซอฟต์แวร์เพื่อค้นหาข้อมูลเมตาที่อยู่ในขอบเขตของช่วงนี้
createFilter()
สร้างตัวกรองและนำไปใช้กับช่วงที่ระบุในชีต คุณไม่สามารถสร้างตัวกรองมากกว่า 1 รายการในแผ่นงาน หากต้องการเข้าถึงและแก้ไขตัวกรองหลังจากสร้าง ให้ใช้ getFilter()
หรือ 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); }ใช้วิธีนี้ในการสร้างตัวกรองสำหรับชีต
Grid
ซึ่งเป็นประเภทเริ่มต้นของชีต
ชีตตารางกริดคือชีตที่ไม่ได้เชื่อมต่อกับฐานข้อมูล หากต้องการสร้างตัวกรองประเภทอื่นๆ
ให้ดูข้อมูลต่อไปนี้
- สร้างตัวกรองตาราง Pivot ด้วย
PivotTable.addFilter(sourceDataColumn, filterCriteria)
- สร้างตัวกรองสำหรับชีตที่เชื่อมต่อกับฐานข้อมูลด้วย
DataSourceSheet.addFilter(columnName, filterCriteria)
- สร้างตัวกรองสำหรับตาราง Pivot ที่เชื่อมต่อกับฐานข้อมูลด้วย
DataSourcePivotTable.addFilter(columnName, filterCriteria)
ขากลับ
Filter
— ตัวกรองใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createPivotTable(sourceData)
สร้างตาราง Pivot เปล่าจาก sourceData
ที่ระบุโดยตรึงไว้ที่เซลล์แรกของช่วงนี้
// 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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
sourceData | Range | ข้อมูลที่ใช้สร้างตาราง Pivot |
ขากลับ
PivotTable
— PivotTable
ที่สร้างขึ้นใหม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createTextFinder(findText)
สร้างโปรแกรมค้นหาข้อความสำหรับช่วง ซึ่งสามารถค้นหาและแทนที่ข้อความในช่วงนี้ได้
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');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
findText | String | ข้อความที่จะค้นหา |
ขากลับ
TextFinder
— TextFinder
สำหรับช่วง
deleteCells(shiftDimension)
ลบช่วงของเซลล์นี้ ข้อมูลที่มีอยู่ในชีตตามมิติข้อมูลที่ให้ไว้จะเลื่อนไปที่ช่วงที่ถูกลบ
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
shiftDimension | Dimension | มิติข้อมูลที่จะปรับเปลี่ยนข้อมูลที่มีอยู่ |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandGroups()
ขยายกลุ่มที่ยุบซึ่งมีช่วงหรือปุ่มสลับการควบคุมตัดกับช่วงนี้ ตำแหน่งปุ่มสลับสำหรับควบคุมคือดัชนีที่จะแสดงการสลับตัวควบคุม โดยอยู่ก่อนหรือหลังกลุ่มโดยตรง ทั้งนี้ขึ้นอยู่กับการตั้งค่า ถ้ามีกลุ่มมากกว่า 1 กลุ่มในตำแหน่งเดียวกัน กลุ่มที่ตื้นที่สุดจะถูกขยายออก
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are expanded. range.expandGroups();
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getA1Notation()
แสดงผลคำอธิบายสตริงของช่วงในรูปแบบ 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());
ขากลับ
String
— คำอธิบายสตริงของช่วงในรูปแบบ A1
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackground()
แสดงผลสีพื้นหลังของเซลล์ซ้ายบนของช่วง (เช่น '#ffffff'
)
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackground());
ขากลับ
String
— รหัสสีของพื้นหลัง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObject()
แสดงผลสีพื้นหลังของเซลล์ซ้ายบนของช่วง
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());
ขากลับ
Color
— สีพื้นหลังของเซลล์ซ้ายบนของช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObjects()
แสดงผลสีพื้นหลังของเซลล์ในช่วง
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()); } }
ขากลับ
Color[][]
— อาร์เรย์ 2 มิติของสีพื้นหลัง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgrounds()
แสดงผลสีพื้นหลังของเซลล์ในช่วง (เช่น '#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]); } }
ขากลับ
String[][]
— อาร์เรย์สองมิติของรหัสสีของพื้นหลัง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBandings()
แสดงผลแถบสีทั้งหมดที่ใช้กับเซลล์ในช่วงนี้
// 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()); }
ขากลับ
Banding[]
— แถบสีทั้งหมดที่ใช้กับเซลล์ในช่วงนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCell(row, column)
แสดงผลเซลล์ที่ระบุภายในช่วง
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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
row | Integer | แถวของเซลล์ที่สัมพันธ์กับช่วง |
column | Integer | คอลัมน์ของเซลล์ที่สัมพันธ์กับช่วง |
ขากลับ
Range
— ช่วงที่มีเซลล์เดียวตามพิกัดที่ระบุ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumn()
แสดงตำแหน่งคอลัมน์เริ่มต้นสำหรับช่วงนี้
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "2.0" Logger.log(range.getColumn());
ขากลับ
Integer
— ตำแหน่งคอลัมน์เริ่มต้นของช่วงในสเปรดชีต
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRegion()
แสดงผลสำเนาของช่วงที่ขยายใน Direction
คาร์ดินัลทั้ง 4 เซลล์ให้ครอบคลุมเซลล์ที่ใกล้เคียงกันทั้งหมดที่มีข้อมูลอยู่ภายใน ถ้าช่วงนั้นล้อมรอบด้วยเซลล์ว่างที่ไม่มีเซลล์ในแนวทแยงมุม ระบบจะแสดงผลช่วงนั้นเอง ซึ่งคล้ายกับการเลือกช่วงและ
การพิมพ์ Ctrl+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());
ขากลับ
Range
— เขตข้อมูลของช่วงหรือช่วงสำหรับทั้งสเปรดชีต
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRegion(dimension)
แสดงผลสำเนาของช่วงที่ขยาย Direction.UP
และ Direction.DOWN
หากมิติข้อมูลที่ระบุคือ Dimension.ROWS
หรือ Direction.NEXT
และ Direction.PREVIOUS
หากมิติข้อมูลเป็น Dimension.COLUMNS
การขยายของช่วงจะขึ้นอยู่กับการตรวจหาข้อมูลถัดจากช่วงที่มีการจัดระเบียบเช่นตาราง ช่วงที่ขยายจะครอบคลุมเซลล์ที่อยู่ติดกันทั้งหมดที่มีข้อมูลในเซลล์ตามมิติข้อมูลที่ระบุ รวมถึงขอบเขตของตาราง หากช่วงเดิมถูกล้อมรอบด้วยเซลล์ว่างตามมิติข้อมูลที่ระบุ ระบบจะแสดงผลช่วงนั้นเอง วิธีนี้คล้ายกับการเลือกช่วงและพิมพ์
Ctrl+Space
สำหรับคอลัมน์ หรือ Shift+Space
สำหรับแถวในเครื่องมือแก้ไข
// 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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
dimension | Dimension | มิติข้อมูลที่จะขยายช่วง |
ขากลับ
Range
— เขตข้อมูลของช่วงหรือช่วงที่ครอบคลุมแต่ละคอลัมน์หรือแต่ละแถวที่ครอบคลุมโดยช่วงเดิม
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormula()
แสดงผล DataSourceFormula
สำหรับเซลล์แรกของช่วง หรือ null
หากเซลล์ไม่มีสูตรแหล่งข้อมูล
// 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);
ขากลับ
DataSourceFormula
— DataSourceFormula
สำหรับเซลล์
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
แสดงผล DataSourceFormula
ของเซลล์ในช่วง
// 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());
ขากลับ
DataSourceFormula[]
— อาร์เรย์ของ DataSourceFormula
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
รับตาราง Pivot ของแหล่งข้อมูลทั้งหมดที่ตัดกับช่วง
// 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());
ขากลับ
DataSourcePivotTable[]
— รายการตาราง Pivot ของแหล่งข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
รับตารางแหล่งข้อมูลทั้งหมดที่ตัดกับช่วง
// 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());
ขากลับ
DataSourceTable[]
— รายการตารางแหล่งข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceUrl()
แสดง URL สำหรับข้อมูลในช่วงนี้ ซึ่งสามารถใช้เพื่อสร้างแผนภูมิและข้อความค้นหา
โค้ด.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(); }
แผนภูมิวงกลม.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>
ขากลับ
String
— URL สำหรับช่วงนี้เพื่อใช้เป็นแหล่งข้อมูลที่ส่งต่อไปยัง API อื่นๆ เช่น แผนภูมิได้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataTable()
แสดงผลข้อมูลภายในออบเจ็กต์นี้เป็น 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();
ขากลับ
DataTable
— ข้อมูลในรูปแบบตารางข้อมูล
getDataTable(firstRowIsHeader)
แสดงผลข้อมูลในช่วงนี้เป็น DataTable
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();
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
firstRowIsHeader | Boolean | ระบุว่าจะใช้แถวแรกเป็นส่วนหัวหรือไม่ |
ขากลับ
DataTable
— ข้อมูลในรูปแบบตารางข้อมูล
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataValidation()
แสดงผลกฎการตรวจสอบข้อมูลสำหรับเซลล์ซ้ายบนของช่วง หากไม่ได้ตั้งค่าการตรวจสอบข้อมูลในเซลล์ไว้ เมธอดนี้จะแสดง 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.') }
ขากลับ
DataValidation
— กฎการตรวจสอบข้อมูลสำหรับเซลล์ซ้ายบนของช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataValidations()
แสดงผลกฎการตรวจสอบข้อมูลสำหรับทุกเซลล์ในช่วง หากไม่มีการตั้งค่าการตรวจสอบข้อมูลไว้ในเซลล์หนึ่งๆ เมธอดนี้จะแสดง null
สำหรับตำแหน่งเซลล์นั้นในอาร์เรย์
// 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);
ขากลับ
DataValidation[][]
— อาร์เรย์ 2 มิติของกฎการตรวจสอบข้อมูลที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
รับข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับช่วงนี้
// 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()}`); }
ขากลับ
DeveloperMetadata[]
— ข้อมูลเมตาของนักพัฒนาซอฟต์แวร์ที่เชื่อมโยงกับช่วงนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValue()
แสดงผลค่าที่แสดงของเซลล์ซ้ายบนของช่วง ค่าจะเป็น String
ค่าที่แสดงจะคำนึงถึงการจัดรูปแบบวันที่ เวลา และสกุลเงิน รวมถึงรูปแบบที่การตั้งค่าภาษาของสเปรดชีตจะใช้โดยอัตโนมัติ เซลล์ที่ว่างจะแสดงสตริง
ที่ว่างเปล่า
// 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());
ขากลับ
String
— ค่าที่แสดงในเซลล์นี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValues()
แสดงผลตารางค่าเป็นรูปสี่เหลี่ยมผืนผ้าสำหรับช่วงนี้
แสดงผลอาร์เรย์ 2 มิติของค่าที่แสดง โดยจัดทำดัชนีตามแถว จากนั้นตามคอลัมน์ ค่าจะเป็นออบเจ็กต์ String
ค่าที่แสดงจะคำนึงถึงการจัดรูปแบบวันที่ เวลา และสกุลเงิน รวมถึงรูปแบบที่การตั้งค่าภาษาของสเปรดชีตจะใช้โดยอัตโนมัติ เซลล์ว่างจะแสดงด้วยสตริงว่างในอาร์เรย์ โปรดทราบว่าแม้ดัชนีช่วงจะเริ่มที่ 1, 1
แต่อาร์เรย์ JavaScript จะได้รับการจัดทำดัชนีจาก [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]);
ขากลับ
String[][]
— อาร์เรย์ของค่า 2 มิติ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilter()
แสดงผลตัวกรองในชีตที่เป็นช่วงนี้ หรือ "null
" หากไม่มีตัวกรองในชีต
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();
ขากลับ
Filter
— ตัวกรอง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontColorObject()
แสดงผลสีแบบอักษรของเซลล์ที่มุมซ้ายบนของช่วง
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontColorObject().asRgbColor().asHexString());
ขากลับ
Color
— สีแบบอักษรของเซลล์ซ้ายบนของช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontColorObjects()
แสดงผลสีแบบอักษรของเซลล์ในช่วง
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()); } }
ขากลับ
Color[][]
— อาร์เรย์ 2 มิติของสีตัวอักษรที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontFamilies()
แสดงผลชุดแบบอักษรของเซลล์ในช่วง
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]); } }
ขากลับ
String[][]
— อาร์เรย์ 2 มิติของชุดแบบอักษรที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontFamily()
แสดงผลชุดแบบอักษรของเซลล์ที่มุมบนซ้ายของช่วง
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontFamily());
ขากลับ
String
— ชุดแบบอักษรของเซลล์
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontLine()
รับรูปแบบเส้นของเซลล์ที่มุมบนซ้ายของช่วง ('underline'
, 'line-through'
หรือ 'none'
)
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontLine());
ขากลับ
String
— บรรทัดแบบอักษร
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontLines()
รับรูปแบบเส้นของเซลล์ในช่วง ('underline'
, 'line-through'
หรือ '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]); } }
ขากลับ
String[][]
— อาร์เรย์ 2 มิติของบรรทัดแบบอักษรที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontSize()
แสดงขนาดแบบอักษรในขนาดจุดของเซลล์ที่มุมบนซ้ายของช่วง
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontSize());
ขากลับ
Integer
— ขนาดแบบอักษรในขนาดจุด
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontSizes()
แสดงผลขนาดแบบอักษรของเซลล์ในช่วง
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]); } }
ขากลับ
Integer[][]
— อาร์เรย์ 2 มิติของขนาดแบบอักษรของข้อความที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontStyle()
แสดงผลรูปแบบแบบอักษร ('italic'
หรือ 'normal'
) ของเซลล์ที่มุมซ้ายบนของช่วง
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontStyle());
ขากลับ
String
— รูปแบบอักษรของข้อความในเซลล์
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontStyles()
แสดงผลรูปแบบตัวอักษรของเซลล์ในช่วง
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]); } }
ขากลับ
String[][]
— อาร์เรย์ 2 มิติของรูปแบบตัวอักษรของข้อความที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontWeight()
แสดงน้ำหนักแบบอักษร (ปกติ/ตัวหนา) ของเซลล์ที่มุมบนซ้ายของช่วง
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontWeight());
ขากลับ
String
— น้ำหนักแบบอักษรของข้อความในเซลล์
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontWeights()
แสดงผลน้ำหนักแบบอักษรของเซลล์ในช่วง
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]); } }
ขากลับ
String[][]
— อาร์เรย์ 2 มิติของน้ำหนักแบบอักษรของข้อความที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormula()
แสดงผลสูตร (สัญลักษณ์ A1) สำหรับเซลล์ด้านบนซ้ายของช่วง หรือสตริงว่างหากเซลล์ว่างเปล่าหรือไม่มีสูตร
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());
ขากลับ
String
— สูตรสำหรับเซลล์
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulaR1C1()
จะแสดงผลสูตร (สัญลักษณ์ R1C1) สำหรับเซลล์หนึ่งๆ หรือ null
หากไม่มี
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5"); var formula = range.getFormulaR1C1(); Logger.log(formula);
ขากลับ
String
— สูตรในหมายเหตุ R1C1
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulas()
แสดงผลสูตร (หมายเหตุ A1) สำหรับเซลล์ในช่วง ข้อมูลในอาร์เรย์ 2 มิติ เป็นสตริงว่างเปล่าสำหรับเซลล์ที่ไม่มีสูตร
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]); } }
ขากลับ
String[][]
— อาร์เรย์ 2 มิติของสูตรในรูปแบบสตริง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulasR1C1()
แสดงผลสูตร (สัญลักษณ์ R1C1) สำหรับเซลล์ในช่วง ข้อมูลในอาร์เรย์ 2 มิติมีค่า null
สำหรับเซลล์ที่ไม่มีสูตร
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]); } }
ขากลับ
String[][]
— อาร์เรย์ 2 มิติของสูตรในรูปแบบ R1C1
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getGridId()
แสดงผลรหัสตารางกริดของชีตระดับบนสุดของช่วง รหัสคือค่าจำนวนเต็มที่ไม่ติดลบแบบสุ่ม
// 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());
ขากลับ
Integer
— รหัสตารางกริดของชีตหลัก
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHeight()
แสดงผลความสูงของช่วง
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // logs 3.0 Logger.log(range.getHeight());
ขากลับ
Integer
— ความสูงของช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHorizontalAlignment()
แสดงผลการจัดข้อความแนวนอน (ซ้าย/กลาง/ขวา) ของเซลล์ที่มุมซ้ายบนของช่วง
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getHorizontalAlignment());
ขากลับ
String
— การจัดข้อความแนวนอนของข้อความในเซลล์
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHorizontalAlignments()
ส่งคืนการจัดข้อความแนวนอนของเซลล์ในช่วง
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]); } }
ขากลับ
String[][]
— อาร์เรย์ 2 มิติของการจัดแนวข้อความในแนวนอนที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
แสดงผลตำแหน่งคอลัมน์สิ้นสุด
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "4.0" Logger.log(range.getLastColumn());
ขากลับ
Integer
— ตำแหน่งคอลัมน์สิ้นสุดของช่วงในสเปรดชีต
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
แสดงผลตำแหน่งของแถวสิ้นสุด
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "4.0" Logger.log(range.getLastRow());
ขากลับ
Integer
— ตำแหน่งแถวสิ้นสุดของช่วงในสเปรดชีต
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMergedRanges()
แสดงผลอาร์เรย์ของออบเจ็กต์ Range
ที่แสดงถึงเซลล์ที่ผสานซึ่งอยู่ในช่วงปัจจุบันอย่างสมบูรณ์ หรือมีเซลล์อย่างน้อย 1 เซลล์ในช่วงปัจจุบัน
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()); }
ขากลับ
Range[]
— อาร์เรย์ของออบเจ็กต์ Range
รายการที่แสดงถึงเซลล์ที่ผสานซึ่งซ้อนทับกับช่วง
getNextDataCell(direction)
เริ่มต้นที่เซลล์ในคอลัมน์และแถวแรกของช่วง จะแสดงผลเซลล์ถัดไปในทิศทางที่กำหนดซึ่งเป็นขอบของช่วงที่อยู่ติดกันของเซลล์ที่มีข้อมูลอยู่ หรือเซลล์ที่ขอบของสเปรดชีตในทิศทางนั้น ข้อความนี้เทียบเท่ากับการพิมพ์
Ctrl+[arrow key]
ในตัวแก้ไข
// 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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
direction | Direction | ทิศทางที่จะใช้ค้นหาเซลล์ Edge ของเขตข้อมูลถัดไป |
ขากลับ
Range
— เซลล์ Edge ของเขตข้อมูลหรือเซลล์ที่ขอบของสเปรดชีต
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNote()
แสดงผลบันทึกที่เชื่อมโยงกับช่วงที่ระบุ
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getNote());
ขากลับ
String
— โน้ตที่เชื่อมโยงกับเซลล์ที่ระบุ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNotes()
แสดงผลบันทึกที่เชื่อมโยงกับเซลล์ในช่วง
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]); } }
ขากลับ
String[][]
— อาร์เรย์ 2 มิติของบันทึกที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumColumns()
แสดงผลจำนวนคอลัมน์ในช่วงนี้
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); Logger.log(range.getNumColumns());
ขากลับ
Integer
— จำนวนคอลัมน์ในช่วงนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumRows()
แสดงผลจำนวนแถวในช่วงนี้
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); Logger.log(range.getNumRows());
ขากลับ
Integer
— จำนวนแถวในช่วงนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumberFormat()
ดูการจัดรูปแบบตัวเลขหรือวันที่ของเซลล์ซ้ายบนของช่วงที่ต้องการ โปรดดูลายรูปแบบที่แสดงได้ในเอกสารของ Sheets API
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("C4"); Logger.log(cell.getNumberFormat());
ขากลับ
String
— รูปแบบตัวเลขจากเซลล์ซ้ายบนของช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumberFormats()
แสดงผลรูปแบบตัวเลขหรือวันที่สำหรับเซลล์ในช่วง โปรดดูรูปแบบของรูปแบบที่แสดงได้ในเอกสารประกอบของชีต API
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]); } }
ขากลับ
String[][]
— อาร์เรย์ 2 มิติของรูปแบบตัวเลข
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRichTextValue()
แสดงผลค่า Rich Text สำหรับเซลล์ซ้ายบนของช่วง หรือ null
หากค่าของเซลล์ไม่ใช่ข้อความ
// 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());
ขากลับ
RichTextValue
— ค่า Rich Text ของเซลล์ซ้ายบนสุดในช่วง หรือ null
หากค่าของเซลล์ไม่ใช่ข้อความ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRichTextValues()
แสดงผลค่า Rich Text สำหรับเซลล์ในช่วง
// 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()); } }
ขากลับ
RichTextValue[][]
— อาร์เรย์ 2 มิติของค่า Rich Text
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRow()
แสดงตำแหน่งแถวสำหรับช่วงนี้ เหมือนกับ getRowIndex()
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2"); Logger.log(range.getRow());
ขากลับ
Integer
— ตำแหน่งแถวของช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowIndex()
แสดงตำแหน่งแถวสำหรับช่วงนี้ เหมือนกับ getRow()
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2"); Logger.log(range.getRowIndex());
ขากลับ
Integer
— ตำแหน่งแถวของช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
ดูเพิ่มเติม
getSheet()
แสดงผลชีตช่วงนี้
// 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());
ขากลับ
Sheet
— ชีตที่มีช่วงนี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextDirection()
แสดงทิศทางข้อความสำหรับเซลล์ซ้ายบนของช่วง แสดงผล null
หากทิศทางข้อความในเซลล์กำหนดด้วยการตรวจหาอัตโนมัติ
// Get the text direction of cell B1. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B1:D4"); Logger.log(range.getTextDirection());
ขากลับ
TextDirection
— ทิศทางข้อความของเซลล์ซ้ายบนสุดของช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextDirections()
แสดงผลทิศทางข้อความสำหรับเซลล์ในช่วง ข้อมูลในอาร์เรย์ 2 มิติมีค่า null
สำหรับเซลล์ที่ใช้การตรวจหาอัตโนมัติ
// 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]); } }
ขากลับ
TextDirection[][]
— อาร์เรย์ 2 มิติของเส้นทางข้อความ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextRotation()
แสดงการตั้งค่าการหมุนข้อความสำหรับเซลล์ซ้ายบนของช่วง
// Log the text rotation settings for a cell. var sheet = SpreadsheetApp.getActiveSheet(); var cell = sheet.getRange("A1"); Logger.log(cell.getTextRotation());
ขากลับ
TextRotation
— การตั้งค่าการหมุนข้อความ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextRotations()
แสดงผลการตั้งค่าการหมุนข้อความสำหรับเซลล์ในช่วง
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); } }
ขากลับ
TextRotation[][]
— อาร์เรย์ 2 มิติของการหมุนข้อความที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextStyle()
แสดงรูปแบบข้อความสำหรับเซลล์ซ้ายบนของช่วง
// Get the text style of cell D4. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("D4:F6"); var style = range.getTextStyle(); Logger.log(style);
ขากลับ
TextStyle
— รูปแบบข้อความของเซลล์ซ้ายบนสุดในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextStyles()
แสดงผลรูปแบบข้อความสำหรับเซลล์ในช่วง
// 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]); } }
ขากลับ
TextStyle[][]
— อาร์เรย์ 2 มิติของรูปแบบข้อความ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getValue()
แสดงผลค่าของเซลล์ด้านบนซ้ายของช่วง ค่าอาจเป็นประเภท Number
, Boolean
, Date
หรือ String
ขึ้นอยู่กับค่าของเซลล์ ส่วนเซลล์ที่ว่างจะแสดงสตริงว่าง
// 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());
ขากลับ
Object
— ค่าในเซลล์นี้
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getValues()
แสดงผลตารางค่าเป็นรูปสี่เหลี่ยมผืนผ้าสำหรับช่วงนี้
แสดงผลค่าอาร์เรย์ 2 มิติ จัดทำดัชนีตามแถว จากนั้นตามคอลัมน์ ค่าอาจเป็นประเภท Number
, Boolean
, Date
หรือ String
ขึ้นอยู่กับค่าของเซลล์ เซลล์ว่างจะแสดงด้วยสตริงว่างในอาร์เรย์ โปรดทราบว่าในขณะที่ดัชนีช่วงเริ่มต้นที่ 1, 1
ระบบจะจัดทำดัชนีอาร์เรย์ JavaScript จาก [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]);ในเว็บแอป ค่า
Date
ไม่ใช่พารามิเตอร์ทางกฎหมาย getValues()
ไม่สามารถส่งข้อมูลไปยังเว็บแอปหากช่วงมีเซลล์ที่มีค่า Date
แต่ให้แปลงค่าทั้งหมดที่ดึงมาจากชีตเป็นค่าพื้นฐานของ JavaScript ที่รองรับแทน เช่น Number
, Boolean
หรือ String
ขากลับ
Object[][]
— อาร์เรย์ของค่า 2 มิติ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getVerticalAlignment()
ส่งคืนการจัดข้อความแนวตั้ง (บน/กลาง/ล่าง) ของเซลล์ที่มุมซ้ายบนของช่วง
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getVerticalAlignment());
ขากลับ
String
— การจัดข้อความแนวตั้งในเซลล์
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getVerticalAlignments()
ส่งคืนการจัดแนวแนวตั้งของเซลล์ในช่วง
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]); } }
ขากลับ
String[][]
— อาร์เรย์ 2 มิติของการจัดแนวข้อความในแนวตั้งที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWidth()
แสดงผลความกว้างของช่วงในคอลัมน์
// 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());
ขากลับ
Integer
— จำนวนคอลัมน์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrap()
แสดงผลว่าข้อความในเซลล์ตัดข้อความหรือไม่ หากต้องการดูกลยุทธ์การรวมที่ละเอียดยิ่งขึ้น ให้ใช้ getWrapStrategy()
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getWrap());
ขากลับ
Boolean
— ระบุว่าข้อความในเซลล์นี้ตัดข้อความหรือไม่
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrapStrategies()
แสดงกลยุทธ์การตัดข้อความสำหรับเซลล์ในช่วง
// 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]); } }
ขากลับ
WrapStrategy[][]
— กลยุทธ์การตัดข้อความแบบ 2 มิติ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrapStrategy()
แสดงกลยุทธ์การตัดข้อความสำหรับเซลล์ซ้ายบนของช่วง
// Get the text wrapping strategy of cell B1. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B1:D4"); Logger.log(range.getWrapStrategy());
ขากลับ
WrapStrategy
— กลยุทธ์การตัดข้อความของเซลล์ซ้ายบนสุดในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWraps()
แสดงผลว่าข้อความในเซลล์ตัดข้อความหรือไม่ หากต้องการดูกลยุทธ์การรวมที่ละเอียดยิ่งขึ้น ให้ใช้ 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); } } }
ขากลับ
Boolean[][]
— อาร์เรย์ 2 มิติของการจัดแนวข้อความในแนวตั้งที่เชื่อมโยงกับเซลล์ในช่วง
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCells(shiftDimension)
แทรกเซลล์ว่างในช่วงนี้ เซลล์ใหม่จะยังคงมีการจัดรูปแบบอยู่ในเซลล์ที่ยึดช่วงนี้ไว้ก่อนหน้านี้ ข้อมูลที่มีอยู่ในชีตตามมิติข้อมูลที่ระบุจะถูกเลื่อนออกไปจากช่วงที่แทรกไว้
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.insertCells(SpreadsheetApp.Dimension.COLUMNS);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
shiftDimension | Dimension | มิติข้อมูลที่จะปรับเปลี่ยนข้อมูลที่มีอยู่ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes()
แทรกช่องทำเครื่องหมายในแต่ละเซลล์ในช่วง โดยกำหนดค่าด้วย true
สำหรับการเลือกและ false
สำหรับการเลือก ตั้งค่าของทุกเซลล์ในช่วงเป็น 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();
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes(checkedValue)
แทรกช่องทำเครื่องหมายในแต่ละเซลล์ในช่วง โดยกำหนดค่าด้วยค่าที่กำหนดเองสำหรับทำเครื่องหมายแล้วและสตริงว่างสำหรับยกเลิกการเลือก ตั้งค่าของแต่ละเซลล์ในช่วงเป็นสตริงว่างเปล่า
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');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
checkedValue | Object | ค่าที่ทำเครื่องหมายสำหรับการตรวจสอบข้อมูลของช่องทำเครื่องหมาย |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes(checkedValue, uncheckedValue)
แทรกช่องทำเครื่องหมายในแต่ละเซลล์ในช่วง โดยกำหนดค่าด้วยค่าที่กำหนดเองสำหรับสถานะที่เลือกและยกเลิกการเลือก ตั้งค่าของแต่ละเซลล์ในช่วงเป็นค่าที่กำหนดเองที่ไม่ได้ทำเครื่องหมาย
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');
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
checkedValue | Object | ค่าที่ทำเครื่องหมายสำหรับการตรวจสอบข้อมูลของช่องทำเครื่องหมาย |
uncheckedValue | Object | ค่าที่ไม่ได้เลือกไว้สำหรับการตรวจสอบข้อมูลของช่องทำเครื่องหมาย |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isBlank()
แสดงผล true
ถ้าช่วงนั้นว่างเปล่าทั้งหมด
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.isBlank());
ขากลับ
Boolean
— true
หากช่วงเป็นค่าว่าง ไม่เช่นนั้นจะเป็น false
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isChecked()
แสดงผลว่าเซลล์ทั้งหมดในช่วงมีสถานะช่องทำเครื่องหมายเป็น "ทำเครื่องหมายแล้ว" หรือไม่ แสดงผล null
หากมีการเลือกเซลล์บางเซลล์และไม่ได้เลือกเซลล์ที่เหลือ หรือหากบางเซลล์ไม่มีการตรวจสอบข้อมูลด้วยช่องทำเครื่องหมาย
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();
ขากลับ
Boolean
— true
หากเลือกทุกเซลล์ในช่วงไว้ ระบบจะทำเครื่องหมาย false
หากไม่ได้เลือกเซลล์ทั้งหมดในช่วงนี้ หรือเลือก null
หากมีการเลือกเซลล์ใดเซลล์หนึ่งหรือไม่ไม่มีการตรวจสอบข้อมูลของช่องทำเครื่องหมาย
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isEndColumnBounded()
ระบุว่าจุดสิ้นสุดของช่วงเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่งหรือไม่ ตัวอย่างเช่น สำหรับช่วง A1:B10
หรือ B:B
ที่ผูกกับคอลัมน์ที่ส่วนท้ายของช่วง เมธอดนี้จะแสดงผล true
สำหรับช่วง 3:7
หรือ A1:5
ที่ผูกกับแถวใดแถวหนึ่งที่ส่วนท้ายของช่วงเท่านั้น เมธอดนี้จะแสดงค่า 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());
ขากลับ
Boolean
— true
หากจุดสิ้นสุดของช่วงถูกผูกไว้กับคอลัมน์ใดคอลัมน์หนึ่ง มิเช่นนั้น จะเป็น false
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isEndRowBounded()
ระบุว่าจุดสิ้นสุดของช่วงเชื่อมโยงกับแถวใดแถวหนึ่งหรือไม่ ตัวอย่างเช่น สำหรับช่วง A1:B10
หรือ 3:7
ที่ผูกกับแถวที่ด้านท้ายของช่วง เมธอดนี้จะแสดงผล true
สำหรับช่วง B:B
หรือ A1:C
ที่ผูกกับบางคอลัมน์ที่ส่วนท้ายของช่วง เมธอดนี้จะแสดงค่า 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());
ขากลับ
Boolean
— true
หากจุดสิ้นสุดของช่วงผูกกับแถวใดแถวหนึ่ง จะเป็น false
ในกรณีอื่นๆ
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isPartOfMerge()
แสดงผล true
หากเซลล์ในช่วงปัจจุบันทับซ้อนเซลล์ที่ผสาน
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();
ขากลับ
Boolean
— true
ถ้าช่วงทับซ้อนเซลล์ที่ผสาน มิเช่นนั้นจะแสดงผล false
isStartColumnBounded()
ระบุว่าจุดเริ่มต้นของช่วงเชื่อมโยงกับคอลัมน์ใดคอลัมน์หนึ่งหรือไม่ ตัวอย่างเช่น สำหรับช่วง A1:B10
หรือ B:B
ที่ผูกกับคอลัมน์ที่จุดเริ่มต้นของช่วง เมธอดนี้จะแสดงค่า true
สำหรับช่วง 3:7
ซึ่งผูกกับแถวที่จุดเริ่มต้นของช่วงเท่านั้น เมธอดนี้จะแสดงค่า 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());
ขากลับ
Boolean
— true
หากจุดเริ่มต้นของช่วงถูกผูกไว้กับคอลัมน์ใดคอลัมน์หนึ่ง มิเช่นนั้น จะเป็น false
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isStartRowBounded()
กำหนดว่าจุดเริ่มต้นของช่วงเชื่อมโยงกับแถวใดแถวหนึ่งหรือไม่ ตัวอย่างเช่น สำหรับช่วง A1:B10
หรือ 3:7
ที่ผูกกับแถวที่จุดเริ่มต้นของช่วง เมธอดนี้จะแสดงผล true
สำหรับช่วง B:B
ซึ่งผูกกับคอลัมน์ใดคอลัมน์หนึ่งที่จุดเริ่มต้นของช่วงเท่านั้น เมธอดนี้จะแสดงค่า 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());
ขากลับ
Boolean
— true
หากจุดเริ่มต้นของช่วงถูกผูกไว้กับแถวใดแถวหนึ่ง มิเช่นนั้น จะเป็น false
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
merge()
ผสานเซลล์ในช่วงเข้าด้วยกันเป็นบล็อกเดียว
var sheet = SpreadsheetApp.getActiveSheet(); // The code below 2-dimensionally merges the cells in A1 to B3 sheet.getRange('A1:B3').merge();
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
mergeAcross()
ผสานเซลล์ในช่วงระหว่างคอลัมน์ต่างๆ ของช่วง
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();
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
mergeVertically()
ผสานเซลล์ในช่วงเข้าด้วยกัน
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();
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveTo(target)
ตัดและวาง (ทั้งรูปแบบและค่า) จากช่วงนี้ไปยังช่วงเป้าหมาย
// 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"));
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
target | Range | ช่วงเป้าหมายที่จะคัดลอกช่วงนี้ไป เฉพาะตำแหน่งเซลล์ด้านบนซ้ายเท่านั้นที่เกี่ยวข้อง |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
offset(rowOffset, columnOffset)
แสดงผลช่วงใหม่ที่มีออฟเซ็ตจากช่วงนี้ตามจำนวนแถวและคอลัมน์ที่กำหนด (ซึ่งอาจเป็นค่าลบ) ช่วงใหม่จะมีขนาดเท่ากับช่วงเดิม
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1"); // newCell references B2 var newCell = cell.offset(1, 1);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
rowOffset | Integer | จำนวนแถวที่เลื่อนลงจากเซลล์ซ้ายบนของช่วง ค่าลบหมายถึงแถวขึ้นจากเซลล์ซ้ายบนของช่วง |
columnOffset | Integer | จำนวนคอลัมน์จากเซลล์ซ้ายบนของช่วง ค่าลบหมายถึงคอลัมน์ที่อยู่ทางซ้ายจากเซลล์ซ้ายบนของช่วง |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
offset(rowOffset, columnOffset, numRows)
แสดงผลช่วงใหม่ที่สัมพันธ์กับช่วงปัจจุบัน โดยที่จุดด้านซ้ายบนมีออฟเซ็ตจากช่วงปัจจุบันโดยแถวและคอลัมน์ที่ระบุ และแสดงความสูงที่ระบุในเซลล์
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
rowOffset | Integer | จำนวนแถวที่เลื่อนลงจากเซลล์ซ้ายบนของช่วง ค่าลบหมายถึงแถวขึ้นจากเซลล์ซ้ายบนของช่วง |
columnOffset | Integer | จำนวนคอลัมน์จากเซลล์ซ้ายบนของช่วง ค่าลบหมายถึงคอลัมน์ที่อยู่ทางซ้ายจากเซลล์ซ้ายบนของช่วง |
numRows | Integer | ความสูงในแถวของช่วงใหม่ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
offset(rowOffset, columnOffset, numRows, numColumns)
แสดงผลช่วงใหม่ที่สัมพันธ์กับช่วงปัจจุบัน โดยที่จุดด้านซ้ายบนมีออฟเซ็ตจากช่วงปัจจุบันด้วยแถวและคอลัมน์ที่ระบุ และด้วยความสูงและความกว้างที่กำหนดในเซลล์
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
rowOffset | Integer | จำนวนแถวที่เลื่อนลงจากเซลล์ซ้ายบนของช่วง ค่าลบหมายถึงแถวขึ้นจากเซลล์ซ้ายบนของช่วง |
columnOffset | Integer | จำนวนคอลัมน์จากเซลล์ซ้ายบนของช่วง ค่าลบหมายถึงคอลัมน์ที่อยู่ทางซ้ายจากเซลล์ซ้ายบนของช่วง |
numRows | Integer | ความสูงในแถวของช่วงใหม่ |
numColumns | Integer | ความกว้างในคอลัมน์ของช่วงใหม่ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
protect()
สร้างออบเจ็กต์ที่ป้องกันไม่ให้แก้ไขช่วงได้ ยกเว้นผู้ใช้ที่มีสิทธิ์ สิทธิ์จะเหมือนกับสิทธิ์เดิมของสเปรดชีตจนกว่าสคริปต์จะเปลี่ยนรายการเอดิเตอร์สำหรับช่วงนั้น (โดยการเรียกใช้ Protection.removeEditor(emailAddress)
, Protection.removeEditor(user)
, Protection.removeEditors(emailAddresses)
, Protection.addEditor(emailAddress)
, Protection.addEditor(user)
, Protection.addEditors(emailAddresses)
หรือตั้งค่าใหม่สำหรับ Protection.setDomainEdit(editable)
) สิทธิ์ดังกล่าวก็จะเหมือนกับสิทธิ์ของสเปรดชีต ซึ่งหมายความว่าช่วงจะไม่มีการป้องกัน หากช่วงได้รับการป้องกันแล้ว วิธีนี้จะสร้างช่วงที่มีการป้องกันใหม่ที่ซ้อนทับช่วงที่มีอยู่ หากเซลล์มีช่วงที่มีการป้องกันหลายช่วง และช่วงใดช่วงหนึ่งป้องกันไม่ให้ผู้ใช้บางคนแก้ไขเซลล์ ผู้ใช้รายนั้นจะไม่มีสิทธิ์แก้ไขเซลล์
// 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); }
ขากลับ
Protection
— ออบเจ็กต์ที่แสดงถึงการตั้งค่าการป้องกัน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
randomize()
สุ่มลำดับของแถวในช่วงที่ระบุ
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:C7"); // Randomizes the range range.randomize();
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeCheckboxes()
นำช่องทำเครื่องหมายทั้งหมดออกจากช่วง ล้างการตรวจสอบข้อมูลของแต่ละเซลล์และล้างค่าเพิ่มเติมหากเซลล์มีค่าที่เลือกหรือยกเลิกการเลือกแล้ว
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();
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeDuplicates()
นำแถวภายในช่วงนี้ที่มีค่าซ้ำกับค่าในแถวก่อนหน้าออก แถวที่มีค่าเหมือนกันแต่มีตัวอักษรพิมพ์เล็กพิมพ์ใหญ่ การจัดรูปแบบ หรือสูตรต่างกันจะถือว่าเป็นรายการที่ซ้ำกัน วิธีนี้จะลบแถวที่ซ้ำกันซึ่งซ่อนไม่ให้เห็นได้ด้วย (เช่น เนื่องจากตัวกรอง) ระบบจะไม่นำเนื้อหาออกที่ไม่อยู่ในช่วงนี้
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B1:D7"); // Remove duplicate rows in the range. range.removeDuplicates();
ขากลับ
Range
— ช่วงผลลัพธ์หลังจากที่นำรายการที่ซ้ำออก ขนาดของช่วงจะลดลง 1 แถวสําหรับทุกแถวที่นําออก
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeDuplicates(columnsToCompare)
ลบแถวในช่วงนี้ที่มีค่าในคอลัมน์ที่ระบุซึ่งซ้ำกับค่าในแถวก่อนหน้า แถวที่มีค่าเหมือนกันแต่มีตัวอักษรพิมพ์เล็กพิมพ์ใหญ่ การจัดรูปแบบ หรือสูตรต่างกันจะถือว่าเป็นรายการที่ซ้ำกัน วิธีนี้จะลบแถวที่ซ้ำกันซึ่งซ่อน ไม่ให้เห็นได้ด้วย (เช่น เนื่องจากตัวกรอง) ระบบจะไม่นำเนื้อหาออกที่ไม่อยู่ในช่วงนี้
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]);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
columnsToCompare | Integer[] | คอลัมน์ที่จะวิเคราะห์ค่าที่ซ้ำกัน หากไม่ได้ระบุคอลัมน์ใดเลย ระบบจะวิเคราะห์คอลัมน์ทั้งหมดเพื่อหาคอลัมน์ที่ซ้ำกัน |
ขากลับ
Range
— ช่วงผลลัพธ์หลังจากที่นำรายการที่ซ้ำออก ขนาดของช่วงจะลดลง 1 แถวสําหรับทุกแถวที่นําออก
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackground(color)
ตั้งค่าสีพื้นหลังของทุกเซลล์ในช่วงในรูปแบบ CSS (เช่น '#ffffff'
หรือ 'white'
)
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); range.setBackground("red");
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | String | รหัสสีในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white' ) ค่า null จะรีเซ็ตสี |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundObject(color)
ตั้งค่าสีพื้นหลังของทุกเซลล์ในช่วง
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | Color | สีพื้นหลังที่ต้องการตั้งค่า ค่า null จะรีเซ็ตสีพื้นหลัง |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundObjects(color)
ตั้งค่าตารางสีพื้นหลังเป็นสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้)
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | Color[][] | อาร์เรย์ 2 มิติของสี ค่า null จะรีเซ็ตสี |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundRGB(red, green, blue)
ตั้งค่าพื้นหลังเป็นสีที่ระบุโดยใช้ค่า RGB (จำนวนเต็มระหว่าง 0 ถึง 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
red | Integer | ค่าสีแดงในรูปแบบ RGB |
green | Integer | ค่าสีเขียวในรูปแบบ RGB |
blue | Integer | ค่าสีน้ำเงินในรูปแบบ RGB |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgrounds(color)
ตั้งค่าตารางสีพื้นหลังเป็นสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) สีเหล่านี้
อยู่ในรูปแบบ CSS (เช่น '#ffffff'
หรือ '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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | String[][] | อาร์เรย์ 2 มิติของสีในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white' ) ค่า null จะรีเซ็ตสี |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal)
ตั้งค่าคุณสมบัติเส้นขอบ ค่าที่ใช้ได้คือ true
(เปิด), false
(ปิด) และ null
(ไม่มีการเปลี่ยนแปลง)
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
top | Boolean | true สำหรับเส้นขอบ false สำหรับไม่มี, null สำหรับไม่มีการเปลี่ยนแปลง |
left | Boolean | true สำหรับเส้นขอบ false สำหรับไม่มี, null สำหรับไม่มีการเปลี่ยนแปลง |
bottom | Boolean | true สำหรับเส้นขอบ false สำหรับไม่มี, null สำหรับไม่มีการเปลี่ยนแปลง |
right | Boolean | true สำหรับเส้นขอบ false สำหรับไม่มี, null สำหรับไม่มีการเปลี่ยนแปลง |
vertical | Boolean | true สำหรับเส้นขอบแนวตั้งภายใน false สำหรับไม่มีการเปลี่ยนแปลง null สำหรับไม่มีการเปลี่ยนแปลง |
horizontal | Boolean | true สำหรับเส้นขอบแนวนอนภายใน false สำหรับไม่มีการเปลี่ยนแปลง null สำหรับไม่มีการเปลี่ยนแปลง |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal, color, style)
ตั้งค่าคุณสมบัติเส้นขอบด้วยสีและ/หรือรูปแบบ ค่าที่ใช้ได้คือ true
(เปิด), false
(ปิด) และ null
(ไม่มีการเปลี่ยนแปลง) สำหรับสี ให้ใช้ "สี" ในคำอธิบาย CSS (เช่น '#ffffff'
หรือ '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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
top | Boolean | true สำหรับเส้นขอบ false สำหรับไม่มี, null สำหรับไม่มีการเปลี่ยนแปลง |
left | Boolean | true สำหรับเส้นขอบ false สำหรับไม่มี, null สำหรับไม่มีการเปลี่ยนแปลง |
bottom | Boolean | true สำหรับเส้นขอบ false สำหรับไม่มี, null สำหรับไม่มีการเปลี่ยนแปลง |
right | Boolean | true สำหรับเส้นขอบ false สำหรับไม่มี, null สำหรับไม่มีการเปลี่ยนแปลง |
vertical | Boolean | true สำหรับเส้นขอบแนวตั้งภายใน false สำหรับไม่มีการเปลี่ยนแปลง null สำหรับไม่มีการเปลี่ยนแปลง |
horizontal | Boolean | true สำหรับเส้นขอบแนวนอนภายใน false สำหรับไม่มีการเปลี่ยนแปลง null สำหรับไม่มีการเปลี่ยนแปลง |
color | String | สีในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white' ), null สำหรับสีเริ่มต้น (สีดำ) |
style | BorderStyle | รูปแบบสำหรับเส้นขอบ null สำหรับรูปแบบเริ่มต้น (ทึบ) |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDataValidation(rule)
ตั้งค่ากฎการตรวจสอบข้อมูล 1 ข้อให้กับทุกเซลล์ในช่วง
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
rule | DataValidation | กฎการตรวจสอบข้อมูลที่จะตั้งค่า หรือ null เพื่อนำการตรวจสอบข้อมูลออก |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDataValidations(rules)
ตั้งค่ากฎการตรวจสอบข้อมูลให้กับทุกเซลล์ในช่วง วิธีนี้จะใช้อาร์เรย์ 2 มิติ ในการตรวจสอบข้อมูล โดยจัดทำดัชนีตามแถวและคอลัมน์ มิติข้อมูลของอาร์เรย์ต้อง สอดคล้องกับมิติข้อมูลของช่วง
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
rules | DataValidation[][] | อาร์เรย์ 2 มิติของกฎการตรวจสอบข้อมูลที่จะตั้งค่า ค่า null
จะนำการตรวจสอบข้อมูลออก |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColor(color)
ตั้งค่าสีแบบอักษรในรูปแบบ CSS (เช่น '#ffffff'
หรือ 'white'
)
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontColor("red");
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | String | สีแบบอักษรในคำอธิบาย CSS (เช่น '#ffffff' หรือ 'white' ) ค่า null จะรีเซ็ตสี |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColorObject(color)
ตั้งค่าสีแบบอักษรของช่วงที่ระบุ
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
color | Color | สีแบบอักษรที่จะตั้งค่า ค่า null จะรีเซ็ตสี |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColorObjects(colors)
ตั้งค่าสีแบบอักษรเป็นตารางสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้)
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
colors | Color[][] | อาร์เรย์ 2 มิติของสี ค่า null จะรีเซ็ตสีตัวอักษร |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColors(colors)
ตั้งค่าสีแบบอักษรเป็นตารางสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) สีต่างๆ อยู่ในรูปแบบ CSS (เช่น '#ffffff'
หรือ '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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
colors | Object[][] | อาร์เรย์ 2 มิติของสีในรูปแบบ CSS (เช่น '#ffffff' หรือ 'white' ) ค่า null จะรีเซ็ตสี |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontFamilies(fontFamilies)
ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของชุดแบบอักษร (ต้องตรงกับขนาดของช่วงนี้) ตัวอย่างของชุดแบบอักษร ได้แก่ "Arial" หรือ "Helvetica"
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
fontFamilies | Object[][] | อาร์เรย์ 2 มิติของชุดแบบอักษร ค่า null จะรีเซ็ตชุดแบบอักษร |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontFamily(fontFamily)
ตั้งค่าชุดแบบอักษร เช่น "Arial" หรือ "Helvetica"
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontFamily("Helvetica");
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
fontFamily | String | ชุดแบบอักษรที่จะตั้งค่า ค่า null จะรีเซ็ตชุดแบบอักษร |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontLine(fontLine)
ตั้งค่ารูปแบบบรรทัดแบบอักษรของช่วงที่ระบุ ('underline'
, 'line-through'
หรือ 'none'
)
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontLine("line-through");
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
fontLine | String | รูปแบบบรรทัดแบบอักษร ไม่ว่าจะเป็น 'underline' , 'line-through' หรือ 'none' ค่า null จะรีเซ็ตรูปแบบของบรรทัดแบบอักษร |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontLines(fontLines)
ตั้งค่าตารางรูปสี่เหลี่ยมผืนผ้าของรูปแบบเส้น (ต้องตรงกับขนาดของช่วงนี้)
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
fontLines | Object[][] | อาร์เรย์ 2 มิติของรูปแบบบรรทัดแบบอักษร ('underline' 'line-through' หรือ 'none' ) ค่า null จะรีเซ็ตรูปแบบบรรทัดแบบอักษร |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontSize(size)
ตั้งค่าขนาดแบบอักษร โดยขนาดเท่ากับขนาดของจุดที่จะใช้
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontSize(20);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
size | Integer | ขนาดแบบอักษรในขนาดจุด |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontSizes(sizes)
ตั้งค่าขนาดแบบอักษรเป็นรูปสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) ขนาดจะอยู่ในรูปของจุด
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
sizes | Object[][] | อาร์เรย์ 2 มิติของขนาด |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontStyle(fontStyle)
กำหนดรูปแบบตัวอักษรสำหรับช่วงที่ระบุ ('italic'
หรือ 'normal'
)
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontStyle("italic");
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
fontStyle | String | รูปแบบตัวอักษร ไม่ว่าจะเป็น 'italic' หรือ 'normal' และค่า null จะรีเซ็ตรูปแบบตัวอักษร |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontStyles(fontStyles)
ตั้งค่าตารางสี่เหลี่ยมผืนผ้าในรูปแบบตัวอักษร (ต้องตรงกับขนาดของช่วงนี้)
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
fontStyles | Object[][] | อาร์เรย์ 2 มิติของรูปแบบตัวอักษร อาจเป็น 'italic' หรือ 'normal' และค่า null จะรีเซ็ตรูปแบบตัวอักษร |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontWeight(fontWeight)
ตั้งค่าน้ำหนักแบบอักษรสำหรับช่วงที่ระบุ (ปกติ/ตัวหนา)
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontWeight("bold");
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
fontWeight | String | น้ำหนักของแบบอักษร ไม่ว่าจะเป็น 'bold' หรือ 'normal' และค่า null จะรีเซ็ตน้ำหนักของแบบอักษร |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontWeights(fontWeights)
ตั้งค่าน้ำหนักแบบอักษรเป็นตารางสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) ตัวอย่างน้ำหนักของแบบอักษรคือ "ตัวหนา"
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
fontWeights | Object[][] | อาร์เรย์ 2 มิติของน้ำหนักแบบอักษร อาจเป็น 'bold' หรือ 'normal' และค่า null จะรีเซ็ตน้ำหนักแบบอักษร |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormula(formula)
อัปเดตสูตรสำหรับช่วงนี้ สูตรที่ระบุต้องอยู่ในรูปแบบ A1
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); cell.setFormula("=SUM(B3:B4)");
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
formula | String | สตริงแทนสูตรที่จะตั้งค่าสำหรับเซลล์ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulaR1C1(formula)
อัปเดตสูตรสำหรับช่วงนี้ สูตรที่ระบุต้องอยู่ในรูปแบบ 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])");
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
formula | String | สูตรสตริง |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulas(formulas)
ตั้งค่าตารางสูตรเป็นรูปสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) สูตรที่ระบุ ต้องอยู่ในรูปแบบ A1 วิธีนี้ใช้อาร์เรย์ 2 มิติของสูตร ซึ่งจัดทำดัชนีตามแถวและตามคอลัมน์ ส่วนข้อมูลของอาร์เรย์ต้องสอดคล้องกับมิติของช่วง
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
formulas | String[][] | อาร์เรย์สตริง 2 มิติของสูตร |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulasR1C1(formulas)
ตั้งค่าตารางสูตรเป็นรูปสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) สูตรที่ระบุ ต้องอยู่ในรูปแบบ 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
formulas | String[][] | อาร์เรย์ 2 มิติของสูตรในรูปแบบ R1C1 |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHorizontalAlignment(alignment)
ตั้งค่าการจัดข้อความแนวนอน (ซ้ายไปขวา) สำหรับช่วงที่ระบุ (ซ้าย/กลาง/ขวา)
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setHorizontalAlignment("center");
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
alignment | String | การจัดข้อความ ไม่ว่าจะเป็น 'left' , 'center' หรือ 'normal' และค่า null จะรีเซ็ตการปรับแนว |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHorizontalAlignments(alignments)
ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าที่มีการจัดแนวแนวนอน ดู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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
alignments | Object[][] | การจัดแนวอาร์เรย์ 2 มิติ ไม่ว่าจะเป็น 'left' , 'center' หรือ 'normal' ค่า null จะรีเซ็ตการปรับแนว |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
ดูเพิ่มเติม
setNote(note)
ตั้งค่าโน้ตตามค่าที่กำหนด
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setNote("This is a note");
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
note | String | ค่าโน้ตที่จะตั้งค่าสำหรับช่วง ค่า null จะนำโน้ตออก |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNotes(notes)
ตั้งค่าตารางบันทึกสี่เหลี่ยมผืนผ้า (ต้องตรงกับมิติของช่วงนี้)
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)
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
notes | Object[][] | อาร์เรย์ 2 มิติของบันทึก ค่า null จะลบหมายเหตุออก |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
ดูเพิ่มเติม
setNumberFormat(numberFormat)
ตั้งค่ารูปแบบตัวเลขหรือวันที่เป็นสตริงการจัดรูปแบบที่กำหนด โปรดดูรูปแบบรูปแบบที่ยอมรับในเอกสารประกอบของชีต API
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Always show 3 decimal points cell.setNumberFormat("0.000");
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
numberFormat | String | สตริงรูปแบบตัวเลข |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNumberFormats(numberFormats)
ตั้งค่าตารางรูปแบบตัวเลขหรือวันที่เป็นรูปสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) ค่าดังกล่าวเป็นสตริงรูปแบบตามที่อธิบายไว้ใน เอกสารประกอบของชีต API
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
numberFormats | Object[][] | อาร์เรย์ 2 มิติของรูปแบบตัวเลข |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRichTextValue(value)
กำหนดค่า Rich Text สำหรับเซลล์ในช่วง
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
value | RichTextValue | ค่า Rich Text ที่ต้องการ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRichTextValues(values)
ตั้งค่าตาราง Rich Text เป็นรูปสี่เหลี่ยมผืนผ้า
// 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]]);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
values | RichTextValue[][] | ค่า Rich Text ที่ต้องการ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setShowHyperlink(showHyperlink)
ตั้งค่าว่าช่วงควรแสดงไฮเปอร์ลิงก์หรือไม่
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
showHyperlink | Boolean | แสดงไฮเปอร์ลิงก์หรือไม่ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextDirection(direction)
ตั้งค่าทิศทางข้อความสำหรับเซลล์ในช่วง หากทิศทางที่ระบุคือ null
ระบบจะอนุมานทิศทางดังกล่าวแล้วตั้งค่า
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
direction | TextDirection | ทิศทางข้อความที่ต้องการ หาก null ระบบจะอนุมานทิศทางก่อนการตั้งค่า |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextDirections(directions)
ตั้งค่าตารางสี่เหลี่ยมผืนผ้าของเส้นทางของข้อความ หากทิศทางที่ระบุคือ null
ระบบจะอนุมานแล้วกำหนดทิศทาง
// 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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
directions | TextDirection[][] | ทิศทางข้อความที่ต้องการ หากทิศทางที่ระบุคือ null ระบบจะอนุมานก่อนที่จะตั้งค่า |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotation(degrees)
ตั้งค่าการหมุนข้อความสำหรับเซลล์ในช่วง อินพุตจะสอดคล้องกับมุมระหว่างการวางแนวข้อความมาตรฐานและการวางแนวที่ต้องการ หากป้อนค่าเป็น 0 แสดงว่า มีการตั้งข้อความเป็นการวางแนวมาตรฐาน
สำหรับทิศทางข้อความจากซ้ายไปขวา มุมบวกจะอยู่ในทิศทางทวนเข็มนาฬิกา ส่วนด้านขวาไปซ้ายจะอยู่ในทิศทางตามเข็มนาฬิกา
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
degrees | Integer | มุมที่ต้องการระหว่างการวางแนวมาตรฐานและการวางแนวที่ต้องการ สำหรับข้อความซ้ายไปขวา มุมบวกจะอยู่ในทิศทางทวนเข็มนาฬิกา |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotation(rotation)
ตั้งค่าการหมุนข้อความสำหรับเซลล์ในช่วง
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
rotation | TextRotation | การตั้งค่าการหมุนข้อความที่ต้องการ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotations(rotations)
ตั้งค่าการหมุนข้อความเป็นตารางสี่เหลี่ยมผืนผ้า
// 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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
rotations | TextRotation[][] | การตั้งค่าการหมุนข้อความที่ต้องการ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextStyle(style)
ตั้งค่ารูปแบบข้อความสำหรับเซลล์ในช่วง
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
style | TextStyle | รูปแบบข้อความที่ต้องการ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextStyles(styles)
ตั้งค่ารูปแบบข้อความเป็นตารางสี่เหลี่ยมผืนผ้า
// 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]]);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
styles | TextStyle[][] | รูปแบบข้อความที่ต้องการ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setValue(value)
กำหนดค่าของช่วง ค่าอาจเป็นตัวเลข สตริง บูลีน หรือวันที่ หากขึ้นต้นด้วย '='
ระบบจะตีความว่าเป็นสูตร
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setValue(100);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
value | Object | ค่าของช่วง |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setValues(values)
ตั้งค่าตารางค่าเป็นรูปสี่เหลี่ยมผืนผ้า (ต้องตรงกับขนาดของช่วงนี้) หากค่าเริ่มต้นด้วย =
ระบบจะถือว่าเป็นสูตร
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
values | Object[][] | อาร์เรย์สองมิติของค่า |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalAlignment(alignment)
ตั้งค่าการจัดข้อความแนวตั้ง (บนลงล่าง) สำหรับช่วงที่ระบุ (บน/กลาง/ล่าง)
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setVerticalAlignment("middle");
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
alignment | String | การจัดข้อความ ไม่ว่าจะเป็น 'top' , 'middle' หรือ 'bottom' และค่า null จะรีเซ็ตการปรับแนว |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalAlignments(alignments)
ตั้งค่าตารางสี่เหลี่ยมผืนผ้าของการจัดแนวแนวตั้ง (ต้องตรงกับขนาดของช่วงนี้)
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
alignments | Object[][] | การจัดแนวอาร์เรย์ 2 มิติ ไม่ว่าจะเป็น 'top' , 'middle' หรือ 'bottom' ค่า null จะรีเซ็ตการปรับแนว |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
ดูเพิ่มเติม
setVerticalText(isVertical)
ตั้งค่าว่าจะซ้อนข้อความสำหรับเซลล์ในช่วงหรือไม่ ถ้าข้อความเรียงซ้อนกันในแนวตั้ง ระบบจะไม่สนใจการตั้งค่าการหมุนข้อความแบบองศา
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
isVertical | Boolean | เลือกว่าจะซ้อนข้อความหรือไม่ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrap(isWrapEnabled)
ตั้งค่าการตัดเซลล์ของช่วงที่ระบุ
ปรับขนาดเซลล์ที่เปิดใช้การตัดข้อความ (ค่าเริ่มต้น) เพื่อแสดงเนื้อหาทั้งหมด เซลล์ที่ปิดใช้หน้าจอปิดการตัดข้อความให้มากที่สุดเท่าที่ทำได้ในเซลล์โดยไม่มีการปรับขนาดหรือเรียกใช้เป็นหลายบรรทัด
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setWrap(true);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
isWrapEnabled | Boolean | ตัดข้อความหรือไม่ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrapStrategies(strategies)
ตั้งค่าตารางกลยุทธ์การตัดข้อความเป็นสี่เหลี่ยมผืนผ้า
// 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());
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
strategies | WrapStrategy[][] | กลยุทธ์การสรุปที่ต้องการ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrapStrategy(strategy)
ตั้งค่ากลยุทธ์การตัดข้อความสำหรับเซลล์ในช่วง
// 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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
strategy | WrapStrategy | กลยุทธ์การสรุปที่ต้องการ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWraps(isWrapEnabled)
ตั้งค่าตารางกริดสี่เหลี่ยมผืนผ้าของนโยบายการตัดคำ (ต้องตรงกับมิติข้อมูลของช่วงนี้) ปรับขนาดเซลล์ที่เปิดใช้การตัดข้อความ (ค่าเริ่มต้น) เพื่อแสดงเนื้อหาทั้งหมด เซลล์ที่ปิดใช้การตัดข้อความจะแสดงหน้าจอได้มากที่สุดเท่าที่เป็นไปได้ในเซลล์โดยไม่มีการปรับขนาดหรือเรียกใช้เป็นหลายบรรทัด
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
isWrapEnabled | Object[][] | อาร์เรย์ 2 มิติของตัวแปรการรวมที่กำหนดว่าจะตัดข้อความในเซลล์หรือไม่ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
ดูเพิ่มเติม
shiftColumnGroupDepth(delta)
เปลี่ยนความลึกในการจัดกลุ่มคอลัมน์ของช่วงตามจำนวนที่ระบุ
การดำเนินการนี้มีผลในการสร้าง แก้ไข หรือการลบกลุ่มที่ตัดกับช่วงดังกล่าว สำหรับเดลต้าเชิงบวก จะมีการสร้างและ/หรือแก้ไขกลุ่ม สำหรับเดลต้าเชิงลบ กลุ่มจะถูกทำลายและ/หรือแก้ไข
ซึ่งจะไม่มีผลเมื่อลดความลึกของกลุ่มให้ต่ำกว่า 0 หรือสูงกว่า 8
หาก column group control position
คือ BEFORE
ระบบจะแสดงข้อผิดพลาดเมื่อพยายามเปลี่ยนความลึกของแถวแรก
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
delta | Integer | จำนวนที่จะใช้เปลี่ยนความลึกของกลุ่มคอลัมน์ของช่วงนี้ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การขว้าง
Error
— เมื่อพยายามเปลี่ยนความลึกของคอลัมน์แรกเมื่อตำแหน่งการควบคุมคือ GroupControlTogglePosition.BEFORE
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
shiftRowGroupDepth(delta)
เปลี่ยนความลึกในการจัดกลุ่มแถวของช่วงตามจำนวนที่ระบุ
การดำเนินการนี้มีผลในการสร้าง แก้ไข หรือการลบกลุ่มที่ตัดกับช่วงดังกล่าว สำหรับเดลต้าเชิงบวก จะมีการสร้างและ/หรือแก้ไขกลุ่ม สำหรับเดลต้าเชิงลบ กลุ่มจะถูกทำลายและ/หรือแก้ไข
ซึ่งจะไม่มีผลเมื่อลดความลึกของกลุ่มให้ต่ำกว่า 0 หรือสูงกว่า 8
หาก row group control position
คือ BEFORE
ระบบจะแสดงข้อผิดพลาดเมื่อพยายามเปลี่ยนความลึกของแถวแรก
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);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
delta | Integer | จำนวนที่จะใช้เปลี่ยนความลึกของกลุ่มแถวของช่วงนี้ |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การขว้าง
Error
— เมื่อพยายามเปลี่ยนความลึกของแถวแรกเมื่อตำแหน่งควบคุมคือ GroupControlTogglePosition.BEFORE
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(sortSpecObj)
จัดเรียงเซลล์ในช่วงที่กำหนดตามคอลัมน์และลำดับที่ระบุ
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}]);
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
sortSpecObj | Object | คอลัมน์ที่จะจัดเรียง |
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
splitTextToColumns()
แบ่งคอลัมน์ของข้อความออกเป็นหลายคอลัมน์ตามตัวคั่นที่ตรวจพบอัตโนมัติ
// 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 |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
splitTextToColumns(delimiter)
แบ่งคอลัมน์ของข้อความออกเป็นหลายคอลัมน์โดยใช้สตริงที่ระบุเป็นตัวคั่นที่กำหนดเอง
// 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 |
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
delimiter | String | ตัวคั่นที่กำหนดเองที่จะแยก |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
splitTextToColumns(delimiter)
แบ่งคอลัมน์ข้อความออกเป็นหลายคอลัมน์ตามตัวคั่นที่ระบุ
// 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 |
พารามิเตอร์
ชื่อ | ประเภท | คำอธิบาย |
---|---|---|
delimiter | TextToColumnsDelimiter | ตัวคั่นที่กำหนดไว้ล่วงหน้าที่จะแยก |
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
trimWhitespace()
ตัดการเว้นวรรค (เช่น เว้นวรรค แท็บ หรือบรรทัดใหม่) ในทุกเซลล์ในช่วงนี้ นำช่องว่างทั้งหมดออกจากจุดเริ่มต้นและจุดสิ้นสุดของข้อความของแต่ละเซลล์ และลดลำดับต่อๆ ไปของอักขระช่องว่างที่เหลืออยู่ให้เหลือเพียงช่องเดียว
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)']
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
uncheck()
เปลี่ยนสถานะของช่องทำเครื่องหมายในช่วงเป็น "ยกเลิกการเลือกแล้ว" ไม่สนใจเซลล์ในช่วงที่ไม่มีการกำหนดค่าที่เลือกหรือไม่ได้เลือกไว้
// 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();
ขากลับ
Range
— ช่วงนี้สำหรับการทำเชน
การให้สิทธิ์
สคริปต์ที่ใช้วิธีการนี้จะต้องมีการให้สิทธิ์ตามขอบเขตต่อไปนี้อย่างน้อย 1 รายการ
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets