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