Class Hierarchy
AcApStatusBar
C++
class AcApStatusBar;
File
AcStatusBar.h
Description
The AcApStatusBar class enables customization of the AutoCAD drawing status bar. An application gets a pointer to an AcApStatusBar object by calling the AcApDocument::drawingStatusBar() function.
This class provides functions for adding panes and tray items to and removing them from the drawing status bar.
Panes are displayed in the main status bar area. For information about pane objects, see the AcPane class. Tray items are displayed in the tray icon area of the status bar. For information about tray item objects, see the AcTrayItem class.
The AcStatusBarItem class provides methods that support both panes and tray items.
To add a new pane to the status bar:
- Derive a class from AcPane and override the OnRButtonDown(), OnLButtonDown(), and OnLButtonDblClk() methods to customize the pane for the desired mouse event behavior.
- Call AcApStatusBar::Add(AcPane* pPane, bool bUpdate) or AcApStatusBar::Insert(AcPane* pPane, BOOL bUpdate).
To add a new tray item to the status bar tray icon area:
- Derive a class from AcTrayItem and override the OnRButtonDown(), OnLButtonDown(), and OnLButtonDblClk() methods to customize the tray item for the desired mouse event behavior.
- Call AcApStatusBar::Add(AcTrayItem* pTrayItem, BOOL bUpdate) or AcApStatusBar::Insert(AcTrayItem* pTrayItem, BOOL bUpdate).
Existing panes and tray items can be modified and removed using the additional AcApStatusBar methods.
Notes
If an application has added a pane or tray item to the status bar, it should remove the pane or tray item when it is unloaded.