Message (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Characteristics of the message
Generated error
Message and MDI child window

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Message (Function)

In french: Message

Displays (or erases) a message in the status bar of current window or browser.

Remark: The window or the browser window must have a status bar.

If the status bar is divided into several cells, you have the ability to specify the cell where the message is displayed.

To easily share code between the WINDEV and WEBDEV applications, this function has no effect in server code.

Versions 15 and later

This function is now available for Java applications.

New in version 15

This function is now available for Java applications.

Example

Message("Processing...")
MyProcess() // Procedure used to perform the requested process
Message("Ready")

// Message in the "MCB_Info" cell
Message(MCB_Info, "Enter your name")

// Message with scroll
Message("Welcome!", Scrolling, 5)

Syntax

Displaying or erasing a message in the status bar Hide the details

Message([<Text>])

<Text>: Optional character string (with quotes)

Text to display (up to 127 characters).
If this parameter is not specified, the message previously displayed in the status bar is erased.
If the status bar is divided into several cells, this text will be displayed in the first cell.

If this parameter contains the "HH:MM" string, this string is automatically replaced by the system time of the current computer.
To display the "&" character, this character must be typed twice otherwise the letter following this character will be underlined.

Displaying or erasing a message in a cell of status bar Hide the details

Message(<Cell name> , <Text>)

<Cell name>: Character string (with or without quotes)

Name of cell to use. If the cell was created:
in the window editor, the cell name can be specified without quotes.
by StatusBarAddCell, the cell name must be specified between quotes (you also have the ability to use the External keyword).

<Text>: Character string (with quotes)

Text to display (up to 127 characters).
If this parameter is not specified, the message previously displayed in the status bar is erased.

Displaying a scrolling message Hide the details

Message([<Text> [, <Option> [, <Spacing>]]])

<Text>: Optional character string

Text to display (up to 127 characters).
If this parameter is not specified, the message previously displayed in the status bar is erased.
If this parameter contains the "HH:MM" string, this string is automatically replaced by the system time of the current computer.
To display the "&" character, this character must be typed twice otherwise the letter following this character will be underlined.

<Option>: Optional constant

Specifies whether the message scrolls:
Scrolling The message will scroll

<Spacing>: Optional integer

Size (in number of characters) between the end of the message and the beginning of the next message. If this parameter is not specified, if it is equal to 0 or if it is a negative number, this spacing corresponds to the number of characters in the message.

Remarks

Characteristics of the message

The message is aligned to left.

The text displayed in the status bar or in the first cell of a multi-cell status bar is automatically erased when the user selects a control associated with a help message: the help message of this control will be displayed in the status bar.

Generated error

A WLanguage error occurs if Message is called from a process of the "Project code" (initialization of the project, closing the project or closing a session).

Message and MDI child window

Message used from an MDI child window without status bar is using the status bar of the parent window.

Component: wd260obj.dll