WireLess Studio Widgets Developer's Guide
WSWDG ContentsWStForm class reference

ShowPopupMessage

Displays a popup dialog. If the timeout is set, the dialog will be close when that timeout is reached, otherwise the user can close the dialog by pressing a key.

Ole declaration

VARIANT_BOOL ShowPopupMessage(LPCTSTR sTittle, LPCTSTR sMessage, SHORT usTimeOut, LPCTSTR sTone);

Parameters
sTittle
The tittle of the popup dialog.
sMessage
The message displayed in the popup dialog.
usTimeOut
Specifies the time (in seconds) that the popup dialog will remain on the screen. If this parameter is zero, the user must press a key to close it.
sTone
Indicates the file name of the tone that will be played once the popup is shown. If this parameter is empty, the default error tone will be played.
Return Value

On success, ShowPopupMessage returns TRUE, FALSE otherwise. To get extended information, call WStError::GetLastErrorCode.

Remarks
Example
C#
using WirelessStudioOleWidgets;
WStForm oForm = new WStForm ();
oForm.ShowPopupMessage("WStudio", "This is a test", 10, "");
Visual Basic 6 (Full Example: PopupMsgDemoModule.bas.txt)
Public wsForm As New WStForm
...
If sObjectName = "showPopupBtn" Then
	If IsNumeric(wsWidget.GetTextByName("timeOutField")) Then
		iTimeOut = wsWidget.GetTextByName("timeOutField")
	End If

	bResult = wsForm.ShowPopupMessage(wsWidget.GetTextByName("popupTittleField"), _
	wsWidget.GetTextByName("popupField"), iTimeOut, "")
End If
...
See also

ShowMessageBox

WStWiget class reference | WStForm class reference | WStFactory class reference | WStError class reference