اختيار المستخدم في العرض التقديمي النشط
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()); }
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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); }
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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); } }
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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()); }
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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); }
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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()); }
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/presentations.currentonly
-
https://www.googleapis.com/auth/presentations