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