Class Range

Aralık

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öntemDö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

Desteği sonlandırılan yöntemler