10/09/13

Funcin MessageBox (Windows)

Centro de desarrollo - Escritorio

DA SH B OA RD EM P EZ A NDO DISEO DESA RROL L A R A P I n dic e C ERT IFIC AR m u estras C om u n idad Registrarse Esc ritorio tec n ologas de serv idor y el sistem a

Aplicacin de escritorio UI Cuadros de dilogo Cuadro de dilogo Referencia Funciones del cuadro de dilogo CreateDialog CreateDialogIndirect CreateDialogIndirectParam CreateDialogParam DefDlgProc DialogBox DialogBoxIndirect DialogBoxIndirectParam DialogBoxParam DialogProc EndDialog GetDialogBaseUnits GetDlgCtrlID GetDlgItem GetDlgItemInt GetDlgItemText GetNextDlgGroupItem GetNextDlgTabItem IsDialogMessage MapDialogRect Mensajes MessageBoxEx MessageBoxIndirect SendDlgItemMessage SetDlgItemInt SetDlgItemText

Funcin MessageBox
320 de 411 MSDN - Valorar este tema Muestra un cuadro de dilogo modal que contiene un icono de sistema, un conjunto de botones, y un breve mensaje especfico de la aplicacin, como el estado o informacin de error. El cuadro de mensaje devuelve un valor entero que indica qu botn se hizo clic el usuario. Sintaxis
C++

i n tW I N A P IM e s s a g e B o x( _ I n _ o p t _H W N Dh W n d , _ I n _ o p t _L P C T S T Rl p T e x t , _ I n _ o p t _L P C T S T Rl p C a p t i o n , _ I n _U I N Tu T y p e ) ;

Parmetros hWnd [in, opcional] Tipo: HWND Un identificador de la ventana propietaria del cuadro de mensaje que se crear. Si este parmetro es NULL , el cuadro de mensaje no tiene ninguna ventana propietaria. lpText [in, opcional] Tipo: LPCTSTR El mensaje que se muestra. Si la cadena se compone de ms de una lnea, puede separar las lneas con un retorno de carro y / o carcter de salto de lnea entre cada lnea. lpCaption [in, opcional] Tipo: LPCTSTR El ttulo del cuadro de dilogo. Si este parmetro es NULL , el ttulo predeterminado es Error . uType [en] Tipo: UINT El contenido y el comportamiento del cuadro de dilogo. Este parmetro puede ser una combinacin de banderas de los siguientes grupos de indicadores. Para indicar los botones que aparecen en el cuadro de mensaje, especifique uno de los siguientes valores. Valor Significado El cuadro de mensaje contiene tres botones: Anular , Reintentar y Omitir .

MB_ABORTRETRYIGNORE 0x00000002L

MB_CANCELTRYCONTINUE 0x00000006L

El cuadro de mensaje contiene tres botones: Anular , Reintentar , Continuar . Utilice este tipo de cuadro de mensaje en lugar de MB_ABORTRETRYIGNORE.

msdn.microsoft.com/en-us/library/windows/desktop/ms645505(v=vs.85).aspx

1/7

10/09/13

Funcin MessageBox (Windows)

MB_HELP 0x00004000L

Agrega una ayuda botn para el cuadro de mensaje. Cuando el usuario hace clic en la Ayuda de botn o presiona F1, el sistema enva una WM_HELP mensaje al propietario. El cuadro de mensaje contiene un botn: en Aceptar . Este es el valor predeterminado.

MB_OK 0x00000000L

MB_OKCANCEL 0x00000001L

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

MB_RETRYCANCEL 0x00000005L

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

MB_YESNO 0x00000004L

El cuadro de mensaje contiene dos botones: S y no .

MB_YESNOCANCEL 0x00000003L

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

Para mostrar un icono en el cuadro de mensaje, especifique uno de los siguientes valores. Valor Significado Un icono de signo de exclamacin aparece en el cuadro de mensaje.

MB_ICONEXCLAMATION 0x00000030L

MB_ICONWARNING 0x00000030L

Un icono de signo de exclamacin aparece en el cuadro de mensaje.

MB_ICONINFORMATION 0x00000040L

Un icono que consiste en una letra minscula i en un crculo aparece en el cuadro de mensaje.

MB_ICONASTERISK 0x00000040L

Un icono que consiste en una letra minscula i en un crculo aparece en el cuadro de mensaje.

MB_ICONQUESTION 0x00000020L

Un icono de la pregunta aparece en el cuadro de mensaje. Ya no se recomienda el icono de mensaje pregunta, ya que no representa claramente un tipo especfico de mensaje y por la redaccin de un mensaje en forma de pregunta podra aplicarse a cualquier tipo de mensaje. Adems, los usuarios pueden confundir el mensaje smbolo de signo de interrogacin con informacin de ayuda. Por lo tanto, no use esta pregunta smbolo de mensaje de marca en sus cuadros de mensaje. El sistema contina apoyando su inclusin slo por compatibilidad con versiones anteriores. Un icono de seal de stop aparece en el cuadro de mensaje.

MB_ICONSTOP 0x00000010L

MB_ICONERROR

Un icono de seal de stop aparece en el cuadro de mensaje.

msdn.microsoft.com/en-us/library/windows/desktop/ms645505(v=vs.85).aspx

2/7

10/09/13

MB_ICONERROR 0x00000010L

Funcin MessageBox (Windows)

MB_ICONHAND 0x00000010L

Un icono de seal de stop aparece en el cuadro de mensaje.

Para indicar el botn predeterminado, especifique uno de los siguientes valores. Valor Significado El primer botn es el botn predeterminado. MB_DEFBUTTON1 es el valor predeterminado a menos MB_DEFBUTTON2 , MB_DEFBUTTON3 o MB_DEFBUTTON4 se especifica. El segundo botn es el botn predeterminado.

MB_DEFBUTTON1 0x00000000L

MB_DEFBUTTON2 0x00000100L

MB_DEFBUTTON3 0x00000200L

El tercer botn es el botn predeterminado.

MB_DEFBUTTON4 0x00000300L

El cuarto botn es el botn predeterminado.

Para indicar la modalidad del cuadro de dilogo, especifique uno de los siguientes valores. Valor Significado El usuario debe responder al cuadro de mensaje antes de continuar trabajando en la ventana identificada por el hWnd parmetro. Sin embargo, el usuario puede desplazarse a las ventanas de los otros temas y trabajar en las ventanas. Dependiendo de la jerarqua de las ventanas de la aplicacin, el usuario puede ser capaz de moverse a otras ventanas dentro de la rosca. Todas las ventanas secundarias de la matriz de la caja de mensajes estn desactivadas, pero las ventanas pop-up no lo son. MB_APPLMODAL es el valor predeterminado si no MB_SYSTEMMODAL ni MB_TASKMODAL se especifica. Igual que MB_APPLMODAL salvo que el cuadro de mensaje tiene el WS_EX_TOPMOST estilo. Utilice los cuadros de mensaje modal del sistema para notificar al usuario de errores graves, potencialmente dainos que requieren atencin inmediata (por ejemplo, el funcionamiento de la memoria). Este indicador no tiene ningn efecto sobre la capacidad del usuario para interactuar con ventanas distintas de las asociadas con hWnd . Igual que MB_APPLMODAL excepto que todas las ventanas de nivel superior pertenecen al subproceso actual se desactivan si el hWnd parmetro es NULL . Utilice este indicador cuando la aplicacin que llama o la biblioteca no tiene un identificador de ventana disponible, pero todava tiene que impedir la entrada de otras ventanas en el subproceso de llamada sin suspender otros temas.

MB_APPLMODAL 0x00000000L

MB_SYSTEMMODAL 0x00001000L

MB_TASKMODAL 0x00002000L

Para especificar otras opciones, utilizar uno o ms de los siguientes valores. Valor Significado Igual que el escritorio de la estacin de ventana interactiva. Para obtener

msdn.microsoft.com/en-us/library/windows/desktop/ms645505(v=vs.85).aspx

3/7

10/09/13

Funcin MessageBox (Windows)

MB_DEFAULT_DESKTOP_ONLY 0x00020000L Igual que el escritorio de la estacin de ventana interactiva. Para obtener ms informacin, consulte las estaciones de ventana . Si el escritorio de entrada actual no es el escritorio por defecto, de mensajes no vuelve hasta que el usuario cambia al escritorio por defecto. El texto est justificado a la derecha.

MB_RIGHT 0x00080000L

MB_RTLREADING 0x00100000L

Muestra mensajes y leyendas de texto mediante el orden de lectura de derecha a izquierda en sistemas hebreo y rabe.

MB_SETFOREGROUND 0x00010000L

El cuadro de mensaje se convierte en la ventana de primer plano. Internamente, el sistema llama al SetForegroundWindow funcin para el cuadro de mensaje. El cuadro de mensaje se crea con el WS_EX_TOPMOST estilo de ventana.

MB_TOPMOST 0x00040000L

MB_SERVICE_NOTIFICATION 0x00200000L

La persona que llama es un servicio de notificar al usuario de un evento. La funcin muestra un cuadro de mensaje en el escritorio activo actual, incluso si no hay sesin en el ordenador del usuario. Servicios de Terminal Server: Si el subproceso de la llamada tiene un testigo de suplantacin, la funcin dirige el cuadro de mensaje para la sesin especificada en el testigo de suplantacin. Si se establece este indicador, el hWnd parmetro debe ser NULL . Esto es para que el cuadro de mensaje puede aparecer en un equipo de escritorio que no sea el escritorio correspondiente al hWnd . Para obtener informacin sobre las consideraciones de seguridad en relacin con el uso de esta bandera, consulte Servicios Interactivos . En particular, tenga en cuenta que este indicador puede producir contenidos interactivos en un escritorio bloqueado y por lo tanto debe ser utilizado slo por un conjunto muy limitado de escenarios, tales como el agotamiento de los recursos.

Valor de retorno Tipo: int Si un cuadro de mensaje tiene una Cancel botn, la funcin devuelve el IDCANCEL valor si se presiona la tecla ESC o Cancelar se selecciona el botn. Si el cuadro de mensaje no ha Cancelar botn, presionar ESC no tiene ningn efecto. Si la funcin falla, el valor de retorno es cero. Para obtener informacin sobre el error, llamar a GetLastError . Si la funcin tiene xito, el valor de retorno es uno de los siguientes valores de elementos de men. Cdigo de retorno / valor Descripcin El Aborto se selecciona el botn.

IDABORT 3

IDCANCEL 2

La Cancelar se selecciona el botn.

IDCONTINUE 11

La Continue se selecciona el botn.

msdn.microsoft.com/en-us/library/windows/desktop/ms645505(v=vs.85).aspx

El Ignorar fue seleccionada botn.

4/7

10/09/13
IDIGNORE 5

Funcin MessageBox (Windows) El Ignorar fue seleccionada botn.

IDNO 7

El No se selecciona el botn.

IDOK 1

El bien se selecciona el botn.

IDRETRY 4

El reintento se selecciona el botn.

IDTRYAGAIN 10

El Intentar de nuevo se selecciona el botn.

IDYES 6

El S se selecciona el botn.

Observaciones Los siguientes iconos del sistema se pueden utilizar en un cuadro de mensaje mediante el establecimiento de la uType parmetro para el valor del indicador correspondiente. Icono Valores de la bandera MB_ICONHAND , MB_ICONSTOP o MB_ICONERROR

MB_ICONQUESTION

MB_ICONEXCLAMATION o MB_ICONWARNING

MB_ICONASTERISK o MB_ICONINFORMATION

Adicin de dos marcas de derecha a izquierda (RLMS), representada por el carcter de formato Unicode U +200 F, en el inicio de una cadena de visualizacin de mensajes es interpretado por el motor de procesamiento de mensajes con el fin de hacer que el orden de lectura de los mensajes que se representa como de derecha a izquierda (RTL). Cuando se utiliza un cuadro de mensaje modal del sistema para indicar que el sistema tiene poca memoria, las cadenas que apunta el lpText y lpCaption parmetros no debe ser tomada de un archivo de recursos, ya que un intento de cargar el recurso puede fallar. Si crea un buzn de mensajes, mientras que un cuadro de dilogo est presente, utilice un identificador para el cuadro de dilogo que el hWnd parmetro. El hWnd parmetro no debe identificar una ventana secundaria, tales como control en un cuadro de dilogo. Ejemplos En el siguiente ejemplo, la aplicacin muestra un cuadro de mensaje que pide al usuario una accin despus de haberse producido un error. El cuadro de mensaje muestra el mensaje que describe el error y cmo solucionarlo. El MB_CANCELTRYCONTINUE estilo dirige mensajes para proporcionar tres botones con los que el usuario puede elegir la forma de proceder. El MB_DEFBUTTON2 estilo ajusta el enfoque por defecto en el segundo botn del cuadro de mensaje, en este caso, la Intentar de nuevo el botn.

msdn.microsoft.com/en-us/library/windows/desktop/ms645505(v=vs.85).aspx

5/7

10/09/13
C++

Funcin MessageBox (Windows)

i n tD i s p l a y R e s o u r c e N A M e s s a g e B o x( ) { i n tm s g b o x I D=M e s s a g e B o x( N U L L , ( L P C W S T R )L" R e c u r s on od i s p o n i b l e\n D e s e ai n t e n t a r l od en u e v o ? ", ( L P C W S T R )L" D e t a l l e sd eC u e n t a ", M B _ I C O N W A R N I N G|M B _ C A N C E L T R Y C O N T I N U E|M B _ D E F B U T T O N 2 ) ; i n t e r r u p t o r( m s g b o x I D ) { c a s oI D C A N C E L : //T O D O :a g r e g a rc d i g od e r u p t u r a; c a s oI D T R Y A G A I N : //T O D O :a g r e g a rc d i g od e r u p t u r a; c a s oI D C O N T I N U E : //T O D O :a g r e g a rc d i g od e r u p t u r a; } v o l v e rm s g b o x I D ; }

La siguiente imagen muestra el resultado del ejemplo de cdigo anterior:

Otro ejemplo cuadro de mensaje, vase Visualizacin de un cuadro de mensaje . Requerimientos Cliente mnima soportada Servidor compatible mnima Windows 2000 Professional [aplicaciones de escritorio solamente] Windows 2000 Server [slo aplicaciones de escritorio]

Encabezamiento

Winuser.h (incluya Windows.h)

Biblioteca

User32.lib

DLL

User32.dll

Nombres Unicode y ANSI Vase tambin Referencia MessageBoxEx MessageBoxIndirect SetForegroundWindow msdn.microsoft.com/en-us/library/windows/desktop/ms645505(v=vs.85).aspx

MessageBoxW (Unicode) y MessageBoxA (ANSI)

6/7

10/09/13
SetForegroundWindow Conceptual Cuadros de dilogo Otros recursos FlashWindow MessageBeep

Funcin MessageBox (Windows)

Enve sus comentarios sobre este tema a Microsoft 06/11/2013: Fecha de la estructura

Adiciones Comunidad

AADIR

C en tros

Sitios relac ion ados desarrollador M ic rosof t C on n ec t . NET Fram ew ork Visu al Stu dio Win dow s P h on e Win dow s Serv er

Desc argas Win dow s 8 De Win dow s SDK para Win dow s 8 Visu al Stu dio Express 2012 T am bin

P rev ia desc argas 8. 1 de Win dow s Vista prev ia Visu al Stu dio Express 2013 P rev iew De Win dow s SDK para Win dow s 8. 1 Vista prev ia

Centro de desarrollo Inicio Aplicaciones de Windows Store Internet Explorer Escritorio Hardware

Fu n dam en tos Otros sitios de Win dow s Em presa L a pequ e a em presa Estu dian tes L os u su arios dom stic os Win dow s 8 A P Is M u estras C om patibilidad y C ertif ic ac in T ablero de esc ritorio

C on ec te c on n osotros Foros Ven tan as A pp Gen erador Blog Opc ion es de soporte

H ola desde Seattle.

Estados Un idos ( In gls)

T rm in os de u so

M arc as c om erc iales

P riv ac idad y C ookies

2013 M ic rosof t

msdn.microsoft.com/en-us/library/windows/desktop/ms645505(v=vs.85).aspx

7/7