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 | 「是」按鈕、「否」按鈕和「取消」按鈕,可讓使用者回答是/否問題或停止作業。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 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. |"]]