BaseForm.ShowMessage Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Exibe uma caixa de mensagem que usa o texto especificado.
Sobrecargas
ShowMessage(String) |
Exibe uma caixa de mensagem que usa o texto especificado. |
ShowMessage(String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton) |
Exibe uma caixa de mensagem que usa o texto, o conjunto de botões, o símbolo e o botão padrão especificados. |
ShowMessage(String)
Exibe uma caixa de mensagem que usa o texto especificado.
protected public:
void ShowMessage(System::String ^ message);
protected internal void ShowMessage (string message);
member this.ShowMessage : string -> unit
Protected Friend Sub ShowMessage (message As String)
Parâmetros
- message
- String
A mensagem a ser exibida.
Exemplos
O exemplo a seguir salva a geometria da janela no repositório de preferências. Se o serviço de preferência for null
, uma mensagem será exibida.
void persistWindowVals() {
IPreferencesService prefService = (IPreferencesService)
GetService(typeof(IPreferencesService));
if (prefService == null) {
ShowMessage("Null PreferencesService");
return;
}
if (prefService != null) {
PreferencesStore prefStore = prefService.GetPreferencesStore(
new Guid(PreferenceKey));
if (WindowState == FormWindowState.Maximized) {
prefStore.SetValue(MaximizedPreferenceKey, true, false);
} else if (WindowState != FormWindowState.Minimized) {
prefStore.SetValue(WidthPreferenceKey, Size.Width, -1);
prefStore.SetValue(HeightPreferenceKey, Size.Height, -1);
prefStore.SetValue(YPosPreferenceKey, Location.Y, -1);
prefStore.SetValue(XPosPreferenceKey, Location.X, -1);
prefStore.SetValue(MaximizedPreferenceKey, false, false);
}
}
}
Aplica-se a
ShowMessage(String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)
Exibe uma caixa de mensagem que usa o texto, o conjunto de botões, o símbolo e o botão padrão especificados.
protected public:
System::Windows::Forms::DialogResult ShowMessage(System::String ^ message, System::Windows::Forms::MessageBoxButtons buttons, System::Windows::Forms::MessageBoxIcon icon, System::Windows::Forms::MessageBoxDefaultButton defaultButton);
protected internal System.Windows.Forms.DialogResult ShowMessage (string message, System.Windows.Forms.MessageBoxButtons buttons, System.Windows.Forms.MessageBoxIcon icon, System.Windows.Forms.MessageBoxDefaultButton defaultButton);
member this.ShowMessage : string * System.Windows.Forms.MessageBoxButtons * System.Windows.Forms.MessageBoxIcon * System.Windows.Forms.MessageBoxDefaultButton -> System.Windows.Forms.DialogResult
Protected Friend Function ShowMessage (message As String, buttons As MessageBoxButtons, icon As MessageBoxIcon, defaultButton As MessageBoxDefaultButton) As DialogResult
Parâmetros
- message
- String
A mensagem a ser exibida.
- buttons
- MessageBoxButtons
Um dos valores de MessageBoxButtons.
- icon
- MessageBoxIcon
Um dos valores de MessageBoxIcon.
- defaultButton
- MessageBoxDefaultButton
Um dos valores de MessageBoxDefaultButton.
Retornos
Um dos valores de DialogResult.
Exemplos
O exemplo a seguir solicita que o usuário salve as alterações.
protected override void OnFormClosing(FormClosingEventArgs e) {
base.OnFormClosing(e);
CloseReason reason = e.CloseReason;
if (reason != CloseReason.UserClosing &&
reason != CloseReason.ApplicationExitCall)
return;
IServiceProvider serviceProvider = this.ServiceProvider;
if (serviceProvider == null)
return;
IConnectionManager connectionManager = (IConnectionManager)
GetService(typeof(IConnectionManager));
if ((connectionManager == null) ||
(!connectionManager.IsDirty)) // nothing to save
return;
DialogResult result = ShowMessage(
"The connection list has changed. Save changes?",
MessageBoxButtons.YesNoCancel, // button set
MessageBoxIcon.Question, // Icon
MessageBoxDefaultButton.Button1); // Default btn
if (result == DialogResult.Yes) {
connectionManager.Save();
} else if (result == DialogResult.Cancel) {
e.Cancel = true;
}
}