Class Browser

المتصفح

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

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

انظر أيضًا

الخصائص

الموقعالنوعالوصف
ButtonsButtonSet

الطُرق

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

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

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

المعلمات

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

الإرجاع

String|null: النص الذي أدخله المستخدم (أو "إلغاء" لمربّع حوار تم إلغاؤه أو إغلاقه).

التفويض

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

  • 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'.
const name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);
لا يُنصح باستخدام هذه الطريقة. يمكنك بدلاً من ذلك استخدام طلب من واجهة المستخدم.

المعلمات

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

الإرجاع

String|null: النص الذي أدخله المستخدم (أو "إلغاء" لمربّع حوار تم إلغاؤه أو إغلاقه).

التفويض

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

  • 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'.
const name = Browser.inputBox(
    'ID Check',
    'Enter your name',
    Browser.Buttons.OK_CANCEL,
);
لا يُنصح باستخدام هذه الطريقة. يمكنك بدلاً من ذلك استخدام طلب من واجهة المستخدم.

المعلمات

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

الإرجاع

String|null: النص الذي أدخله المستخدم (أو "إلغاء" لمربّع حوار تم إلغاؤه أو إغلاقه).

التفويض

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

  • 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|null: النص بالأحرف الصغيرة للزر الذي ينقر عليه المستخدم (أو "إلغاء" لمربع حوار تم إغلاقه).

التفويض

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

  • 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|null: النص بالأحرف الصغيرة للزر الذي ينقر عليه المستخدم (أو "إلغاء" لمربع حوار تم إغلاقه).

التفويض

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

  • 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|null: النص بالأحرف الصغيرة للزر الذي ينقر عليه المستخدم (أو "إلغاء" لمربع حوار تم إغلاقه).

التفويض

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

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