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: الزر الذي نقر عليه المستخدم