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
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. |
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 |
Example
The following code generates a simple pop-up window.
Visual Basic Script | Copy Code |
---|---|
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 |
JScript | Copy Code |
---|---|
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; } |