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()Page|nullZwraca obecnie aktywny element Page lub null, jeśli nie ma aktywnej strony.
getPageElementRange()PageElementRange|nullZwraca PageElementRange kolekcję PageElement instancji, które są wybrane, lub null, jeśli nie wybrano żadnych instancji PageElement.
getPageRange()PageRange|nullZwraca PageRange kolekcję instancji Page w pasku filmowym, które są wybrane, lub null, jeśli wybór nie jest typu SelectionType.PAGE.
getSelectionType()SelectionTypeZwraca wartość SelectionType.
getTableCellRange()TableCellRange|nullZwraca kolekcję TableCellRange wybranych instancji TableCell lub null, jeśli nie wybrano żadnych instancji TableCell.
getTextRange()TextRange|nullZwraca wybraną wartość TextRange lub null, jeśli wybór nie jest typu SelectionType.TEXT.

Szczegółowa dokumentacja

getCurrentPage()

Zwraca obecnie aktywny element 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|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

getPageElementRange()

Zwraca PageElementRange kolekcję PageElement instancji, które są 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|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

getPageRange()

Zwraca PageRange kolekcję instancji Page w pasku filmowym, które są wybrane, lub null, jeśli wybór nie jest 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|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

getSelectionType()

Zwraca wartość 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 korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego 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|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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

getTextRange()

Zwraca wybraną wartość TextRange lub null, jeśli wybór nie jest typu SelectionType.TEXT.

Symbol TextRange oznacza 2 scenariusze:

1. Zaznaczono zakres tekstu. Jeśli na przykład kształt zawiera tekst „Hello”, a wybrany fragment to „He”, zwrócony zakres ma TextRange.getStartIndex() = 0 i TextRange.getEndIndex() = 2.

2. Pozycja kursora. Jeśli na przykład kształt zawiera tekst „Hello”, a kursor znajduje się po literze „H” („H|ello”), zwrócony zakres ma 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|null

Autoryzacja

Skrypty korzystające z tej metody wymagają autoryzacji z użyciem co najmniej jednego z tych zakresów:

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