DialogResult Enumeração

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Especifica os identificadores para indicar o valor retornado de uma caixa de diálogo.

public enum class DialogResult

[System.Runtime.InteropServices.ComVisible(true)]
public enum DialogResult

public enum DialogResult

[<System.Runtime.InteropServices.ComVisible(true)>]
type DialogResult = 

type DialogResult = 

Public Enum DialogResult

Herança

Object

ValueType

Enum

DialogResult

Atributos

ComVisibleAttribute

Campos

Abort	3	O valor retornado da caixa de diálogo é Abort (normalmente enviado de um botão rotulado Anular).
Cancel	2	O valor retornado da caixa de diálogo é Cancel (normalmente enviado de um botão rotulado Cancelar).
Continue	11	O valor de retorno da caixa de diálogo é Continue (geralmente enviado de um botão rotulado Continue).
Ignore	5	O valor retornado da caixa de diálogo é Ignore (normalmente enviado de um botão rotulado Ignorar).
No	7	O valor retornado da caixa de diálogo é No (normalmente enviado de um botão rotulado Não).
None	0	Nothing é retornado da caixa de diálogo. Isso significa que a caixa de diálogo modal continua sendo executada.
OK	1	O valor retornado da caixa de diálogo é OK (normalmente enviado de um botão rotulado OK).
Retry	4	O valor retornado da caixa de diálogo é Retry (normalmente enviado de um botão rotulado Tentar Novamente).
TryAgain	10	O valor de retorno da caixa de diálogo é Try Again (geralmente enviado de um botão rotulado Try Again).
Yes	6	O valor retornado da caixa de diálogo é Yes (normalmente enviado de um botão rotulado Sim).

Exemplos

O exemplo de código a seguir demonstra como exibir uma MessageBox com as opções compatíveis com essa sobrecarga de Show. Depois de verificar se uma variável ServerNamede cadeia de caracteres está vazia, o exemplo exibe um MessageBox, oferecendo ao usuário a opção de cancelar a operação. Se o Show valor retornado do método for avaliado como Sim, o formulário que exibiu o MessageBox é fechado.

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();
         }
      }
   }

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;
        DialogResult result;

        // Displays the MessageBox.

        result = MessageBox.Show(this, message, caption, buttons);

        if(result == DialogResult.Yes)
        {

            // Closes the parent form.

            this.Close();
        }
    }
}

Private Sub ValidateUserEntry5()

    ' Checks the value of the text.

    If ServerName.Text.Length = 0 Then

        ' Initializes variables to pass to the MessageBox.Show method.

        Dim Message As String = "You did not enter a server name. Cancel this operation?"
        Dim Caption As String = "No Server Name Specified"
        Dim Buttons As Integer = MessageBoxButtons.YesNo

        Dim Result As DialogResult

        'Displays a MessageBox using the Question icon and specifying the No button as the default.

        Result = MessageBox.Show(Me, Message, Caption, MessageBoxButtons.YesNo)

        ' Gets the result of the MessageBox display.

        If Result = System.Windows.Forms.DialogResult.Yes Then

            ' Closes the parent form.

            Me.Close()

        End If

    End If

End Sub

Comentários

A Button.DialogResult propriedade e o Form.ShowDialog método usam essa enumeração.

Confira também

• Button
• Form