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 |
---|---|
|
O botão Anular foi selecionado. |
|
O botão Cancelar foi selecionado. |
|
O botão Continuar foi selecionado. |
|
O botão Ignorar foi selecionado. |
|
O botão Não foi selecionado. |
|
O botão OK foi selecionado. |
|
O botão Repetir foi selecionado. |
|
O botão Tentar Novamente foi selecionado. |
|
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
Referência