3D PLM Enterprise Architecture |
User Interface - Dialogs |
CATDlgToolbarArranges commands |
| Quick Reference | ||
CATDialog
|
+---CATDlgBar
|
+---CATDlgToolBar
| The toolbar gathers related commands, usually displayed using icons. These commands are often also presented in menus. Some commands can be gathered in an icon box, as in a submenu. Each command in a toolbar is either a push item, a check item, or a radio item. They can be separated by separator items. |
Use the toolbar when you want to group commands that relate to each other.
| Name | Description |
|---|---|
| CATDlgTlbDockOnTop | The toolbar is displayed horizontally and is attached to the top side of the main application window. This is the default |
| CATDlgTlbDockOnBottom | The toolbar is displayed horizontally and is attached to the botom side of the main application window |
| CATDlgTlbDockOnLeft | The toolbar is displayed vertically and is attached to the left side of the main application window |
| CATDlgTlbDockOnRight | The toolbar is displayed vertically and is attached to the right side of the main application window |
| CATDlgTlbUnDock | The toolbar is displayed as a separate dialog window |
[Top]
| Notification | Method | Sent when |
|---|---|---|
| CATDlgWindCloseNotification | GetWindCloseNotification |
Whenever the end user closes the toolbar window when it is undocked |
| CATDlgWindDockNotification | GetWindDockNotification |
Whenever the end user modifies the toolbar attachment |
| CATDlgToolBarMButtonNotification | GetToolBarMButtonNotification |
Whenever the end user presses a toolbar push, check, or radio item |
[Top]
The message displayed by the message window is set using the SetText method. This message can contain parameter you retrieve at run time to give run time parameter values.
[Top]
For example, the following toolbar is displayed vertically and attached to the right side of the main application window:
_pToolbar = new CATDlgToolBar(iParent, iName, CATDlgTlbDockOnRight) |
[Top]
You can set or get the toolbar docking state as follows:
CATULong PreviousState; PreviousState = _pToolbar->SetDockState(CATDlgTlbDockOnBottom); |
CATULong CurrentState; CurrentState= _pToolbar->SetDockState(); |
[Top]
You can set or get the undocked toolbar floating position using the pixel coordinates of the toolbar top left corner as follows:
int x = 250; int y = 300; _pToolbar->SetFloatingPosition (x, y); |
int x, y; _pToolbar->GetFloatingPosition(&x, &y); |
[Top]
You can retrieve the contextual menu of a toolbar as follows:
CATDlgContextualMenu * pCtxMenu; pCtxMenu = _pToolbar->GetContextualMenu(); |
[Top]
The toolbar title should be set by the resource file using a key built with the identifier you declare as the second parameter of the toolbar constructor.
[Top]
| Version: 1 [Jan 2000] | Document created |
| [Top] | |
Copyright © 2000, Dassault Systèmes. All rights reserved.