Class Selection

Wybór

Wybór użytkownika w aktywnej prezentacji.

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

Metody

MetodaZwracany typKrótki opis
getCurrentPage()PageZwraca obecnie aktywną funkcję Page lub null, jeśli nie ma żadnej aktywnej strony.
getPageElementRange()PageElementRangeZwraca kolekcję PageElementRange dla PageElement instancji, które są wybrano lub null, jeśli nie wybrano PageElement instancji.
getPageRange()PageRangeZwraca PageRange zbiór Page instancji w pasku bocznym, które są wybrano lub null, jeśli wybór nie jest typu SelectionType.PAGE.
getSelectionType()SelectionTypeZwraca SelectionType.
getTableCellRange()TableCellRangeZwraca kolekcję TableCellRange z TableCell wybranych instancji lub null, jeśli nie wybrano TableCell instancji.
getTextRange()TextRangeZwraca wybraną wartość TextRange lub null, jeśli wybór nie jest typu SelectionType.TEXT

Szczegółowa dokumentacja

getCurrentPage()

Zwraca obecnie aktywną funkcję Page lub null, jeśli nie ma żadnej aktywnej strony.

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

Powrót

Page

Autoryzacja

Skrypty korzystające 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 dla PageElement instancji, które są wybrano lub null, jeśli nie wybrano PageElement instancji.

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

Powrót

PageElementRange

Autoryzacja

Skrypty korzystające 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 w pasku bocznym, które są wybrano lub null, jeśli wybór nie jest typu SelectionType.PAGE.

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

Powrót

PageRange

Autoryzacja

Skrypty korzystające 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.

var selection = SlidesApp.getActivePresentation().getSelection();
var selectionType = selection.getSelectionType();
if (selectionType == SlidesApp.SelectionType.CURRENT_PAGE) {
  var 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 co najmniej jednym z tych zakresów:

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

getTableCellRange()

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

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

Powrót

TableCellRange

Autoryzacja

Skrypty korzystające 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 wybraną wartość TextRange lub null, jeśli wybór nie jest typu SelectionType.TEXT

TextRange obejmuje 2 scenariusze:

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

2. Pozycja kursora. Jeśli np. kształt zawiera tekst „Cześć”, a kursor jest za „H”, („H|ello”) zwrócony zakres ma TextRange.getStartIndex() = 1 i TextRange.getEndIndex() = 1.

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

Powrót

TextRange

Autoryzacja

Skrypty korzystające 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