Belge öğelerinden Range
nesneleri oluşturmak için kullanılan derleyici.
// Change the user's selection to a range that includes every table in the document. var doc = DocumentApp.getActiveDocument(); var rangeBuilder = doc.newRange(); var tables = doc.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 bütün bir Element ekler. |
addElement(textElement, startOffset, endOffsetInclusive) | RangeBuilder | Bu RangeBuilder öğesine kısmi bir Text öğesi ekler. |
addElementsBetween(startElement, endElementInclusive) | RangeBuilder | İki tam öğeyi ve araları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 | Bu RangeBuilder öğesine başka bir Range öğesinin içeriğini ekler. |
build() | Range | Oluşturucuya uygulanan ayarlardan bir Range oluşturur. |
getRangeElements() | RangeElement[] | Kısmi Text öğeleri de dahil olmak üzere bu Range öğesindeki tüm öğeleri alır (örneğin, bir Text öğesinin yalnızca bir kısmını içeren bir seçim durumunda). |
Ayrıntılı belgeler
addElement(element)
Bu RangeBuilder
öğesine bütün bir Element
ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
element | Element | eklenecek öğe |
Return
RangeBuilder
— zincirleme bağlantı için bu derleyici
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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 | eklenecek son karakterden önceki karakter sayısı (yani aralıktaki son karakterin dizini) |
Return
RangeBuilder
— zincirleme bağlantı için bu derleyici
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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 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 bağlantı için bu derleyici
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların 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)
İ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 startTextElement ilk karakterinden önceki karakter sayısı (yani aralıktaki ilk karakterin dizini) |
endTextElementInclusive | Text | kısmen eklenecek son metin öğesi |
endOffsetInclusive | Integer | dahil edilecek endTextElementInclusive öğesinin son karakterinden önceki karakter sayısı (yani aralıktaki son karakterin dizini) |
Return
RangeBuilder
— zincirleme bağlantı için bu derleyici
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
addRange(range)
Bu RangeBuilder
öğesine başka bir Range
öğesinin içeriğini ekler.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
range | Range | öğeleri eklenmesi gereken aralık |
Return
RangeBuilder
— zincirleme bağlantı için bu derleyici
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
build()
getRangeElements()
Kısmi Text
öğeleri de dahil olmak üzere bu Range
öğesindeki tüm öğeleri alır (örneğin, bir Text
öğesinin yalnızca bir kısmını içeren bir seçim durumunda). Bir Text
öğesinin yalnızca aralığa kısmen dahil olup olmadığını belirlemek için RangeElement.isPartial()
konusuna bakın.
Return
RangeElement[]
: Dokümanda göründükleri sırayla bir öğe dizisi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents