Promotic
WikipediaLinkedInYoutubeTwitterFacebook

MessageBox - method of object Pm

Description:
Displays the message box and waits for the user's clicking the button. Returns a value corresponding to the pressed button.
Syntax:
MessageBox(sTitle As String, sText As String, [nStyle As Long]) As Long
Calling:
n = Pm.MessageBox(sTitle, sText, nStyle)
Parameters:
sTitle(String) String displayed in the message box title
sText(String) Text that is displayed in the message box. If the text has to be made out of more lines, then the vbCr, vbLf or vbCrLf constants can be used as separators.
nStyle[optional] (Long) Bit attributes definig window type and content.

Hexadecimal numbers can be entered by adding a prefix: for JavaScript it is 0x and for VBScript it is &H. For example, 0x10 or &H10 represents decimal 16 in hexadecimal notation.

It is possible to enter the following styles or their combinations as a sum:

&H0 (default) - Display only the OK button
&H1 - Display the OK and Cancel buttons
&H2 - Display the ABORT, RETRY and IGNORE buttons
&H3 - Display the YES, NO and Cancel buttons
&H4 - Display the YES and NO buttons
&H5 - Display the RETRY and Cancel buttons
&H10 - Display the "Critical Message" icon
&H20 - Display the "Warning Query" icon
&H30 - Display the "Warning Message" icon
&H40 - Display the "Information Message" icon
&H0 - The first button is the default
&H100 - The second button is the default
&H200 - The third button is the default
&H300 - The fourth button is the default
&H0 - Application modal mode. If the user wants to continue in the current application activities, then he must respond to the message box.
&H10000 - System modal mode. All applications are suspended until the user responds to the message box.
&H10000000 - The window will be "Always on top" over normal windows.
Return Values:
Returns a value corresponding to the pressed button. The values correspond to the following constants:
vbOK - OK button was clicked
vbCancel - Cancel button was clicked
vbAbort - ABORT button was clicked.
vbRetry - RETRY button was clicked.
vbIgnore - IGNORE button was clicked.
vbYes - YES button was clicked.
vbNo - NO button was clicked.
Note:
The Pm.InputBox method enables also to display required text and unlike to the MessageBox method the window position can be entered.
 
The method can also be called in the graphic item events for Web panels. So far the nStyle parameter is not functional for Web.
Example:
Displays the message box with a multiline text and with two buttons OK, Cancel
JavaScriptVBScriptSelect and copy to clipboard

var ret;
var sText = "I must do at home:";
sText += "\n 1) Wash the dishes";
sText += "\n 2) Clean up";
ret = Pm.MessageBox("Title", sText, 0x0+0x10000000);
if (ret == 1)
  //If the OK button has been pressed...
PROMOTIC 8.3.22 SCADA system documentation - MICROSYS, spol. s r.o.

Send page remarkContact responsible person
Navigation:
 
- Pm
 
- Abs
- Cos
- E
- Exp
- LN2
- MessageBox
 
 
- PI
- Pow
- Sin
- Tan
© MICROSYS, spol. s r. o.Tavičská 845/21 703 00 Ostrava-Vítkovice