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