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

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

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

التفويض

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

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

`inputBox(prompt, buttons)`

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

تعمل طريقة enterBox على رفع مربع إدخال من جانب العميل يعرض المطالبة المحددة إلى للمستخدم، وتوفر خيارًا للأزرار التي سيتم عرضها. لاحظ أن هذه الدالة تتسبب في سيتم تعليق النص البرمجي من جهة الخادم ويتم استئنافه تلقائيًا بعد أن يمحو المستخدم مربع الحوار، ولكن لا تستمر اتصالات 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 — النص الذي أدخله المستخدم (أو "إلغاء" لمربع حوار تم إلغاؤه أو إغلاقه).

التفويض

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

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

`inputBox(title, prompt, buttons)`

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

تعمل طريقة enterBox على رفع مربع إدخال من جانب العميل بالعنوان المحدد، والذي يعرض يقدم مطالبة للمستخدم، ويوفر خيار الأزرار التي سيتم عرضها. لاحظ أن هذا تعليق النص البرمجي من جانب الخادم. يستأنف التطبيق تلقائيًا بعد أن يبدأ المستخدم محو مربع الحوار، ولكن لا تستمر اتصالات 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 — النص الذي أدخله المستخدم (أو "إلغاء" لمربع حوار تم إلغاؤه أو إغلاقه).

التفويض

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

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