Class Selection

الاختيار

اختيار المستخدم في العرض التقديمي النشط

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

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
getCurrentPage()Pageتعرِض هذه السمة القيمة Page أو null النشطة حاليًا إذا لم تكن هناك صفحة نشطة.
getPageElementRange()PageElementRangeعرض مجموعة PageElementRange من مثيلات PageElement التي تم اختيارها أو null إذا لم يتم اختيار أي مثيلات PageElement
getPageRange()PageRangeتعرِض PageRange مجموعة من عناصر Page في شريط الفيلم التي تم اختيارها أو null إذا لم يكن الاختيار من النوع SelectionType.PAGE.
getSelectionType()SelectionTypeعرض SelectionType
getTableCellRange()TableCellRangeعرض مجموعة TableCellRange من مثيلات TableCell التي تم اختيارها أو null إذا لم يتم اختيار أي مثيلات TableCell
getTextRange()TextRangeتعرِض هذه الدالة العنصر TextRange المحدَّد أو null إذا لم يكن الاختيار من النوع SelectionType.TEXT.

مستندات تفصيلية

getCurrentPage()

تعرِض هذه السمة القيمة 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

getPageElementRange()

عرض مجموعة PageElementRange من مثيلات PageElement التي تم اختيارها أو null إذا لم يتم اختيار أي مثيلات 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}`);
}

الإرجاع

PageElementRange

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

getPageRange()

تعرِض PageRange مجموعة من عناصر Page في شريط الفيلم التي تم اختيارها أو null إذا لم يكن الاختيار من النوع 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}`,
  );
}

الإرجاع

PageRange

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

getSelectionType()

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

الإرجاع

SelectionType

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

getTableCellRange()

عرض مجموعة TableCellRange من مثيلات TableCell التي تم اختيارها أو null إذا لم يتم اختيار أي مثيلات 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}`);
}

الإرجاع

TableCellRange

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

getTextRange()

تعرِض هذه الدالة العنصر TextRange المحدَّد أو null إذا لم يكن الاختيار من النوع SelectionType.TEXT.

يمثّل الرمز TextRange سيناريوهَين:

1. نطاق النص المحدّد على سبيل المثال، إذا كان الشكل يحتوي على النص "مرحبًا"، وتم اختيار "هو"، يكون النطاق المعروض هو TextRange.getStartIndex() = 0 وTextRange.getEndIndex() = 2.

2. موضع المؤشر على سبيل المثال، إذا كان الشكل يحتوي على النص "مرحبًا"، وكان المؤشر بعد "ح"، ("ح|مرحبًا")، يكون للنطاق المعروض القيمة TextRange.getStartIndex() = 1 و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()}`);
}

الإرجاع

TextRange

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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