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

MetodaZwracany typKrótki opis
getCurrentPage()PageZwraca aktualnie aktywną stronę Page lub null, jeśli nie ma aktywnej strony.
getPageElementRange()PageElementRangeZwraca kolekcję PageElementRange instancji PageElement, które zostały wybrane, lub null, jeśli nie wybrano żadnych instancji PageElement.
getPageRange()PageRangeZwraca 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()SelectionTypeZwraca SelectionType.
getTableCellRange()TableCellRangeZwraca kolekcję TableCellRange wybranych instancji TableCell lub null, jeśli nie wybrano żadnych instancji TableCell.
getTextRange()TextRangeZwraca 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