Método IConsole::MessageBox (mmc.h)
Exibe uma caixa de mensagem.
Sintaxe
HRESULT MessageBox(
[in] LPCWSTR lpszText,
[in] LPCWSTR lpszTitle,
[in] UINT fuStyle,
[out] int *piRetval
);
Parâmetros
[in] lpszText
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém a mensagem a ser exibida.
[in] lpszTitle
Um ponteiro para uma cadeia de caracteres terminada em nulo usada para o título da caixa de mensagem. Se esse parâmetro for NULL, o título padrão "Error" será usado.
[in] fuStyle
Um valor que especifica um conjunto de sinalizadores de bits que determinam o conteúdo e o comportamento da caixa de mensagem. Esse parâmetro pode ser uma combinação de sinalizadores dos seguintes grupos de sinalizadores retirados da documentação da MessageBox da API do Windows.
Especifique um dos sinalizadores a seguir para indicar quais botões aparecem na caixa de mensagem.
MB_ABORTRETRYIGNORE
A caixa de mensagem contém três botões: Anular, Repetir e Ignorar.
MB_OK
A caixa de mensagem contém um botão: OK. Esse é o padrão.
MB_OKCANCEL
A caixa de mensagem contém dois botões: OK e Cancelar.
MB_RETRYCANCEL
A caixa de mensagem contém dois botões: Repetir e Cancelar.
MB_YESNO
A caixa de mensagem contém dois botões: Sim e Não.
MB_YESNOCANCEL
A caixa de mensagem contém três botões: Sim, Não e Cancelar.
Especifique um dos seguintes sinalizadores para indicar qual ícone aparece na caixa de mensagem:
MB_ICONEXCLAMATION, MB_ICONWARNING
Um ícone de ponto de exclamação aparece na caixa de mensagem.
MB_ICONINFORMATION, MB_ICONASTERISK
Um ícone que consiste em um "I" em um círculo aparece na caixa de mensagem.
MB_ICONQUESTION
Um ícone de ponto de interrogação aparece na caixa de mensagem.
MB_ICONSTOP,
MB_ICONERROR, MB_ICONHAND
Um ícone de sinal de parada aparece na caixa de mensagem.
Especifique um dos seguintes sinalizadores para indicar o botão padrão:
MB_DEFBUTTON1
O primeiro botão é o botão padrão, a menos que um dos outros sinalizadores desse grupo seja especificado como o padrão.
MB_DEFBUTTON2
O segundo botão é o botão padrão.
MB_DEFBUTTON3
O terceiro botão é o botão padrão.
MB_DEFBUTTON4
O quarto botão é o botão padrão.
Especifique um dos seguintes sinalizadores para indicar a modalidade da caixa de diálogo:
MB_APPLMODAL
O usuário deve responder à caixa de mensagem antes de continuar o trabalho na janela atual. No entanto, o usuário pode mudar para as janelas de outros aplicativos e trabalhar nessas janelas. O padrão será MB_APPLMODAL se nem MB_SYSTEMMODAL nem MB_TASKMODAL forem especificados.
MB_SYSTEMMODAL
Todos os aplicativos são suspensos até que o usuário responda à caixa de mensagem. As caixas de mensagem modal do sistema são usadas para notificar o usuário sobre erros graves e potencialmente prejudiciais que exigem atenção imediata e devem ser usados com moderação.
MB_TASKMODAL
Semelhante a MB_APPLMODAL, mas não útil em um aplicativo do Microsoft Foundation Classes (MFC). Esse sinalizador é reservado para um aplicativo de chamada ou biblioteca que não tem um identificador de janela disponível.
Além disso, você pode especificar os seguintes sinalizadores:
MB_DEFAULT_DESKTOP_ONLY
A área de trabalho que está recebendo entrada no momento deve ser uma área de trabalho padrão; caso contrário, a função falhará. Uma área de trabalho padrão é uma em que um aplicativo é executado depois que o usuário faz logon.
MB_HELP
Adiciona um botão Ajuda à caixa de mensagem. Escolher o botão Ajuda ou pressionar F1 gera um evento de Ajuda.
MB_RIGHT
O texto é justificado com o botão direito do mouse.
MB_RTLREADING
Exibe mensagem e legenda texto usando a ordem de leitura da direita para a esquerda para sistemas hebraicos e árabes.
MB_SETFOREGROUND
A caixa de mensagem se torna a janela em primeiro plano. Internamente, o sistema operacional chama a função SetForegroundWindow para a caixa de mensagem.
MB_TOPMOST
A caixa de mensagem é criada com o estilo de janela WS_EX_TOPMOST .
MB_SERVICE_NOTIFICATION
O chamador é um serviço que notifica o usuário sobre um evento. A função exibe uma caixa de mensagem na área de trabalho ativa atual, mesmo que não haja nenhum usuário conectado ao computador.
Para obter mais informações sobre como usar esse sinalizador, consulte a função MessageBox .
MB_SERVICE_NOTIFICATION_NT3x
Esse valor corresponde ao valor definido para MB_SERVICE_NOTIFICATION para versões anteriores do Windows.
[out] piRetval
Um ponteiro para o valor retornado.
Retornar valor
Esse método pode retornar um desses valores.
Comentários
MessageBox não deve ser usado para o que exibe erros que ocorrem quando o snap-in não tem o foco. Geralmente
MessageBox deve ser usado somente quando o erro exigir atenção do usuário e quando o painel de resultados contiver informações úteis, apesar do erro.
Na maioria dos casos, o controle OCX da mensagem MMC é uma maneira mais apropriada de exibir mensagens de erro. Para obter mais informações, consulte Usando o controle OCX de Mensagem do MMC.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | mmc.h |
| DLL | Mmcndmgr.dll |