Class Selection

Pemilihan

Pilihan pengguna dalam presentasi aktif.

const selection = SlidesApp.getActivePresentation().getSelection();
const currentPage = selection.getCurrentPage();
const selectionType = selection.getSelectionType();

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getCurrentPage()PageMenampilkan Page atau null yang saat ini aktif jika tidak ada halaman yang aktif.
getPageElementRange()PageElementRangeMenampilkan koleksi PageElementRange instance PageElement yang dipilih atau null jika tidak ada instance PageElement yang dipilih.
getPageRange()PageRangeMenampilkan PageRange kumpulan instance Page di flimstrip yang dipilih atau null jika pilihannya bukan dari jenis SelectionType.PAGE.
getSelectionType()SelectionTypeMenampilkan SelectionType.
getTableCellRange()TableCellRangeMenampilkan koleksi TableCellRange instance TableCell yang dipilih atau null jika tidak ada instance TableCell yang dipilih.
getTextRange()TextRangeMenampilkan TextRange yang dipilih atau null jika pilihannya bukan dari jenis SelectionType.TEXT.

Dokumentasi mendetail

getCurrentPage()

Menampilkan Page atau null yang saat ini aktif jika tidak ada halaman yang aktif.

const selection = SlidesApp.getActivePresentation().getSelection();
const currentPage = selection.getCurrentPage();
if (currentPage != null) {
  Logger.log(`Selected current active page ID: ${currentPage.getObjectId()}`);
}

Pulang pergi

Page

Otorisasi

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

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

getPageElementRange()

Menampilkan koleksi PageElementRange instance PageElement yang dipilih atau null jika tidak ada instance PageElement yang dipilih.

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.PAGE_ELEMENT) {
  const currentPage = selection.getCurrentPage();
  const pageElements = selection.getPageElementRange().getPageElements();
  Logger.log(`Number of page elements selected: ${pageElements.length}`);
}

Pulang pergi

PageElementRange

Otorisasi

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

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

getPageRange()

Menampilkan PageRange kumpulan instance Page di flimstrip yang dipilih atau null jika pilihannya bukan dari jenis SelectionType.PAGE.

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.PAGE) {
  const pageRange = selection.getPageRange();
  Logger.log(
      `Number of pages in the flimstrip selected: ${
          pageRange.getPages().length}`,
  );
}

Pulang pergi

PageRange

Otorisasi

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

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

getSelectionType()

Menampilkan SelectionType.

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.CURRENT_PAGE) {
  const currentPage = selection.getCurrentPage();
  Logger.log(`Selected current active page ID: ${currentPage.getObjectId()}`);
}

Pulang pergi

SelectionType

Otorisasi

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

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

getTableCellRange()

Menampilkan koleksi TableCellRange instance TableCell yang dipilih atau null jika tidak ada instance TableCell yang dipilih.

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.TABLE_CELL) {
  const currentPage = selection.getCurrentPage();
  const tableCells = selection.getTableCellRange().getTableCells();
  const table = tableCells[0].getParentTable();
  Logger.log(`Number of table cells selected: ${tableCells.length}`);
}

Pulang pergi

TableCellRange

Otorisasi

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

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

getTextRange()

Menampilkan TextRange yang dipilih atau null jika pilihannya bukan dari jenis SelectionType.TEXT.

TextRange mewakili dua skenario:

1. Rentang teks yang dipilih. Misalnya, jika bentuk memiliki teks "Halo", dan "Dia" dipilih, rentang yang ditampilkan memiliki TextRange.getStartIndex() = 0, dan TextRange.getEndIndex() = 2.

2. Posisi kursor. Misalnya, jika bentuk memiliki teks "Halo", dan kursor berada setelah "H", ("H|ello"), rentang yang ditampilkan memiliki TextRange.getStartIndex() = 1 dan TextRange.getEndIndex() = 1.

const selection = SlidesApp.getActivePresentation().getSelection();
const selectionType = selection.getSelectionType();
if (selectionType === SlidesApp.SelectionType.TEXT) {
  const currentPage = selection.getCurrentPage();
  const pageElement = selection.getPageElementRange().getPageElements()[0];
  const textRange = selection.getTextRange();
  Logger.log(`Text selected: ${textRange.asString()}`);
}

Pulang pergi

TextRange

Otorisasi

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

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