Back to main index

2.2.4   Show Message

The .in file

Attributes in [Head] section:

Type: 103
Allowed Mode: 0 (try once), 1 (try until success)
Allowed Blocking: 0 (non blocking), 1 (blocking)

Attributes in [ShowMessage] section:

• ShowMessageCaption: The caption text for the message window
• ShowMessageMessage: The message text for the message window
• ShowMessageButtons: The buttons to display under the message

  ShowMessageButtons	Description
  1	Ok button
  2	Ok and cancel button (single choice)
  3	Yes and no button (single choice)

Sample .in file: This request shows a sample message and waits until the user clicks on the yes  or no button.

[Head] Type=103 Mode=0 Blocking=0 [ShowMessage] ShowMessageCaption=I am the caption ShowMessageMessage=And I am the message. Please confirm with yes or no button! ShowMessageButtons=3

The .out file

Attributes in [ShowMessage] section:

• ShowMessageResult: Result code

  ShowMessageResult	Description
  -2	Message can't be shown while the application is in option menu
  -1	Message was not shown
  1	Message was shown

• ShowMessageResultDesc: A textual description of ShowMessageResult
• ShowMessageCaption: The ShowMessageCaption attribute given in the .in file
• ShowMessageMessage: The ShowMessageMessage attribute given in the .in file
• ShowMessageButtons: The ShowMessageButtons attribute given in the .in file

• ShowMessageUserFeedback	Description
  1	Ok button
  2	Cancel button
  3	Yes button
  4	No button

Sample .out file: The message window was shown and the user clicked on the yes button

[Head] Type=103 TypeDesc=show message Mode=0 ModeDesc=try once Blocking=0 BlockingDesc=not blocking Timestamp=697856109 Id=697856062 Result=2 ResultDesc=success and request deleted ExecuteDuration=6906 [ShowMessage] ShowMessageResult=1 ShowMessageResultDesc=message shown ShowMessageCaption=I am the caption ShowMessageMessage=And I am the message. Please confirm with yes or no button! ShowMessageButtons=3 ShowMessageUserFeedback=3 ShowMessageUserFeedbackDesc=yes