Class Browser

مرورگر

این کلاس دسترسی به کادرهای محاوره‌ای مخصوص Google Sheets را فراهم می‌کند.

روش‌های این کلاس فقط برای استفاده در زمینه صفحه‌گسترده Google در دسترس هستند. لطفاً به جای آن از گفتگوهای Google Workspace استفاده کنید.

همچنین ببینید

خواص

ویژگی تایپ کنید شرح
Buttons ButtonSet

مواد و روش ها

روش نوع برگشت توضیح مختصر
inputBox(prompt) String یک کادر محاوره ای با کادر ورودی متن در مرورگر کاربر ظاهر می شود.
inputBox(prompt, buttons) String یک کادر محاوره ای با کادر ورودی متن در مرورگر کاربر ظاهر می شود.
inputBox(title, prompt, buttons) String یک کادر محاوره ای با کادر ورودی متن در مرورگر کاربر ظاهر می شود.
msgBox(prompt) String یک کادر محاوره ای با پیام داده شده و یک دکمه OK در مرورگر کاربر ظاهر می شود.
msgBox(prompt, buttons) String یک کادر محاوره ای با پیام داده شده و دکمه های مشخص شده در مرورگر کاربر ظاهر می شود.
msgBox(title, prompt, buttons) String یک کادر محاوره ای با عنوان، پیام و دکمه های مشخص شده در مرورگر کاربر ظاهر می شود.

مستندات دقیق

inputBox(prompt)

یک کادر محاوره ای با کادر ورودی متن در مرورگر کاربر ظاهر می شود.

روش inputBox یک جعبه ورودی سمت سرویس گیرنده را ایجاد می کند که دستور داده شده را به کاربر نمایش می دهد. توجه داشته باشید که این تابع باعث تعلیق اسکریپت سمت سرور می شود. پس از پاک کردن گفتگو توسط کاربر، به طور خودکار از سر گرفته می شود، اما اتصالات JDBC در سراسر تعلیق ادامه نمی یابد.

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('Enter your name');
این روش توصیه نمی شود. در عوض، از یک درخواست رابط کاربری استفاده کنید.

مولفه های

نام تایپ کنید شرح
prompt String متنی که در کادر محاوره ای نمایش داده می شود.

برگشت

String - متن وارد شده توسط کاربر (یا "لغو" برای گفتگوی لغو شده یا رد شده).

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

inputBox(prompt, buttons)

یک کادر محاوره ای با کادر ورودی متن در مرورگر کاربر ظاهر می شود.

روش inputBox یک جعبه ورودی سمت سرویس گیرنده را ایجاد می کند که اعلان داده شده را به کاربر نمایش می دهد و گزینه ای از دکمه ها را برای نمایش ارائه می دهد. توجه داشته باشید که این تابع باعث تعلیق اسکریپت سمت سرور می شود. پس از پاک کردن گفتگو توسط کاربر، به طور خودکار از سر گرفته می شود، اما اتصالات JDBC در سراسر تعلیق ادامه نمی یابد.

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);
این روش توصیه نمی شود. در عوض، از یک درخواست رابط کاربری استفاده کنید.

مولفه های

نام تایپ کنید شرح
prompt String متنی که در کادر محاوره ای نمایش داده می شود.
buttons ButtonSet نوع دکمه تنظیم شده برای استفاده.

برگشت

String - متن وارد شده توسط کاربر (یا "لغو" برای گفتگوی لغو شده یا رد شده).

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

inputBox(title, prompt, buttons)

یک کادر محاوره ای با کادر ورودی متن در مرورگر کاربر ظاهر می شود.

روش inputBox یک کادر ورودی سمت کلاینت را با عنوان داده شده بالا می‌برد، که دستور داده شده را به کاربر نمایش می‌دهد و گزینه‌ای از دکمه‌ها را برای نمایش ارائه می‌دهد. توجه داشته باشید که این تابع باعث تعلیق اسکریپت سمت سرور می شود. پس از پاک کردن گفتگو توسط کاربر، به طور خودکار از سر گرفته می شود، اما اتصالات JDBC در سراسر تعلیق ادامه نمی یابد.

// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('ID Check', 'Enter your name', Browser.Buttons.OK_CANCEL);
این روش توصیه نمی شود. در عوض، از یک درخواست رابط کاربری استفاده کنید.

مولفه های

نام تایپ کنید شرح
title String عنوان کادر محاوره ای
prompt String متنی که در کادر محاوره ای نمایش داده می شود.
buttons ButtonSet نوع دکمه تنظیم شده برای استفاده.

برگشت

String - متن وارد شده توسط کاربر (یا "لغو" برای گفتگوی لغو شده یا رد شده).

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

msgBox(prompt)

یک کادر محاوره ای با پیام داده شده و یک دکمه OK در مرورگر کاربر ظاهر می شود.

روش msgBox یک جعبه پیام سمت سرویس گیرنده را ایجاد می کند که پیام داده شده را به کاربر نمایش می دهد. توجه داشته باشید که این روش باعث تعلیق اسکریپت سمت سرور می شود. پس از پاک کردن گفتگو توسط کاربر، به طور خودکار از سر گرفته می شود، اما اتصالات JDBC در سراسر تعلیق ادامه نمی یابد.

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');
این روش توصیه نمی شود. در عوض، از یک گفتگوی هشدار رابط کاربری استفاده کنید.

مولفه های

نام تایپ کنید شرح
prompt String متنی که در کادر محاوره ای نمایش داده می شود.

برگشت

String - متن کوچک دکمه ای که کاربر روی آن کلیک می کند (یا «لغو» برای گفتگوی رد شده).

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

msgBox(prompt, buttons)

یک کادر محاوره ای با پیام داده شده و دکمه های مشخص شده در مرورگر کاربر ظاهر می شود.

روش msgBox یک جعبه پیام سمت سرویس گیرنده را ایجاد می کند که پیام داده شده را به کاربر نمایش می دهد و انتخابی از دکمه ها را برای نمایش ارائه می دهد. توجه داشته باشید که این روش باعث تعلیق اسکریپت سمت سرور می شود. پس از پاک کردن گفتگو توسط کاربر، به طور خودکار از سر گرفته می شود، اما اتصالات JDBC در سراسر تعلیق ادامه نمی یابد.

// The code below displays "hello world" in a dialog box with OK and Cancel buttons.
Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);
این روش توصیه نمی شود. در عوض، از یک گفتگوی هشدار رابط کاربری استفاده کنید.

مولفه های

نام تایپ کنید شرح
prompt String متنی که در کادر محاوره ای نمایش داده می شود.
buttons ButtonSet نوع دکمه تنظیم شده برای استفاده.

برگشت

String - متن کوچک دکمه ای که کاربر روی آن کلیک می کند (یا «لغو» برای گفتگوی رد شده).

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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

msgBox(title, prompt, buttons)

یک کادر محاوره ای با عنوان، پیام و دکمه های مشخص شده در مرورگر کاربر ظاهر می شود.

روش msgBox یک جعبه پیام سمت سرویس گیرنده با عنوان داده شده را ایجاد می کند که پیام داده شده را به کاربر نمایش می دهد و گزینه ای از دکمه ها را برای نمایش ارائه می دهد. توجه داشته باشید که این روش باعث تعلیق اسکریپت سمت سرور می شود. پس از پاک کردن گفتگو توسط کاربر، به طور خودکار از سر گرفته می شود، اما اتصالات JDBC در سراسر تعلیق ادامه نمی یابد.

// The code below displays "hello world" in a dialog box with a custom title and Yes and
// No buttons
Browser.msgBox('Greetings', 'hello world', Browser.Buttons.YES_NO);
این روش توصیه نمی شود. در عوض، از یک گفتگوی هشدار رابط کاربری استفاده کنید.

مولفه های

نام تایپ کنید شرح
title String عنوان کادر محاوره ای
prompt String متنی که در کادر محاوره ای نمایش داده می شود.
buttons ButtonSet نوع دکمه تنظیم شده برای استفاده.

برگشت

String - متن کوچک دکمه ای که کاربر روی آن کلیک می کند (یا «لغو» برای گفتگوی رد شده).

مجوز

اسکریپت هایی که از این روش استفاده می کنند نیاز به مجوز با یک یا چند مورد از حوزه های زیر دارند:

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