fgl_message_box()

Displays an informative message box with one or more predefined buttons.

Syntax

fgl_message_box("title", "text", {0-4})

or

fgl_message_box(title_var, text_var, btn_var)

Parameters

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

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

btn, the conventional INTEGER value (or variable) that defines which pre-defined set of buttons to display

Usage and examples

fgl_message_box() produces an interactive message box with limited customization, with one or more buttons present:

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

The buttons displayed to the message box are set by the third parameter.

There are 5 predefined sets of buttons specified by a conventional INTEGER value:

• 0 – OK
• 1 – OK, Cancel
• 2 – Retry, Cancel
• 3 – Yes, No, Cancel
• 4 – Yes, No

The icon of the message box displayed by fgl_message_box() cannot be customized and depends on the selected set of buttons:

• exclamation for 0 and 1
• question for 2, 3, and 4

Try the example program, fgl_message_box_01, to see test it:

fgl_message_box() returns an INTEGER value that corresponds to the for the pressed button:

• 1 for OK or Yes
• 2 for Cancel
• 3 for No or Retry

Try the example program, fgl_message_box_02, to see how it works.

 

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

CALL fgl_message_box("", "This is the text of the test message.", 1)

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

CALL fgl_message_box("Title of the message", "", 1)

If the 3rd parameter is NULL, the message will have only one button, OK, and will nave no icon:

CALL fgl_message_box("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_message_box("Title of the message", "This is the 1st message line. \nThis is the 2nd message line.", 4)

 

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: