Class RangeList

RangeList

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öntemDönüş türüKısa açıklama
activate()RangeListRange örneklerinin listesini seçer.
breakApart()RangeListAralık listesinde yer alan yatay veya dikey olarak birleştirilmiş tüm hücreleri, tekrar tek tek hücrelere bölün.
check()RangeListAralıktaki onay kutularının durumunu "işaretli" olarak değiştirir.
clear()RangeListAralık listesindeki her bir Range için içerik, biçim ve veri doğrulama kuralları aralığını temizler.
clear(options)RangeListBelirtilen seçeneklerde belirtildiği gibi içerik, biçim, veri doğrulama kuralları ve yorum aralığını temizler.
clearContent()RangeListAralık listesindeki her bir Range öğesinin içeriğini temizleyerek biçimlendirmeyi korur.
clearDataValidations()RangeListAralık listesindeki her bir Range için veri doğrulama kurallarını temizler.
clearFormat()RangeListAralık listesindeki her Range için metin biçimlendirmesini temizler.
clearNote()RangeListAralı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()RangeListAralı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)RangeListAralı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)RangeListAralıktaki her bir hücreye, işaretli ve işaretlenmemiş durumlar için özel değerlerle yapılandırılmış onay kutuları ekler.
removeCheckboxes()RangeListAralıktaki tüm onay kutularını kaldırır.
setBackground(color)RangeListAralık listesindeki her bir Range için arka plan rengini ayarlar.
setBackgroundRGB(red, green, blue)RangeListArka planı verilen RGB renge ayarlar.
setBorder(top, left, bottom, right, vertical, horizontal)RangeListAralık listesindeki her bir Range için kenarlık özelliğini ayarlar.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)RangeListAralık listesindeki her bir Range için kenarlık özelliğini renk ve/veya stille ayarlar.
setFontColor(color)RangeListAralık listesindeki her bir Range için yazı tipi rengini ayarlar.
setFontFamily(fontFamily)RangeListAralık listesindeki her bir Range için yazı tipi ailesini ayarlar.
setFontLine(fontLine)RangeListAralık listesindeki her bir Range için yazı tipi çizgi stilini ayarlar.
setFontSize(size)RangeListAralık listesindeki her bir Range için yazı tipi boyutunu (punto cinsinden) ayarlar.
setFontStyle(fontStyle)RangeListAralık listesindeki her Range için yazı tipi stilini ayarlayın.
setFontWeight(fontWeight)RangeListAralık listesindeki her Range için yazı tipi ağırlığını ayarlayın.
setFormula(formula)RangeListAralık listesindeki her bir Range için formülü günceller.
setFormulaR1C1(formula)RangeListAralık listesindeki her bir Range için formülü günceller.
setHorizontalAlignment(alignment)RangeListAralık listesindeki her Range için yatay hizalamayı ayarlayın.
setNote(note)RangeListAralık listesindeki her bir Range için not metnini ayarlar.
setNumberFormat(numberFormat)RangeListAralık listesindeki her bir Range için sayıyı veya tarih biçimini ayarlar.
setShowHyperlink(showHyperlink)RangeListAralık listesindeki her Range değerinin köprüleri gösterip göstermeyeceğini ayarlar.
setTextDirection(direction)RangeListAralık listesinde her bir Range öğesinde bulunan hücrelerin metin yönünü ayarlar.
setTextRotation(degrees)RangeListAralık listesinde her bir Range öğesinde bulunan hücreler için metin döndürme ayarlarını belirler.
setValue(value)RangeListAralık listesindeki her bir Range için değeri ayarlar.
setVerticalAlignment(alignment)RangeListAralık listesindeki her Range için dikey hizalamayı ayarlayın.
setVerticalText(isVertical)RangeListAralık listesindeki her bir Range için hücrelerde metnin gruplanıp yığılmayacağını ayarlar.
setWrap(isWrapEnabled)RangeListAralık listesindeki her Range için metin kaydırmayı ayarlayın.
setWrapStrategy(strategy)RangeListAralık listesindeki her bir Range için metin kaydırma stratejisini ayarlar.
trimWhitespace()RangeListBu aralık listesindeki her hücrede bulunan boşlukları (boşluklar, sekmeler veya yeni satırlar gibi) kırpar.
uncheck()RangeListAralı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

AdTürAçıklama
optionsObjectAşağıda listelendiği gibi, gelişmiş parametreleri belirten bir JavaScript nesnesi.

Gelişmiş parametreler

AdTürAçıklama
commentsOnlyBooleanYalnızca yorumların temizlenip temizlenmeyeceğini belirler.
contentsOnlyBooleanYalnızca içeriğin temizlenip temizlenmeyeceğini belirler.
formatOnlyBooleanYalnızca biçimin temizlenip temizlenmeyeceği; biçimin temizlenmesinin veri doğrulama kurallarını da temizlediğini unutmayın.
validationsOnlyBooleanYalnızca veri doğrulama kurallarının temizlenip temizlenmeyeceğini belirler.
skipFilteredRowsBooleanFiltrelenmiş 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

AdTürAçıklama
checkedValueObjectOnay 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

AdTürAçıklama
checkedValueObjectOnay kutusu veri doğrulaması için işaretli değer.
uncheckedValueObjectOnay 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

AdTürAçıklama
colorStringCSS 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

AdTürAçıklama
redIntegerRGB gösterimindeki kırmızı değerdir.
greenIntegerRGB gösterimindeki yeşil değerdir.
blueIntegerRGB 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

AdTürAçıklama
topBooleanKenarlık için true, yok için false, değişiklik yok için null.
leftBooleanKenarlık için true, yok için false, değişiklik yok için null.
bottomBooleanKenarlık için true, yok için false, değişiklik yok için null.
rightBooleanKenarlık için true, yok için false, değişiklik yok için null.
verticalBooleanİç dikey kenarlıklar için true, hiçbiri için false, değişiklik yok için null.
horizontalBooleanİç 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

AdTürAçıklama
topBooleanKenarlık için true, yok için false, değişiklik yok için null.
leftBooleanKenarlık için true, yok için false, değişiklik yok için null.
bottomBooleanKenarlık için true, yok için false, değişiklik yok için null.
rightBooleanKenarlık için true, yok için false, değişiklik yok için null.
verticalBooleanİç dikey kenarlıklar için true, hiçbiri için false, değişiklik yok için null.
horizontalBooleanİç yatay kenarlıklar için true, hiçbiri için false, değişiklik yok için null.
colorStringCSS gösterimindeki kenarlık rengi ('#ffffff' veya 'white' gibi), varsayılan renk (siyah) için null.
styleBorderStyleKenarlı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

AdTürAçıklama
colorStringCSS 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

AdTürAçıklama
fontFamilyStringAyarlanacak 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

AdTürAçıklama
fontLineStringYazı 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

AdTürAçıklama
sizeIntegerYazı 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

AdTürAçıklama
fontStyleStringYazı 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

AdTürAçıklama
fontWeightStringYazı 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

AdTürAçıklama
formulaStringAyarlanacak 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

AdTürAçıklama
formulaStringDize 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

AdTürAçıklama
alignmentStringHizalama ('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

AdTürAçıklama
noteStringAyarlanacak 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

AdTürAçıklama
numberFormatStringSayı 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

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

AdTürAçıklama
showHyperlinkBooleanKö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

AdTürAçıklama
directionTextDirectionİ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

AdTürAçıklama
degreesIntegerStandart 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

AdTürAçıklama
valueObjectAralığı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

AdTürAçıklama
alignmentStringHizalama ('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

AdTürAçıklama
isVerticalBooleanMetnin 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

AdTürAçıklama
isWrapEnabledBooleanMetnin 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

AdTürAçıklama
strategyWrapStrategyİ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