پاسخی به یک گفتگوی prompt
که در محیط رابط کاربری برای یک برنامه Google نمایش داده می شود. پاسخ شامل هر متنی است که کاربر در فیلد ورودی گفتگو وارد کرده است و نشان می دهد که کاربر روی کدام دکمه کلیک کرده تا گفتگو را رد کند.
// Display a dialog box with a title, message, input field, and "Yes" and "No" buttons. The // user can also close the dialog by clicking the close button in its title bar. var ui = DocumentApp.getUi(); var response = ui.prompt('Getting to know you', 'May I know your name?', ui.ButtonSet.YES_NO); // Process the user's response. if (response.getSelectedButton() == ui.Button.YES) { Logger.log('The user\'s name is %s.', response.getResponseText()); } else if (response.getSelectedButton() == ui.Button.NO) { Logger.log('The user didn\'t want to provide a name.'); } else { Logger.log('The user clicked the close button in the dialog\'s title bar.'); }
روش ها
روش | نوع برگشت | شرح مختصر |
---|---|---|
getResponseText() | String | متنی را که کاربر در قسمت ورودی گفتگو وارد کرده است دریافت می کند. |
getSelectedButton() | Button | دکمه ای را دریافت می کند که کاربر برای رد کردن گفتگو روی آن کلیک کرده است. |
مستندات دقیق
getResponseText()
متنی را که کاربر در قسمت ورودی گفتگو وارد کرده است دریافت می کند. متن در دسترس است حتی اگر کاربر با کلیک کردن روی دکمه ای با مفهوم منفی مانند "لغو" یا دکمه بستن در نوار عنوان گفتگو، گفتگو را ببندد. getSelectedButton()
می تواند به تعیین اینکه آیا کاربر قصد دارد متن پاسخ معتبر باشد یا خیر کمک کند.
بازگشت
String
- متنی که کاربر در فیلد ورودی گفتگو وارد کرده است.
getSelectedButton()
دکمه ای را دریافت می کند که کاربر برای رد کردن گفتگو روی آن کلیک کرده است. اگر کاربر روی دکمه بستن که در نوار عنوان هر گفتگو موجود است کلیک کند، این روش Button.CLOSE
را برمیگرداند.
بازگشت
Button
- دکمه ای که کاربر روی آن کلیک کرده است.