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