Class RangeList

RangeList

Aynı sayfada bulunan bir veya daha fazla Range örneğinin koleksiyonu. Bu sınıfı, bitişik olmayan aralık veya hücre koleksiyonlarında işlemler uygulamak için kullanabilirsiniz.

Yöntemler

YöntemDönüş türüKısa açıklama
activate()RangeListRange örneklerinin listesini seçer.
breakApart()RangeListAralık listesinde bulunan tüm yatay veya dikey olarak birleştirilmiş hücreleri tekrar ayrı hücreler haline getirin.
check()RangeListAralıktaki onay kutularının durumunu "işaretli" olarak değiştirir.
clear()RangeListAralık listesindeki her Range için içerik, biçim ve veri doğrulama kuralları aralığını temizler.
clear(options)RangeListBelirtilen seçeneklerle belirlenen içerik aralığını, biçimi, veri doğrulama kurallarını ve yorumları temizler.
clearContent()RangeListAralık listesindeki her Range içeriğini temizler ve biçimlendirmeyi olduğu gibi bırakır.
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ı sayfadaki bir veya daha fazla Range örneğinin listesini döndürür.
insertCheckboxes()RangeListAralıktaki her hücreye onay kutuları ekler. Onay kutuları, işaretli için true, işaretsiz için false ile yapılandırılır.
insertCheckboxes(checkedValue)RangeListAralıktaki her hücreye, işaretli için özel bir değer ve işaretli olmayan için boş dize ile yapılandırılmış onay kutuları ekler.
insertCheckboxes(checkedValue, uncheckedValue)RangeListAralıktaki her hücreye, işaretli ve işaretsiz 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 kenarlık ö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 stille 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 çizgi stilini ayarlar.
setFontSize(size)RangeListAralık listesindeki her Range için yazı tipi boyutunu (puan 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 ayarlar.
setTextDirection(direction)RangeListAralık listesindeki her bir Range hücresinin metin yönünü ayarlar.
setTextRotation(degrees)RangeListAralık listesindeki her Range hücresinin 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ıktaki her Range için hücrelerdeki metnin yığılıp yığılmayacağını belirler.
setWrap(isWrapEnabled)RangeListAralık listesindeki her Range için metin kaydırmayı ayarlayın.
setWrapStrategy(strategy)RangeListAralık listesindeki her Range için metin kaydırma stratejisini ayarlar.
trimWhitespace()RangeListBu aralık listesindeki her hücrede boşlukları (ör. boşluklar, sekmeler veya yeni satırlar) 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 ayarlanır.

Not: Bu, birden fazla aralığı seçmenin bir yoludur. 

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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • 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 ayrı hücreler haline getirin.

Bu işlevi bir aralık listesinde çağırmak, bir aralık kümesi seçmeye ve Biçim > Birleştir > Birleştirilenleri Ayır E-Tablolar menü öğesini seçmeye eşdeğerdir. 

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ı, aşağıdaki kapsamlardan 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, şu anda yapılandırılmış işaretli veya işaretsiz değerini içermeyen hücreleri yoksayar. 

// 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ı, aşağıdaki kapsamlardan 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 Range için içerik, biçim ve veri doğrulama kuralları aralığı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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

clear(options)

Belirtilen seçeneklerle belirlenen 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 listelendiği gibi gelişmiş parametreleri belirten bir JavaScript nesnesi.

Gelişmiş parametreler

AdTürAçıklama
commentsOnlyBooleanYalnızca yorumların temizlenip temizlenmeyeceği.
contentsOnlyBooleanYalnızca içeriklerin temizlenip temizlenmeyeceği.
formatOnlyBooleanYalnızca biçimin temizlenip temizlenmeyeceği. Biçimin temizlenmesiyle veri doğrulama kurallarının da temizleneceğini unutmayın.
validationsOnlyBooleanYalnızca veri doğrulama kurallarının temizlenip temizlenmeyeceği.
skipFilteredRowsBooleanFiltrelenmiş satırların temizlenmesinden kaçınılıp kaçınılmayacağını belirtir.

Return

RangeList: Zincirleme için bu aralık listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 Range içeriğini temizler ve biçimlendirmeyi olduğu gibi bırakır. 

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ı, aşağıdaki kapsamlardan 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 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ı, aşağıdaki kapsamlardan 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ı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ı, aşağıdaki kapsamlardan 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 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ı, aşağıdaki kapsamlardan 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ıkların listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertCheckboxes()

Aralıktaki her hücreye onay kutuları ekler. Onay kutuları, işaretli için true, işaretsiz için false ile yapılandırılır. 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ı, aşağıdaki kapsamlardan 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 hücreye, işaretli için özel bir değer ve işaretli olmayan için boş dize ile yapılandırılmış onay kutuları 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ı, aşağıdaki kapsamlardan 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 hücreye, işaretli ve işaretsiz durumlar için özel değerlerle yapılandırılmış onay kutuları ekler. Aralıktaki her hücrenin değerini özel işaretlenmemiş 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ı, aşağıdaki kapsamlardan 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 hücre işaretli veya işaretsiz değeri 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ı, aşağıdaki kapsamlardan 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 Range için arka plan rengini ayarlar. Renk, CSS gösterimiyle (ör. '#ffffff' veya 'white') gösterilir. 

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

Parametreler

AdTürAçıklama
colorStringCSS gösteriminde 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ı, aşağıdaki kapsamlardan 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ı 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ğeri.
greenIntegerRGB gösterimindeki yeşil değeri.
blueIntegerRGB gösterimindeki mavi değeri.

Return

RangeList: Zincirleme için bu aralık listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 Range için kenarlık ö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
topBooleantrue: Kenarlık için, false: Yok için, null: Değişiklik yok için.
leftBooleantrue: Kenarlık için, false: Yok için, null: Değişiklik yok için.
bottomBooleantrue: Kenarlık için, false: Yok için, null: Değişiklik yok için.
rightBooleantrue: Kenarlık için, false: Yok için, null: Değişiklik yok için.
verticalBooleantrue: İç dikey kenarlıklar için, false: Kenarlık yok için, null: Değişiklik yok için.
horizontalBooleantrue: İç yatay kenarlıklar için, false: Yok için, null: Değişiklik yok için.

Return

RangeList: Zincirleme için bu aralık listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 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) şeklindedir. Renk, CSS gösterimiyle ifade edilir. Örneğin, '#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
topBooleantrue: Kenarlık için, false: Yok için, null: Değişiklik yok için.
leftBooleantrue: Kenarlık için, false: Yok için, null: Değişiklik yok için.
bottomBooleantrue: Kenarlık için, false: Yok için, null: Değişiklik yok için.
rightBooleantrue: Kenarlık için, false: Yok için, null: Değişiklik yok için.
verticalBooleantrue: İç dikey kenarlıklar için, false: Kenarlık yok için, null: Değişiklik yok için.
horizontalBooleantrue: İç yatay kenarlıklar için, false: Yok için, null: Değişiklik yok için.
colorStringVarsayılan renk (siyah) için '#ffffff' veya 'white', null gibi CSS gösteriminde kenarlık rengi.
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 kapsamlardan 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 Range için yazı tipi rengini ayarlar. Renk, CSS gösterimiyle temsil edilir. Örneğin, '#ffffff' veya 'white'. 

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

Parametreler

AdTürAçıklama
colorString'#ffffff' veya 'white' gibi CSS gösteriminde yazı tipi rengi; 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 kapsamlardan 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 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ı, aşağıdaki kapsamlardan 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 Range için yazı tipi çizgi 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 çizgi stili ('underline', 'line-through' veya 'none'); null değeri, yazı tipi çizgi stilini sıfırlar.

Return

RangeList: Zincirleme için bu aralık listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 Range için yazı tipi boyutunu (puan 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ı, aşağıdaki kapsamlardan 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 'italic' veya 'normal''dir. 

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ı, aşağıdaki kapsamlardan 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''dır. 

const sheet = SpreadsheetApp.getActiveSheet();
const 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 kapsamlardan 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 Range için formülü günceller. Belirtilen formül A1 gösteriminde 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ı, aşağıdaki kapsamlardan 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 Range için formülü günceller. Belirtilen formül R1C1 gösteriminde 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
formulaStringDize formülü.

Return

RangeList: Zincirleme için bu aralık listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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. 

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ı, aşağıdaki kapsamlardan 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 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ı, aşağıdaki kapsamlardan 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 Range için sayı veya tarih biçimini ayarlar.

Kabul edilen biçimlendirme kalıpları E-Tablolar API'si 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ı, aşağıdaki kapsamlardan 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 için köprülerin gösterilip gösterilmeyeceğini ayarlar. 

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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTextDirection(direction)

Aralık listesindeki her bir Range hücresinin metin yönünü ayarlar. Belirtilen yön null ise yön çıkarılır 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ü; yön, ayarlanmadan önce null çıkarılıyorsa.

Return

RangeList: Zincirleme için bu aralık listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTextRotation(degrees)

Aralık listesindeki her Range hücresinin 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 metin yönünde ise saat yönüne doğrudur. 

// 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 istenen açı. Soldan sağa metinlerde 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 kapsamlardan 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 Range için değeri ayarlar. Değer sayısal, dize, Boole veya tarih olabilir. "=" ile başlıyorsa 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ı, aşağıdaki kapsamlardan 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''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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setVerticalText(isVertical)

Aralıktaki her Range için hücrelerdeki metnin yığılıp yığılmayacağını belirler. Metin dikey olarak sıralanmış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 üst üste yerleştirilip yerleştirilmeyeceği.

Return

RangeList: Zincirleme için bu aralık listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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ği etkinleştirilmiş hücreler, içeriklerinin tamamını gösterecek şekilde yeniden boyutlandırılır. Sarma 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 çok görüntülenir. 

// 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ı, aşağıdaki kapsamlardan 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 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 kaydırma stratejisi.

Return

RangeList: Zincirleme için bu aralık listesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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 boşlukları (ör. boşluklar, sekmeler veya yeni satırlar) kırpar. Her hücrenin metninin başındaki ve sonundaki tüm boşlukları kaldırır ve kalan boşluk karakterlerinin herhangi bir alt dizisini tek bir boşluğa indirir. 

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ı, aşağıdaki kapsamlardan 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şaretlenmemiş" olarak değiştirir. Aralıktaki, şu anda yapılandırılmış işaretli veya işaretsiz değerleri içermeyen hücreleri yoksayar. 

// 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ı, aşağıdaki kapsamlardan biri veya daha fazlasıyla yetkilendirme gerektirir:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets