Class Selection

Wybór

Wybór użytkownika w aktywnej prezentacji.

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

Metody

Metoda	Zwracany typ	Krótki opis
getCurrentPage()	Page	Zwraca aktualnie aktywną stronę Page lub null, jeśli nie ma aktywnej strony.
getPageElementRange()	PageElementRange	Zwraca kolekcję PageElementRange instancji PageElement, które zostały wybrane, lub null, jeśli nie wybrano żadnych instancji PageElement.
getPageRange()	PageRange	Zwraca PageRange zbiór Page instancji na taśmie filmowej, które są wybrane, lub null, jeśli wybrane elementy nie są typu SelectionType.PAGE.
getSelectionType()	SelectionType	Zwraca SelectionType.
getTableCellRange()	TableCellRange	Zwraca kolekcję TableCellRange wybranych instancji TableCell lub null, jeśli nie wybrano żadnych instancji TableCell.
getTextRange()	TextRange	Zwraca wybrany element TextRange lub null, jeśli wybrany element nie jest typu SelectionType.TEXT.

Szczegółowa dokumentacja

getCurrentPage()

Zwraca aktualnie aktywną stronę Page lub null, jeśli nie ma aktywnej strony.

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

Powrót

Page

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getPageElementRange()

Zwraca kolekcję PageElementRange instancji PageElement, które zostały wybrane, lub null, jeśli nie wybrano żadnych instancji PageElement.

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

Powrót

PageElementRange

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getPageRange()

Zwraca PageRange zbiór Page instancji na taśmie filmowej, które są wybrane, lub null, jeśli wybrane elementy nie są typu 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}`,
  );
}

Powrót

PageRange

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getSelectionType()

Zwraca 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()}`);
}

Powrót

SelectionType

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getTableCellRange()

Zwraca kolekcję TableCellRange wybranych instancji TableCell lub null, jeśli nie wybrano żadnych instancji TableCell.

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

Powrót

TableCellRange

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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

---

getTextRange()

Zwraca wybrany element TextRange lub null, jeśli wybrany element nie jest typu SelectionType.TEXT.

TextRange oznacza 2 sytuacje:

1. Zaznaczony zakres tekstu. Jeśli na przykład kształt ma tekst „Witaj” i jest wybrany „Wi”, zwracany zakres ma TextRange.getStartIndex() = 0, a TextRange.getEndIndex() = 2.

2. Pozycja kursora. Jeśli na przykład kształt zawiera tekst „Cześć”, a kursor znajduje się za „C” (w „C|esze”), zwracany zakres ma wartość TextRange.getStartIndex() = 1 i 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()}`);
}

Powrót

TextRange

Autoryzacja

Skrypty, które korzystają z tej metody, wymagają autoryzacji z co najmniej jednym z tych zakresów:

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