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

Class 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öntem	Dönüş türü	Kısa açıklama
`addElement(element)`	`RangeBuilder`	Bu `RangeBuilder` alanına bir `Element`'ün tamamını ekler.
`addElement(textElement, startOffset, endOffsetInclusive)`	`RangeBuilder`	Bu `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)`	`RangeBuilder`	`RangeBuilder` öğesine iki kısmi `Text` öğesi ve aralarındaki tüm öğeleri ekler.
`addRange(range)`	`RangeBuilder`	Başka bir `Range`'nin içeriğini bu `RangeBuilder`'a ekler.
`build()`	`Range`	Oluş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).

Kullanımdan kaldırılan yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`getSelectedElements()`	`RangeElement[]`	Kısmen seçili `Text`ögeleri dahil olmak üzere, kullanıcının açık doküman örneğinde seçtiği tüm öğeleri alır.

Ayrıntılı dokümanlar

`addElement(element)`

Bu RangeBuilder alanına bir Element'ün 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ı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

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ı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

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ı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

Ad	Tür	Açıklama
`startTextElement`	`Text`	Kısmen eklenecek ilk metin öğesi
`startOffset`	`Integer`	Dahil edilecek `startTextElement` karakterinden önceki karakter sayısı (yani, aralıktaki ilk karakterin dizini)
`endTextElementInclusive`	`Text`	Kısmen eklenecek son metin öğesi
`endOffsetInclusive`	`Integer`	`endTextElementInclusive` 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

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ı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

`getSelectedElements()`

Kullanımdan kaldırıldı. Adı getRangeElements() olarak değiştirildi.

Kısmen seçili Textögeleri dahil olmak üzere, kullanıcının açık doküman örneğinde seçtiği tüm öğeleri alır.

Return

RangeElement[]: Seçilen veya kısmen seçilen öğelerin dokümanda göründükleri sıradaki 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