Class XbpStatusBar() Foundation
Class function of the XbpStatusBar() class
The class XbpStatusBar implements an Xbase Part that can be used by an Xbase++ application to inform the user of the application's status. An XbpStatusBar object consists of one or more panels, each of which can display status text as well as an application-defined image.
Possible uses of the XbpStatusBar class include:
Using the XbpStatusBar Xbase Part
An instance of the XbpStatusBar class is created by calling its :new() method followed by :create(). After the object is created, an application uses the object's instance variables and methods to assign the status text and/or image to be displayed by the Xbase Part. The visible area of an XbpStatusBar object can be divided into one or more status bar panels, each of which can display a status message and image. A status bar panel is defined using the method :addItem(). An XbpStatusBar object can hold up to 16 panels.
Usage in MDI applications
In so-called MDI applications, one or more child or document windows can be displayed within the main window of the application. MDI applications are created by making the XbpDialog objects representing the child windows a child of the :drawingArea of the main window. Afterwards, the child windows can be moved freely within the drawing area of the main window. The child dialogs overlap each other as well as all other childs defined in the :drawingArea of the main window. This is to be taken into account when using the XbpStatusBar class within the main window of an MDI application. In this case, the status bar often visualizes the global application status and hence should be visible at all times. In order to prevent the status bar from being hidden by overlapping child dialogs, the status bar should be created as a child of the main window (XbpDialog), and not as a child of the main window's drawing area. Also, the dimension of the drawing area must be reduced by the height of the status bar, and the position must be adjusted accordingly.
If you see anything in the documentation that is not correct, does not match your experience with the particular feature or requires further clarification, please use this form to report a documentation issue.