Método DoAlert

Microsoft Office Objects

Mostrar todo

Método DoAlert

       

Muestra una alerta y devuelve un valor Long que indica qué botón ha presionado el usuario. Puede mostrar la alerta mediante el Ayudante de Microsoft Office o como un cuadro de mensaje normal.

expresión.DoAlert(bstrAlertTitle, bstrAlertText, alb, alc, ald, alq, varfSysAlert)

expresión   Requerida. Expresión que devuelve uno de los objetos de la lista Aplicar a.

bstrAlertTitle  String requerida. Establece el título de la alerta.

bstrAlertText   String requerida. Establece el texto de la alerta.

alb  MsoAlertButtonType requerido. Determina qué botones se mostrarán en la alerta.

MsoAlertButtonType puede ser una de estas constantes de MsoAlertButtonType.
msoAlertButtonAbortRetryIgnore
msoAlertButtonOK
msoAlertButtonOKCancel
msoAlertButtonRetryCancel
msoAlertButtonYesAllNoCancel Utilícelo sólo si el argumento varfSysAlert está establecido a False.
msoAlertButtonYesNo
msoAlertButtonYesNoCancel

alc  MsoAlertIconType requerido. Determina el icono que aparece en la alerta.

MsoAlertIconType puede ser una de estas constantes de MsoAlertIconType.
msoAlertIconCritical
msoAlertIconInfo
msoAlertIconNoIcon
msoAlertIconQuery
msoAlertIconWarning

ald  MsoAlertDefaultType requerido. Determina qué botón está establecido como el predeterminado de la alerta. Si este argumento está establecido a un valor superior al número de botones, devolverá un error.

MsoAlertDefaultType puede ser una de estas constantes de MsoAlertDefaultType.
msoAlertDefaultFifth
msoAlertDefaultFirst
msoAlertDefaultFourth
msoAlertDefaultSecond
msoAlertDefaultThird

alq  MsoAlertCancelType requerido. Se debe establecer siempre a msoAlertCancelDefault. Cualquier otra configuración puede devolver un error.

MsoAlertCancelType puede ser una de estas constantes de MsoAlertCancelType.
msoAlertCancelDefault
msoAlertCancelFifth
msoAlertCancelFirst
msoAlertCancelFourth
msoAlertCancelSecond
msoAlertCancelThird

varfSysAlert   Boolean requerido. True si la alerta se muestra en un cuadro de mensaje o False si se muestra en el Ayudante de Office.

Comentarios

Los valores devueltos del método DoAlert corresponden a los valores del tipo vbMsgBoxResult enumerado (por ejemplo, vbYes, vbNo o vbCancel). Además de estos valores, también se pueden devolver los siguientes:

  • "Yes to all" = 8
  • "Try again" = 10
  • "Continue" = 11

Ejemplo

El ejemplo siguiente muestra una alerta mediante el Ayudante de Office y un cuadro de mensaje que indica qué botón ha presionado el usuario. Si el ayudante está deshabilitado, la alerta se mostrará en un cuadro de mensaje normal.

Sub AssistantAlert()
    With Application.Assistant
        Select Case _
            .DoAlert( _
            "Test", _
            "Click a button.", _
            msoAlertButtonYesAllNoCancel, _
            msoAlertIconCritical, _
            msoAlertDefaultSecond, _
            msoAlertCancelFirst, _
            False)

            Case vbYes: MsgBox "The user clicked Yes."
            Case vbNo: MsgBox "The user clicked No."
            Case vbCancel: MsgBox "The user clicked Cancel."
            Case 8: MsgBox "The user clicked Yes To All" 'This is the return value for YesToAll
            Case Else
        End Select
    End With
End Sub