Class Selection

الاختيار

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

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

الطُرق

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

الوثائق التفصيلية

getCurrentPage()

عرض Page أو null النشطة حاليًا إذا لم تكن هناك صفحة نشطة. 

var selection = SlidesApp.getActivePresentation().getSelection();
var 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 مثيلات. 

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

استرجاع الكرة

PageElementRange

التفويض

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

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

getPageRange()

تعرض PageRange مجموعة من Page من المثيلات المحددة في شريط flimstrip أو null إذا لم يكن التحديد من النوع 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);
}
}

استرجاع الكرة

PageRange

التفويض

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

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

getSelectionType()

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

استرجاع الكرة

SelectionType

التفويض

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

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

getTableCellRange()

تعرض مجموعة TableCellRange المكونة من TableCell من الحالات التي تم اختيارها أو null إذا لم يتم اختيار TableCell مثيلات. 

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

استرجاع الكرة

TableCellRange

التفويض

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

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

getTextRange()

تعرض السمة TextRange أو السمة null إذا لم يكن الاختيار من النوع SelectionType.TEXT.

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

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

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

استرجاع الكرة

TextRange

التفويض

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

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