Class Range

Aralık

Bir dokümandaki öğ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 erişebilir ve yalnızca komut dosyası dokümana bağlıysa bu erişimi gerçekleştirebilir. 

// 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[]Bu Range içindeki tüm öğeleri (kısmi Text öğeleri dahil) 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()

Bu Range içindeki tüm öğeleri (kısmi Text öğeleri dahil) alır (örneğin, yalnızca bir Text öğesinin bir kısmını içeren bir seçim söz konusu olduğunda). Text öğesinin aralığa yalnızca kısmen dahil olup olmadığını belirlemek için RangeElement.isPartial() bölümüne bakın.

Return

RangeElement[]: Öğelerin, dokümanda göründükleri sırayla yer aldığı bir dizi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan 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