Aynı sayfada bir veya daha fazla Range
örneğinden oluşan koleksiyon. Bitişik olmayan aralık veya hücre koleksiyonlarına işlem uygulamak için bu sınıfı kullanabilirsiniz.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
activate() | RangeList | Range örneklerinin listesini seçer. |
breakApart() | RangeList | Aralık listesinde yer alan yatay veya dikey olarak birleştirilmiş tüm hücreleri, tekrar tek tek hücrelere bölün. |
check() | RangeList | Aralıktaki onay kutularının durumunu "işaretli" olarak değiştirir. |
clear() | RangeList | Aralık listesindeki her bir Range için içerik, biçim ve veri doğrulama kuralları aralığını temizler. |
clear(options) | RangeList | Belirtilen seçeneklerde belirtildiği gibi içerik, biçim, veri doğrulama kuralları ve yorum aralığını temizler. |
clearContent() | RangeList | Aralık listesindeki her bir Range öğesinin içeriğini temizleyerek biçimlendirmeyi korur. |
clearDataValidations() | RangeList | Aralık listesindeki her bir Range için veri doğrulama kurallarını temizler. |
clearFormat() | RangeList | Aralık listesindeki her Range için metin biçimlendirmesini temizler. |
clearNote() | RangeList | Aralık listesindeki her bir Range için notu temizler. |
getRanges() | Range[] | Aynı sayfadaki bir veya daha fazla Range örneğinin listesini döndürür. |
insertCheckboxes() | RangeList | Aralıktaki her bir hücreye onay kutuları ekler. İşaretli olanlar için true , işaretli olanlar içinse false ile yapılandırılır. |
insertCheckboxes(checkedValue) | RangeList | Aralıktaki her bir hücreye, işaretli için özel bir değerle, işaretlenmemiş için ise boş bir dizeyle yapılandırılmış onay kutuları ekler. |
insertCheckboxes(checkedValue, uncheckedValue) | RangeList | Aralıktaki her bir hücreye, işaretli ve işaretlenmemiş durumlar için özel değerlerle yapılandırılmış onay kutuları ekler. |
removeCheckboxes() | RangeList | Aralıktaki tüm onay kutularını kaldırır. |
setBackground(color) | RangeList | Aralık listesindeki her bir Range için arka plan rengini ayarlar. |
setBackgroundRGB(red, green, blue) | RangeList | Arka planı verilen RGB renge ayarlar. |
setBorder(top, left, bottom, right, vertical, horizontal) | RangeList | Aralık listesindeki her bir Range için kenarlık özelliğini ayarlar. |
setBorder(top, left, bottom, right, vertical, horizontal, color, style) | RangeList | Aralık listesindeki her bir Range için kenarlık özelliğini renk ve/veya stille ayarlar. |
setFontColor(color) | RangeList | Aralık listesindeki her bir Range için yazı tipi rengini ayarlar. |
setFontFamily(fontFamily) | RangeList | Aralık listesindeki her bir Range için yazı tipi ailesini ayarlar. |
setFontLine(fontLine) | RangeList | Aralık listesindeki her bir Range için yazı tipi çizgi stilini ayarlar. |
setFontSize(size) | RangeList | Aralık listesindeki her bir Range için yazı tipi boyutunu (punto cinsinden) ayarlar. |
setFontStyle(fontStyle) | RangeList | Aralık listesindeki her Range için yazı tipi stilini ayarlayın. |
setFontWeight(fontWeight) | RangeList | Aralık listesindeki her Range için yazı tipi ağırlığını ayarlayın. |
setFormula(formula) | RangeList | Aralık listesindeki her bir Range için formülü günceller. |
setFormulaR1C1(formula) | RangeList | Aralık listesindeki her bir Range için formülü günceller. |
setHorizontalAlignment(alignment) | RangeList | Aralık listesindeki her Range için yatay hizalamayı ayarlayın. |
setNote(note) | RangeList | Aralık listesindeki her bir Range için not metnini ayarlar. |
setNumberFormat(numberFormat) | RangeList | Aralık listesindeki her bir Range için sayıyı veya tarih biçimini ayarlar. |
setShowHyperlink(showHyperlink) | RangeList | Aralık listesindeki her Range değerinin köprüleri gösterip göstermeyeceğini ayarlar. |
setTextDirection(direction) | RangeList | Aralık listesinde her bir Range öğesinde bulunan hücrelerin metin yönünü ayarlar. |
setTextRotation(degrees) | RangeList | Aralık listesinde her bir Range öğesinde bulunan hücreler için metin döndürme ayarlarını belirler. |
setValue(value) | RangeList | Aralık listesindeki her bir Range için değeri ayarlar. |
setVerticalAlignment(alignment) | RangeList | Aralık listesindeki her Range için dikey hizalamayı ayarlayın. |
setVerticalText(isVertical) | RangeList | Aralık listesindeki her bir Range için hücrelerde metnin gruplanıp yığılmayacağını ayarlar. |
setWrap(isWrapEnabled) | RangeList | Aralık listesindeki her Range için metin kaydırmayı ayarlayın. |
setWrapStrategy(strategy) | RangeList | Aralık listesindeki her bir Range için metin kaydırma stratejisini ayarlar. |
trimWhitespace() | RangeList | Bu aralık listesindeki her hücrede bulunan boşlukları (boşluklar, sekmeler veya yeni satırlar gibi) kırpar. |
uncheck() | RangeList | Aralıktaki onay kutularının durumunu "işaretsiz" olarak değiştirir. |
Ayrıntılı belgeler
activate()
Range
örneklerinin listesini seçer. Listedeki son aralık active range
olarak ayarlanmıştır.
Not: Bu şekilde, birden çok aralık seçebilirsiniz.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.activate(); var selection = sheet.getSelection(); // Current cell: B2 var currentCell = selection.getCurrentCell(); // Active range: B2:C4 var activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] var activeRangeList = selection.getActiveRangeList();
Return
RangeList
: Zincirleme için etkin aralıkların listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
breakApart()
Aralık listesinde yer alan yatay veya dikey olarak birleştirilmiş tüm hücreleri, tekrar tek tek hücrelere bölün.
Bu işlevin bir aralık listesinde çağrılması, bir aralık grubunu seçmeye ve Biçim > Birleştir > Birleştirilenleri Ayır menü öğesini seçmeye eşdeğerdir.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.breakApart();
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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, yapılandırılmış veya işaretli olmayan değer içermeyen hücreleri yok sayar.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the ranges D4 and E6 to 'checked'. var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.check();
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
Aralık listesindeki her bir Range
için içerik, biçim ve veri doğrulama kuralları aralığını temizler.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clear();
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Belirtilen seçeneklerde belirtildiği gibi içerik, biçim, veri doğrulama kuralları ve yorum aralığını temizler. Varsayılan olarak tüm veriler temizlenir.
// The code below clears the contents of the following ranges A:A and C:C in the active sheet, // but preserves the format, data validation rules, and comments. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clear({contentsOnly: true});
Parametreler
Ad | Tür | Açıklama |
---|---|---|
options | Object | Aşağıda listelendiği gibi, 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ği; biçimin temizlenmesinin veri doğrulama kurallarını da temizlediğini unutmayın. |
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
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContent()
Aralık listesindeki her bir Range
öğesinin içeriğini temizleyerek biçimlendirmeyi korur.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearContent();
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearDataValidations()
Aralık listesindeki her bir Range
için veri doğrulama kurallarını temizler.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearDataValidations();
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormat()
Aralık listesindeki her Range
için metin biçimlendirmesini temizler.
Bu işlem her aralığın metin biçimlendirmesini temizler, ancak sayı biçimlendirme kurallarını sıfırlamaz.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearFormat();
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNote()
Aralık listesindeki her bir Range
için notu temizler.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearNote();
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRanges()
Aynı sayfadaki bir veya daha fazla Range
örneğinin listesini döndürür.
Return
Range[]
: Aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes()
Aralıktaki her bir hücreye onay kutuları ekler. İşaretli olanlar için true
, işaretli olanlar içinse false
ile yapılandırılır. Aralıktaki tüm hücrelerin değerini false
olarak ayarlar.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); // Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'true' for checked // and 'false' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to // 'false'. rangeList.insertCheckboxes();
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes(checkedValue)
Aralıktaki her bir hücreye, işaretli için özel bir değerle, işaretlenmemiş için ise boş bir dizeyle yapılandırılmış onay kutuları ekler. Aralıktaki her hücrenin değerini boş dizeye ayarlar.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); // Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked // and the empty string for unchecked. Also, sets the value of each cell in the ranges D4 and // E6 to the empty string. rangeList.insertCheckboxes('yes');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
checkedValue | Object | Onay kutusu veri doğrulaması için işaretli değer. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes(checkedValue, uncheckedValue)
Aralıktaki her bir hücreye, işaretli ve işaretlenmemiş durumlar için özel değerlerle yapılandırılmış onay kutuları ekler. Aralıktaki her hücrenin değerini özel olarak işaretlenmemiş değere ayarlar.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); // Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked // and 'no' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to 'no'. rangeList.insertCheckboxes('yes', 'no');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
checkedValue | Object | Onay kutusu veri doğrulaması için işaretli değer. |
uncheckedValue | Object | Onay kutusu veri doğrulaması için işaretlenmemiş değer. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeCheckboxes()
Aralıktaki tüm onay kutularını kaldırır. Her hücrenin veri doğrulamasını temizler ve ayrıca hücre işaretli veya işaretlenmemiş değeri içeriyorsa hücrenin değerini de temizler.
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 rangeList1 = SpreadsheetApp.getActive().getRangeList(['A1', 'A3']); rangeList1.setValue('yes'); // Removes the checkbox data validation in cells A1 and A3 and clears their value. rangeList1.removeCheckboxes(); var rangeList2 = SpreadsheetApp.getActive().getRangeList(['A5', 'A7']); rangeList2.setValue('random'); // Removes the checkbox data validation in cells A5 and A7 but does not clear their value. rangeList2.removeCheckboxes();
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackground(color)
Aralık listesindeki her bir Range
için arka plan rengini ayarlar. Renk, CSS gösteriminde temsil edilir (örneğin, '#ffffff'
veya 'white'
).
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setBackground('red');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
color | String | CSS gösteriminde arka plan renk kodu (ör. '#ffffff' veya 'white' ); null değeri, rengi sıfırlar. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundRGB(red, green, blue)
Arka planı verilen RGB renge ayarlar. Bu, setBackground(color)
aramasıyla ilgili bir kolaylık paketidir.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); // Sets the background to red for each range in the range list. rangeList.setBackgroundRGB(255, 0, 0);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
red | Integer | RGB gösterimindeki kırmızı değerdir. |
green | Integer | RGB gösterimindeki yeşil değerdir. |
blue | Integer | RGB gösterimindeki mavi değerdir. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal)
Aralık listesindeki her bir Range
için kenarlık özelliğini ayarlar. Geçerli değerler true
(açık), false
(kapalı) ve null
(değişiklik yok) şeklindedir.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']); // Sets borders on the top and bottom of the ranges A2:B4 and C1:D4, but leaves the left and // right unchanged. rangeList.setBorder(true, null, true, null, false, false);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
top | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
left | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
bottom | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
right | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
vertical | Boolean | İç dikey kenarlıklar için true , hiçbiri için false , değişiklik yok için null . |
horizontal | Boolean | İç yatay kenarlıklar için true , hiçbiri için false , değişiklik yok için null . |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal, color, style)
Aralık listesindeki her bir Range
için kenarlık özelliğini renk ve/veya stille ayarlar.
Geçerli değerler true
(açık), false
(kapalı) ve null
(değişiklik yok) değerleridir. Renk, CSS gösteriminde temsil edilir (örneğin, '#ffffff'
veya 'white'
).
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']); // Sets borders on the top and bottom, but leaves the left and right unchanged of the ranges // A2:B4 and C1:D4. Also sets the color to 'red', and the border to 'DASHED'. rangeList.setBorder( true, null, true, null, false, false, 'red', SpreadsheetApp.BorderStyle.DASHED);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
top | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
left | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
bottom | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
right | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
vertical | Boolean | İç dikey kenarlıklar için true , hiçbiri için false , değişiklik yok için null . |
horizontal | Boolean | İç yatay kenarlıklar için true , hiçbiri için false , değişiklik yok için null . |
color | String | CSS gösterimindeki kenarlık rengi ('#ffffff' veya 'white' gibi), varsayılan renk (siyah) için null . |
style | BorderStyle | Kenarlıkların stili, varsayılan stil (düz) için null . |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColor(color)
Aralık listesindeki her bir Range
için yazı tipi rengini ayarlar. Renk, CSS gösterimiyle temsil edilir (örneğin, '#ffffff'
veya 'white'
).
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontColor('red');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
color | String | CSS gösterimindeki yazı tipi rengi (ör. '#ffffff' veya 'white' ). null değeri, rengi sıfırlar. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontFamily(fontFamily)
Aralık listesindeki her bir Range
için yazı tipi ailesini ayarlar. Yazı tipi ailesi, Arial
veya Roboto
gibi bir dize tanımlayıcısıyla tanımlanır.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontFamily('Roboto');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
fontFamily | String | Ayarlanacak yazı tipi ailesi; null değeri, yazı tipi ailesini sıfırlar. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontLine(fontLine)
Aralık listesindeki her bir Range
için yazı tipi çizgi stilini ayarlar. Çizgi stili seçenekleri 'underline'
, 'line-through'
veya 'none'
şeklindedir.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontLine('line-through');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
fontLine | String | Yazı tipi çizgi stili ('underline' , 'line-through' veya 'none' ). null değeri, yazı tipi satır stilini sıfırlar. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontSize(size)
Aralık listesindeki her bir Range
için yazı tipi boyutunu (punto cinsinden) ayarlar.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontSize(20);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
size | Integer | Yazı tipi noktası boyutu. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontStyle(fontStyle)
Aralık listesindeki her Range
için yazı tipi stilini ayarlayın. Yazı tipi stili seçenekleri şunlardır:
'italic'
veya 'normal'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontStyle("italic");
Parametreler
Ad | Tür | Açıklama |
---|---|---|
fontStyle | String | Yazı tipi stili ('italic' veya 'normal' ). null değeri, yazı tipi stilini sıfırlar. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontWeight(fontWeight)
Aralık listesindeki her Range
için yazı tipi ağırlığını ayarlayın. Yazı tipi kalınlığı seçenekleri 'normal'
veya 'bold'
şeklindedir.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontWeight('bold');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
fontWeight | String | Yazı tipi ağırlığı ('bold' veya 'normal' ). null değeri, yazı tipi ağırlığını sıfırlar. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormula(formula)
Aralık listesindeki her bir Range
için formülü günceller. Verilen formül A1 gösteriminde
olmalıdır.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A11', 'C11']); rangeList.setFormula('=SUM(B1:B10)');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
formula | String | Ayarlanacak formülü temsil eden bir dize. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulaR1C1(formula)
Aralık listesindeki her bir Range
için formülü günceller. Verilen formül R1C1 gösteriminde olmalıdır.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A11', 'C11']); // This sets the formula to be the sum of the 3 rows above B5 rangeList.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
formula | String | Dize formülü. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHorizontalAlignment(alignment)
Aralık listesindeki her Range
için yatay hizalamayı ayarlayın. Hizalama seçenekleri 'left'
, 'center'
veya 'right'
'dir.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setHorizontalAlignment("center");
Parametreler
Ad | Tür | Açıklama |
---|---|---|
alignment | String | Hizalama ('left' , 'center' veya 'normal' ); null değeri hizalamayı sıfırlar. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNote(note)
Aralık listesindeki her bir Range
için not metnini ayarlar.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setNote('This is a note');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
note | String | Ayarlanacak not metni. null değeri, notu kaldırır. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNumberFormat(numberFormat)
Aralık listesindeki her bir Range
için sayıyı veya tarih biçimini ayarlar.
Kabul edilen biçimlendirme kalıpları E-Tablolar API tarih ve sayı biçimlendirme kılavuzunda açıklanmıştır.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); // Always show 3 decimal points for the specified ranges. rangeList.setNumberFormat('0.000');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
numberFormat | String | Sayı biçimi dizesi. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setShowHyperlink(showHyperlink)
Aralık listesindeki her Range
değerinin köprüleri gösterip göstermeyeceğini ayarlar.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); // Show hyperlinks for all the ranges. rangeList.setShowHyperlink(true);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
showHyperlink | Boolean | Köprünün gösterilip gösterilmeyeceği. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextDirection(direction)
Aralık listesinde her bir Range
öğesinde bulunan hücrelerin metin yönünü ayarlar. Belirtilen bir yön null
ise yön belirlenir ve ardından ayarlanır.
// Sets right-to-left text direction each range in the range list. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
direction | TextDirection | İstenen metin yönü; null ise yön, ayarlamadan önce tahmin edilir. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotation(degrees)
Aralık listesinde her bir Range
öğesinde bulunan hücreler için metin döndürme ayarlarını belirler. Giriş, standart metin yönü ile istenen yön arasındaki açıya karşılık gelir. Sıfır girişi, metnin standart yöne ayarlandığını gösterir.
Soldan sağa metin yönünde, pozitif açılar saat yönünün tersine, sağdan sola için ise saat yönündedir.
// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45 degrees. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); rangeList.setTextRotation(45);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
degrees | Integer | Standart yön ile istenen yön arasında istenen açı. Soldan sağa metinde pozitif açılar saat yönünün tersinedir. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setValue(value)
Aralık listesindeki her bir Range
için değeri ayarlar. Değer; sayısal, dize, boole veya tarih olabilir. '=" ile başlıyorsa, formül olarak yorumlanır.
var sheet = SpreadsheetApp.getActiveSheet(); // Set value of 100 to each range in the range list. var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setValue(100);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
value | Object | Aralığın değeri. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalAlignment(alignment)
Aralık listesindeki her Range
için dikey hizalamayı ayarlayın. Hizalama seçenekleri
'top'
, 'middle'
veya 'bottom'
şeklindedir.
// Sets the vertical alignment to middle for the list of ranges. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setVerticalAlignment("middle");
Parametreler
Ad | Tür | Açıklama |
---|---|---|
alignment | String | Hizalama ('top' , 'middle' veya 'bottom' ); null değeri hizalamayı sıfırlar. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalText(isVertical)
Aralık listesindeki her bir Range
için hücrelerde metnin gruplanıp yığılmayacağını ayarlar. Metin dikey olarak yığılmışsa metin derece döndürme ayarı yok sayılır.
// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setVerticalText(true);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
isVertical | Boolean | Metnin yığınlı olup olmayacağı. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrap(isWrapEnabled)
Aralık listesindeki her Range
için metin kaydırmayı ayarlayın. Kaydırma özelliğinin etkin olduğu hücreler, içeriğin tamamını
görecek şekilde yeniden boyutlandırır. Kaydırma devre dışı olan hücreler, yeniden boyutlandırılmadan veya birden fazla satıra eklenmeden hücre içinde mümkün olduğunca çok gösterilir.
// Enable text wrap for the list of ranges. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setWrap(true);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
isWrapEnabled | Boolean | Metnin kaydırılıp kaydırılmayacağı. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrapStrategy(strategy)
Aralık listesindeki her bir Range
için metin kaydırma stratejisini ayarlar.
// Sets the list of ranges to use the clip wrap strategy. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
strategy | WrapStrategy | İstenen sarmalama stratejisi. |
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
trimWhitespace()
Bu aralık listesindeki her hücrede bulunan boşlukları (boşluklar, sekmeler veya yeni satırlar gibi) kırpar. Her hücrenin metninin başındaki ve sonundaki tüm boşlukları kaldırır ve kalan boşluk karakterlerinin sonraki sırasını tek bir boşluğa azaltır.
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)']); var rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']); rangeList.trimWhitespace(); var values = range.getValues(); // Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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:
uncheck()
Aralıktaki onay kutularının durumunu "işaretli değil" olarak değiştirir. Aralıktaki, yapılandırılmış veya işaretli olmayan değer içermeyen hücreleri yok sayar.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the ranges D4 and E6 to 'unchecked'. var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.uncheck();
Return
RangeList
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets