Função MessageBoxIndirectA (winuser.h)

Artigo
08/27/2023

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)