پاسخی به یک کادر prompt که در محیط رابط کاربری یک برنامه گوگل نمایش داده میشود. این پاسخ شامل هر متنی است که کاربر در فیلد ورودی کادر محاورهای وارد کرده و نشان میدهد که کاربر برای بستن کادر محاورهای روی کدام دکمه کلیک کرده است.
// 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. const ui = DocumentApp.getUi(); const 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.'); }
روشها
| روش | نوع بازگشتی | شرح مختصر |
|---|---|---|
get Response Text() | String | متنی را که کاربر در فیلد ورودی کادر محاورهای وارد کرده است، برمیگرداند. |
get Selected Button() | Button | دکمهای را که کاربر برای بستن پنجرهی محاورهای کلیک کرده است، برمیگرداند. |
مستندات دقیق
getResponseText()
متنی را که کاربر در فیلد ورودی کادر محاورهای وارد کرده است، دریافت میکند. این متن حتی اگر کاربر با کلیک روی دکمهای با بار معنایی منفی، مانند "لغو" یا دکمه بستن در نوار عنوان کادر محاورهای، کادر محاورهای را بسته باشد، در دسترس است. getSelectedButton() میتواند به تعیین اینکه آیا کاربر قصد داشته متن پاسخ معتبر باشد یا خیر، کمک کند.
بازگشت
String — متنی که کاربر در فیلد ورودی کادر محاورهای وارد کرده است.
getSelectedButton()
دکمهای را که کاربر برای بستن پنجره کلیک کرده است، برمیگرداند. اگر کاربر روی دکمهی بستن که در نوار عنوان هر پنجره قرار دارد کلیک کرده باشد، این متد Button.CLOSE را برمیگرداند.
بازگشت
Button - دکمهای که کاربر روی آن کلیک کرده است.