Class Range

Rentang

Rentang elemen dalam dokumen. Pilihan pengguna direpresentasikan sebagai Range, di antara penggunaan lainnya. Skrip hanya dapat mengakses pemilihan pengguna yang menjalankan skrip, dan hanya jika skrip terikat ke dokumen.

// 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);
      }
    }
  }
}

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getRangeElements()RangeElement[]Mendapatkan semua elemen dalam Range ini, termasuk elemen Text sebagian (misalnya, dalam kasus pilihan yang hanya menyertakan sebagian elemen Text).

Dokumentasi mendetail

getRangeElements()

Mendapatkan semua elemen dalam Range ini, termasuk elemen Text sebagian (misalnya, dalam kasus pilihan yang hanya menyertakan sebagian elemen Text). Untuk menentukan apakah elemen Text hanya disertakan sebagian dalam rentang, lihat RangeElement.isPartial().

Return

RangeElement[] — array elemen, sesuai urutan kemunculannya dalam dokumen

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/documents.currentonly
  • https://www.googleapis.com/auth/documents

Metode yang tidak digunakan lagi