Class Browser

مرورگر

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

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

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

خواص

اموال تایپ کنید توضیحات
Buttons Button Set

روش ها

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

مستندات دقیق

input Box(prompt)

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

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

input Box(prompt, buttons)

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

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

input Box(title, prompt, buttons)

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

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

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

پارامترها

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

بازگشت

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

مجوز

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

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

msg Box(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

msg Box(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 Button Set نوع دکمه تنظیم شده برای استفاده.

بازگشت

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

مجوز

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

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

msg Box(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 Button Set نوع دکمه تنظیم شده برای استفاده.

بازگشت

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

مجوز

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

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