CATDlgStatusBar

3D PLM Enterprise Architecture	User Interface - Dialogs	CATDlgStatusBar Displays application or window information
Quick Reference

CATDialog
  |
  +---CATDlgBar
        |
        +---CATDlgStatusBar

*The Status Bar*

The status bar is used to display temporary or permanent information information related to the application status, such as the prompts of the active command or its messages, and a keyboard entry field that used by the application PowerInput. It is generally located at the bottom of the window. It can also include push buttons, check buttons, radio buttons, and labels.

Use the status bar when you want to give applicatoin status information.

[Top]

Events
Notification	Method	Sent when
CATDlgEditModifyNotification	`GetEditModifyNotification`	Whenever the end user edits the PowerInput entry field

[Top]

Programmer's Guide

The parent of a status bar must be an instance of the class CATDlgDocument, which can contain only one status bar instance. The labels or buttons instances which have a status bar as father are arranged from left to right in their creation order, left of a defaulted message area.

[Top]

Constructing a Status Bar

Construct a status bar as follows:

_pStatusbar = new CATDlgStatusBar(iParent, iName)

[Top]

Managing the PowerInput

You can set or get the PowerInput mode:

set the PowerInput mode with the SetPowerInputMode method:
int PowerInputMode = 1; _pStatusbar->SetPowerInputMode(PowerInputMode);
Valid values are:

1 The PowerInput is enabled

0 The PowerInput is disabled

get the PowerInput mode with the GetPowerInputMode method:

int PowerInputMode;
PowerInputMode= _pStatusbar->GetPowerInputMode();

You can set or get the PowerInput label:

set the PowerInput label with the SetPowerInputLabel method:

CATUnicodeString PowerInputLabel = ... ;
_pStatusbar->SetPowerInputLabel(PowerInputLabel);

get the PowerInput label with the GetPowerInputLabel method:

CATUnicodeString PowerInputLabel;
PowerInputLabel = _pStatusbar->GetPowerInputLabel();

You can set or get the PowerInput text:

set the PowerInput text with the SetPowerInputText method:

CATUnicodeString PowerInputText = ... ;
_pStatusbar->SetPowerInputText(PowerInputText);

get the PowerInput text with the GetPowerInputText method:

CATUnicodeString PowerInputText;
PowerInputText = _pStatusbar->GetPowerInputText();

You can set the PowerInput state with the SetPowerInputState method:

int PowerInputState = ... ;
_pStatusbar->SetPowerInputText(PowerInputText);

Valid values are:

0	The PowerInput entry must be associated with the active dialog box
1	The PowerInput entry was caught by the CATApplicationDocument
2	The PowerInput entry cannot be decoded

You can get the PowerInput field separator with the GetFieldSeparator method:

CATUnicodeChar PowerInputSeparator;
PowerInputSeparator = _pStatusbar->GetFieldSeparator();

[Top]

History

Version: 1 [Jan 2000]	Document created
[Top]

3D PLM Enterprise Architecture

User Interface - Dialogs