Class RangeBuilder

RangeBuilder

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

// 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öntemDönüş türüKısa açıklama
addElement(element)RangeBuilderBu RangeBuilder alanına bir Element'ün tamamını ekler.
addElement(textElement, startOffset, endOffsetInclusive)RangeBuilderBu RangeBuilder için kısmi bir Text öğesi ekler.
addElementsBetween(startElement, endElementInclusive)RangeBuilderİki öğenin tamamını ve aralarındaki tüm öğeleri bu RangeBuilder öğesine ekler.
addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)RangeBuilderRangeBuilder öğesine iki kısmi Text öğesi ve aralarındaki tüm öğeleri ekler.
addRange(range)RangeBuilderBaşka bir Range'nin içeriğini bu RangeBuilder'a ekler.
build()RangeOluşturucuya uygulanan ayarlardan bir Range oluşturur.
getRangeElements()RangeElement[]Kısmi Text öğeleri de dahil olmak üzere bu Range'deki tüm öğeleri alır (örneğin, yalnızca bir Text öğesinin bir kısmını içeren bir seçim söz konusu olduğunda).

Ayrıntılı dokümanlar

addElement(element)

Bu RangeBuilder alanına bir Element'ün tamamını ekler.

Parametreler

AdTürAçıklama
elementElementeklenecek öğe

Return

RangeBuilder: zincirleme için bu oluşturucu

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/documents.currentonly
  • https://www.googleapis.com/auth/documents

addElement(textElement, startOffset, endOffsetInclusive)

Bu RangeBuilder için kısmi bir Text öğesi ekler.

Parametreler

AdTürAçıklama
textElementTextKısmen eklenecek metin öğesi
startOffsetIntegerDahil edilecek ilk karakterden önceki karakter sayısı (yani, aralıktaki ilk karakterin dizini)
endOffsetInclusiveIntegerDahil 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

addElementsBetween(startElement, endElementInclusive)

İki öğenin tamamını ve aralarındaki tüm öğeleri bu RangeBuilder öğesine ekler.

Parametreler

AdTürAçıklama
startElementElementeklenecek ilk öğe
endElementInclusiveElementeklenecek son öğe

Return

RangeBuilder: zincirleme için bu oluşturucu

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/documents.currentonly
  • https://www.googleapis.com/auth/documents

addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)

RangeBuilder öğesine iki kısmi Text öğesi ve aralarındaki tüm öğeleri ekler.

Parametreler

AdTürAçıklama
startTextElementTextKısmen eklenecek ilk metin öğesi
startOffsetIntegerDahil edilecek startTextElement karakterinden önceki karakter sayısı (yani, aralıktaki ilk karakterin dizini)
endTextElementInclusiveTextKısmen eklenecek son metin öğesi
endOffsetInclusiveIntegerendTextElementInclusive değerinin son karakterinden önce dahil edilecek karakter sayısı (yani, aralıktaki son karakterin dizini)

Return

RangeBuilder: zincirleme için bu oluşturucu

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/documents.currentonly
  • https://www.googleapis.com/auth/documents

addRange(range)

Başka bir Range'nin içeriğini bu RangeBuilder'a ekler.

Parametreler

AdTürAçıklama
rangeRangeÖğelerinin eklenmesi gereken aralık

Return

RangeBuilder: zincirleme için bu oluşturucu

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/documents.currentonly
  • https://www.googleapis.com/auth/documents

build()

Oluşturucuya uygulanan ayarlardan bir Range oluşturur.

Return

Range: Yeni oluşturulan aralık

getRangeElements()

Kısmi Text öğeleri de dahil olmak üzere bu Range'deki tüm öğeleri alır (örneğin, yalnızca bir Text öğesinin bir kısmını içeren bir seçim söz konusu olduğunda). Bir Text öğesinin aralığa yalnızca kısmen dahil edilip edilmediğini belirlemek için RangeElement.isPartial() bölümüne bakın.

Return

RangeElement[]: Belgede göründükleri sırayla bir öğe dizisi

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/documents.currentonly
  • https://www.googleapis.com/auth/documents

Kullanımdan kaldırılan yöntemler