Popup Method

Displays text in a pop-up message box.

                      intButton = object.Popup(strText,[nSecondsToWait],[strTitle],[nType]) 

Arguments

• object
  WshShell object.

• strText
  String value that contains the text you want to appear in the pop-up message box.

• nSecondsToWait
  Optional. Numeric value indicating the maximum number of seconds you want the pop-up message box displayed. If nSecondsToWait is zero (the default), the pop-up message box remains visible until closed by the user.

• strTitle
  Optional. String value that contains the text you want to appear as the title of the pop-up message box.

• nType
  Optional. Numeric value indicating the type of buttons and icons you want in the pop-up message box. These determine how the message box is used.

• intButton
  Integer value indicating the number of the button the user clicked to dismiss the message box. This is the value returned by the Popup method.

Remarks

The Popup method displays a message box regardless of which host executable file is running (WScript.exe or CScript.exe).

If nSecondsToWait equals zero (the default), the pop-up message box remains visible until closed by the user. If nSecondsToWaitis is greater than zero, the pop-up message box closes after nSecondsToWait seconds.

If you do not supply the argument strTitle, the title of the pop-up message box defaults to "Windows Script Host."

Type Parameter

The meaning of the nType parameter is the same as it is in the Microsoft Win32 API MessageBox function. The following tables show the values and their meanings. You can add values in these tables to combine them.

Button Types

Icon Types

Other Type Values

The previous three tables do not cover all values for nType. For more information, see MessageBox Function.

Return Value

The return value intButton is the number of the button that the user clicked, or is -1 if the message box timed out. The following table lists possible return values.

Example

The following code generates a simple pop-up message box.

    Dim wshShell, btn
    Set wshShell = WScript.CreateObject("WScript.Shell")
    
    ' Call the Popup method with a 7 second timeout.
    btn = WshShell.Popup("Do you feel alright?", 7, "Question:", &H4 + &H20)
    
    Select Case btn
        ' Yes button pressed.
        case 6
            WScript.Echo "Glad to hear you feel alright."
        ' No button pressed.
        case 7
            WScript.Echo "Hope you're feeling better soon."
        ' Timed out.
        case -1
            WScript.Echo "Is there anybody out there?"
    End Select

var wshShell = WScript.CreateObject("WScript.Shell");

// Call the Popup method with a 7 second timeout.
var btn = wshShell.Popup("Do you feel alright?", 7, "Question:", 0x4 + 0x20);
switch(btn) {
    // Yes button pressed.
    case 6:
        WScript.Echo("Glad to hear you feel alright.");
        break;
    // No button pressed.
    case 7:
        WScript.Echo("Hope you're feeling better soon.");
        break;
    // Timed out.
    case -1:
       WScript.Echo("Is there anybody out there?");
       break;
}

Applies To:

WshShell Object

See Also

Reference

Echo Method

Change History