Programming a status bar

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / Developing an application or website / Controls, windows and pages / Controls: Available types / Status Bar control

Overview
Inserting a cell into the status bar of the current window
How to?
Example
WLanguage functions associated with the status bars
WLanguage properties used to manage the status bars

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

Status bar of windows

Programming a status bar

Overview

WINDEV allows you to manipulate a status Bar and a status Bar cell directly by programming.. To do so, use the variable of the status bar or the variable of the cell in the code.

The variable of a status bar corresponds to the name of the status bar. The variable of a cell found in a status bar corresponds to the name of the cell.

Inserting a cell into the status bar of the current window

How to?

To insert a cell programmatically in a status bar, use StatusBarAddCell.

Then, this cell can be handled by several properties. Caution: The name of a box created with the StatusBarAddCell function must be surrounded by indirection operators ({ }) to be manipulated with WLanguage properties.

Example

The following example adds a cell in the status bar of the current window.

This cell displays the coordinates of the mouse cursor. The background of this cell is red. The font used in this cell is bold.

// -- Code d'initialisation de la fenêtre
// Ajoute la case "MaCase" dans la barre de message de la fenêtre en cours
StatusBarAddCell("MaCase", 100, LightRed) 
// Modifie la graisse des informations affichées dans la case "MaCase"
// Les opérateurs d'indirection sont nécessaires avec une case créée 
// avec la fonction MessageAjouteCase
{"MaCase"}..FontBold = True

// -- Code optionnel de survol de la souris
// Affiche les coordonnées du curseur de la souris dans la case "MaCase"
Message("MaCase", MouseXPos() + " , " + MouseYPos())

WLanguage functions associated with the status bars

The following functions are associated with the status bars:


Message	Displays (or erases) a message in the status bar of the current window.
ProgressBar	Displays a progress bar in the status bar of current window.
StatusBarAddCell	Adds a cell into the status bar of the current window.
StatusBarDeleteCell	Deletes a cell from the status bar of the current window.

Note: The name of a box created with the StatusBarAddCell function must be surrounded by indirection operators to be manipulated with WLanguage properties.

WLanguage properties used to manage the status bars

The following properties are used to manage status bars:


Message	Used to find out and modify the help message associated with the control or with the window.
StatusBar	Used to find out whether the status bar of window is enabled and to enable it if necessary.

Specific properties are also available for each cell found in a status bar. For more details, see Properties associated with the cells of the status bars.