تمت ترجمة هذه الصفحة بواسطة 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)`

تنشئ نافذة منبثقة مربّع إدخال نص في متصفّح المستخدم.

تُنشئ طريقة 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

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

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

المعلمات

الاسم	النوع	الوصف
`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'.
const 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)`

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

تُنشئ طريقة 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