Bu sayfa, Cloud Translation API ile çevrilmiştir.

Class RangeBuilder

Belge öğ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.
var doc = DocumentApp.getActiveDocument();
var documentTab = doc.getActiveTab().asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.getBody().getTables();
for (var 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 tüm `Element` ekler.
`addElement(textElement, startOffset, endOffsetInclusive)`	`RangeBuilder`	Bu `RangeBuilder` öğesine kısmi bir `Text` öğesi ekler.
`addElementsBetween(startElement, endElementInclusive)`	`RangeBuilder`	İki tam öğeyi ve bunların arasındaki tüm öğeleri bu `RangeBuilder` öğesine ekler.
`addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)`	`RangeBuilder`	İki kısmi `Text` öğesini ve bunların arasındaki tüm öğeleri `RangeBuilder` öğesine ekler.
`addRange(range)`	`RangeBuilder`	Başka bir `Range` içeriğini bu `RangeBuilder` öğesine ekler.
`build()`	`Range`	Oluşturucuya uygulanan ayarlardan bir `Range` oluşturur.
`getRangeElements()`	`RangeElement[]`	Kısmi `Text` öğeleri dahil olmak üzere bu `Range` içindeki tüm öğeleri alır (örneğin, `Text` öğesinin yalnızca bir kısmını içeren bir seçimin).

Desteği sonlandı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 alır. Örneğin, kısmen seçilmiş `Text` öğeler.

Ayrıntılı belgeler

`addElement(element)`

Bu RangeBuilder öğesine tüm Element 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 bir 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`	eklenecek ilk karakterden önceki karakter sayısı (yani aralıktaki ilk karakterin dizini)
`endOffsetInclusive`	`Integer`	eklenecek 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 bir veya daha fazlasıyla yetkilendirme gerektirir:

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

`addElementsBetween(startElement, endElementInclusive)`

İki tam öğeyi ve bunların arasındaki tüm öğeleri bu RangeBuilder öğesine ekler.

Parametreler

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

Return

RangeBuilder — zincirleme için bu oluşturucu

Yetkilendirme

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

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

`addElementsBetween(startTextElement, startOffset, endTextElementInclusive, endOffsetInclusive)`

İki kısmi Text öğesini ve bunların arasındaki tüm öğeleri RangeBuilder öğesine ekler.

Parametreler

Ad	Tür	Açıklama
`startTextElement`	`Text`	kısmen eklenecek ilk metin öğesi
`startOffset`	`Integer`	dahil edilecek ilk `startTextElement` karakterinden önceki karakter sayısı (yani aralıktaki ilk karakterin dizini)
`endTextElementInclusive`	`Text`	kısmen eklenecek son metin öğesi
`endOffsetInclusive`	`Integer`	dahil edilecek son `endTextElementInclusive` karakterinden önceki karakter sayısı (yani aralık)

Return

RangeBuilder — zincirleme için bu oluşturucu

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir 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 içeriğini bu RangeBuilder öğesine ekler.

Parametreler

Ad	Tür	Açıklama
`range`	`Range`	öğelerinin eklenmesi gereken aralık

Return

RangeBuilder — zincirleme için bu oluşturucu

Yetkilendirme

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

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 dahil olmak üzere bu Range içindeki tüm öğeleri alır (örneğin, Text öğesinin yalnızca bir kısmını içeren bir seçimin). Bir projenin Text öğesi aralığa yalnızca kısmen dahil edilmiş, bkz. RangeElement.isPartial().

Return

RangeElement[] — dokümanda göründükleri sırayla bir öğe dizisi

Yetkilendirme

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

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

Desteği sonlandı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 alır. Örneğin, kısmen seçilmiş Text öğeler.

Return

RangeElement[] — doküman

Yetkilendirme

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

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