Class Range

Range

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

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

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
getRangeElements()	RangeElement[]	Mendapatkan semua elemen dalam Range ini, termasuk elemen Text parsial (misalnya, dalam kasus pemilihan yang hanya menyertakan sebagian elemen Text).

Metode yang tidak digunakan lagi

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
getSelectedElements()	RangeElement[]	Mendapatkan semua elemen yang telah dipilih pengguna dalam instance dokumen yang terbuka, termasuk elemen yang dipilih sebagian.Text

Dokumentasi mendetail

getRangeElements()

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

Pulang pergi

RangeElement[] — array elemen, dalam 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

getSelectedElements()

Tidak digunakan lagi. Mengganti namanya menjadi getRangeElements().

Mendapatkan semua elemen yang telah dipilih pengguna dalam instance dokumen yang terbuka, termasuk elemen yang dipilih sebagian.Text

Pulang pergi

RangeElement[] — array elemen yang dipilih atau sebagian dipilih, dalam 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