Class Range

Aralık

Dokümandaki bir öğe aralığı. Kullanıcının seçimi, diğer kullanımların yanı sıra Range olarak gösterilir. Komut dosyaları yalnızca komut dosyasını çalıştıran kullanıcının seçimine ve yalnızca komut dosyasının dokümana bağlı olması durumunda erişebilir. 

// 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 öğ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

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

Kullanımdan kaldırılan yöntemler