Displays text in a pop-up message box.
intButton = object.Popup(strText,[nSecondsToWait],[strTitle],[nType])
- 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.
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
Value | Description |
|---|
0 | Show OK button. |
1 | Show OK and Cancel buttons. |
2 | Show Abort, Retry, and Ignore buttons. |
3 | Show Yes, No, and Cancel buttons. |
4 | Show Yes and No buttons. |
5 | Show Retry and Cancel buttons. |
Icon Types
Value | Description |
|---|
16 | Show "Stop Mark" icon. |
32 | Show "Question Mark" icon. |
48 | Show "Exclamation Mark" icon. |
64 | Show "Information Mark" icon. |
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.
Value | Description |
|---|
1 | OK button |
2 | Cancel button |
3 | Abort button |
4 | Retry button |
5 | Ignore button |
6 | Yes button |
7 | No button |
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;
}
Reference