ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

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
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Programming a status bar
Overview
WINDEV allows you to handle a status bar and a cell found in a status bar through 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 cell created by StatusBarAddCell must be enclosed between indirection operators ({ }) in order to be handled by the 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.
// -- Initialization code of window
// Adds "MyCell" to the status bar of the current window
StatusBarAddCell("MyCell", 100, LightRed)
// Modifies the weight of the information displayed in "MyCell"
// The indirection operators are required for a cell created
// by MessageAddCell
{"MyCell"}..FontBold = True
// -- Optional code for mouse rollover
// Displays the coordinates of the mouse cursor in "MyCell"
Message("MyCell", MouseXPos() + " , " + MouseYPos())
WLanguage functions associated with the status bars
The following functions are associated with the status bars:
MessageDisplays (or erases) a message in the status bar of the current window.
ProgressBarDisplays a progress bar in the status bar of current window.
StatusBarAddCellAdds a cell into the status bar of the current window.
StatusBarDeleteCellDeletes a cell from the status bar of the current window.

Remark: The name of a cell created by StatusBarAddCell must be enclosed between indirection operators to be handled by the WLanguage properties.
WLanguage properties used to manage the status bars
The following properties are used to manage the status bars:
MessageUsed to find out and modify the help message associated with the control or with the window.
StatusBarUsed 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.
Minimum version required
  • Version 9
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help