Name

messagebox — Open a message box.

Calling Sequence

    [btn] = messagebox(msg)
    [btn] = messagebox(msg, msgboxtitle)
    [btn] = messagebox(msg, msgboxtitle, msgboxicon)
    [btn] = messagebox(msg, msgboxtitle, msgboxicon)
    [btn] = messagebox(msg, msgboxtitle, msgboxicon, buttons)
    [btn] = messagebox(msg, msgboxtitle, msgboxicon, buttons, ismodal)

Parameters

msg

Matrix of strings: the message box displays each entry of this matrix (one entry per line).

msgboxtitle

String: the title of the message box (default value is "Scilab Message").

msgboxicon

String: the name of the icon to be displayed in the message box, its possible values are:

  • "error"

  • "hourglass"

  • "info"

  • "passwd"

  • "question"

  • "warning"

  • "scilab": default icon

buttons

1xn vector of strings: the names of the buttons to be displayed in the message box. By default, only one button is displayed with label "OK".

modal

String: "modal" to create a modal dialog, any other string to create a non-modal dialog. Please note that "modal" can replace any of the other input arguments except msg (See examples).

btn

Scalar: number of the button that the user pressed (1 is the leftmost button) for a modal dialog, 0 else.

Description

Creates a dialog window to display a message waiting or not for a user action.

Examples

 
// Simple example
messagebox("Single line message")

// Multi line message with title
messagebox(["Multi-line" "message"], "User defined title")

// Icon specified by th euser
messagebox("An error message", "Error", "error")

// Buttons labels + "modal" replaces title
messagebox("Have you seen this beautiful message", "modal", "info", ["Yes" "No"])

// "modal" given as fifth input argument
messagebox("An error message", "Error", "error", ["Continue" "Stop"], "modal")

Authors

Vincent COUVERT