Class 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öntem	Dönüş türü	Kısa açıklama
`activate()`	`RangeList`	`Range` örnek listesini seçer.
`breakApart()`	`RangeList`	Aralık listesinde bulunan tüm yatay veya dikey olarak birleştirilmiş hücreleri tekrar ayrı hücrelere ayırın.
`check()`	`RangeList`	Aralıktaki onay kutularının durumunu "işaretli" olarak değiştirir.
`clear()`	`RangeList`	Aralık listesindeki her `Range` için içerik, biçim ve veri doğrulama kuralları aralığını temizler.
`clear(options)`	`RangeList`	Belirtilen seçeneklerle belirlenen içerik aralığını, biçimi, veri doğrulama kurallarını ve yorumları temizler.
`clearContent()`	`RangeList`	Aralık listesindeki her `Range` içeriğini temizler ve biçimlendirmeyi olduğu gibi bırakır.
`clearDataValidations()`	`RangeList`	Aralık listesindeki her `Range` için veri doğrulama kurallarını temizler.
`clearFormat()`	`RangeList`	Aralık listesindeki her `Range` için metin biçimlendirmesini temizler.
`clearNote()`	`RangeList`	Aralık listesindeki her `Range` için notu temizler.
`getRanges()`	`Range[]`	Aynı sayfadaki bir veya daha fazla `Range` örneğinin listesini döndürür.
`insertCheckboxes()`	`RangeList`	Aralıktaki her 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)`	`RangeList`	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.
`insertCheckboxes(checkedValue, uncheckedValue)`	`RangeList`	Aralıktaki her hücreye, işaretli ve işaretsiz durumlar için özel değerlerle yapılandırılmış onay kutuları ekler.
`removeCheckboxes()`	`RangeList`	Aralıktaki tüm onay kutularını kaldırır.
`setBackground(color)`	`RangeList`	Aralık listesindeki her `Range` için arka plan rengini ayarlar.
`setBackgroundRGB(red, green, blue)`	`RangeList`	Arka planı belirtilen RGB rengine ayarlar.
`setBorder(top, left, bottom, right, vertical, horizontal)`	`RangeList`	Aralık listesindeki her `Range` için kenarlık özelliğini ayarlar.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`RangeList`	Aralık listesindeki her `Range` için kenarlık özelliğini renk ve/veya stille ayarlar.
`setFontColor(color)`	`RangeList`	Aralık listesindeki her `Range` için yazı tipi rengini ayarlar.
`setFontFamily(fontFamily)`	`RangeList`	Aralık listesindeki her `Range` için yazı tipi ailesini ayarlar.
`setFontLine(fontLine)`	`RangeList`	Aralık listesindeki her `Range` için yazı tipi çizgi stilini ayarlar.
`setFontSize(size)`	`RangeList`	Aralık listesindeki her `Range` için yazı tipi boyutunu (puan cinsinden) ayarlar.
`setFontStyle(fontStyle)`	`RangeList`	Aralık listesindeki her `Range` için yazı tipi stilini ayarlayın.
`setFontWeight(fontWeight)`	`RangeList`	Aralık listesindeki her `Range` için yazı tipi ağırlığını ayarlayın.
`setFormula(formula)`	`RangeList`	Aralık listesindeki her `Range` için formülü günceller.
`setFormulaR1C1(formula)`	`RangeList`	Aralık listesindeki her `Range` için formülü günceller.
`setHorizontalAlignment(alignment)`	`RangeList`	Aralık listesindeki her `Range` için yatay hizalamayı ayarlayın.
`setNote(note)`	`RangeList`	Aralık listesindeki her `Range` için not metnini ayarlar.
`setNumberFormat(numberFormat)`	`RangeList`	Aralık listesindeki her `Range` için sayı veya tarih biçimini ayarlar.
`setShowHyperlink(showHyperlink)`	`RangeList`	Aralık listesindeki her `Range` için köprülerin gösterilip gösterilmeyeceğini ayarlar.
`setTextDirection(direction)`	`RangeList`	Aralık listesindeki her bir `Range` hücresinin metin yönünü ayarlar.
`setTextRotation(degrees)`	`RangeList`	Aralık listesindeki her `Range` hücresinin metin döndürme ayarlarını belirler.
`setValue(value)`	`RangeList`	Aralık listesindeki her `Range` için değeri ayarlar.
`setVerticalAlignment(alignment)`	`RangeList`	Aralık listesindeki her `Range` için dikey hizalamayı ayarlayın.
`setVerticalText(isVertical)`	`RangeList`	Aralıktaki her `Range` için hücrelerdeki metnin yığılıp yığılmayacağını ayarlar.
`setWrap(isWrapEnabled)`	`RangeList`	Aralık listesindeki her `Range` için metin kaydırmayı ayarlayın.
`setWrapStrategy(strategy)`	`RangeList`	Aralık listesindeki her `Range` için metin kaydırma stratejisini ayarlar.
`trimWhitespace()`	`RangeList`	Bu aralık listesindeki her hücrede boşlukları (ör. boşluk, sekme veya yeni satır) kırpar.
`uncheck()`	`RangeList`	Aralıktaki onay kutularının durumunu "işaretsiz" olarak değiştirir.

Ayrıntılı belgeler

`activate()`

Range örneklerinin listesini seçer. Listedeki son aralık active range olarak ayarlanır.

Not: Bu, bir dizi aralığı çoklu seçmenin bir yolunu sunar.

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ücrelere ayırın.

Bu işlevi bir aralık listesinde çağırmak, bir aralık kümesini seçip 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

Ad	Tür	Açıklama
`options`	`Object`	Aşağıda listelendiği gibi gelişmiş parametreleri belirten bir JavaScript nesnesi.

Gelişmiş parametreler

Ad	Tür	Açıklama
`commentsOnly`	`Boolean`	Yalnızca yorumların temizlenip temizlenmeyeceğini belirler.
`contentsOnly`	`Boolean`	Yalnızca içeriklerin temizlenip temizlenmeyeceği.
`formatOnly`	`Boolean`	Yalnızca biçimin temizlenip temizlenmeyeceği. Biçimin temizlenmesiyle veri doğrulama kurallarının da temizleneceğini unutmayın.
`validationsOnly`	`Boolean`	Yalnızca veri doğrulama kurallarının temizlenip temizlenmeyeceği.
`skipFilteredRows`	`Boolean`	Filtrelenmiş 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

Ad	Tür	Açıklama
`checkedValue`	`Object`	Onay kutusu veri doğrulaması için işaretli değer.

Return

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

Yetkilendirme

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

Ad	Tür	Açıklama
`checkedValue`	`Object`	Onay kutusu veri doğrulaması için işaretli değer.
`uncheckedValue`	`Object`	Onay kutusu veri doğrulaması için iş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

Ad	Tür	Açıklama
`color`	`String`	CSS 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

Ad	Tür	Açıklama
`red`	`Integer`	RGB gösterimindeki kırmızı değeri.
`green`	`Integer`	RGB gösterimindeki yeşil değeri.
`blue`	`Integer`	RGB 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

Ad	Tür	Açıklama
`top`	`Boolean`	`true`: Kenarlık için, `false`: Yok için, `null`: Değişiklik yok için.
`left`	`Boolean`	`true`: Kenarlık için, `false`: Yok için, `null`: Değişiklik yok için.
`bottom`	`Boolean`	`true`: Kenarlık için, `false`: Yok için, `null`: Değişiklik yok için.
`right`	`Boolean`	`true`: Kenarlık için, `false`: Yok için, `null`: Değişiklik yok için.
`vertical`	`Boolean`	Dikey iç kenarlıklar için `true`, kenarlık olmaması için `false`, değişiklik olmaması için `null`.
`horizontal`	`Boolean`	`true`: İç 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

Ad	Tür	Açıklama
`top`	`Boolean`	`true`: Kenarlık için, `false`: Yok için, `null`: Değişiklik yok için.
`left`	`Boolean`	`true`: Kenarlık için, `false`: Yok için, `null`: Değişiklik yok için.
`bottom`	`Boolean`	`true`: Kenarlık için, `false`: Yok için, `null`: Değişiklik yok için.
`right`	`Boolean`	`true`: Kenarlık için, `false`: Yok için, `null`: Değişiklik yok için.
`vertical`	`Boolean`	Dikey iç kenarlıklar için `true`, kenarlık olmaması için `false`, değişiklik olmaması için `null`.
`horizontal`	`Boolean`	`true`: İç yatay kenarlıklar için, `false`: Yok için, `null`: Değişiklik yok için.
`color`	`String`	Varsayılan renk (siyah) için `'#ffffff'` veya `'white'`, `null` gibi CSS gösteriminde kenarlık rengi.
`style`	`BorderStyle`	Kenarlıkların stili. Varsayılan stil (düz) için `null`.

Return

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

Yetkilendirme

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

Ad	Tür	Açıklama
`color`	`String`	`'#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

Ad	Tür	Açıklama
`fontFamily`	`String`	Ayarlanacak yazı tipi ailesi. `null` değeri, yazı tipi ailesini sıfırlar.

Return

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

Yetkilendirme

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

Ad	Tür	Açıklama
`fontLine`	`String`	Yazı 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

Ad	Tür	Açıklama
`size`	`Integer`	Yazı tipi 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

Ad	Tür	Açıklama
`fontStyle`	`String`	Yazı tipi stili, `'italic'` veya `'normal'`; `null` değeri yazı tipi stilini sıfırlar.

Return

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

Yetkilendirme

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

Ad	Tür	Açıklama
`fontWeight`	`String`	Yazı tipi ağırlığı, `'bold'` veya `'normal'`; `null` değeri yazı tipi ağırlığını sıfırlar.

Return

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

Yetkilendirme

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

Ad	Tür	Açıklama
`formula`	`String`	Ayarlanacak formülü temsil eden bir dize.

Return

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

Yetkilendirme

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

Ad	Tür	Açıklama
`formula`	`String`	Dize formülü.

Return

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

Yetkilendirme

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

Ad	Tür	Açıklama
`alignment`	`String`	Hizalama (`'left'`, `'center'` veya `'normal'`); `null` değeri hizalamayı sıfırlar.

Return

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

Yetkilendirme

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

Ad	Tür	Açıklama
`note`	`String`	Ayarlanacak not metni. `null` değeri notu kaldırır.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki 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ı Sheets API tarih ve sayı biçimlendirme kılavuzunda açıklanmaktadır.

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Always show 3 decimal points for the specified ranges.
rangeList.setNumberFormat('0.000');

Parametreler

Ad	Tür	Açıklama
`numberFormat`	`String`	Sayı biçimi dizesi.

Return

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

Yetkilendirme

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

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

`setShowHyperlink(showHyperlink)`

Aralık listesindeki her Range 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

Ad	Tür	Açıklama
`showHyperlink`	`Boolean`	Köprünün gösterilip gösterilmeyeceği.

Return

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

Yetkilendirme

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

Ad	Tür	Açıklama
`direction`	`TextDirection`	İstenen metin yönü. Yön, ayarlanmadan önce `null` çıkarılırsa.

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

Ad	Tür	Açıklama
`degrees`	`Integer`	Standart 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

Ad	Tür	Açıklama
`value`	`Object`	Aralığın değeri.

Return

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

Yetkilendirme

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

Ad	Tür	Açıklama
`alignment`	`String`	Hizalama (`'top'`, `'middle'` veya `'bottom'`); `null` değeri hizalamayı sıfırlar.

Return

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

Yetkilendirme

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

Ad	Tür	Açıklama
`isVertical`	`Boolean`	Metnin yığılıp yığı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

`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ırma veya birden fazla satıra yayılma olmadan 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

Ad	Tür	Açıklama
`isWrapEnabled`	`Boolean`	Metnin kaydırılıp kaydırılmayacağı.

Return

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

Yetkilendirme

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

Ad	Tür	Açıklama
`strategy`	`WrapStrategy`	İ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şluk, sekme veya yeni satır) 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:

Range.trimWhitespace()

`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ş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 '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

Class RangeList Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Yöntemler

Ayrıntılı belgeler

activate()

Return

Yetkilendirme

breakApart()

Return

Yetkilendirme

check()

Return

Yetkilendirme

clear()

Return

Yetkilendirme

clear(options)

Parametreler

Gelişmiş parametreler

Return

Yetkilendirme

clearContent()

Return

Yetkilendirme

clearDataValidations()

Return

Yetkilendirme

clearFormat()

Return

Yetkilendirme

clearNote()

Return

Yetkilendirme

getRanges()

Return

Yetkilendirme

insertCheckboxes()

Return

Yetkilendirme

insertCheckboxes(checkedValue)

Parametreler

Return

Yetkilendirme

insertCheckboxes(checkedValue, uncheckedValue)

Parametreler

Return

Yetkilendirme

removeCheckboxes()

Return

Yetkilendirme

setBackground(color)

Parametreler

Return

Yetkilendirme

setBackgroundRGB(red, green, blue)

Parametreler

Return

Yetkilendirme

setBorder(top, left, bottom, right, vertical, horizontal)

Parametreler

Return

Yetkilendirme

setBorder(top, left, bottom, right, vertical, horizontal, color, style)

Parametreler

Return

Yetkilendirme

setFontColor(color)

Parametreler

Return

Yetkilendirme

setFontFamily(fontFamily)

Parametreler

Return

Yetkilendirme

setFontLine(fontLine)

Parametreler

Return

Yetkilendirme

setFontSize(size)

Parametreler

Return

Class RangeList

`activate()`

`breakApart()`

`check()`

`clear()`

`clear(options)`

`clearContent()`

`clearDataValidations()`

`clearFormat()`

`clearNote()`

`getRanges()`

`insertCheckboxes()`

`insertCheckboxes(checkedValue)`

`insertCheckboxes(checkedValue, uncheckedValue)`

`removeCheckboxes()`

`setBackground(color)`

`setBackgroundRGB(red, green, blue)`

`setBorder(top, left, bottom, right, vertical, horizontal)`

`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`

`setFontColor(color)`

`setFontFamily(fontFamily)`

`setFontLine(fontLine)`

`setFontSize(size)`

`setFontStyle(fontStyle)`

`setFontWeight(fontWeight)`

`setFormula(formula)`

`setFormulaR1C1(formula)`

`setHorizontalAlignment(alignment)`

`setNote(note)`

`setNumberFormat(numberFormat)`

`setShowHyperlink(showHyperlink)`

`setTextDirection(direction)`

`setTextRotation(degrees)`

`setValue(value)`

`setVerticalAlignment(alignment)`

`setVerticalText(isVertical)`

`setWrap(isWrapEnabled)`

`setWrapStrategy(strategy)`

`trimWhitespace()`

`uncheck()`