Class Range

Aralık

Bir dokümanda bir dizi öğe. 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 bu da yalnızca komut dosyası dokümana bağlıysa geçerlidir.

// Bold all selected text.
const selection = DocumentApp.getActiveDocument().getSelection();
if (selection) {
  const elements = selection.getRangeElements();
  for (let i = 0; i < elements.length; i++) {
    const element = elements[i];

    // Only modify elements that can be edited as text; skip images and other
    // non-text elements.
    if (element.getElement().editAsText) {
      const 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ı dokümanlar

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