PowerShell Popup Method

wshq

Popup Method

1 out of 1 rated this helpful-
Rate this topic
　　Updated: September 2010
　　Displays text in a pop-up message box.





Copy



                      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. IfnSecondsToWait 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 thePopup 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. IfnSecondsToWaitis is greater than zero, the pop-up message box closes afternSecondsToWait
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 APIMessageBox function. The following tables show the values and their meanings. You can add values in these tables to combine
them.

Button Types

　　Decimal value
　　Hexadecimal value
　　Description



　　0


　　0x0


　　Show OK button.




　　1


　　0x1


　　Show OK and Cancel buttons.




　　2


　　0x2


　　Show Abort, Retry, and
Ignore buttons.




　　3


　　0x3


　　Show Yes, No, and
Cancel buttons.




　　4


　　0x4


　　Show Yes and No buttons.




　　5


　　0x5


　　Show Retry and Cancel buttons.




　　6


　　0x6


　　Show Cancel, Try Again, andContinue buttons.





Icon Types

　　Decimal value
　　Hexadecimal value
　　Description



　　16


　　0x10


　　Show "Stop Mark" icon.




　　32


　　0x20


　　Show "Question Mark" icon.




　　48


　　0x30


　　Show "Exclamation Mark" icon.




　　64


　　0x40


　　Show "Information Mark" icon.





Other Type Values

　　Decimal value
　　Hexadecimal value
　　Description



　　256


　　0x100


　　The second button is the default button.




　　512


　　0x200


　　The third button is the default button.




　　4096


　　0x1000


　　The message box is a system modal message box and appears in a topmost window.




　　524288


　　0x80000


　　The text is right-justified.




　　1048576


　　0x100000


　　The message and caption text display in right-to-left reading order, which is useful for some languages.




　　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.



　　Decimal value
　　Description



　　-1


　　The user did not click a button before nSecondsToWait seconds elapsed.




　　1


　　OK button




　　2


　　Cancel button




　　3


　　Abort button




　　4


　　Retry button




　　5


　　Ignore button




　　6


　　Yes button




　　7


　　No button




　　10


　　Try Again button




　　11


　　Continue button







Example :

# Popup the message

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

$a = new-object -comobject wscript.shell

$intAnswer = $a.popup("Do you ?", 0, "Delete", 4)

if($intAnswer -eq 6)

{

$a.popup("yes")

}

else

{

$a.popup("no")

}