انتخاب همان چیزی است که در حال حاضر در یک صفحه ارائه باز انتخاب شده است، مانند گستره ای از متن برجسته یا جدول. این راهنما به شما می گوید که چگونه می توانید انتخاب را در یک ارائه فعال با استفاده از Apps Script دریافت و تنظیم کنید.
انتخاب تصویری است از آنچه در زمان شروع فیلمنامه بود. اگر کاربر کلیک کند و انتخاب تغییر کند در حالی که اسکریپت در حال اجرا است، آن تغییرات منعکس نخواهند شد.
انتخاب ها و نوع انتخاب
با استفاده از کلاس Selection می توانید انتخاب را بخوانید. کلاس متدهای مختلفی برای بدست آوردن اشیاء انتخاب شده بر اساس نوع شی(های) انتخاب شده دارد.
شماره SelectionType نوع خاصی از اشیاء انتخاب شده را نشان می دهد. به عنوان مثال، اگر کاربر متنی را در یک شکل انتخاب کرده باشد، نوع انتخاب TEXT خواهد بود. در این حالت می توانید محدوده متن انتخاب شده را با استفاده از متد selection.getTextRange()
بازیابی کنید.
شما همچنین می توانید شیء حاوی انتخاب را بازیابی کنید. در ادامه مثال بالا، می توانید شکل حاوی متن انتخاب شده را با استفاده از selection.getPageElementRange().getPageElements()[0]
بازیابی کنید. به طور مشابه، صفحه ای که حاوی شکل محصور است، صفحه فعال فعلی است. برای بازیابی آن صفحه، از selection.getCurrentPage()
استفاده کنید.
خواندن منتخب
برای خواندن انتخاب، از متد Presentation.getSelection() همانطور که در مثال زیر نشان داده شده است استفاده کنید:
خواندن صفحه فعلی
برای بازیابی صفحه فعلی که کاربر در حال مشاهده آن است، از متدهای getSelection() و getCurrentPage() به صورت زیر استفاده کنید:
توجه داشته باشید که صفحه فعلی ممکن است یکی از انواع زیر باشد:
صفحه فعلی می تواند یک یا چند شی انتخاب شده داشته باشد و SelectionType نوع انتخاب را تعیین می کند.
خواندن انتخاب بر اساس نوع انتخاب
مثال زیر نشان می دهد که چگونه می توانید از نوع انتخاب برای خواندن انتخاب فعلی به روشی مناسب استفاده کنید.
خواندن متن انتخاب شده
می توانید متن انتخابی را با استفاده از متد Selection.getTextRange() بخوانید. دو نوع انتخاب متن وجود دارد:
- انتخاب محدوده : اگر شکلی حاوی متن "Hello" باشد و "He" انتخاب شده باشد، محدوده بازگشتی startIndex=0 و endIndex=2 دارد.
- انتخاب مکان نما : اگر شکلی حاوی متن "Hello" باشد و مکان نما بعد از "H" ("H|ello") باشد، محدوده بازگشتی محدوده خالی با startIndex=1 و endIndex=1 است.
اصلاح انتخاب
اسکریپت می تواند انتخاب کاربر را تغییر دهد. هر گونه تغییر انتخابی که اسکریپت در ارائه ایجاد می کند در عملیات انتخاب بعدی در طول مدت اجرای اسکریپت منعکس می شود.
تغییرات انتخابی تنها پس از اتمام اجرای اسکریپت یا زمانی که Presentation.saveAndClose()
فراخوانی شود، در مرورگر کاربر منعکس می شود.
انتخاب صفحه فعلی
با فراخوانی متد ()selectAsCurrentPage می توان یک صفحه در ارائه فعال را به عنوان صفحه فعلی انتخاب کرد. این روش هر عنصر صفحه، صفحه یا انتخاب متن قبلی را حذف می کند. بنابراین استفاده از این روش در صفحه فعلی به شما این امکان را می دهد که انتخاب های فعلی در صفحه را لغو انتخاب کنید. به عنوان مثال:
انتخاب عنصر صفحه
برای انتخاب یک عنصر صفحه در یک صفحه، از متد PageElement.select() استفاده کنید. با این کار هر عنصر صفحه که قبلا انتخاب شده بود، لغو انتخاب می شود.
به عنوان مثال:
انتخاب چندین عنصر صفحه
برای اضافه کردن عناصر صفحه اضافی به انتخاب، از روش PageElement.select(false) استفاده کنید. همه عناصر صفحه باید در صفحه فعلی باشند.
دگرگونی انتخاب
ویرایش هایی که اسکریپت شما انجام می دهد می تواند انتخاب فعلی را تغییر دهد ، به طوری که آنچه انتخاب شده در نتیجه ویرایش تغییر کند. به عنوان مثال:
- فرض کنید دو شکل A و B را انتخاب کرده اید.
- سپس اسکریپت شما شکل A را حذف می کند.
- در نتیجه، انتخاب در برابر ویرایش تغییر شکل میدهد تا فقط شکل B انتخاب شود.
مثال زیر نشان می دهد که چگونه می توان با دستکاری عناصر صفحه انتخاب شده، انتخاب را تغییر داد.
انتخاب متن
متن موجود در یک شکل یا یک سلول جدول را می توان با استفاده از متد ()TextRange.select انتخاب کرد. اگر متن در یک شکل باشد، آن شکل نیز انتخاب می شود. اگر متن در یک سلول جدول باشد، آن سلول جدول و جدول احاطه کننده آن هر دو انتخاب می شوند.
این همچنین صفحه والد را به عنوان صفحه فعلی تنظیم می کند.
انتخاب محدوده در یک شکل
مثال زیر نحوه انتخاب محدوده را در متن موجود در یک شکل نشان می دهد.
انتخاب مکان نما در یک شکل
مثال زیر نحوه انتخاب مکان نما را در متن موجود در یک شکل نشان می دهد.
انتخاب محدوده در سلول جدول
مثال زیر نحوه انتخاب محدوده را در متن موجود در سلول جدول نشان می دهد.
انتخاب مکان نما در TableCell
مثال زیر نحوه انتخاب مکان نما را در متن موجود در سلول جدول نشان می دهد.
دگرگونی انتخاب با ویرایش های متنی
مثال زیر نشان می دهد که چگونه می توان انتخاب را با ویرایش متن انتخاب شده تغییر داد.
لغو انتخاب
هیچ روش صریحی برای لغو انتخاب متن یا عناصر صفحه وجود ندارد. با این حال، این نتیجه را می توان با استفاده از متدهای Page.selectAsCurrentPage()
یا pageElement.select()
بدست آورد.
یک صفحه فعلی را انتخاب کنید
مثال زیر نشان می دهد که چگونه می توان با تنظیم آن صفحه به عنوان صفحه فعلی، انتخاب های فعلی را در یک صفحه لغو انتخاب کرد.
یک عنصر صفحه را انتخاب کنید
مثال زیر نشان می دهد که چگونه می توان با انتخاب یک عنصر صفحه، انتخاب های فعلی را در یک صفحه لغو انتخاب کرد، بنابراین همه موارد دیگر را از انتخاب حذف کرد.