DialogResult Enumeration
Specifies identifiers to indicate the return value of a dialog box.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
| Member name | Description | |
|---|---|---|
| Abort | The dialog box return value is Abort (usually sent from a button labeled Abort). | |
| Cancel | The dialog box return value is Cancel (usually sent from a button labeled Cancel). | |
| Ignore | The dialog box return value is Ignore (usually sent from a button labeled Ignore). | |
| No | The dialog box return value is No (usually sent from a button labeled No). | |
| None | Nothing is returned from the dialog box. This means that the modal dialog continues running. | |
| OK | The dialog box return value is OK (usually sent from a button labeled OK). | |
| Retry | The dialog box return value is Retry (usually sent from a button labeled Retry). | |
| Yes | The dialog box return value is Yes (usually sent from a button labeled Yes). |
The Button::DialogResult property and the Form::ShowDialog method use this enumeration.
The following code example demonstrates how to display a MessageBox with the options supported by this overload of Show. After verifying that a string variable, ServerName, is empty, the example displays a MessageBox, offering the user the option to cancel the operation. If the Show method's return value evaluates to Yes, the form that displayed the MessageBox is closed.
private: void validateUserEntry5() { // Checks the value of the text. if ( serverName->Text->Length == 0 ) { // Initializes the variables to pass to the MessageBox::Show method. String^ message = "You did not enter a server name. Cancel this operation?"; String^ caption = "No Server Name Specified"; MessageBoxButtons buttons = MessageBoxButtons::YesNo; System::Windows::Forms::DialogResult result; // Displays the MessageBox. result = MessageBox::Show( this, message, caption, buttons ); if ( result == ::DialogResult::Yes ) { // Closes the parent form. this->Close(); } } }
Available since 1.1