E-tablo aralıklarına erişme ve bu aralıkları değiştirme Bir aralık, sayfadaki tek bir hücre veya bitişik hücreler.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
activate() | Range | Belirtilen aralığı active range olarak ayarlar ve üst
current cell olarak aralıktaki sol hücreyi seçin. |
activateAsCurrentCell() | Range | Belirtilen hücreyi current cell olarak ayarlar. |
addDeveloperMetadata(key) | Range | Belirtilen anahtara sahip geliştirici meta verilerini aralığa ekler. |
addDeveloperMetadata(key, visibility) | Range | Belirtilen anahtara ve görünürlüğe sahip geliştirici meta verilerini aralığa ekler. |
addDeveloperMetadata(key, value) | Range | Belirtilen anahtar ve değere sahip geliştirici meta verilerini aralığa ekler. |
addDeveloperMetadata(key, value, visibility) | Range | Belirtilen anahtar, değer ve görünürlüğe sahip geliştirici meta verilerini aralığa ekler. |
applyColumnBanding() | Banding | Aralığa varsayılan bir sütun şeridi oluşturma teması uygular. |
applyColumnBanding(bandingTheme) | Banding | Aralığa belirli bir sütun şerit oluşturma teması uygular. |
applyColumnBanding(bandingTheme, showHeader, showFooter) | Banding | Belirtilen üstbilgi ve altbilgiye sahip aralığa belirli bir sütun şerit oluşturma teması uygular Ayarlar'da devre dışı bırakabilirsiniz. |
applyRowBanding() | Banding | Aralığa varsayılan bir satır şeridi oluşturma teması uygular. |
applyRowBanding(bandingTheme) | Banding | Aralığa, belirtilen bir satır şeridi oluşturma teması uygular. |
applyRowBanding(bandingTheme, showHeader, showFooter) | Banding | Belirtilen üstbilgi ve altbilgi ayarlarıyla aralığa belirli bir satır şeridi oluşturma teması uygular. |
autoFill(destination, series) | void | destinationRange aralığını bu aralıktaki verilere dayalı verilerle doldurur. |
autoFillToNeighbor(series) | void | Komşu hücrelere göre yeni verilerle doldurulacak aralığı hesaplar ve otomatik olarak doldurur bu aralıktaki verilere dayalı olarak yeni değerlerle değiştirilir. |
breakApart() | Range | Aralıktaki çok sütunlu hücreleri tekrar tek tek hücrelere bölün. |
canEdit() | Boolean | Kullanıcının aralıktaki her hücreyi düzenleme izni olup olmadığını belirler. |
check() | Range | Aralıktaki onay kutularının durumunu "işaretli" olarak değiştirir. |
clear() | Range | İçerik ve biçim aralığını temizler. |
clear(options) | Range | Aşağıdaki gibi içerik aralığını, biçimi, veri doğrulama kurallarını ve/veya yorumları temizler: verilen gelişmiş seçeneklerdir. |
clearContent() | Range | Biçimlendirmeyi değiştirmeden aralığın içeriğini temizler. |
clearDataValidations() | Range | Aralıkla ilgili veri doğrulama kurallarını temizler. |
clearFormat() | Range | Bu aralığın biçimlendirmesini temizler. |
clearNote() | Range | Verilen hücredeki veya hücrelerdeki notu temizler. |
collapseGroups() | Range | Tamamen aralık içinde yer alan tüm grupları daraltır. |
copyFormatToRange(gridId, column, columnEnd, row, rowEnd) | void | Aralığın biçimlendirmesini belirtilen konuma kopyalayın. |
copyFormatToRange(sheet, column, columnEnd, row, rowEnd) | void | Aralığın biçimlendirmesini belirtilen konuma kopyalayın. |
copyTo(destination) | void | Bir hücre aralığındaki verileri başka bir hücre aralığına kopyalar. |
copyTo(destination, copyPasteType, transposed) | void | Bir hücre aralığındaki verileri başka bir hücre aralığına kopyalar. |
copyTo(destination, options) | void | Bir hücre aralığındaki verileri başka bir hücre aralığına kopyalar. |
copyValuesToRange(gridId, column, columnEnd, row, rowEnd) | void | Aralığın içeriğini belirtilen konuma kopyalayın. |
copyValuesToRange(sheet, column, columnEnd, row, rowEnd) | void | Aralığın içeriğini belirtilen konuma kopyalayın. |
createDataSourcePivotTable(dataSource) | DataSourcePivotTable | Veri kaynağından, ilk hücreye sabitlenmiş boş bir veri kaynağı pivot tablosu oluşturur bu aralıkta. |
createDataSourceTable(dataSource) | DataSourceTable | Veri kaynağından, bu sayfadaki ilk hücreye sabitlenmiş boş bir veri kaynağı tablosu oluşturur aralığı. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Bu kapsamdaki geliştirici meta verilerini bulmak için bir DeveloperMetadataFinderApi değeri döndürür aralığı. |
createFilter() | Filter | Bir filtre oluşturur ve bunu sayfada belirtilen aralığa uygular. |
createPivotTable(sourceData) | PivotTable | Belirtilen sourceData sütunundan, ilk hücreye sabitlenmiş boş bir pivot tablo oluşturur
bu aralıkta. |
createTextFinder(findText) | TextFinder | Aralık için, bu aralıktaki metni bulup değiştirebilen bir metin bulucu oluşturur. |
deleteCells(shiftDimension) | void | Bu hücre aralığını siler. |
expandGroups() | Range | Aralık veya kontrol açma/kapatma düğmesi bu aralıkla kesişen daraltılmış grupları genişletir. |
getA1Notation() | String | A1 gösteriminde aralığın dize açıklamasını döndürür. |
getBackground() | String | Aralıkta sol üstteki hücrenin arka plan rengini döndürür (örneğin, '#ffffff' ). |
getBackgroundObject() | Color | Aralıkta sol üstteki hücrenin arka plan rengini döndürür. |
getBackgroundObjects() | Color[][] | Aralıktaki hücrelerin arka plan renklerini döndürür. |
getBackgrounds() | String[][] | Aralıktaki hücrelerin arka plan renklerini döndürür (örneğin, '#ffffff' ). |
getBandings() | Banding[] | Bu aralıktaki hücrelere uygulanan tüm şeritleri döndürür. |
getCell(row, column) | Range | Bir aralıktaki belirli bir hücreyi döndürür. |
getColumn() | Integer | Bu aralığın başlangıç sütunu konumunu döndürür. |
getDataRegion() | Range | Dört kardinal Direction içinde genişletilen aralığın, tümünü kapsayacak şekilde bir kopyasını döndürür
veri bulunan bitişik hücreler. |
getDataRegion(dimension) | Range | Şu durumda Direction.UP ve Direction.DOWN aralığının bir kopyasını döndürür:
belirtilen boyut Dimension.ROWS veya boyut Dimension.COLUMNS ise Direction.NEXT ve Direction.PREVIOUS olur. |
getDataSourceFormula() | DataSourceFormula | Aralıktaki ilk hücre için DataSourceFormula değerini veya aralıktaki ilk hücre için null değerini döndürür
hücre, veri kaynağı formülü içermiyor. |
getDataSourceFormulas() | DataSourceFormula[] | Aralıktaki hücreler için DataSourceFormula değerlerini döndürür. |
getDataSourcePivotTables() | DataSourcePivotTable[] | Aralıkla kesişen tüm veri kaynağı pivot tablolarını alır. |
getDataSourceTables() | DataSourceTable[] | Aralıkla kesişen tüm veri kaynağı tablolarını alır. |
getDataSourceUrl() | String | Bu aralıktaki veriler için, grafik ve sorgu oluşturmak amacıyla kullanılabilecek bir URL döndürür. |
getDataTable() | DataTable | Bu nesnenin içindeki verileri DataTable olarak döndürün. |
getDataTable(firstRowIsHeader) | DataTable | Bu aralıktaki verileri DataTable olarak döndürün. |
getDataValidation() | DataValidation | Aralıkta sol üstteki hücre için veri doğrulama kuralını döndürür. |
getDataValidations() | DataValidation[][] | Aralıktaki tüm hücreler için veri doğrulama kurallarını döndürür. |
getDeveloperMetadata() | DeveloperMetadata[] | Bu aralıkla ilişkili geliştirici meta verilerini alır. |
getDisplayValue() | String | Aralıkta sol üstte bulunan hücrenin görüntülenen değerini döndürür. |
getDisplayValues() | String[][] | Bu aralığın değerlerin dikdörtgen tablosunu döndürür. |
getFilter() | Filter | Bu aralığın ait olduğu sayfadaki filtreyi veya filtre yoksa null döndürür.
yapacaksınız. |
getFontColorObject() | Color | Aralığın sol üst köşesindeki hücrenin yazı tipi rengini döndürür. |
getFontColorObjects() | Color[][] | Aralıktaki hücrelerin yazı tipi renklerini döndürür. |
getFontFamilies() | String[][] | Aralıktaki hücrelerin yazı tipi ailelerini döndürür. |
getFontFamily() | String | Aralığın sol üst köşesindeki hücrenin yazı tipi ailesini döndürür. |
getFontLine() | String | Aralığın sol üst köşesindeki hücrenin çizgi stilini alır ('underline' ,
'line-through' veya 'none' ). |
getFontLines() | String[][] | Aralıktaki ('underline' , 'line-through' veya
'none' ). |
getFontSize() | Integer | Aralığın sol üst köşesindeki hücrenin nokta boyutunda yazı tipi boyutunu döndürür. |
getFontSizes() | Integer[][] | Aralıktaki hücrelerin yazı tipi boyutlarını döndürür. |
getFontStyle() | String | Sol üstteki hücrenin yazı tipi stilini ('italic' veya 'normal' ) döndürür
köşesine eklenir. |
getFontStyles() | String[][] | Aralıktaki hücrelerin yazı tipi stillerini döndürür. |
getFontWeight() | String | Aralığın sol üst köşesindeki hücrenin yazı tipi ağırlığını (normal/kalın) döndürür. |
getFontWeights() | String[][] | Aralıktaki hücrelerin yazı tipi ağırlıklarını döndürür. |
getFormula() | String | Aralığın sol üst hücresine ilişkin formülü (A1 gösterimini) veya hücre boş veya formül içermiyor. |
getFormulaR1C1() | String | Belirli bir hücrenin formülünü (R1C1 gösterimini) veya yoksa null değerini döndürür. |
getFormulas() | String[][] | Aralıktaki hücrelere ait formülleri (A1 gösterimi) döndürür. |
getFormulasR1C1() | String[][] | Aralıktaki hücrelere ait formülleri (R1C1 gösterimi) döndürür. |
getGridId() | Integer | Aralığın üst sayfasının ızgara kimliğini döndürür. |
getHeight() | Integer | Aralığın yüksekliğini döndürür. |
getHorizontalAlignment() | String | Hücrenin sol üstteki metninin yatay hizalamasını (sola/orta/sağ) döndürür köşesine eklenir. |
getHorizontalAlignments() | String[][] | Aralıktaki hücrelerin yatay hizalamalarını döndürür. |
getLastColumn() | Integer | Bitiş sütunu konumunu döndürür. |
getLastRow() | Integer | Bitiş satırı konumunu döndürür. |
getMergedRanges() | Range[] | Tamamen var olan birleştirilmiş hücreleri temsil eden Range nesne dizisini döndürür
veya geçerli aralıktaki en az bir hücreyi içermelidir. |
getNextDataCell(direction) | Range | Aralığın ilk sütunundaki ve satırındaki hücreden başlayarak, veri içeren bitişik bir hücre aralığının kenarı olan yön kenarını, e-tablonun kenarına, |
getNote() | String | Verilen aralıkla ilişkili notu döndürür. |
getNotes() | String[][] | Aralıktaki hücrelerle ilişkili notları döndürür. |
getNumColumns() | Integer | Bu aralıktaki sütun sayısını döndürür. |
getNumRows() | Integer | Bu aralıktaki satır sayısını döndürür. |
getNumberFormat() | String | Verilen aralığın sol üst tarafındaki hücrenin sayısını veya tarih biçimlendirmesini alın. |
getNumberFormats() | String[][] | Aralıktaki hücrelerin sayısını veya tarih biçimlerini döndürür. |
getRichTextValue() | RichTextValue | Aralığın sol üst hücresi için Zengin Metin değerini veya hücreyse null değerini döndürür
değer metin değil. |
getRichTextValues() | RichTextValue[][] | Aralıktaki hücreler için Zengin Metin değerlerini döndürür. |
getRow() | Integer | Bu aralık için satır konumunu döndürür. |
getRowIndex() | Integer | Bu aralık için satır konumunu döndürür. |
getSheet() | Sheet | Bu aralığın ait olduğu sayfayı döndürür. |
getTextDirection() | TextDirection | Aralığın sol üst hücresinin metin yönünü döndürür. |
getTextDirections() | TextDirection[][] | Aralıktaki hücrelerin metin yönlerini döndürür. |
getTextRotation() | TextRotation | Aralığın sol üst hücresi için metin döndürme ayarlarını döndürür. |
getTextRotations() | TextRotation[][] | Aralıktaki hücreler için metin döndürme ayarlarını döndürür. |
getTextStyle() | TextStyle | Aralığın sol üst hücresinin metin stilini döndürür. |
getTextStyles() | TextStyle[][] | Aralıktaki hücrelerin metin stillerini döndürür. |
getValue() | Object | Aralıkta sol üstte bulunan hücrenin değerini döndürür. |
getValues() | Object[][] | Bu aralığın değerlerin dikdörtgen tablosunu döndürür. |
getVerticalAlignment() | String | Hücrenin sol üst köşesinde dikey hizalamasını (üst/orta/alt) döndürür aralığı. |
getVerticalAlignments() | String[][] | Aralıktaki hücrelerin dikey hizalamalarını döndürür. |
getWidth() | Integer | Sütunlardaki aralığın genişliğini döndürür. |
getWrap() | Boolean | Hücredeki metnin kaydırılıp kaydırılmayacağını döndürür. |
getWrapStrategies() | WrapStrategy[][] | Aralıktaki hücreler için metin kaydırma stratejilerini döndürür. |
getWrapStrategy() | WrapStrategy | Aralığın sol üst hücresinin metin kaydırma stratejisini döndürür. |
getWraps() | Boolean[][] | Hücrelerdeki metnin kaydırılıp kaydırılmadığını döndürür. |
insertCells(shiftDimension) | Range | Bu aralığa boş hücreler ekler. |
insertCheckboxes() | Range | Aralıktaki her bir hücreye onay kutuları ekler. İşaretli olanlar ve işaretli olanlar için true ile yapılandırılır.
İşaretlenmemiş için false . |
insertCheckboxes(checkedValue) | Range | Aralıktaki her bir hücreye onay kutuları ekler. Bu alanlar, işaretlenmiş ve işaretlenmiş olanlar için özel bir değerle yapılandırılır. boş dizeyi işaretlemeyin. |
insertCheckboxes(checkedValue, uncheckedValue) | Range | Aralıktaki her bir hücreye onay kutuları ekler, işaretli olanlar için özel değerlerle yapılandırılır kontrol edebilirsiniz. |
isBlank() | Boolean | Aralık tamamen boşsa true değerini döndürür. |
isChecked() | Boolean | Aralıktaki tüm hücrelerin onay kutusu durumunun "işaretli" olup olmadığını döndürür. |
isEndColumnBounded() | Boolean | Aralık sonunun belirli bir sütuna bağlı olup olmadığını belirler. |
isEndRowBounded() | Boolean | Aralık sonunun belirli bir satıra bağlı olup olmadığını belirler. |
isPartOfMerge() | Boolean | Geçerli aralıktaki hücreler birleştirilmiş hücrelerle çakışırsa true değerini döndürür. |
isStartColumnBounded() | Boolean | Aralık başlangıcının belirli bir sütuna bağlı olup olmadığını belirler. |
isStartRowBounded() | Boolean | Aralık başlangıcının belirli bir satıra bağlı olup olmadığını belirler. |
merge() | Range | Aralıktaki hücreleri tek bir blok halinde birleştirir. |
mergeAcross() | Range | Aralıktaki hücreleri, aralıktaki sütunlarda birleştirin. |
mergeVertically() | Range | Aralıktaki hücreleri birleştirir. |
moveTo(target) | void | Bu aralıktan kesip (hem biçim hem de değerler) hedef aralığa yapıştırın. |
offset(rowOffset, columnOffset) | Range | Belirtilen satır ve sütun sayısına göre bu aralıktan uzaklık verilen yeni bir aralık döndürür (negatif olabilir). |
offset(rowOffset, columnOffset, numRows) | Range | Sol üst noktası uzaklık verilen geçerli aralığa göre yeni bir aralık döndürür belirtilen satır ve sütunlara göre ve hücrelerde belirtilen yükseklikle geçerli aralıktan değiştirebilirsiniz. |
offset(rowOffset, columnOffset, numRows, numColumns) | Range | Sol üst noktası uzaklık verilen geçerli aralığa göre yeni bir aralık döndürür geçerli aralıktan verilen satır ve sütunlara göre ve belirtilen yükseklik ve genişlikte hücreler. |
protect() | Protection | Aralığa erişimi olan kullanıcılar dışında, aralığın düzenlenmesine karşı korunabilecek bir nesne oluşturur. izni gerekir. |
randomize() | Range | Verilen aralıktaki satırların sırasını rastgele hale getirir. |
removeCheckboxes() | Range | Aralıktaki tüm onay kutularını kaldırır. |
removeDuplicates() | Range | Bu aralık içinde bulunan ve herhangi bir önceki satırda yer alır. |
removeDuplicates(columnsToCompare) | Range | Bu aralık içinde bulunan ve belirtilen sütunlarda yinelenen değerler içeren satırları kaldırır önceki herhangi bir satırda değer olarak görünür. |
setBackground(color) | Range | CSS gösteriminde ('#ffffff' gibi) aralıktaki tüm hücrelerin arka plan rengini ayarlar
veya 'white' ). |
setBackgroundObject(color) | Range | Aralıktaki tüm hücrelerin arka plan rengini ayarlar. |
setBackgroundObjects(color) | Range | Arka plan renklerinin dikdörtgen ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setBackgroundRGB(red, green, blue) | Range | RGB değerlerini (0 ile 255 arasındaki tam sayılar dahil) kullanarak arka planı belirtilen renge ayarlar. |
setBackgrounds(color) | Range | Arka plan renklerinin dikdörtgen ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setBorder(top, left, bottom, right, vertical, horizontal) | Range | Kenarlık özelliğini ayarlar. |
setBorder(top, left, bottom, right, vertical, horizontal, color, style) | Range | Kenarlık özelliğini renk ve/veya stille ayarlar. |
setDataValidation(rule) | Range | Aralıktaki tüm hücreler için tek bir veri doğrulama kuralı ayarlar. |
setDataValidations(rules) | Range | Aralıktaki tüm hücreler için veri doğrulama kurallarını ayarlar. |
setFontColor(color) | Range | CSS gösteriminde yazı tipi rengini ayarlar ('#ffffff' veya 'white' gibi). |
setFontColorObject(color) | Range | Verilen aralığın yazı tipi rengini ayarlar. |
setFontColorObjects(colors) | Range | Yazı tipi renklerinin dikdörtgen ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setFontColors(colors) | Range | Yazı tipi renklerinin dikdörtgen ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setFontFamilies(fontFamilies) | Range | Yazı tipi ailelerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setFontFamily(fontFamily) | Range | Yazı tipi ailesini ayarlar (ör. "SFTP") veya "Helvetica". |
setFontLine(fontLine) | Range | Verilen aralığın ('underline' , 'line-through' veya
'none' ). |
setFontLines(fontLines) | Range | Çizgi stillerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setFontSize(size) | Range | Yazı tipi boyutunu ayarlar. Boyut, kullanılacak nokta boyutudur. |
setFontSizes(sizes) | Range | Yazı tipi boyutlarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setFontStyle(fontStyle) | Range | Verilen aralığın ('italic' veya 'normal' ) yazı tipi stilini ayarlayın. |
setFontStyles(fontStyles) | Range | Yazı tipi stillerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setFontWeight(fontWeight) | Range | Belirtilen aralık için yazı tipi ağırlığını (normal/kalın) ayarlayın. |
setFontWeights(fontWeights) | Range | Yazı tipi ağırlıklarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setFormula(formula) | Range | Bu aralığa ilişkin formülü günceller. |
setFormulaR1C1(formula) | Range | Bu aralığa ilişkin formülü günceller. |
setFormulas(formulas) | Range | Dikdörtgen formül ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setFormulasR1C1(formulas) | Range | Dikdörtgen formül ızgarasını ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setHorizontalAlignment(alignment) | Range | Verilen aralık (sol/orta/sağ) için yatay (soldan sağa) hizalamayı ayarlayın. |
setHorizontalAlignments(alignments) | Range | Yatay hizalamalardan oluşan dikdörtgen bir ızgara ayarlar. |
setNote(note) | Range | Notu verilen değere ayarlar. |
setNotes(notes) | Range | Dikdörtgen bir not ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setNumberFormat(numberFormat) | Range | Sayıyı veya tarih biçimini, verilen biçimlendirme dizesine ayarlar. |
setNumberFormats(numberFormats) | Range | Sayı veya tarih biçimlerinden oluşan dikdörtgen bir tablo ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setRichTextValue(value) | Range | Aralıktaki hücreler için Zengin Metin değerini ayarlar. |
setRichTextValues(values) | Range | Zengin Metin değerlerinin dikdörtgen ızgarasını ayarlar. |
setShowHyperlink(showHyperlink) | Range | Aralığın köprüleri gösterip göstermeyeceğini belirler. |
setTextDirection(direction) | Range | Aralıktaki hücrelerin metin yönünü ayarlar. |
setTextDirections(directions) | Range | Metin yönlerinden oluşan dikdörtgen bir ızgara ayarlar. |
setTextRotation(degrees) | Range | Aralıktaki hücreler için metin döndürme ayarlarını belirler. |
setTextRotation(rotation) | Range | Aralıktaki hücreler için metin döndürme ayarlarını belirler. |
setTextRotations(rotations) | Range | Metin döndürmeleri için dikdörtgen bir tablo ayarlar. |
setTextStyle(style) | Range | Aralıktaki hücrelerin metin stilini ayarlar. |
setTextStyles(styles) | Range | Metin stillerinden oluşan dikdörtgen bir ızgara ayarlar. |
setValue(value) | Range | Aralığın değerini ayarlar. |
setValues(values) | Range | Dikdörtgen bir değer ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setVerticalAlignment(alignment) | Range | Verilen aralık (üst/orta/alt) için dikey (üstten alta) hizalamayı ayarlayın. |
setVerticalAlignments(alignments) | Range | Dikey hizalamaları içeren dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
setVerticalText(isVertical) | Range | Aralıktaki hücreler için metnin yığın halinde yığılıp yığılmayacağını ayarlar. |
setWrap(isWrapEnabled) | Range | Verilen aralığın hücre sarmalamayı ayarlayın. |
setWrapStrategies(strategies) | Range | Sarma stratejilerinden oluşan bir dikdörtgen ızgara ayarlar. |
setWrapStrategy(strategy) | Range | Aralıktaki hücreler için metin kaydırma stratejisini ayarlar. |
setWraps(isWrapEnabled) | Range | Kelime kaydırma politikalarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
shiftColumnGroupDepth(delta) | Range | Aralığın sütun gruplama derinliğini belirtilen tutara göre değiştirir. |
shiftRowGroupDepth(delta) | Range | Aralığın satır gruplama derinliğini belirtilen tutara göre değiştirir. |
sort(sortSpecObj) | Range | Verilen aralıktaki hücreleri, belirtilen sütun ve düzene göre sıralar. |
splitTextToColumns() | void | Bir metin sütununu, otomatik olarak algılanan sınırlayıcıya göre birden fazla sütuna böler. |
splitTextToColumns(delimiter) | void | Belirtilen dizeyi özel sınırlayıcı olarak kullanarak bir metin sütununu birden fazla sütuna böler. |
splitTextToColumns(delimiter) | void | Bir metin sütununu, belirtilen sınırlayıcıya göre birden fazla sütuna böler. |
trimWhitespace() | Range | Bu aralıktaki her hücredeki boşlukları (ör. boşluklar, sekmeler veya yeni satırlar) kırpar. |
uncheck() | Range | Aralıktaki onay kutularının durumunu "işareti kaldırıldı" olarak değiştirir. |
Ayrıntılı belgeler
activate()
Belirtilen aralığı, en üstteki active range
olacak şekilde ayarlar
current cell
olarak aralıktaki sol hücreyi seçin.
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();
Return
Range
: Zincirleme için bu aralık.
activateAsCurrentCell()
Belirtilen hücreyi current cell
olarak ayarlar.
Belirtilen hücre mevcut bir aralıktaysa bu aralık etkin olacak hücrenin bulunduğu aralık.
Belirtilen hücre mevcut aralıklardan herhangi birinde bulunmuyorsa mevcut seçim kaldırılır ve hücre, geçerli hücre ve etkin aralık olur.
Not: Belirtilen Range
tek bir hücreden oluşmalıdır, aksi takdirde
kabul edersiniz.
// 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());
Return
Range
: Zincirleme için bu aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key)
Belirtilen anahtara sahip geliştirici meta verilerini aralığa ekler.
// 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());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
Return
Range
: Zincirleme için bu aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
Belirtilen anahtara ve görünürlüğe sahip geliştirici meta verilerini aralığa ekler.
// 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());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
visibility | DeveloperMetadataVisibility | Yeni geliştirici meta verilerinin görünürlüğü. |
Return
Range
: Zincirleme için bu aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
Belirtilen anahtar ve değere sahip geliştirici meta verilerini aralığa ekler.
// 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());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
value | String | Yeni geliştirici meta verilerinin değeri. |
Return
Range
: Zincirleme için bu aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
Belirtilen anahtar, değer ve görünürlüğe sahip geliştirici meta verilerini aralığa ekler.
// 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());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
value | String | Yeni geliştirici meta verilerinin değeri. |
visibility | DeveloperMetadataVisibility | Yeni geliştirici meta verilerinin görünürlüğü. |
Return
Range
: Zincirleme için bu aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding()
Aralığa varsayılan bir sütun şeridi oluşturma teması uygular. Varsayılan olarak şerit oluşturma; üstbilgiye sahiptir ve altbilgi rengi.
// 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());
Return
Banding
— Yeni müzik grupları.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding(bandingTheme)
Aralığa belirli bir sütun şerit oluşturma teması uygular. Varsayılan olarak şerit oluşturma; başlık ve altbilgi rengi yok.
// 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());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
bandingTheme | BandingTheme | Aralıktaki sütunlara uygulanacak bir renk teması. |
Return
Banding
— Yeni müzik grupları.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding(bandingTheme, showHeader, showFooter)
Belirtilen üstbilgi ve altbilgiye sahip aralığa belirli bir sütun şerit oluşturma teması uygular Ayarlar'da devre dışı bırakabilirsiniz.
// 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());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
bandingTheme | BandingTheme | Aralıktaki sütunlara uygulanacak bir renk teması. |
showHeader | Boolean | true ise şerit oluşturma teması başlık rengi ilk
sütununa girin. |
showFooter | Boolean | true ise şerit oluşturma teması altbilgi rengi son
sütununa girin. |
Return
Banding
— Yeni müzik grupları.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding()
Aralığa varsayılan bir satır şeridi oluşturma teması uygular. Varsayılan olarak şerit oluşturma; üstbilgiye sahiptir ve altbilgi rengi.
// 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);
Return
Banding
— Bant oluşturma.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme)
Aralığa, belirtilen bir satır şeridi oluşturma teması uygular. Varsayılan olarak şerit oluşturma; üstbilgiye sahiptir ve altbilgi rengi.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
bandingTheme | BandingTheme | Aralıktaki satırlara uygulanacak renk teması. |
Return
Banding
— Yeni müzik grupları.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme, showHeader, showFooter)
Belirtilen üstbilgi ve altbilgi ayarlarıyla aralığa belirli bir satır şeridi oluşturma teması uygular.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
bandingTheme | BandingTheme | Aralıktaki satırlara uygulanacak renk teması. |
showHeader | Boolean | true değerine ayarlanırsa şerit oluşturma teması başlık rengi ilk satıra uygulanır. |
showFooter | Boolean | true değerine ayarlanırsa şerit oluşturma teması altbilgi rengi son satıra uygulanır. |
Return
Banding
— Yeni müzik grupları.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoFill(destination, series)
destinationRange
aralığını bu aralıktaki verilere dayalı verilerle doldurur. Yeni değerler
belirtilen series
türüne göre de belirlenir. Hedef aralık şunları içermelidir:
yalnızca tek bir yöne doğru genişletin. Örneğin, aşağıdakiler A1:A20
alanını doldurur
A1:A4
içindeki mevcut değerlere göre artan bir sayı dizisiyle:
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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
destination | Range | Değerlerle otomatik olarak doldurulacak aralık. Hedef aralığı içeren bir liste oluşturabilir ve yalnızca tek bir yönde (yukarı, aşağı, sola veya sağ.) |
series | AutoFillSeries | Yeni değerleri hesaplamak için kullanılması gereken autoFill serisinin türü. İlgili içeriği oluşturmak için kullanılan bu serinin etkisi, kaynak verilerin türüne ve miktarına göre farklılık gösterir. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoFillToNeighbor(series)
Komşu hücrelere göre yeni verilerle doldurulacak aralığı hesaplar ve otomatik olarak doldurur
bu aralıktaki verilere dayalı olarak yeni değerlerle değiştirilir. Bu yeni değerler ayrıca
belirtilen series
türüne göre belirlenir.
Hesaplanan hedef aralığı, yeni trafiğin nerede olduğunu belirlemek için çevredeki verileri dikkate alır. değerleri eklenmelidir: Sütunun hemen solunda veya sağında Otomatik olarak doldurulduğundan, yeni değerler yalnızca bu bitişik verilere kadar genişler.
Örneğin, A1:A20
bir dizi artan sayıyla doluysa ve bu yöntem
bir tarih dizisini içeren B1:B4
aralığında çağrılır; yeni değerler yalnızca
B5:B20
içine eklendi. Bu şekilde, söz konusu yeni değerler “kalıcı” ekleyebileceğiniz
değerleri gösterilir.
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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
series | AutoFillSeries | Yeni değerleri hesaplamak için kullanılması gereken autoFill serisinin türü. İlgili içeriği oluşturmak için kullanılan bu serinin etkisi, kaynak verilerin türüne ve miktarına göre farklılık gösterir. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
breakApart()
Aralıktaki çok sütunlu hücreleri tekrar tek tek hücrelere bölün.
Bu işlevi bir aralıkta çağırmak, bir aralık seçip üzerine basarak Biçimlendir > Hücreleri birleştir > Birleştirilenleri ayır.
// 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();
Return
Range
: Zincirleme için bu aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
canEdit()
Kullanıcının aralıktaki her hücreyi düzenleme izni olup olmadığını belirler. E-tablo sahibi her zaman korunan aralıkları ve sayfaları düzenleyebilir.
// 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());
Return
Boolean
— Kullanıcının aralıktaki her hücreyi düzenleme izni varsa true
; false
aksi takdirde.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
check()
Aralıktaki onay kutularının durumunu "işaretli" olarak değiştirir. Aralıktaki hücreleri yoksayar Bu segmentler, şu anda yapılandırılmış veya işaretli olmayan değerleri içermiyor.
// 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();
Return
Range
: Zincirleme için bu aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
İçerik ve biçim aralığını temizler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clear();
Return
Range
: Zincirleme için bu aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Aşağıdaki gibi içerik aralığını, biçimi, veri doğrulama kurallarını ve/veya yorumları temizler: verilen gelişmiş seçeneklerdir. Varsayılan olarak tüm veriler temizlenir.
// 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});
Parametreler
Ad | Tür | Açıklama |
---|---|---|
options | Object | Aşağıda listelenen, gelişmiş parametreleri belirten bir JavaScript nesnesi. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
commentsOnly | Boolean | Yalnızca yorumların temizlenip temizlenmeyeceğini belirler. |
contentsOnly | Boolean | Yalnızca içeriğin temizlenip temizlenmeyeceğini belirler. |
formatOnly | Boolean | Yalnızca biçimin temizlenip temizlenmeyeceğini belirler. temizlemenin biçimi veri doğrulama kurallarını da temizler. |
validationsOnly | Boolean | Yalnızca veri doğrulama kurallarının temizlenip temizlenmeyeceğini belirler. |
skipFilteredRows | Boolean | Filtrelenmiş satırların temizlenip temizlenmeyeceğini belirler. |
Return
Range
: Zincirleme için bu aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContent()
Biçimlendirmeyi değiştirmeden aralığın içeriğini temizler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearContent();
Return
Range
: Zincirleme için bu aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearDataValidations()
Aralıkla ilgili veri doğrulama kurallarını temizler.
// Clear the data validation rules for cells A1:B5. var range = SpreadsheetApp.getActive().getRange('A1:B5'); range.clearDataValidations();
Return
Range
: Zincirleme için bu aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormat()
Bu aralığın biçimlendirmesini temizler.
Bu işlemle, aralıktaki hücre veya hücrelerin metin biçimlendirmesi temizlenir, ancak bunlarda herhangi bir sıfırlanmaz sayı biçimlendirme kuralları vardır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearFormat();
Return
Range
: Zincirleme için bu aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNote()
Verilen hücredeki veya hücrelerdeki notu temizler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearNote();
Return
Range
: Zincirleme için bu aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseGroups()
Tamamen aralık içinde yer alan tüm grupları daraltır. Hiçbir grup tam olarak kapsam içinde değilse aralığın içinde kısmen bulunan en derin genişletilmiş grup daraltılır.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are collapsed. range.collapseGroups();
Return
Range
: Zincirleme için bu aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
Aralığın biçimlendirmesini belirtilen konuma kopyalayın. Hedef daha büyük veya küçükse kaynak aralıktan daha fazla ise kaynak uygun şekilde tekrarlanır veya kısaltılır. Bu yöntemi yalnızca biçimlendirmeyi kopyalar.
ızgaraId parametresinin ayrıntılı açıklaması için getGridId()
adresini ziyaret edin.
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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
gridId | Integer | Konumdan bağımsız olarak, sayfanın e-tablodaki benzersiz kimliği. |
column | Integer | Hedef aralığın ilk sütunu. |
columnEnd | Integer | Hedef aralığın bitiş sütunu. |
row | Integer | Hedef aralığın başlangıç satırı. |
rowEnd | Integer | Hedef aralığın bitiş satırı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Aşağıdaki kaynakları da incelemenizi öneririz:
copyFormatToRange(sheet, column, columnEnd, row, rowEnd)
Aralığın biçimlendirmesini belirtilen konuma kopyalayın. Hedef daha büyük veya küçükse kaynak aralıktan daha fazla ise kaynak uygun şekilde tekrarlanır veya kısaltılır. Bu yöntemi yalnızca biçimlendirmeyi kopyalar.
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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheet | Sheet | Hedef sayfa. |
column | Integer | Hedef aralığın ilk sütunu. |
columnEnd | Integer | Hedef aralığın bitiş sütunu. |
row | Integer | Hedef aralığın başlangıç satırı. |
rowEnd | Integer | Hedef aralığın bitiş satırı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination)
Bir hücre aralığındaki verileri başka bir hücre aralığına kopyalar. Hem değerler hem de biçimlendirme kopyalandığından emin olun.
// 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));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
destination | Range | Kopyalanacak hedef aralık; hücrenin yalnızca sol üstteki konumu alakalı olmalıdır. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination, copyPasteType, transposed)
Bir hücre aralığındaki verileri başka bir hücre aralığına kopyalar.
// 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
destination | Range | Kopyalanacak hedef aralık; hücrenin yalnızca sol üstteki konumu alakalı olmalıdır. |
copyPasteType | CopyPasteType | Aralık içeriğinin seçeceğiz. |
transposed | Boolean | Aralığın ters çevrilmiş yönde yapıştırılıp yapıştırılmayacağı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination, options)
Bir hücre aralığındaki verileri başka bir hücre aralığına kopyalar. Varsayılan olarak hem değerler hem de biçimlendirmeler kopyalanır, ancak bu durum gelişmiş bağımsız değişkenler kullanılarak geçersiz kılınabilir.
// 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});
Parametreler
Ad | Tür | Açıklama |
---|---|---|
destination | Range | Kopyalanacak hedef aralık; hücrenin yalnızca sol üstteki konumu alakalı olmalıdır. |
options | Object | Aşağıda listelenen, gelişmiş parametreleri belirten bir JavaScript nesnesi. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
formatOnly | Boolean | yalnızca biçimin kopyalanması gerektiğini belirtir |
contentsOnly | Boolean | yalnızca içeriğin kopyalanması gerektiğini belirtir |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyValuesToRange(gridId, column, columnEnd, row, rowEnd)
Aralığın içeriğini belirtilen konuma kopyalayın. Hedef daha büyük veya küçükse kaynak aralıktan daha fazla ise kaynak uygun şekilde tekrarlanır veya kısaltılır.
ızgaraId parametresinin ayrıntılı açıklaması için getGridId()
adresini ziyaret edin.
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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
gridId | Integer | Konumdan bağımsız olarak, sayfanın e-tablodaki benzersiz kimliği. |
column | Integer | Hedef aralığın ilk sütunu. |
columnEnd | Integer | Hedef aralığın bitiş sütunu. |
row | Integer | Hedef aralığın başlangıç satırı. |
rowEnd | Integer | Hedef aralığın bitiş satırı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Aşağıdaki kaynakları da incelemenizi öneririz:
copyValuesToRange(sheet, column, columnEnd, row, rowEnd)
Aralığın içeriğini belirtilen konuma kopyalayın. Hedef daha büyük veya küçükse kaynak aralıktan daha fazla ise kaynak uygun şekilde tekrarlanır veya kısaltılır.
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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheet | Sheet | Hedef sayfa. |
column | Integer | Hedef aralığın ilk sütunu. |
columnEnd | Integer | Hedef aralığın bitiş sütunu. |
row | Integer | Hedef aralığın başlangıç satırı. |
rowEnd | Integer | Hedef aralığın bitiş satırı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourcePivotTable(dataSource)
Veri kaynağından, ilk hücreye sabitlenmiş boş bir veri kaynağı pivot tablosu oluşturur bu aralıkta.
Bu örnekte, yeni bir veri kaynağı pivot tablosunun nasıl oluşturulacağı ve yapılandırılacağı gösterilmektedir.
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());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
dataSource | DataSource | Pivot tablonun oluşturulacağı veri kaynağı. |
Return
DataSourcePivotTable
— Yeni oluşturulan veri kaynağı pivot tablosu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourceTable(dataSource)
Veri kaynağından, bu sayfadaki ilk hücreye sabitlenmiş boş bir veri kaynağı tablosu oluşturur aralığı.
Bu örnekte, yeni bir veri kaynağı tablosunun nasıl oluşturulacağı ve yapılandırılacağı gösterilmektedir.
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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
dataSource | DataSource | Pivot tablonun oluşturulacağı veri kaynağı. |
Return
DataSourceTable
: Yeni oluşturulan veri kaynağı tablosu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
Bu kapsamdaki geliştirici meta verilerini bulmak için bir DeveloperMetadataFinderApi değeri döndürür aralığı. Meta veriler, yalnızca aralık dahilinde olduğu sürece bu aralığın kapsamındadır. aralığı. Örneğin, "3:3" satırıyla ilişkili meta veriler bir aralığın kapsamında değildir "A1:D5" ancak "1:5" aralığındadır.
// 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());
Return
DeveloperMetadataFinder
: Bu aralık kapsamındaki meta verileri aramak için kullanılan bir geliştirici meta veri bulucudur.
createFilter()
Bir filtre oluşturur ve bunu sayfada belirtilen aralığa uygular. En fazla
tek bir filtre ekler. Filtrenizi oluşturduktan sonra erişmek ve değiştirmek için getFilter()
veya Sheet.getFilter()
tuşlarını kullanın.
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
sayfa için filtre oluşturmak üzere bu yöntemi kullanın.
Tablo sayfaları, bir veritabanına bağlı olmayan sayfalardır. Diğer filtre türlerini oluşturmak için:
aşağıdakilere bakın:
PivotTable.addFilter(sourceDataColumn, filterCriteria)
ile pivot tablo filtresi oluşturunDataSourceSheet.addFilter(columnName, filterCriteria)
ile veritabanına bağlı bir sayfa için filtre oluşturun.DataSourcePivotTable.addFilter(columnName, filterCriteria)
ile veritabanına bağlı pivot tablo için filtre oluşturun
Return
Filter
— Yeni filtre.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createPivotTable(sourceData)
Belirtilen sourceData
sütunundan, ilk hücreye sabitlenmiş boş bir pivot tablo oluşturur
bu aralıkta.
// 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());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sourceData | Range | Pivot tablonun oluşturulacağı veriler. |
Return
PivotTable
— Yeni oluşturulan PivotTable
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createTextFinder(findText)
Aralık için, bu aralıktaki metni bulup değiştirebilen bir metin bulucu oluşturur.
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');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
findText | String | Aranacak metin. |
Return
TextFinder
— Aralık için TextFinder
deleteCells(shiftDimension)
Bu hücre aralığını siler. Sayfada, sağlanan boyuta göre mevcut veriler kaydırılır seçilen aralığa doğru ilerler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
shiftDimension | Dimension | Mevcut verilerin kaydırılacağı boyut. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandGroups()
Aralık veya kontrol açma/kapatma düğmesi bu aralıkla kesişen daraltılmış grupları genişletir. İlgili içeriği oluşturmak için kullanılan kontrol açma/kapatma konumu, kontrol açma/kapatma düğmesinin gösterildiği dizindir. Bu işlem, sonra da ekleyebilirsiniz. Aynı konumda birden fazla grup varsa en kapsamlı grup genişletilir.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are expanded. range.expandGroups();
Return
Range
: Zincirleme için bu aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getA1Notation()
A1 gösteriminde aralığın dize açıklamasını döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange(1, 1, 2, 5); // Logs "A1:E2" Logger.log(range.getA1Notation());
Return
String
: A1 gösteriminde aralığın dize açıklaması.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackground()
Aralıkta sol üstteki hücrenin arka plan rengini döndürür (örneğin, '#ffffff'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackground());
Return
String
— Arka planın renk kodu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObject()
Aralıkta sol üstteki hücrenin arka plan rengini döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());
Return
Color
— Aralıkta sol üstteki hücrenin arka plan rengi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObjects()
Aralıktaki hücrelerin arka plan renklerini döndürür.
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()); } }
Return
Color[][]
— İki boyutlu bir arka plan renkleri dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgrounds()
Aralıktaki hücrelerin arka plan renklerini döndürür (örneğin, '#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]); } }
Return
String[][]
— Arka planların iki boyutlu renk kodları dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBandings()
Bu aralıktaki hücrelere uygulanan tüm şeritleri döndürür.
// 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()); }
Return
Banding[]
— Bu aralıktaki tüm hücrelere uygulanan tüm şeritler.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCell(row, column)
Bir aralıktaki belirli bir hücreyi döndürür.
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());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Aralığa göre hücre satırı. |
column | Integer | Aralığa göre hücrenin sütunu. |
Return
Range
: Belirtilen koordinatlarda tek bir hücre içeren aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumn()
Bu aralığın başlangıç sütunu konumunu döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "2.0" Logger.log(range.getColumn());
Return
Integer
: Aralığın e-tablodaki başlangıç sütunu konumu.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRegion()
Dört kardinal Direction
içinde genişletilen aralığın, tümünü kapsayacak şekilde bir kopyasını döndürür
veri bulunan bitişik hücreler. Aralık, aşağıdakileri içermeyen boş hücrelerle çevriliyse
üzere aralığın kendisi döndürülür. Bu, aralığı seçmeye benzer ve
Düzenleyicide Ctrl+A
yazıyor.
// 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());
Return
Range
— Aralığın veri bölgesi veya e-tablonun tamamı için bir aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRegion(dimension)
Şu durumda Direction.UP
ve Direction.DOWN
aralığının bir kopyasını döndürür:
belirtilen boyut Dimension.ROWS
veya boyut Dimension.COLUMNS
ise Direction.NEXT
ve Direction.PREVIOUS
olur. Aralığın genişlemesi
, tablo gibi düzenlenmiş aralığın yanındaki verilerin algılanmasına dayanır. Genişletilmiş aralık
tablo dahil olmak üzere, belirtilen boyut boyunca, içinde veri bulunan tüm bitişik hücreleri kapsar.
sınırlar. Orijinal aralık, belirtilen boyut boyunca boş hücrelerle çevriliyse
aralığın kendisi döndürülür. Bu yöntem, aralığı seçip sütunlar için
Ctrl+Space
veya düzenleyicide satırlar için Shift+Space
yazmaya benzer.
// 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());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
dimension | Dimension | Aralığın genişletileceği boyut. |
Return
Range
— Aralığın veri bölgesi veya her bir sütunu ya da
orijinal aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormula()
Aralıktaki ilk hücre için DataSourceFormula
değerini veya aralıktaki ilk hücre için null
değerini döndürür
hücre, veri kaynağı formülü içermiyor.
// 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);
Return
DataSourceFormula
— Hücre için DataSourceFormula
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
Aralıktaki hücreler için DataSourceFormula
değerlerini döndürür.
// 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());
Return
DataSourceFormula[]
— DataSourceFormula
dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
Aralıkla kesişen tüm veri kaynağı pivot tablolarını alır.
// 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());
Return
DataSourcePivotTable[]
: Veri kaynağı pivot tablolarının listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
Aralıkla kesişen tüm veri kaynağı tablolarını alır.
// 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());
Return
DataSourceTable[]
: Veri kaynağı tablolarının listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceUrl()
Bu aralıktaki veriler için, grafik ve sorgu oluşturmak amacıyla kullanılabilecek bir URL döndürür.
Code.gs
function doGet() { var ss = SpreadsheetApp.openById('1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c'); var sheet = ss.getSheetByName('ContinentData'); var range = sheet.getRange('A1:B8'); var template = HtmlService.createTemplateFromFile('piechart'); template.dataSourceUrl = range.getDataSourceUrl(); return template.evaluate(); }
piechart.html
<!DOCTYPE html> <html> <head> <!--Load the AJAX API--> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> // Load the Visualization API and the corechart package. google.charts.load('current', {'packages': ['corechart']}); // Set a callback to run when the Google Visualization API is loaded. google.charts.setOnLoadCallback(queryData); function queryData() { var query = new google.visualization.Query('<?= dataSourceUrl ?>'); query.send(drawChart); } // Callback that creates and populates a data table, // instantiates the pie chart, passes in the data and // draws it. function drawChart(response) { if (response.isError()) { alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage()); return; } var data = response.getDataTable(); // Set chart options. var options = { title: 'Population by Continent', width: 400, height: 300 }; // Instantiate and draw the chart, passing in some options. var chart = new google.visualization.PieChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <!-- Div that holds the pie chart. --> <div id="chart_div"></div> </body> </html>
Return
String
— Grafik gibi başka API'lere aktarılabilecek bir veri kaynağı olarak bu aralığın URL'si.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataTable()
Bu nesnenin içindeki verileri DataTable olarak döndürün.
// 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();
Return
DataTable
— veri tablosu olarak veriler.
getDataTable(firstRowIsHeader)
Bu aralıktaki verileri DataTable olarak döndürün.
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();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
firstRowIsHeader | Boolean | İlk satırın başlık olarak ele alınıp alınmayacağını belirtir. |
Return
DataTable
— Veri tablosu olarak veriler.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataValidation()
Aralıkta sol üstteki hücre için veri doğrulama kuralını döndürür. Veri doğrulama
değerine ayarlanırsa bu yöntem null
değerini döndürür.
// 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.') }
Return
DataValidation
— Aralıkta sol üstteki hücre için veri doğrulama kuralı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataValidations()
Aralıktaki tüm hücreler için veri doğrulama kurallarını döndürür. Veri doğrulama
belirli bir hücrede ayarlanmışsa bu yöntem, hücrenin dizideki konumu için null
değerini döndürür.
// 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);
Return
DataValidation[][]
— Şuradaki hücrelerle ilişkili veri doğrulama kurallarından oluşan iki boyutlu bir dizi:
aralığı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
Bu aralıkla ilişkili geliştirici meta verilerini alır.
// 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()}`); }
Return
DeveloperMetadata[]
: Bu aralıkla ilişkili geliştirici meta verileri.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValue()
Aralıkta sol üstte bulunan hücrenin görüntülenen değerini döndürür. Değer String
.
Görüntülenen değer, aşağıdakiler de dahil olmak üzere tarih, saat ve para birimi biçimlendirme
biçimleri, e-tablonun yerel ayarı tarafından otomatik olarak uygulanır. Boş hücreler, boş değer döndürür
dize.
// 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());
Return
String
: Bu hücrede gösterilen değer.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValues()
Bu aralığın değerlerin dikdörtgen tablosunu döndürür.
Satıra ve ardından sütuna göre dizine eklenen, görüntülenen değerlerin iki boyutlu bir dizisini döndürür. İlgili içeriği oluşturmak için kullanılan
değerler String
nesnedir. Görüntülenen değer,
e-tablonun yerel ayarına göre otomatik olarak uygulanan biçimler dahil olmak üzere para birimi biçimlendirme
ayarını değiştirebilirsiniz. Boş hücreler, dizideki boş bir dizeyle temsil edilir. Bir görevin
aralık dizini 1, 1
itibarıyla başlıyor, JavaScript dizisi [0][0]
adresinden dizine eklendi.
// 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]);
Return
String[][]
— İki boyutlu bir değer dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilter()
Bu aralığın ait olduğu sayfadaki filtreyi veya filtre yoksa null
döndürür.
yapacaksınız.
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();
Return
Filter
— Filtre.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontColorObject()
Aralığın sol üst köşesindeki hücrenin yazı tipi rengini döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontColorObject().asRgbColor().asHexString());
Return
Color
: Aralıkta sol üstteki hücrenin yazı tipi rengi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontColorObjects()
Aralıktaki hücrelerin yazı tipi renklerini döndürür.
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()); } }
Return
Color[][]
— Aralıktaki hücrelerle ilişkili yazı tipi renklerinin iki boyutlu bir dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontFamilies()
Aralıktaki hücrelerin yazı tipi ailelerini döndürür.
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]); } }
Return
String[][]
— Aralıktaki hücrelerle ilişkili yazı tipi ailelerinin iki boyutlu dizisi.
Yetkilendirme
Bu yöntemi ku