| CoronaMessageBox Class |
Non-blocking XAML based message box supporting custom button text.
Displayed by Corona via the Lua native.showAlert() function.
Inheritance HierarchyNamespace: CoronaLabs.Corona.WinRT.Phone
Assembly: CoronaLabs.Corona.DotNet (in CoronaLabs.Corona.DotNet.dll) Version: 1.0.0.0 (1.0.0.0)
SyntaxThe CoronaMessageBox type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | CoronaMessageBox | Creates a new message box initialized with empty text and no buttons. You are expected to set the returned message box's Title, Message, and ButtonLabels properties before showing it. |
Methods| Name | Description | |
|---|---|---|
| Close | Closes the message box, if currently shown. The WasButtonPressed property will be set to false in this case. |
| CloseWithButtonIndex | Closes the message box, if currently shown, by simulating a button press. |
| Equals | (Inherited from Object.) |
 | Finalize | Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.) |
| GetHashCode | Serves as a hash function for a particular type. (Inherited from Object.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| MemberwiseClone | Creates a shallow copy of the current Object. (Inherited from Object.) |
| Show | Displays the message box using the assigned title, message, and button labels. |
| ToString | Returns a string that represents the current object. (Inherited from Object.) |
Properties| Name | Description | |
|---|---|---|
 | ButtonLabels | Gets a modifiable collection of labels to be displayed as buttons in the message box. |
| IsShowing | Determines if the message box is currently being shown to the end-user. |
| Message | Gets or sets the main text to be displayed in the message box. |
| PressedButtonIndex | Indicates which button was pressed to close the message box. Note that this property is only applicable if the WasButtonPressed property is set true. |
 | ShownMessagBoxes | Gets a read-only collection of all currently shown message boxes. |
| Title | Gets or sets the message box's optional title text. |
| WasButtonPressed | Determines if the message box was closed via one of its displayed button. |
Events| Name | Description | |
|---|---|---|
 | Closed |
Raised when the message box has been closed by the end-user via a displayed button, back key,
or if one of the Close() methods have been called.
|
Remarks
Microsoft's built-in Silverlight XAML MessageBox class blocks the main UI thread
and does not support customizable buttons. This custom message box is non-blocking and does support multiple
buttons (or no buttons) with text of your choosing. With this custom message box, you'll get similar
alert dialog behavior as seen on iOS and Android, which makes it easier to port your app via Corona.
See Also