fgl_winmessage()

Displays an informative message box with one button.

Syntax

fgl_winmessage("title", "text", "icon")

or

fgl_winmessage(title_var, text_var, icon_var)

Parameters

title, the title of the message box (a string of characters or a variable of the STRING or CHAR data type)

text, the text that will be displayed in the message box (a string of characters or a variable of the STRING or CHAR data type)

icon, the conventional name of the icon that will be displayed in the message box (a string of characters or a variable of the STRING or CHAR data type)

Usage and examples

fgl_winmessage() produces a semi-interactive and almost non-customizable message box with one button, OK.

The purpose of this message is only to notify a user without getting any feedback.

Here is the simplest possible message dialog:

CALL fgl_winmessage("Title of the message", "This is the text of the test message", "info")

 

With fgl_winmessage(), you can customize only the title and the text of the message box.

Buttons cannot be set or changed.

There are four icons that can be used in message boxes produced by fgl_winmessage() – info, exclamation, question, and stop:

 

If the 1st parameter is NULL, the message will have no title:

CALL fgl_winmessage("", "This is the text of the test message.", "info")

If the 2nd parameter is NULL, the message will have no text:

CALL fgl_winmessage("Title of the message", "", "info")

If the 3rd parameter is NULL, the message will have no icon:

CALL fgl_winmessage("Title of the message", "This is the text of the test message.", "")

 

To display the message text in several lines, you must add \n in the place where the new line must start:

CALL fgl_winmessage("Multiple lines", "This is the 1st message line. \nThis is the 2nd message line.", "info")

 

You can change the appearance on the message box by applying css styles.

Exact selectors depend on what Lycia version you use, jquery or Material Design one:

• the whole message box:

  .qx-mb-dialog

• the title of the message box (only jquery Lycia):

  .qx-mb-dialog .ui-dialog-title

• the text in a message box:

  .qx-mb-dialog pre

  .qx-mb-dialog .qx-message-box-text

• the buttons of the message box:

  .qx-mb-dialog .qx-winmessage-button

  .qx-mb-dialog .qx-button-wrapper .qx-winmessage-button

For example,

jquery Lycia:

Material Design Lycia: