این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class Selection

انتخاب کاربر در ارائه فعال.

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

روش ها

روش	نوع برگشت	شرح مختصر
`get Current Page()`	`Page`	`Page` فعال فعلی را برمی‌گرداند یا اگر صفحه فعالی وجود نداشته باشد، `null` برمی‌گرداند.
`get Page Element Range()`	`Page Element Range`	مجموعه `Page Element Range` از نمونه‌های `Page Element` را برمی‌گرداند که اگر نمونه‌ای `Page Element` انتخاب نشده باشد، انتخاب شده یا `null` .
`get Page Range()`	`Page Range`	`Page Range` مجموعه‌ای از نمونه‌های `Page` را در نوار نواری برمی‌گرداند که اگر انتخاب از نوع `Selection Type.PAGE` نباشد، انتخاب شده یا `null` است.
`get Selection Type()`	`Selection Type`	`Selection Type` را برمی‌گرداند.
`get Table Cell Range()`	`Table Cell Range`	مجموعه `Table Cell Range` از نمونه‌های `Table Cell` را برمی‌گرداند که در صورت انتخاب هیچ نمونه `Table Cell` انتخاب شده یا `null` هستند.
`get Text Range()`	`Text Range`	اگر انتخاب از نوع `Selection Type.TEXT` نباشد، `Text Range` انتخاب شده یا `null` را برمی‌گرداند.

مستندات دقیق

`get Current Page()`

Page فعال فعلی را برمی‌گرداند یا اگر صفحه فعالی وجود نداشته باشد، null برمی‌گرداند.

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

بازگشت

Page

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`get Page Element Range()`

مجموعه Page Element Range از نمونه‌های Page Element را برمی‌گرداند که اگر نمونه‌ای Page Element انتخاب نشده باشد، انتخاب شده یا null .

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

بازگشت

Page Element Range

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`get Page Range()`

Page Range مجموعه‌ای از نمونه‌های Page را در نوار نواری برمی‌گرداند که اگر انتخاب از نوع Selection Type.PAGE نباشد، انتخاب شده یا null است.

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

بازگشت

Page Range

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`get Selection Type()`

Selection Type را برمی‌گرداند.

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

بازگشت

Selection Type

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`get Table Cell Range()`

مجموعه Table Cell Range از نمونه‌های Table Cell را برمی‌گرداند که در صورت انتخاب هیچ نمونه Table Cell انتخاب شده یا null هستند.

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

بازگشت

Table Cell Range

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

`get Text Range()`

اگر انتخاب از نوع Selection Type.TEXT نباشد، Text Range انتخاب شده یا null را برمی‌گرداند.

Text Range دو سناریو را نشان می دهد:

1. محدوده متن انتخاب شده است. به عنوان مثال اگر شکلی دارای متن "Hello" باشد و "He" انتخاب شده باشد، محدوده بازگشتی دارای Text Range.getStartIndex() = 0 و Text Range.getEndIndex() = 2 است.

2. موقعیت مکان نما. به عنوان مثال، اگر شکلی دارای متن "Hello" باشد، و مکان نما بعد از "H"، ("H|ello")، محدوده بازگشتی دارای Text Range.getStartIndex() = 1 و Text Range.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()}`);
}

بازگشت

Text Range

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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