Aynı sayfada bir veya daha fazla Range
örneğinin bulunduğu koleksiyon. Bu sınıfı, bitişik olmayan aralık veya hücre koleksiyonlarına işlem uygulamak için kullanabilirsiniz.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
activate() | Range | Range örnekleri listesini seçer. |
break | Range | Aralık listesinde bulunan tüm yatay veya dikey olarak birleştirilmiş hücreleri tekrar tek hücrelere ayırın. |
check() | Range | Aralıktaki onay kutularının durumunu "işaretli" olarak değiştirir. |
clear() | Range | Aralık listesindeki her Range için içerik aralığını, biçimleri ve veri doğrulama kurallarını temizler. |
clear(options) | Range | Belirtilen seçeneklerle belirtildiği şekilde içerik aralığını, biçimi, veri doğrulama kurallarını ve yorumları temizler. |
clear | Range | Aralık listesindeki her Range öğesinin içeriğini temizler ancak biçimlendirmeyi korur. |
clear | Range | Aralık listesindeki her Range için veri doğrulama kurallarını temizler. |
clear | Range | Aralık listesindeki her Range için metin biçimlendirmesini temizler. |
clear | Range | Aralık listesindeki her Range için notu temizler. |
get | Range[] | Aynı sayfada bir veya daha fazla Range örneğinin listesini döndürür. |
insert | Range | İşaretli için true ve işaretsiz için false ile yapılandırılmış onay kutularını aralıktaki her hücreye ekler. |
insert | Range | İşaretli için özel bir değerle ve işaretli olmayan için boş dizeyle yapılandırılmış onay kutularını aralıktaki her hücreye ekler. |
insert | Range | Aralıktaki her hücreye, işaretli ve işaretli olmayan durumlar için özel değerlerle yapılandırılmış onay kutuları ekler. |
remove | Range | Aralıktaki tüm onay kutularını kaldırır. |
set | Range | Aralık listesindeki her Range için arka plan rengini ayarlar. |
set | Range | Arka planı belirtilen RGB rengine ayarlar. |
set | Range | Aralık listesindeki her Range için kenar özelliğini ayarlar. |
set | Range | Aralık listesindeki her Range için kenarlık özelliğini renk ve/veya stil ile ayarlar. |
set | Range | Aralık listesindeki her Range için yazı tipi rengini ayarlar. |
set | Range | Aralık listesindeki her Range için yazı tipi ailesini ayarlar. |
set | Range | Aralık listesindeki her Range için yazı tipi satır stilini ayarlar. |
set | Range | Aralık listesindeki her Range için yazı tipi boyutunu (punto cinsinden) ayarlar. |
set | Range | Aralık listesindeki her Range için yazı tipi stilini ayarlayın. |
set | Range | Aralık listesindeki her Range için yazı tipi ağırlığını ayarlayın. |
set | Range | Aralık listesindeki her Range için formülü günceller. |
set | Range | Aralık listesindeki her Range için formülü günceller. |
set | Range | Aralık listesindeki her Range için yatay hizalamayı ayarlayın. |
set | Range | Aralık listesindeki her Range için not metnini ayarlar. |
set | Range | Aralık listesindeki her Range için sayı veya tarih biçimini ayarlar. |
set | Range | Aralık listesindeki her Range için köprülerin gösterilip gösterilmeyeceğini belirler. |
set | Range | Aralık listesindeki her Range içindeki hücrelerin metin yönünü ayarlar. |
set | Range | Aralık listesindeki her Range içindeki hücreler için metin döndürme ayarlarını belirler. |
set | Range | Aralık listesindeki her Range için değeri ayarlar. |
set | Range | Aralık listesindeki her Range için dikey hizalamayı ayarlayın. |
set | Range | Aralık listesindeki her Range için hücre metinlerinin yığın halinde gösterilip gösterilmeyeceğini belirler. |
set | Range | Aralık listesindeki her Range için metin kaydırma özelliğini ayarlayın. |
set | Range | Aralık listesindeki her Range için metin kaydırma stratejisini ayarlar. |
trim | Range | Bu aralık listesindeki her hücredeki boşlukları (boşluklar, sekmeler veya yeni satırlar gibi) kısaltır. |
uncheck() | Range | Aralıktaki onay kutularının durumunu "onaysız" olarak değiştirir. |
Ayrıntılı dokümanlar
activate()
Range
örnekleri listesini seçer. Listedeki son aralık active range
olarak ayarlanır.
Not: Bu yöntem, bir dizi aralığı birden çok şekilde seçmenize olanak tanır.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.activate(); const selection = sheet.getSelection(); // Current cell: B2 const currentCell = selection.getCurrentCell(); // Active range: B2:C4 const activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] const activeRangeList = selection.getActiveRangeList();
Return
Range
: Zincirleme için etkin aralıkların listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
break Apart()
Aralık listesinde bulunan tüm yatay veya dikey olarak birleştirilmiş hücreleri tekrar tek hücrelere ayırın.
Bu işlevin bir aralık listesinde çağrılması, bir aralık grubu seçip E-Tablolar menüsünde Biçimlendir > Birleştir > Birleştirmeyi Geri Al'ı seçmekle aynıdır.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.breakApart();
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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, şu anda yapılandırılmış işaretli veya işaretli olmayan değeri içermeyen hücreler yoksayılır.
// Changes the state of cells which currently contain either the checked or // unchecked value configured in the ranges D4 and E6 to 'checked'. const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.check();
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
Aralık listesindeki her Range
için içerik aralığını, biçimleri ve veri doğrulama kurallarını temizler.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clear();
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Belirtilen seçeneklerle belirtildiği şekilde içerik aralığını, biçimi, veri doğrulama kurallarını ve yorumları 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. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.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 |
---|---|---|
comments | Boolean | Yalnızca yorumların temizlenip temizlenmeyeceğini belirtir. |
contents | Boolean | Yalnızca içeriğin temizlenip temizlenmeyeceği. |
format | Boolean | Yalnızca biçimin temizlenip temizlenmeyeceği. Biçimin temizlenmesinin veri doğrulama kurallarının da temizlendiğini unutmayın. |
validations | Boolean | Yalnızca veri doğrulama kurallarının temizlenip temizlenmeyeceği. |
skip | Boolean | Filtrelenmiş satırların temizlenip temizlenmeyeceği. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear Content()
Aralık listesindeki her Range
öğesinin içeriğini temizler ancak biçimlendirmeyi korur.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearContent();
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear Data Validations()
Aralık listesindeki her Range
için veri doğrulama kurallarını temizler.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearDataValidations();
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear Format()
Aralık listesindeki her Range
için metin biçimlendirmesini temizler.
Bu işlem, her aralık için metin biçimlendirmesini temizler ancak sayı biçimlendirme kurallarını sıfırlamaz.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearFormat();
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear Note()
Aralık listesindeki her Range
için notu temizler.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearNote();
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Ranges()
Aynı sayfada bir veya daha fazla Range
örneğinin listesini döndürür.
Return
Range[]
: Aralıkların listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Checkboxes()
İşaretli için true
ve işaretsiz için false
ile yapılandırılmış onay kutularını aralıktaki her hücreye ekler. Aralıktaki tüm hücrelerin değerini false
olarak ayarlar.
const 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
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Checkboxes(checkedValue)
İşaretli için özel bir değerle ve işaretli olmayan için boş dizeyle yapılandırılmış onay kutularını aralıktaki her hücreye ekler. Aralıktaki her hücrenin değerini boş dize olarak ayarlar.
const 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 |
---|---|---|
checked | Object | Onay kutusu veri doğrulaması için işaretli değer. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Checkboxes(checkedValue, uncheckedValue)
Aralıktaki her hücreye, işaretli ve işaretli olmayan durumlar için özel değerlerle yapılandırılmış onay kutuları ekler. Aralıktaki her hücrenin değerini, işaretlenmemiş özel değere ayarlar.
const 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 |
---|---|---|
checked | Object | Onay kutusu veri doğrulaması için işaretli değer. |
unchecked | Object | Onay kutusu veri doğrulaması için işaretli olmayan değer. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove Checkboxes()
Aralıktaki tüm onay kutularını kaldırır. Her hücrenin veri doğrulamasını temizler ve hücre işaretli veya işaretsiz bir değer içeriyorsa değerini de temizler.
const range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:B10. range.insertCheckboxes('yes', 'no'); const 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(); const 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
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Background(color)
Aralık listesindeki her Range
için arka plan rengini ayarlar. Renk, CSS notasyonunda gösterilir (ör. '#ffffff'
veya 'white'
).
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setBackground('red');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
color | String | CSS notasyonundaki arka plan rengi kodu (ör. '#ffffff' veya 'white' ); null değeri rengi sıfırlar. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Background RGB(red, green, blue)
Arka planı belirtilen RGB rengine ayarlar. Bu, set
çağrısı için kolaylık sağlayan bir sarmalayıcıdır.
const sheet = SpreadsheetApp.getActiveSheet(); const 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ğer. |
green | Integer | RGB gösterimindeki yeşil değer. |
blue | Integer | RGB gösterimindeki mavi değer. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Border(top, left, bottom, right, vertical, horizontal)
Aralık listesindeki her Range
için kenar özelliğini ayarlar. Geçerli değerler true
(açık), false
(kapalı) ve null
(değişiklik yok) şeklindedir.
const sheet = SpreadsheetApp.getActiveSheet(); const 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 | Dahili dikey kenarlıklar için true , hiç kenarlık yok için false , değişiklik yok için null . |
horizontal | Boolean | Dahili yatay kenarlıklar için true , hiçbiri için false , değişiklik yok için null . |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Border(top, left, bottom, right, vertical, horizontal, color, style)
Aralık listesindeki her Range
için kenarlık özelliğini renk ve/veya stil ile ayarlar.
Geçerli değerler true
(açık), false
(kapalı) ve null
(değişiklik yok) şeklindedir. Renk, CSS notasyonuyla temsil edilir (ör. '#ffffff'
veya 'white'
).
const sheet = SpreadsheetApp.getActiveSheet(); const 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 | Dahili dikey kenarlıklar için true , hiç kenarlık yok için false , değişiklik yok için null . |
horizontal | Boolean | Dahili yatay kenarlıklar için true , hiçbiri için false , değişiklik yok için null . |
color | String | CSS notasyonunda '#ffffff' veya 'white' gibi bir kenarlık rengi, varsayılan renk için null (siyah). |
style | Border | Kenarlıkların stili. Varsayılan stil için null (düz). |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Color(color)
Aralık listesindeki her Range
için yazı tipi rengini ayarlar. Renk, CSS notasyonuyla gösterilir (ör. '#ffffff'
veya 'white'
).
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontColor('red');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
color | String | CSS notasyonundaki yazı tipi rengi (ör. '#ffffff' veya 'white' ); null değeri rengi sıfırlar. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Family(fontFamily)
Aralık listesindeki her Range
için yazı tipi ailesini ayarlar. Yazı tipi ailesi, Arial
veya Roboto
gibi bir dize tanımlayıcıyla açıklanır.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontFamily('Roboto');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
font | String | Ayarlanacak yazı tipi ailesi. null değeri yazı tipi ailesini sıfırlar. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Line(fontLine)
Aralık listesindeki her Range
için yazı tipi satır stilini ayarlar. Çizgi stili seçenekleri 'underline'
, 'line-through'
veya 'none'
'dir.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontLine('line-through');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
font | String | Yazı tipi satır stili ('underline' , 'line-through' veya 'none' ). null değeri yazı tipi satır stilini sıfırlar. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Size(size)
Aralık listesindeki her Range
için yazı tipi boyutunu (punto cinsinden) ayarlar.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontSize(20);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
size | Integer | Yazı tipi punto boyutu. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Style(fontStyle)
Aralık listesindeki her Range
için yazı tipi stilini ayarlayın. Yazı tipi stili seçenekleri 'italic'
veya 'normal'
'dur.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontStyle('italic');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
font | String | Yazı tipi stili ('italic' veya 'normal' ); null değeri yazı tipi stilini sıfırlar. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Weight(fontWeight)
Aralık listesindeki her Range
için yazı tipi ağırlığını ayarlayın. Yazı tipi kalınlığı seçenekleri 'normal'
veya 'bold'
'dur.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontWeight('bold');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
font | String | Yazı tipi kalınlığı ('bold' veya 'normal' ); null değeri yazı tipi kalınlığını sıfırlar. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Formula(formula)
Aralık listesindeki her Range
için formülü günceller. Belirtilen formül A1 gösterimde olmalıdır.
const sheet = SpreadsheetApp.getActiveSheet(); const 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
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Formula R1C1(formula)
Aralık listesindeki her Range
için formülü günceller. Belirtilen formül R1C1 gösterimde olmalıdır.
const sheet = SpreadsheetApp.getActiveSheet(); const 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 | Bir dize formülü. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Horizontal Alignment(alignment)
Aralık listesindeki her Range
için yatay hizalamayı ayarlayın. Hizalama seçenekleri 'left'
, 'center'
veya 'right'
'dir.
const sheet = SpreadsheetApp.getActiveSheet(); const 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
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Note(note)
Aralık listesindeki her Range
için not metnini ayarlar.
const sheet = SpreadsheetApp.getActiveSheet(); const 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
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Number Format(numberFormat)
Aralık listesindeki her Range
için sayı veya tarih biçimini ayarlar.
Kabul edilen biçimlendirme kalıpları Sheets API tarih ve sayı biçimlendirme kılavuzunda açıklanmaktadır.
const sheet = SpreadsheetApp.getActiveSheet(); const 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 |
---|---|---|
number | String | Sayı biçimi dizesi. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Show Hyperlink(showHyperlink)
Aralık listesindeki her Range
için köprülerin gösterilip gösterilmeyeceğini belirler.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); // Show hyperlinks for all the ranges. rangeList.setShowHyperlink(true);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
show | Boolean | Köprünün gösterilip gösterilmeyeceği. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Text Direction(direction)
Aralık listesindeki her Range
içindeki hücrelerin metin yönünü ayarlar. Belirtilen yön null
ise yön tahmin edilir ve ayarlanır.
// Sets right-to-left text direction each range in the range list. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
direction | Text | İstenen metin yönü; null ise yön ayarlanmadan önce anlaşılır. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Text Rotation(degrees)
Aralık listesindeki her Range
içindeki 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önde ayarlandığını gösterir.
Soldan sağa metin yönü için pozitif açılar saat yönünün tersine, sağdan sola metin yönü 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. const sheet = SpreadsheetApp.getActiveSheet(); const 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ındaki açı. Soldan sağa metinlerde pozitif açılar saat yönünün tersine doğrudur. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Value(value)
Aralık listesindeki her Range
için değeri ayarlar. Değer sayı, dize, boole veya tarih olabilir. "=" ile başlarsa formül olarak yorumlanır.
const sheet = SpreadsheetApp.getActiveSheet(); // Set value of 100 to each range in the range list. const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setValue(100);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
value | Object | Aralığın değeri. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Vertical Alignment(alignment)
Aralık listesindeki her Range
için dikey hizalamayı ayarlayın. Hizalama seçenekleri 'top'
, 'middle'
veya 'bottom'
'dir.
// Sets the vertical alignment to middle for the list of ranges. const sheet = SpreadsheetApp.getActiveSheet(); const 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
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Vertical Text(isVertical)
Aralık listesindeki her Range
için hücre metinlerinin yığın halinde gösterilip gösterilmeyeceğini belirler. Metin dikey olarak yığılmışsa metin döndürme derecesi ayarı yoksayılır.
// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setVerticalText(true);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
is | Boolean | Metnin yığılıp yığılmayacağı. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Wrap(isWrapEnabled)
Aralık listesindeki her Range
için metin kaydırma özelliğini ayarlayın. Kaydırma özelliği etkinleştirilen hücreler, içeriğin tamamını gösterecek şekilde yeniden boyutlandırılır. Satır sonuna sarma özelliği devre dışı bırakılmış hücreler, yeniden boyutlandırılmadan veya birden fazla satıra yayılmadan hücrede mümkün olduğunca fazla yer kaplar.
// Enable text wrap for the list of ranges. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setWrap(true);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
is | Boolean | Metnin kaydırılıp kaydırılmayacağı. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Wrap Strategy(strategy)
Aralık listesindeki her Range
için metin kaydırma stratejisini ayarlar.
// Sets the list of ranges to use the clip wrap strategy. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
strategy | Wrap | İstenen sarma stratejisi. |
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
trim Whitespace()
Bu aralık listesindeki her hücredeki boşlukları (boşluklar, sekmeler veya yeni satırlar gibi) kısaltır. Her hücrenin metninin başındaki ve sonundaki tüm boşlukları kaldırır ve kalan boşluk karakterlerinin alt dizelerini tek bir boşluk karakterine indirger.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const range = sheet.getRange('A1:A4'); range.activate(); range.setValues([ ' preceding space', 'following space ', 'two middle spaces', ' =SUM(1,2)', ]); const rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']); rangeList.trimWhitespace(); const values = range.getValues(); // Values are ['preceding space', 'following space', 'two middle spaces', // '=SUM(1,2)']
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
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, şu anda yapılandırılmış işaretli veya işaretli olmayan değeri içermeyen hücreler yoksayılır.
// Changes the state of cells which currently contain either the checked or // unchecked value configured in the ranges D4 and E6 to 'unchecked'. const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.uncheck();
Return
Range
: Zincirleme için bu aralık listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets