MsgBox (Funcin, Visual Basic)

Muestra un mensaje en un cuadro de dilogo, espera a que el usuario haga clic en un botn y devuelve un entero que indica el
botn utilizado.
Public Function MsgBox( _
ByVal Prompt As Object, _
Optional ByVal Buttons As MsgBoxStyle = MsgBoxStyle.OKOnly, _
Optional ByVal Title As Object = Nothing _
) As MsgBoxResult
Parmetros
Prompt
Obligatorio. Expresin de tipo String que se muestra como mensaje en el cuadro de dilogo. La longitud mxima de
Prompt es de aproximadamente 1024 caracteres, segn el ancho de los caracteres utilizados. Si Prompt consta de ms
de una lnea, puede separar las lneas mediante un carcter de retorno de carro (Chr(13)), un carcter de avance de lnea
(Chr(10)) o una combinacin de caracteres de retorno de carro/avance de lnea (Chr(13) y Chr(10)) entre cada lnea.
Buttons
Opcional. Expresin numrica que corresponde a la suma de los valores que especifican el nmero y tipo de botones
que se han de mostrar, el estilo de icono que se va a usar, la identificacin del botn predeterminado y la modalidad del
cuadro de mensaje. Si se omite Buttons, el valor predeterminado ser cero.
Title
Opcional. Expresin de tipo String que se muestra en la barra de ttulo del cuadro de dilogo. Si se omite Title, en la
barra de ttulo aparecer el nombre de la aplicacin.
Valores
En la siguiente tabla se incluyen los valores de enumeracin de MsgBoxStyle:
Miembro Valor Descripcin
OKOnly 0 Muestra slo el botn Aceptar.
OKCancel 1 Muestra los botones Aceptar y Cancelar.
AbortRetryIgnore 2 Muestra los botones Anular, Reintentar y Omitir.
YesNoCancel 3 Muestra los botones S, No y Cancelar.
YesNo 4 Muestra los botones S y No.
RetryCancel 5 Muestra los botones Reintentar y Cancelar.
Critical 16 Muestra el icono Mensaje crtico.
Question 32 Muestra el icono Consulta de advertencia.
Exclamation 48 Muestra el icono Mensaje de advertencia.
Information 64 Muestra el icono Mensaje de informacin.
DefaultButton1 0 El primer botn es el predeterminado.
DefaultButton2 256 El segundo botn es el predeterminado.
DefaultButton3 512 El tercer botn es el predeterminado.
ApplicationModal 0 Aplicacin modal: el usuario debe responder al cuadro de mensaje antes de continuar
trabajando en la aplicacin actual.
SystemModal 4096 Sistema modal: se suspenden todas las aplicaciones hasta que el usuario responda al
cuadro de mensaje.
MsgBoxSetForeground 65536 Especifica la ventana del cuadro de mensaje como ventana de primer plano.
MsgBoxRight 524288 Texto alineado a la derecha.
MsgBoxRtlReading 1048576 Especifica que el texto debe aparecer para ser ledo de derecha a izquierda en los sistemas
rabe y hebreo.
El primer grupo de valores (0-5) describe el nmero y tipo de botones mostrados en el cuadro de dilogo. El segundo grupo (16,
32, 48, 64) describe el estilo de icono. El tercer grupo (0, 256, 512) determina qu botn es el valor predeterminado. El cuarto
grupo (0, 4096) determina la modalidad del cuadro de mensaje y el quinto grupo especifica si el cuadro de mensaje es la
ventana de primer plano, junto con la alineacin y la direccin del texto. A la hora de sumar nmeros para crear el valor final del
argumento Buttons, se deber utilizar nicamente un nmero de cada grupo.
Valor devuelto
Constante Valor
OK 1
Cancel 2
Abort 3
Retry 4
Ignore 5
Yes 6
No 7
Excepciones
Tipo de excepcin Nmero de
error
Condicin
ArgumentException 5
Prompt no es una expresin String o Title no es vlido.
InvalidOperationException 5
El proceso no se est ejecutando en modo interactivo de usuario.
InvalidEnumArgumentException 5
Uno o ms parmetros no son miembros de la enumeracin MsgBoxResult o
MsgBoxStyle.
Consulte la columna "Nmero de error" si est actualizando aplicaciones de Visual Basic 6.0 que utilizan el control de errores no
estructurado. (Se puede comparar el nmero de error con respecto a Number (Propiedad, objeto Err)). Sin embargo, siempre que
sea posible, se debe considerar la sustitucin de dicho control de errores por Informacin general sobre el control estructurado de
excepciones de Visual Basic.