Class Selection

Seçim

Kullanıcının etkin sunudaki seçimi.

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

Yöntemler

YöntemDönüş türüKısa açıklama
getCurrentPage()PageEtkin sayfa yoksa şu anda etkin olan Page veya null değerini döndürür.
getPageElementRange()PageElementRangeSeçilen PageElement örneklerini içeren PageElementRange koleksiyonunu veya seçili PageElement örneği yoksa null değerini döndürür.
getPageRange()PageRangeFilm şeridinde seçili olan Page örneklerini içeren PageRange koleksiyonunu veya seçim SelectionType.PAGE türünde değilse null değerini döndürür.
getSelectionType()SelectionTypeSelectionType değerini döndürür.
getTableCellRange()TableCellRangeSeçilen TableCell örnekleri TableCellRange koleksiyonunu veya seçili TableCell örneği yoksa null değerini döndürür.
getTextRange()TextRangeSeçili TextRange değerini veya seçim SelectionType.TEXT türünde değilse null değerini döndürür.

Ayrıntılı dokümanlar

getCurrentPage()

Etkin sayfa yoksa şu anda etkin olan Page veya null değerini döndürür.

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

Return

Page

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getPageElementRange()

Seçilen PageElement örneklerini içeren PageElementRange koleksiyonunu veya seçili PageElement örneği yoksa null değerini döndürür.

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

Return

PageElementRange

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getPageRange()

Film şeridinde seçili olan Page örneklerini içeren PageRange koleksiyonunu veya seçim SelectionType.PAGE türünde değilse null değerini döndürür.

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

Return

PageRange

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getSelectionType()

SelectionType değerini döndürür.

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

Return

SelectionType

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getTableCellRange()

Seçilen TableCell örnekleri TableCellRange koleksiyonunu veya seçili TableCell örneği yoksa null değerini döndürür.

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

Return

TableCellRange

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

getTextRange()

Seçili TextRange değerini veya seçim SelectionType.TEXT türünde değilse null değerini döndürür.

TextRange iki senaryoyu temsil eder:

1. Seçilen metin aralığı. Örneğin, bir şekilde "Merhaba" metni varsa ve "O" seçilirse döndürülen aralık TextRange.getStartIndex() = 0 ve TextRange.getEndIndex() = 2 değerini alır.

2. İmleç konumu. Örneğin, bir şekilde "Merhaba" metni varsa ve imleç "H"den sonraysa ("H|ello"), döndürülen aralık TextRange.getStartIndex() = 1 ve TextRange.getEndIndex() = 1 değerini içerir.

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

Return

TextRange

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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