تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class Browser

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

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

راجع أيضًا

ButtonSet

أماكن إقامة

الخاصية	النوع	الوصف
`Buttons`	`ButtonSet`

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`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');

لا يُنصح باستخدام هذه الطريقة. وبدلاً من ذلك، استخدِم رسالة مطالبة لواجهة المستخدم.

المعلّمات

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

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

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);

لا يُنصح باستخدام هذه الطريقة. وبدلاً من ذلك، استخدِم رسالة مطالبة لواجهة المستخدم.

المعلّمات

الاسم	النوع	الوصف
`prompt`	`String`	سيتم عرض النص في مربع الحوار.
`buttons`	`ButtonSet`	نوع الزر الذي تم ضبطه للاستخدام.

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

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);

لا يُنصح باستخدام هذه الطريقة. وبدلاً من ذلك، استخدِم رسالة مطالبة لواجهة المستخدم.

المعلّمات

الاسم	النوع	الوصف
`title`	`String`	عنوان مربع الحوار.
`prompt`	`String`	سيتم عرض النص في مربع الحوار.
`buttons`	`ButtonSet`	نوع الزر الذي تم ضبطه للاستخدام.

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

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');

لا يُنصح باستخدام هذه الطريقة. وبدلاً من ذلك، استخدِم مربّع حوار تنبيه واجهة مستخدم.

المعلّمات

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

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

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);

لا يُنصح باستخدام هذه الطريقة. وبدلاً من ذلك، استخدِم مربّع حوار تنبيه واجهة مستخدم.

المعلّمات

الاسم	النوع	الوصف
`prompt`	`String`	سيتم عرض النص في مربع الحوار.
`buttons`	`ButtonSet`	نوع الزر الذي تم ضبطه للاستخدام.

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

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);

لا يُنصح باستخدام هذه الطريقة. وبدلاً من ذلك، استخدِم مربّع حوار تنبيه واجهة مستخدم.

المعلّمات

الاسم	النوع	الوصف
`title`	`String`	عنوان مربع الحوار.
`prompt`	`String`	سيتم عرض النص في مربع الحوار.
`buttons`	`ButtonSet`	نوع الزر الذي تم ضبطه للاستخدام.

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

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

التفويض

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

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