STATUSBAR

PLBCMP GUI Only

The STATUSBAR object is a horizontal window at the bottom of a parent window. A PL/B application can display various kinds of status information in the STATUSBAR. To define a STATUSBAR, use one of the following statement formats:

(1)	[label]	STATUSBAR	[%]
(2)	[label]	STATUSBAR	(arraysize)
(3)	[label]	STATUSBAR	^
(4)	[label]	STATUSBAR	^,{label}
(5)	[label]	STATUSBAR	^(arraysize)
(6)	[label]	STATUSBAR	^(arraysize),({target}),...,({target})

Where:

label

Optional. A Data Label.

Optional. Denotes the item as being GLOBAL.

arraysize

Required. An integer decimal constant, CONST variable, or EQUATEd value indicating the number of array items.

Optional. Denotes the item as being a POINTER.

target

Required. The name of a previously defined data item of the same type.

Flags Affected: NONE

Note the following:

The STATUSBAR can be divided into panels to display more than one type of information. Each panel is represented by a STATUSPANEL object.
The STATUSBAR object is composed of multiple STATUSPANEL objects that can be added and removed using methods. Each panel can be accessed directly via a PANELS collection or retrieved into a STATUSPANEL object.
The PANELS collection allows direct access to the STATUSPANEL objects by the GETPROP or SETPROP statements. The collection uses the following format:

[label] GetProp {object}.Panels({key}),{property}

Where:

label

Optional. A Program Execution Label.

object

Required. A STATUSBAR object that is accessed.

key

Required. A Character String Variable or Numeric Variable that specifies the run-time name (RUNNAME property) or zero-based position of the panel.

property

Required. The remaining line of the GETPROP statement.

Multi-dimension arrays are supported up to a maximum of fourteen dimensions.
The ^ denotes Pointer Variable.
Although a STATUSBAR may be defined as Global, it is DESTROYed during a CHAIN instruction.
Using the PL/B Web Server (10.1A), this object is supported with the following limitations:

The SIZEGRIP property is not supported.
The AUTOSIZE property 'spring' setting only works for the last STATUSPANEL. Otherwise, the STATUSPANEL behavior uses 'content'.
There is no right-click action.
A Click event always returns a event result of zero.
STATUSPANEL tooltips are not supported.
CSS classes are used a follows:

Class	Applies to the...
plbsb	StatusBar
plbsbp	StatusPanel BDRSYTLE pain text
plbsbi	StatusPanel BDRSTYLE inset (Sunken)
plbsbo	StatusPanel BDRSTYLE outset (Raised)
plbsbz	StatusPanel last panel with spring.