Class RangeList

AralıkListe

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öntemDönüş türüKısa açıklama
activate()RangeListRange örnekleri listesini seçer.
breakApart()RangeListAralık listesinde bulunan tüm yatay veya dikey olarak birleştirilmiş hücreleri tekrar tek hücrelere ayırın.
check()RangeListAralıktaki onay kutularının durumunu "işaretli" olarak değiştirir.
clear()RangeListAralık listesindeki her Range için içerik aralığını, biçimleri ve veri doğrulama kurallarını temizler.
clear(options)RangeListBelirtilen seçeneklerle belirtildiği şekilde içerik aralığını, biçimi, veri doğrulama kurallarını ve yorumları temizler.
clearContent()RangeListAralık listesindeki her Range öğesinin içeriğini temizler ancak biçimlendirmeyi korur.
clearDataValidations()RangeListAralık listesindeki her 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 Range için notu temizler.
getRanges()Range[]Aynı sayfada bir veya daha fazla Range örneğinin listesini döndürür.
insertCheckboxes()RangeListİşaretli için true ve işaretsiz için false ile yapılandırılmış onay kutularını aralıktaki her hücreye ekler.
insertCheckboxes(checkedValue)RangeListİş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.
insertCheckboxes(checkedValue, uncheckedValue)RangeListAralıktaki her hücreye, işaretli ve işaretli olmayan 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 Range için arka plan rengini ayarlar.
setBackgroundRGB(red, green, blue)RangeListArka planı belirtilen RGB rengine ayarlar.
setBorder(top, left, bottom, right, vertical, horizontal)RangeListAralık listesindeki her Range için kenar özelliğini ayarlar.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)RangeListAralık listesindeki her Range için kenarlık özelliğini renk ve/veya stil ile ayarlar.
setFontColor(color)RangeListAralık listesindeki her Range için yazı tipi rengini ayarlar.
setFontFamily(fontFamily)RangeListAralık listesindeki her Range için yazı tipi ailesini ayarlar.
setFontLine(fontLine)RangeListAralık listesindeki her Range için yazı tipi satır stilini ayarlar.
setFontSize(size)RangeListAralık listesindeki her 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 Range için formülü günceller.
setFormulaR1C1(formula)RangeListAralık listesindeki her 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 Range için not metnini ayarlar.
setNumberFormat(numberFormat)RangeListAralık listesindeki her Range için sayı veya tarih biçimini ayarlar.
setShowHyperlink(showHyperlink)RangeListAralık listesindeki her Range için köprülerin gösterilip gösterilmeyeceğini belirler.
setTextDirection(direction)RangeListAralık listesindeki her Range içindeki hücrelerin metin yönünü ayarlar.
setTextRotation(degrees)RangeListAralık listesindeki her Range içindeki hücreler için metin döndürme ayarlarını belirler.
setValue(value)RangeListAralık listesindeki her 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 Range için hücre metinlerinin yığın halinde gösterilip gösterilmeyeceğini belirler.
setWrap(isWrapEnabled)RangeListAralık listesindeki her Range için metin kaydırma özelliğini ayarlayın.
setWrapStrategy(strategy)RangeListAralık listesindeki her Range için metin kaydırma stratejisini ayarlar.
trimWhitespace()RangeListBu aralık listesindeki her hücredeki boşlukları (boşluklar, sekmeler veya yeni satırlar gibi) kısaltır.
uncheck()RangeListAralı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

RangeList: 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

breakApart()

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

RangeList: 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

RangeList: 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

RangeList: 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

AdTürAçıklama
optionsObjectAşağıda listelenen gelişmiş parametreleri belirten bir JavaScript nesnesi.

Gelişmiş parametreler

AdTürAçıklama
commentsOnlyBooleanYalnızca yorumların temizlenip temizlenmeyeceğini belirtir.
contentsOnlyBooleanYalnızca içeriğin temizlenip temizlenmeyeceği.
formatOnlyBooleanYalnızca biçimin temizlenip temizlenmeyeceği. Biçimin temizlenmesinin veri doğrulama kurallarının da temizlendiğini unutmayın.
validationsOnlyBooleanYalnızca veri doğrulama kurallarının temizlenip temizlenmeyeceği.
skipFilteredRowsBooleanFiltrelenmiş satırların temizlenip temizlenmeyeceği.

Return

RangeList: 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

clearContent()

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

RangeList: 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

clearDataValidations()

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

RangeList: 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

clearFormat()

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

RangeList: 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

clearNote()

Aralık listesindeki her Range için notu temizler.

const sheet = SpreadsheetApp.getActiveSheet();
const 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ı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

getRanges()

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

insertCheckboxes()

İş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

RangeList: 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

insertCheckboxes(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

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ı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

insertCheckboxes(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

AdTürAçıklama
checkedValueObjectOnay kutusu veri doğrulaması için işaretli değer.
uncheckedValueObjectOnay kutusu veri doğrulaması için işaretli olmayan değer.

Return

RangeList: 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

removeCheckboxes()

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

RangeList: 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

setBackground(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

AdTürAçıklama
colorStringCSS notasyonundaki arka plan rengi 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ı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

setBackgroundRGB(red, green, blue)

Arka planı belirtilen RGB rengine ayarlar. Bu, setBackground(color) ç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

AdTürAçıklama
redIntegerRGB gösterimindeki kırmızı değer.
greenIntegerRGB gösterimindeki yeşil değer.
blueIntegerRGB gösterimindeki mavi değer.

Return

RangeList: 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

setBorder(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

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.
verticalBooleanDahili dikey kenarlıklar için true, hiç kenarlık yok için false, değişiklik yok için null.
horizontalBooleanDahili 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ı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

setBorder(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

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.
verticalBooleanDahili dikey kenarlıklar için true, hiç kenarlık yok için false, değişiklik yok için null.
horizontalBooleanDahili yatay kenarlıklar için true, hiçbiri için false, değişiklik yok için null.
colorStringCSS notasyonunda '#ffffff' veya 'white' gibi bir kenarlık rengi, varsayılan renk için null (siyah).
styleBorderStyleKenarlıkların stili. Varsayılan stil için null (düz).

Return

RangeList: 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

setFontColor(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

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

setFontFamily(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

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ı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

setFontLine(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

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

setFontSize(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

AdTürAçıklama
sizeIntegerYazı tipi punto boyutu.

Return

RangeList: 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

setFontStyle(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

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ı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

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''dur.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontWeight('bold');

Parametreler

AdTürAçıklama
fontWeightStringYazı tipi kalınlığı ('bold' veya 'normal'); null değeri yazı tipi kalınlığını sıfırlar.

Return

RangeList: 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

setFormula(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

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ı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

setFormulaR1C1(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

AdTürAçıklama
formulaStringBir dize formülü.

Return

RangeList: 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

setHorizontalAlignment(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

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ı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

setNote(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

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ı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

setNumberFormat(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

AdTürAçıklama
numberFormatStringSayı biçimi dizesi.

Return

RangeList: 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

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

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ı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

setTextDirection(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

AdTürAçıklama
directionTextDirectionİstenen metin yönü; null ise yön ayarlanmadan önce anlaşılır.

Return

RangeList: 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

setTextRotation(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

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

RangeList: 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

setValue(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

AdTürAçıklama
valueObjectAralığın değeri.

Return

RangeList: 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

setVerticalAlignment(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

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ı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

setVerticalText(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

AdTürAçıklama
isVerticalBooleanMetnin yığılıp yığılmayacağı.

Return

RangeList: 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

setWrap(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

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ı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

setWrapStrategy(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

AdTürAçıklama
strategyWrapStrategyİstenen sarma stratejisi.

Return

RangeList: 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

trimWhitespace()

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

RangeList: 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

RangeList: 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