Class PromptResponse

PromptResponse

پاسخی به یک گفتگوی 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 - دکمه ای که کاربر روی آن کلیک کرده است.