Class RangeBuilder

RangeBuilder

Doküman öğelerinden Range nesneleri oluşturmak için kullanılan bir oluşturucudur.

// Change the user's selection to a range that includes every table in the
// active tab.
const doc = DocumentApp.getActiveDocument();
const documentTab = doc.getActiveTab().asDocumentTab();
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
addElement(element)	RangeBuilder	Bu RangeBuilder öğesine Element öğesinin tamamını ekler.
addElement(textElement, startOffset, endOffsetInclusive)	RangeBuilder	Bu RangeBuilder öğesine kısmi bir Text öğesi ekler.
addElementsBetween(startElement, endElementInclusive)	RangeBuilder	Bu RangeBuilder öğesine iki öğenin tamamını ve aralarındaki tüm öğeleri ekler.
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)	RangeBuilder	Text öğesinin iki bölümünü ve aralarındaki tüm öğeleri RangeBuilder öğesine ekler.
addRange(range)	RangeBuilder	Başka bir Range dosyasının içeriğini bu RangeBuilder dosyasına ekler.
build()	Range	Oluşturucuya uygulanan ayarlardan Range oluşturur.
getRangeElements()	RangeElement[]	Bu Range içindeki tüm öğeleri (kısmi Text öğeleri dahil) alır (örneğin, yalnızca bir Text öğesinin bir kısmını içeren bir seçim söz konusu olduğunda).

Kullanımdan kaldırılan yöntemler

Yöntem	Dönüş türü	Kısa açıklama
getSelectedElements()	RangeElement[]	Kullanıcının dokümanın açık örneğinde seçtiği tüm öğeleri (kısmen seçilmiş Text öğeler dahil) alır.

Ayrıntılı belgeler

addElement(element)

Bu RangeBuilder öğesine Element öğesinin tamamını ekler.

Parametreler

Ad	Tür	Açıklama
element	Element	Eklenecek öğe

Return

RangeBuilder: Zincirleme için bu oluşturucu

Yetkilendirme

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

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

---

addElement(textElement, startOffset, endOffsetInclusive)

Bu RangeBuilder öğesine kısmi bir Text öğesi ekler.

Parametreler

Ad	Tür	Açıklama
textElement	Text	Kısmen eklenecek metin öğesi
startOffset	Integer	Dahil edilecek ilk karakterden önceki karakter sayısı (yani, aralıktaki ilk karakterin dizini)
endOffsetInclusive	Integer	Dahil edilecek son karakterden önceki karakter sayısı (yani aralıktaki son karakterin dizini)

Return

RangeBuilder: Zincirleme için bu oluşturucu

Yetkilendirme

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

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

---

addElementsBetween(startElement, endElementInclusive)

Bu RangeBuilder öğesine iki öğenin tamamını ve aralarındaki tüm öğeleri ekler.

Parametreler

Ad	Tür	Açıklama
startElement	Element	eklenecek ilk öğe
endElementInclusive	Element	eklenen son öğe

Return

RangeBuilder: Zincirleme için bu oluşturucu

Yetkilendirme

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

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

---

addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)

Text öğesinin iki bölümünü ve aralarındaki tüm öğeleri RangeBuilder öğesine ekler.

Parametreler

Ad	Tür	Açıklama
startTextElement	Text	Kısmen eklenecek ilk metin öğesi
startOffset	Integer	startTextElement öğesinin ilk karakterinden önce eklenecek karakter sayısı (yani aralıktaki ilk karakterin dizini)
endTextElementInclusive	Text	Kısmen eklenen son metin öğesi
endOffsetInclusive	Integer	endTextElementInclusive öğesinin son karakterinden önce eklenecek karakter sayısı (yani aralıktaki son karakterin dizini)

Return

RangeBuilder: Zincirleme için bu oluşturucu

Yetkilendirme

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

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

---

addRange(range)

Başka bir Range dosyasının içeriğini bu RangeBuilder dosyasına ekler.

Parametreler

Ad	Tür	Açıklama
range	Range	öğeleri eklenecek aralık

Return

RangeBuilder: Zincirleme için bu oluşturucu

Yetkilendirme

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

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

---

build()

Oluşturucuya uygulanan ayarlardan Range oluşturur.

Return

Range: Yeni oluşturulan aralık

---

getRangeElements()

Bu Range içindeki tüm öğeleri (kısmi Text öğeleri dahil) alır (örneğin, yalnızca bir Text öğesinin bir kısmını içeren bir seçim söz konusu olduğunda). Text öğesinin aralığa yalnızca kısmen dahil olup olmadığını belirlemek için RangeElement.isPartial() bölümüne bakın.

Return

RangeElement[]: Öğelerin, dokümanda göründükleri sırayla yer aldığı bir dizi

Yetkilendirme

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

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

Kullanımdan kaldırılan yöntemler

getSelectedElements()

Kullanımdan kaldırıldı. getRangeElements() olarak yeniden adlandırıldı.

Kullanıcının dokümanın açık örneğinde seçtiği tüm öğeleri (kısmen seçilmiş Text öğeler dahil) alır.

Return

RangeElement[]: Seçilen veya kısmen seçilen öğelerin, dokümanda göründükleri sırayla yer aldığı bir dizi

Yetkilendirme

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

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