Class 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.
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.');
}

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
getResponseText()	String	تحصل على النص الذي أدخله المستخدم في حقل الإدخال في مربّع الحوار.
getSelectedButton()	Button	تحصل على الزر الذي نقر عليه المستخدم لإغلاق مربّع الحوار.

مستندات تفصيلية

getResponseText()

تحصل على النص الذي أدخله المستخدم في حقل الإدخال في مربّع الحوار. يتوفّر النص حتى إذا أغلق المستخدم مربّع الحوار من خلال النقر على زرّ يحمل دلالة سلبية، مثل "إلغاء" أو زر الإغلاق في شريط عنوان مربّع الحوار. يمكن أن يساعد getSelectedButton() في تحديد ما إذا كان المستخدم يريد أن يكون نص الرد صالحًا.

الإرجاع

String: النص الذي أدخله المستخدم في حقل الإدخال في مربّع الحوار

---

getSelectedButton()

تحصل على الزر الذي نقر عليه المستخدم لإغلاق مربّع الحوار. إذا نقر المستخدم على زر الإغلاق المضمّن في شريط عنوان كل مربّع حوار، تعرض هذه الطريقة القيمة Button.CLOSE.

الإرجاع

Button: الزر الذي نقر عليه المستخدم