Message (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help

WLanguage

WLanguage functions

Standard functions

Windows management functions

Dialog Box functions

WLanguage procedure

Message

Presentation

Example

Characteristics of the message

Generated error

Message and MDI child window

See also

Message (Function)

In french: Message

Displays or removes a message from the status bar of the 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.

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

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 with 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

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 Extern keyword).

<Text>: 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.

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 with 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 the 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, uses the status bar of the parent window.

Component: wd270obj.dll