تتيح هذه الفئة الوصول إلى مربّعات الحوار الخاصة بـ "جداول بيانات Google".
لا تتوفّر الطرق في هذه الفئة إلا للاستخدام في سياق "جداول بيانات Google". يُرجى استخدام مربّعات حوار Google Workspace بدلاً من ذلك.
انظر أيضًا
الخصائص
| الموقع | النوع | الوصف |
|---|---|---|
Buttons | Button |
الطُرق
| الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
|---|---|---|
input | String|null | يؤدي إلى ظهور مربّع حوار يتضمّن مربّع إدخال نص في متصفّح المستخدم. |
input | String|null | يؤدي إلى ظهور مربّع حوار يتضمّن مربّع إدخال نص في متصفّح المستخدم. |
input | String|null | يؤدي إلى ظهور مربّع حوار يتضمّن مربّع إدخال نص في متصفّح المستخدم. |
msg | String|null | يؤدي إلى ظهور مربّع حوار يتضمّن الرسالة المحدّدة وزر "حسنًا" في متصفّح المستخدم. |
msg | String|null | يؤدي إلى ظهور مربّع حوار يتضمّن الرسالة المحدّدة والأزرار المحدّدة في متصفّح المستخدم. |
msg | String|null | يفتح مربّع حوار بالعنوان والرسالة والأزرار المحدّدة في متصفّح المستخدم. |
مستندات تفصيلية
input Box(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|null: النص الذي أدخله المستخدم (أو "إلغاء" لمربّع حوار تم إلغاؤه أو إغلاقه).
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
input Box(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 | Button | نوع مجموعة الأزرار المطلوب استخدامها. |
الإرجاع
String|null: النص الذي أدخله المستخدم (أو "إلغاء" لمربّع حوار تم إلغاؤه أو إغلاقه).
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
input Box(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 | Button | نوع مجموعة الأزرار المطلوب استخدامها. |
الإرجاع
String|null: النص الذي أدخله المستخدم (أو "إلغاء" لمربّع حوار تم إلغاؤه أو إغلاقه).
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
msg Box(prompt)
يؤدي إلى ظهور مربّع حوار يتضمّن الرسالة المحدّدة وزر "حسنًا" في متصفّح المستخدم.
تعرض طريقة msgBox مربّع رسالة من جهة العميل يعرض الرسالة المحدّدة للمستخدم. يُرجى العِلم أنّ هذه الطريقة تؤدي إلى تعليق النص البرمجي من جهة الخادم. ويتم استئنافها تلقائيًا بعد أن يغلق المستخدم مربّع الحوار، ولكن لا تستمر اتصالات JDBC بعد التعليق.
// The code below displays "hello world" in a dialog box with an OK button Browser.msgBox('hello world');
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
prompt | String | النص الذي سيتم عرضه في مربّع الحوار |
الإرجاع
String|null: النص بالأحرف الصغيرة للزر الذي ينقر عليه المستخدم (أو "إلغاء" لمربع حوار تم إغلاقه).
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
msg Box(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 | Button | نوع مجموعة الأزرار المطلوب استخدامها. |
الإرجاع
String|null: النص بالأحرف الصغيرة للزر الذي ينقر عليه المستخدم (أو "إلغاء" لمربع حوار تم إغلاقه).
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
msg Box(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 | Button | نوع مجموعة الأزرار المطلوب استخدامها. |
الإرجاع
String|null: النص بالأحرف الصغيرة للزر الذي ينقر عليه المستخدم (أو "إلغاء" لمربع حوار تم إغلاقه).
التفويض
تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets