guiShowMessage (Function)

This function shows a dialog, that contains a message and a number of buttons.

The dialog closes either when the user selects one of the buttons, or when it times out.

Input:

message : STRING

The message to show to the user

timeout : INT (-1, 0..3600) default -1

The number of seconds without activity before the dialog closes by itself. Use -1 for no timeout.

type : INT

The type of buttons to show:

 0        - OK button

 1        - OK and Cancel buttons

 2        - Yes and No buttons

 3        - Yes, No and Cancel buttons.

Returns: INT

Declaration:

FUNCTION guiShowMessage : INT;
VAR_INPUT
  message : STRING;
  type    : INT;
  timeout : INT := -1;
END_VAR;

Example:

INCLUDE rtcu.inc
 
PROGRAM test;
VAR
  rc     : INT;
END_VAR;
 
BEGIN
  ...
  // Show an OK dialog that disappears after 10 seconds
  rc := guiShowMessage(message := "The task is done!", type:=0, timeout:=10);
  ...
END;
END_PROGRAM;