Bir dokümandaki öğe aralığı. Kullanıcının seçimi, diğer kullanımlar arasında Range
olarak gösterilir. Komut dosyaları, yalnızca komut dosyasını çalıştıran kullanıcının seçimine erişebilir ve yalnızca
Komut dosyası dokümana bağlı ise.
// Bold all selected text. var selection = DocumentApp.getActiveDocument().getSelection(); if (selection) { var elements = selection.getRangeElements(); for (var i = 0; i < elements.length; i++) { var element = elements[i]; // Only modify elements that can be edited as text; skip images and other non-text elements. if (element.getElement().editAsText) { var text = element.getElement().editAsText(); // Bold the selected part of the element, or the full element if it's completely selected. if (element.isPartial()) { text.setBold(element.getStartOffset(), element.getEndOffsetInclusive(), true); } else { text.setBold(true); } } } }
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
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ı belgeler
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