Enum ButtonSet
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
مجموعة الأزرار
فهرس يمثّل مجموعات مُحدَّدة مسبقًا ومُترجَمة من زرّ واحد أو أكثر من أزرار مربّع الحوار يمكن
إضافتها إلى alert
أو prompt
لتحديد الزر الذي نقر عليه المستخدم،
استخدِم Button
.
لاستدعاء قائمة أرقام صحيحة، عليك استدعاء الصف الرئيسي والاسم والخاصية. مثلاً:
Base.ButtonSet.OK
// Display a dialog box with a message and "Yes" and "No" buttons.
const ui = DocumentApp.getUi();
const response = ui.alert(
'Are you sure you want to continue?',
ui.ButtonSet.YES_NO,
);
// Process the user's response.
if (response === ui.Button.YES) {
Logger.log('The user clicked "Yes."');
} else {
Logger.log('The user clicked "No" or the dialog\'s close button.');
}
أماكن إقامة
الموقع | النوع | الوصف |
OK | Enum | زر "حسنًا" واحد يشير إلى رسالة معلوماتية لا يمكن إغلاقها إلا من خلال هذا الزر |
OK_CANCEL | Enum | زر "حسنًا" وزر "إلغاء"، للسماح للمستخدم بمواصلة عملية أو إيقافها
|
YES_NO | Enum | زر "نعم" وزر "لا"، للسماح للمستخدم بالإجابة عن سؤال بنعم/لا |
YES_NO_CANCEL | Enum | زر "نعم" وزر "لا" وزر "إلغاء"، للسماح للمستخدم بالإجابة عن سؤال "نعم/لا" أو إيقاف عملية |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003e\u003ccode\u003eButtonSet\u003c/code\u003e is an enum used to create predefined, localized button sets for dialog boxes in Apps Script.\u003c/p\u003e\n"],["\u003cp\u003eIt provides options like \u003ccode\u003eOK\u003c/code\u003e, \u003ccode\u003eOK_CANCEL\u003c/code\u003e, \u003ccode\u003eYES_NO\u003c/code\u003e, and \u003ccode\u003eYES_NO_CANCEL\u003c/code\u003e for different dialog scenarios.\u003c/p\u003e\n"],["\u003cp\u003eYou can determine the user's button click by comparing the response to \u003ccode\u003eui.Button\u003c/code\u003e values.\u003c/p\u003e\n"],["\u003cp\u003eThese button sets are used with \u003ccode\u003ealert()\u003c/code\u003e and \u003ccode\u003eprompt()\u003c/code\u003e methods of the \u003ccode\u003eUi\u003c/code\u003e class.\u003c/p\u003e\n"]]],[],null,["# Enum ButtonSet\n\nButtonSet\n\nAn enum representing predetermined, localized sets of one or more dialog buttons that can be\nadded to an [alert](/apps-script/reference/base/ui#alert(String,ButtonSet)) or a [prompt](/apps-script/reference/base/ui#prompt(String,ButtonSet)). To determine which button the user clicked,\nuse [Button](/apps-script/reference/base/button).\n\nTo call an enum, you call its parent class, name, and property. For example, `\nBase.ButtonSet.OK`.\n\n```javascript\n// Display a dialog box with a message and \"Yes\" and \"No\" buttons.\nconst ui = DocumentApp.getUi();\nconst response = ui.alert(\n 'Are you sure you want to continue?',\n ui.ButtonSet.YES_NO,\n);\n\n// Process the user's response.\nif (response === ui.Button.YES) {\n Logger.log('The user clicked \"Yes.\"');\n} else {\n Logger.log('The user clicked \"No\" or the dialog\\'s close button.');\n}\n``` \n\n### Properties\n\n| Property | Type | Description |\n|-----------------|--------|----------------------------------------------------------------------------------------------------------------------------------|\n| `OK` | `Enum` | A single \"OK\" button, indicating an informational message that can only be dismissed. |\n| `OK_CANCEL` | `Enum` | An \"OK\" button and a \"Cancel\" button, allowing the user to either proceed with or halt an operation. |\n| `YES_NO` | `Enum` | A \"Yes\" button and a \"No\" button, allowing the user to answer a yes/no question. |\n| `YES_NO_CANCEL` | `Enum` | A \"Yes\" button, a \"No\" button, and a \"Cancel\" button, allowing the user to either answer a yes/no question or halt an operation. |"]]