Class Browser

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المتصفح

يوفّر هذا الصف إمكانية الوصول إلى مربعات الحوار الخاصة بتطبيق "جداول بيانات Google".

الطرق المتاحة في هذا الصف متاحة للاستخدام في سياق جدول بيانات Google فقط. يُرجى استخدام مربعات حوار Google Workspace بدلاً من ذلك.

راجع أيضًا

أماكن إقامة

الخاصيةالنوعالوصف
ButtonsButtonSet

الطُرق

الطريقةنوع الإرجاعوصف قصير
inputBox(prompt)Stringينبثق مربع حوار يتضمن مربع إدخال نص في متصفح المستخدم.
inputBox(prompt, buttons)Stringينبثق مربع حوار يتضمن مربع إدخال نص في متصفح المستخدم.
inputBox(title, prompt, buttons)Stringينبثق مربع حوار يتضمن مربع إدخال نص في متصفح المستخدم.
msgBox(prompt)Stringينبثق مربع حوار يتضمن الرسالة المحددة وزر "حسنًا" في متصفح المستخدم.
msgBox(prompt, buttons)Stringفتح مربع حوار يتضمن الرسالة المحددة وأزرار محددة في متصفح المستخدم.
msgBox(title, prompt, buttons)Stringينبثق مربع حوار يتضمن عنوانًا معيّنًا ورسالة وأزرار محددة في متصفح المستخدم.

المستندات التفصيلية

inputBox(prompt)

ينبثق مربع حوار يتضمن مربع إدخال نص في متصفح المستخدم.

يرفع أسلوب الإدخالBox مربّع إدخال من جهة العميل يعرض الطلب المحدَّد للمستخدم. وتجدر الإشارة إلى أن هذه الدالة تؤدي إلى تعليق النص البرمجي من جهة الخادم. ويتم استئناف الحالة تلقائيًا بعد محو المستخدم لمربّع الحوار، ولكن لا تستمر اتصالات 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');
لا يُنصح باستخدام هذه الطريقة. وبدلاً من ذلك، استخدِم رسالة مطالبة لواجهة المستخدم.

المعلّمات

الاسمالنوعالوصف
promptStringسيتم عرض النص في مربع الحوار.

تذكرة ذهاب وعودة

String — النص الذي أدخله المستخدم (أو 'cancel' لمربع حوار تم إلغاؤه أو رفضه).

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

inputBox(prompt, buttons)

ينبثق مربع حوار يتضمن مربع إدخال نص في متصفح المستخدم.

يرفع أسلوب الإدخالBox مربّع إدخال من جهة العميل يعرِض المطالبة المحدَّدة للمستخدم، ويعرض مجموعة من الأزرار ليتم عرضها. تجدر الإشارة إلى أن هذه الدالة تتسبب في تعليق النص البرمجي من جهة الخادم. ويتم استئنافها تلقائيًا بعد محو المستخدم لمربّع الحوار، ولكن لا تستمر اتصالات 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);
لا يُنصح باستخدام هذه الطريقة. وبدلاً من ذلك، استخدِم رسالة مطالبة لواجهة المستخدم.

المعلّمات

الاسمالنوعالوصف
promptStringسيتم عرض النص في مربع الحوار.
buttonsButtonSetنوع الزر الذي تم ضبطه للاستخدام.

تذكرة ذهاب وعودة

String — النص الذي أدخله المستخدم (أو 'cancel' لمربع حوار تم إلغاؤه أو رفضه).

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

inputBox(title, prompt, buttons)

ينبثق مربع حوار يتضمن مربع إدخال نص في متصفح المستخدم.

يرفع أسلوب الإدخالBox مربّع إدخال من جهة العميل مع العنوان المحدّد، والذي يعرض المطالبة التي تم تقديمها للمستخدم ويعرض مجموعة من الأزرار ليتم عرضها. لاحظ أن هذه الدالة تؤدي إلى تعليق النص البرمجي من جهة الخادم. ويتم استئنافها تلقائيًا بعد أن يمحو المستخدم مربع الحوار، ولكن لا تستمر اتصالات 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);
لا يُنصح باستخدام هذه الطريقة. وبدلاً من ذلك، استخدِم رسالة مطالبة لواجهة المستخدم.

المعلّمات

الاسمالنوعالوصف
titleStringعنوان مربع الحوار.
promptStringسيتم عرض النص في مربع الحوار.
buttonsButtonSetنوع الزر الذي تم ضبطه للاستخدام.

تذكرة ذهاب وعودة

String — النص الذي أدخله المستخدم (أو 'cancel' لمربع حوار تم إلغاؤه أو رفضه).

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

msgBox(prompt)

ينبثق مربع حوار يتضمن الرسالة المحددة وزر "حسنًا" في متصفح المستخدم.

تعرض طريقة msgBox مربّع رسالة من جهة العميل يعرض الرسالة المحدّدة للمستخدم. تجدر الإشارة إلى أن هذه الطريقة تؤدي إلى تعليق النص البرمجي من جهة الخادم. ويتم استئناف الحالة تلقائيًا بعد محو المستخدم لمربّع الحوار، ولكن لا تستمر اتصالات JDBC في التعليق.

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');
لا يُنصح باستخدام هذه الطريقة. وبدلاً من ذلك، استخدِم مربّع حوار تنبيه واجهة مستخدم.

المعلّمات

الاسمالنوعالوصف
promptStringسيتم عرض النص في مربع الحوار.

تذكرة ذهاب وعودة

String — نص أحرف صغيرة للزر الذي نقر عليه المستخدم (أو 'cancel' لمربّع حوار مرفوض).

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • 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);
لا يُنصح باستخدام هذه الطريقة. وبدلاً من ذلك، استخدِم مربّع حوار تنبيه واجهة مستخدم.

المعلّمات

الاسمالنوعالوصف
promptStringسيتم عرض النص في مربع الحوار.
buttonsButtonSetنوع الزر الذي تم ضبطه للاستخدام.

تذكرة ذهاب وعودة

String — نص أحرف صغيرة للزر الذي نقر عليه المستخدم (أو 'cancel' لمربّع حوار مرفوض).

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • 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);
لا يُنصح باستخدام هذه الطريقة. وبدلاً من ذلك، استخدِم مربّع حوار تنبيه واجهة مستخدم.

المعلّمات

الاسمالنوعالوصف
titleStringعنوان مربع الحوار.
promptStringسيتم عرض النص في مربع الحوار.
buttonsButtonSetنوع الزر الذي تم ضبطه للاستخدام.

تذكرة ذهاب وعودة

String — نص أحرف صغيرة للزر الذي نقر عليه المستخدم (أو 'cancel' لمربّع حوار مرفوض).

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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