Msg

Displays a modal dialog box that contains a system icon, a set of buttons, and a brief application-specific message, such as status or error information. The message box returns an integer value that indicates which button the user clicked.

Syntax

msg(text)
msg(text, title)
msg(text, title, flags)

Parameters

| text | The message to be displayed. | | title | The dialog box title. If this parameter is NULL, the default title is Nilesoft Shell. | | flags | The contents and behavior of the dialog box. This parameter can be a combination of flags from the following groups of flags. |

Flags

To display an icon in the message box, specify one of the following values.

msg.errorA stop-sign icon appears in the message box.msg.questionA question-mark icon appears in the message box.msg.warningAn exclamation-point icon appears in the message box.msg.infoAn icon consisting of a lowercase letter i in a circle appears in the message box.

To indicate the buttons displayed in the message box, specify one of the following values.

msg.okThe message box contains one push button: OK. This is the default.msg.okcancelThe message box contains two push buttons: OK and Cancel.msg.yesnocancelThe message box contains three push buttons: Yes, No, and Cancel.msg.yesnoThe message box contains two push buttons: Yes and No.

To indicate the default button, specify one of the following values.

msg.defbutton1The first button is the default button.msg.defbutton2The second button is the default button.msg.defbutton3The third button is the default button.

To indicate the modality of the dialog box, specify one of the following values.

msg.applmodalThe user must respond to the message box before continuing work in the current window. However, the user can move to the windows of other threads and work in those windows. msg.taskmodalSame as msg.applmodal except that all the top-level windows belonging to the current thread are disabled.

To specify other options, use one or more of the following values.

msg.rightThe text is right-justified.msg.rtlreadingDisplays message and caption text using right-to-left reading order on Hebrew and Arabic systems.msg.setforegroundThe message box becomes the foreground window.msg.topmost

Return value

If a message box has a Cancel button, the function returns the msg.idcancel value if either the ESC key is pressed or the Cancel button is selected. If the message box has no Cancel button, pressing ESC will no effect - unless an msg.ok button is present. If an msg.ok button is displayed and the user presses ESC, the return value will be msg.idok.

If the function fails, the return value is zero.
If the function succeeds, the return value is one of the following values:

msg.idok or 1The OK button was selected.msg.idcancel or 2The Cancel button was selected.msg.idyes or 6The Yes button was selected.msg.idno or 7The No button was selected.

Examples

msg("Hello, Warld!","NileSoft Shell", msg.info | msg.ok)
msg("Hello, Warld!","NileSoft Shell")
msg("Hello, Warld!")

msg.beep(type)

Plays a waveform sound. The waveform sound for each sound type is identified by an entry in the registry.

Syntax

msg.beep
msg.beep(msg.error)
msg.beep(msg.warning)