MessageBox Classe

Definição

Namespace:

System.Windows

Assembly:

PresentationFramework.dll

Exibe uma caixa de mensagem.

public ref class MessageBox sealed

public sealed class MessageBox

type MessageBox = class

Public NotInheritable Class MessageBox

Herança

Object

MessageBox

Comentários

Uma caixa de mensagem é uma caixa de diálogo modal pré-fabricada que exibe uma mensagem de texto para um usuário. Você mostra uma caixa de mensagem chamando o método estático Show da MessageBox classe . A mensagem de texto exibida é o argumento de cadeia de caracteres que você passa para Show. Várias sobrecargas do Show método também permitem que você forneça uma legenda da barra de título.

Para permitir que um usuário feche uma caixa de mensagem, Show exibe uma caixa de mensagem que tem um botão OK e um botão Fechar na barra de título.

Você também pode usar uma caixa de mensagem para fazer uma pergunta a um usuário. O usuário responde clicando em um dos vários botões que você especifica para exibir usando a MessageBoxButton enumeração . Você pode passar essa enumeração para várias sobrecargas do Show método . O valor padrão da MessageBoxButton enumeração é OK.

Você pode determinar qual botão um usuário clica examinando o valor que Show retorna. O valor retornado é um valor da MessageBoxResult enumeração , em que cada valor equivale a um dos botões que uma caixa de mensagem pode exibir. O valor padrão da caixa de mensagem é OK porque OK é o botão de caixa de mensagem padrão. No entanto, algumas sobrecargas do Show método permitem que você forneça um valor padrão diferente MessageBoxResult .

As caixas de mensagem podem comunicar informações e podem fazer perguntas que têm diferentes graus de importância. As caixas de mensagem usam ícones para indicar importância. Por exemplo, os ícones podem indicar se a mensagem é informativa, é um aviso ou é importante. A MessageBoxImage enumeração encapsula o conjunto de possíveis ícones da caixa de mensagem. Por padrão, uma caixa de mensagem não exibe um ícone. No entanto, você pode passar um MessageBoxImage valor para uma das várias Show sobrecargas de método para especificar que a caixa de mensagem inclui um ícone.

Às vezes, as caixas de mensagem fornecem funcionalidades especiais, como leitura da direita para a esquerda. Você pode personalizar o comportamento de uma caixa de mensagem usando um ou mais MessageBoxOptions valores de enumeração que são aceitos por algumas sobrecargas do Show método.

As caixas de mensagem sempre têm uma janela de proprietário. Por padrão, o proprietário de uma caixa de mensagem é a janela que está ativa atualmente em um aplicativo no momento em que uma caixa de mensagem é aberta. No entanto, você pode especificar outro proprietário para o Window usando uma das várias Show sobrecargas. Para obter mais informações sobre janelas de proprietário, consulte Window.Owner.

Para obter mais informações, consulte Exemplo de MessageBox.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
Show(String)	Exibe uma caixa de mensagem que tem uma mensagem e que retorna um resultado.
Show(String, String)	Exibe uma caixa de mensagem que contém uma mensagem e uma legenda da barra de título e que retorna um resultado.
Show(String, String, MessageBoxButton)	Exibe uma caixa de mensagem que contém uma mensagem, legenda da barra de título e um botão, e que retorna um resultado.
Show(String, String, MessageBoxButton, MessageBoxImage)	Exibe uma caixa de mensagem que contém uma mensagem, uma legenda da barra de título, um botão e um ícone, e que retorna um resultado.
Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult)	Exibe uma caixa de mensagem que contém uma mensagem, uma legenda da barra de título, um botão e um ícone, e que aceita um resultado de caixa de mensagem padrão e retorna um resultado.
Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)	Exibe uma caixa de mensagem que contém uma mensagem, uma legenda da barra de título, um botão e um ícone, e que aceita um resultado de caixa de mensagem padrão, está em conformidade com as opções especificadas e retorna um resultado.
Show(Window, String)	Exibe uma caixa de mensagem na frente da janela especificada. A caixa de mensagem exibe uma mensagem e retorna um resultado.
Show(Window, String, String)	Exibe uma caixa de mensagem na frente da janela especificada. A caixa de mensagem exibe uma mensagem e uma legenda da barra de título; além disso, ela retorna um resultado.
Show(Window, String, String, MessageBoxButton)	Exibe uma caixa de mensagem na frente da janela especificada. A caixa de mensagem exibe uma mensagem, uma legenda da barra de título e um botão; além disso, retorna um resultado.
Show(Window, String, String, MessageBoxButton, MessageBoxImage)	Exibe uma caixa de mensagem na frente da janela especificada. A caixa de mensagem exibe uma mensagem, uma legenda da barra de título, um botão e um ícone, e também retorna um resultado.
Show(Window, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult)	Exibe uma caixa de mensagem na frente da janela especificada. A caixa de mensagem exibe uma mensagem, uma legenda da barra de título, um botão e um ícone; além disso, aceita um resultado da caixa de mensagem padrão e retorna um resultado.
Show(Window, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)	Exibe uma caixa de mensagem na frente da janela especificada. A caixa de mensagem exibe uma mensagem, legenda da barra de título, botão e ícone e aceita um resultado de caixa de mensagem padrão, segue as opções especificadas e retorna um resultado.
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• MessageBoxButton
• MessageBoxImage
• MessageBoxResult
• MessageBoxOptions