MessageBox Classe

Definição

Espaço de Nomes:
System.Windows
Assemblagem:
PresentationFramework.dll

Mostra uma caixa de mensagem.

public ref class MessageBox sealed
public sealed class MessageBox
type MessageBox = class
Public NotInheritable Class MessageBox
Herança
Object
MessageBox

Observações

Uma caixa de mensagem é uma caixa de diálogo modal pré-fabricada que apresenta uma mensagem de texto ao utilizador. Mostras uma caixa de mensagem chamando o método estático Show da MessageBox classe. A mensagem de texto que é apresentada é o argumento da cadeia que passa para Show. Várias sobrecargas do Show método também permitem fornecer uma legenda na barra de título.

Para permitir que um utilizador feche uma caixa de mensagem, Show mostra uma caixa de mensagem com um botão OK e um botão Fechar na barra de título.

Também pode usar uma caixa de mensagens para fazer uma pergunta a um utilizador. O utilizador responde clicando num dos vários botões que especifica para mostrar através da MessageBoxButton enumeração. Pode passar esta enumeração a várias sobrecargas do Show método. O valor padrão da MessageBoxButton enumeração é OK.

Pode determinar em que botão o utilizador clica examinando o valor que Show devolve. O valor de retorno é um valor da MessageBoxResult enumeração, onde cada valor equivale a um dos botões que uma caixa de mensagem pode mostrar. O valor padrão da caixa de mensagens é OK porque OK é o botão padrão da caixa de mensagem. No entanto, algumas sobrecargas do Show método permitem fornecer um valor padrão diferente MessageBoxResult .

As caixas de mensagens podem comunicar informação e fazer perguntas com diferentes graus de importância. As caixas de mensagens usam ícones para indicar importância. Por exemplo, ícones podem indicar se a mensagem é informativa, um aviso ou importante. A MessageBoxImage enumeração encapsula o conjunto de ícones possíveis de caixas de mensagem. Por defeito, uma caixa de mensagem não apresenta um ícone. No entanto, pode passar um MessageBoxImage valor a um dos vários Show overloads de método para especificar que a caixa de mensagem inclui um ícone.

As caixas de mensagens por vezes oferecem funcionalidades especiais, como leitura da direita para a esquerda. Pode personalizar o comportamento de uma caixa de mensagem usando um ou mais MessageBoxOptions valores de enumeração aceites por algumas sobrecargas do Show método.

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

Para mais informações, consulte o Exemplo da Caixa de Mensagem.

Métodos

Name Description
Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)

Exibe uma caixa de mensagem que contém uma mensagem, legenda na barra de título, botão e ícone; e que aceita um resultado de caixa de mensagem por defeito, cumpre as opções especificadas e devolve um resultado.
Show(String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult)

Exibe uma caixa de mensagem que contém uma mensagem, legenda na barra de título, botão e ícone; e que aceita um resultado de caixa de mensagem por defeito e devolve um resultado.
Show(String, String, MessageBoxButton, MessageBoxImage)

Exibe uma caixa de mensagem que contém uma mensagem, legenda na barra de título, botão e ícone; E isso retorna um resultado.
Show(String, String, MessageBoxButton)

Exibe uma caixa de mensagem com uma mensagem, legenda na barra de título e botão; E isso retorna um resultado.
Show(String, String)

Mostra uma caixa de mensagem com uma legenda na barra de mensagem e na barra de título; E isso retorna um resultado.
Show(String)

Mostra uma caixa de mensagem com uma mensagem e que devolve um resultado.
Show(Window, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult, MessageBoxOptions)

Apresenta uma caixa de mensagem em frente à janela especificada. A caixa de mensagem mostra uma mensagem, legenda na barra de título, botão e ícone; e aceita um resultado padrão na caixa de mensagem, cumpre as opções especificadas e devolve um resultado.
Show(Window, String, String, MessageBoxButton, MessageBoxImage, MessageBoxResult)

Apresenta uma caixa de mensagem em frente à janela especificada. A caixa de mensagem mostra uma mensagem, legenda na barra de título, botão e ícone; e aceita um resultado de caixa de mensagem por defeito e devolve um resultado.
Show(Window, String, String, MessageBoxButton, MessageBoxImage)

Apresenta uma caixa de mensagem em frente à janela especificada. A caixa de mensagem mostra uma mensagem, legenda na barra de título, botão e ícone; E também devolve um resultado.
Show(Window, String, String, MessageBoxButton)

Apresenta uma caixa de mensagem em frente à janela especificada. A caixa de mensagem mostra uma mensagem, legenda na barra de título e um botão; E também devolve um resultado.
Show(Window, String, String)

Apresenta uma caixa de mensagem em frente à janela especificada. A caixa de mensagem mostra uma mensagem e a legenda da barra de título; e devolve um resultado.
Show(Window, String)

Apresenta uma caixa de mensagem em frente à janela especificada. A caixa de mensagem mostra uma mensagem e devolve um resultado.
ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

Aplica-se a

Ver também