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

Class Browser

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

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

يمكن أيضًا مراجعة

ButtonSet

أماكن إقامة

الموقع	Type	الوصف
`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');

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

المَعلمات

الاسم	Type	الوصف
`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);

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

المَعلمات

الاسم	Type	الوصف
`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);

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

المَعلمات

الاسم	Type	الوصف
`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');

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

المَعلمات

الاسم	Type	الوصف
`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);

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

المَعلمات

الاسم	Type	الوصف
`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);

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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