Função MessageBoxIndirectA (winuser.h)

Cria, exibe e opera uma caixa de mensagem. A caixa de mensagem contém texto e título de mensagem definidos pelo aplicativo, qualquer ícone e qualquer combinação de botões de push predefinidos.

Sintaxe

int MessageBoxIndirectA(
  [in] const MSGBOXPARAMSA *lpmbp
);

Parâmetros

[in] lpmbp

Tipo: const LPMSGBOXPARAMS

Um ponteiro para uma estrutura MSGBOXPARAMS que contém informações usadas para exibir a caixa de mensagem.

Valor retornado

Tipo: int

Se a função for bem-sucedida, o valor retornado será um dos seguintes valores de item de menu.

Se uma caixa de mensagem tiver um botão Cancelar , a função retornará o valor IDCANCEL se a tecla ESC for pressionada ou o botão Cancelar estiver selecionado. Se a caixa de mensagem não tiver nenhum botão Cancelar , pressionar ESC não terá efeito.

Se não houver memória suficiente para criar a caixa de mensagem, o valor retornado será zero.

Valor/código retornado Descrição
IDABORT
3
O botão Anular foi selecionado.
IDCANCEL
2
O botão Cancelar foi selecionado.
IDCONTINUE
11
O botão Continuar foi selecionado.
IDIGNORE
5
O botão Ignorar foi selecionado.
IDNO
7
O botão Não foi selecionado.
IDOK
1
O botão OK foi selecionado.
IDRETRY
4
O botão Repetir foi selecionado.
IDTRYAGAIN
10
O botão Tentar Novamente foi selecionado.
IDYES
6
O botão Sim foi selecionado.

Comentários

Quando você usa uma caixa de mensagem modal do sistema para indicar que o sistema está com pouca memória, as cadeias de caracteres apontadas pelos membros lpszText e lpszCaption da estrutura MSGBOXPARAMS não devem ser retiradas de um arquivo de recurso, pois uma tentativa de carregar o recurso pode falhar.

Se você criar uma caixa de mensagem enquanto uma caixa de diálogo estiver presente, use um identificador para a caixa de diálogo como o parâmetro hWnd . O parâmetro hWnd não deve identificar uma janela filho, como um controle em uma caixa de diálogo.

Observação

O cabeçalho winuser.h define MessageBoxIndirect como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll
Conjunto de APIs ext-ms-win-ntuser-dialogbox-l1-1-0 (introduzido no Windows 8)

Confira também

Conceitual

Caixas de diálogo

MSGBOXPARAMS

Messagebox

MessageBoxEx

Referência