Método IConsole::MessageBox (mmc.h)

Muestra un cuadro de mensaje.

Sintaxis

HRESULT MessageBox(
  [in]  LPCWSTR lpszText,
  [in]  LPCWSTR lpszTitle,
  [in]  UINT    fuStyle,
  [out] int     *piRetval
);

Parámetros

[in] lpszText

Puntero a una cadena terminada en null que contiene el mensaje que se va a mostrar.

[in] lpszTitle

Puntero a una cadena terminada en null usada para el título del cuadro de mensaje. Si este parámetro es NULL, se usa el título predeterminado "Error".

[in] fuStyle

Valor que especifica un conjunto de marcas de bits que determinan el contenido y el comportamiento del cuadro de mensaje. Este parámetro puede ser una combinación de marcas de los siguientes grupos de marcas tomados de la documentación del Cuadro de mensajes de la API de Windows.

Especifique una de las marcas siguientes para indicar qué botones aparecen en el cuadro de mensaje.

MB_ABORTRETRYIGNORE

El cuadro de mensaje contiene tres botones: Anular, Reintentar e Omitir.

MB_OK

El cuadro de mensaje contiene un botón: Aceptar. Este es el valor predeterminado.

MB_OKCANCEL

El cuadro de mensaje contiene dos botones: Aceptar y Cancelar.

MB_RETRYCANCEL

El cuadro de mensaje contiene dos botones: Reintentar y Cancelar.

MB_YESNO

El cuadro de mensaje contiene dos botones: Sí y No.

MB_YESNOCANCEL

El cuadro de mensaje contiene tres botones: Sí, No y Cancelar.

Especifique una de las marcas siguientes para indicar qué icono aparece en el cuadro de mensaje:

MB_ICONEXCLAMATION, MB_ICONWARNING

Aparece un icono de signo de exclamación en el cuadro de mensaje.

MB_ICONINFORMATION, MB_ICONASTERISK

Aparece un icono que consta de una "I" en un círculo en el cuadro de mensaje.

MB_ICONQUESTION

Aparece un icono de signo de interrogación en el cuadro de mensaje.

MB_ICONSTOP,

MB_ICONERROR, MB_ICONHAND

Aparece un icono de signo de detención en el cuadro de mensaje.

Especifique una de las marcas siguientes para indicar el botón predeterminado:

MB_DEFBUTTON1

El primer botón es el predeterminado a menos que se especifique una de las otras marcas de este grupo como valor predeterminado.

MB_DEFBUTTON2

El segundo botón es el predeterminado.

MB_DEFBUTTON3

El tercer botón es el predeterminado.

MB_DEFBUTTON4

El cuarto botón es el predeterminado.

Especifique una de las marcas siguientes para indicar la modalidad del cuadro de diálogo:

MB_APPLMODAL

El usuario debe responder al cuadro de mensaje antes de continuar trabajando en la ventana actual. Sin embargo, el usuario puede pasar a las ventanas de otras aplicaciones y trabajar en esas ventanas. El valor predeterminado es MB_APPLMODAL si no se especifica ni MB_SYSTEMMODAL ni MB_TASKMODAL .

MB_SYSTEMMODAL

Se suspenden todas las aplicaciones hasta que el usuario responda al cuadro de mensaje. Los cuadros de mensaje modales del sistema se usan para notificar al usuario errores graves y potencialmente perjudiciales que requieren atención inmediata, y se deben usar con moderación.

MB_TASKMODAL

Es similar a MB_APPLMODAL, pero no resulta útil en una aplicación de Microsoft Foundation Classes (MFC). Esta marca está reservada para una aplicación o biblioteca que llama que no tiene disponible un manipulador de ventana.

Además, puede especificar las marcas siguientes:

MB_DEFAULT_DESKTOP_ONLY

El escritorio que recibe actualmente la entrada debe ser un escritorio predeterminado; de lo contrario, se produce un error en la función. Un escritorio predeterminado es una aplicación que se ejecuta después de que el usuario haya iniciado sesión.

MB_HELP

Agrega un botón Ayuda al cuadro de mensaje. Al elegir el botón Ayuda o presionar F1 , se genera un evento de Ayuda.

MB_RIGHT

El texto está justificado a la derecha.

MB_RTLREADING

Muestra el mensaje y subtítulo texto mediante el orden de lectura de derecha a izquierda para los sistemas hebreo y árabe.

MB_SETFOREGROUND

El cuadro de mensaje se convierte en la ventana de primer plano. Internamente, el sistema operativo llama a la función SetForegroundWindow para el cuadro de mensaje.

MB_TOPMOST

El cuadro de mensaje se crea con el estilo de ventana WS_EX_TOPMOST .

MB_SERVICE_NOTIFICATION

El autor de llamada es un servicio que notifica al usuario sobre un evento. La función muestra un cuadro de mensaje en el escritorio activo actual, incluso si no hay ningún usuario que haya iniciado sesión en el equipo.

Para obtener más información sobre el uso de esta marca, vea la función MessageBox .

MB_SERVICE_NOTIFICATION_NT3x

Este valor corresponde al valor definido para MB_SERVICE_NOTIFICATION para versiones anteriores de Windows.

[out] piRetval

Puntero al valor devuelto.

Valor devuelto

Este método puede devolver uno de estos valores.

Comentarios

MessageBox no debe usarse para que muestre errores que se producen cuando el complemento no tiene el foco. Generalmente

MessageBox solo se debe usar cuando el error exige atención al usuario y cuando el panel de resultados contiene información útil a pesar del error.

En la mayoría de los casos, el control OCX del mensaje MMC es una forma más adecuada de que muestre mensajes de error. Para obtener más información, vea Usar el control OCX del mensaje MMC.

Requisitos

Consulte también

IConsole