Popup Method

Displays text in a pop-up message box.

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

Arguments

object

WshShell object.

strText

String value containing the text you want to appear in the pop-up message box.

nSecondsToWait

Optional. Numeric value indicating the maximum length of time (in seconds) you want the pop-up message box displayed.

strTitle

Optional. String value containing 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 nSecondsToWaitis 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." The meaning of nType is the same as in the Microsoft Win32® application programming interface MessageBox function. The following tables show the values and their meanings. You can combine values in these tables.

Note   To display text properly in RTL languages such as Hebrew or Arabic, add hex &h00100000 (decimal 1048576) to the nType parameter.

Button Types

Icon Types

The previous two tables do not cover all values for nType. For a complete list, see the Microsoft Win32 documentation.

The return value intButton denotes the number of the button that the user clicked. If the user does not click a button before nSecondsToWait seconds, intButton is set to -1.

Example

The following code generates a simple pop-up window.

Dim WshShell, BtnCode
Set WshShell = WScript.CreateObject("WScript.Shell")

BtnCode = WshShell.Popup("Do you feel alright?", 7, "Answer This Question:", 4 + 32)

Select Case BtnCode
   case 6      WScript.Echo "Glad to hear you feel alright."
   case 7      WScript.Echo "Hope you're feeling better soon."
   case -1     WScript.Echo "Is there anybody out there?"
End Select

var WshShell = WScript.CreateObject("WScript.Shell");
var BtnCode = WshShell.Popup("Do you feel alright?", 7, "Answer This Question:", 4 + 32);
switch(BtnCode) {
   case 6:
      WScript.Echo("Glad to hear you feel alright.");
      break;
   case 7:
      WScript.Echo("Hope you're feeling better soon.");
      break;
   case -1:
      WScript.Echo("Is there anybody out there?");
      break;
}

See Also

WshShell Object | Echo Method