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 في شريط الأدوات أو 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 في شريط الأدوات أو 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. تم تحديد نطاق النص. على سبيل المثال، إذا كان الشكل يحتوي على النص "مرحبًا" و"هي" المحدد، النطاق المعروض هو TextRange.getStartIndex() = 0، وTextRange.getEndIndex() = 2-

2. موضع المؤشر. على سبيل المثال، إذا كان الشكل يحتوي على النص "مرحبًا"، وكان المؤشر بعد "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