3D PLM Enterprise Architecture

CATDialog
  |
  +---CATDlgBar
        |
        +---CATDlgToolBar

The Toolbar

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.

[Top]

[Top]

Programmer's Guide

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]

Constructing a Toolbar

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]

Managing the Docking Mode

You can set or get the toolbar docking state as follows:

• set the toolbar docking state with the SetDockState method. It returns the previous docking state:

  CATULong PreviousState; PreviousState = _pToolbar->SetDockState(CATDlgTlbDockOnBottom);

• get the toolbar docking state with the GetDockState method:

  CATULong CurrentState; CurrentState= _pToolbar->SetDockState();

[Top]

Managing the Undocked Floating Position

You can set or get the undocked toolbar floating position using the pixel coordinates of the toolbar top left corner as follows:

• set the undocked toolbar floating position with the SetFloatingPosition method:

  int x = 250; int y = 300; _pToolbar->SetFloatingPosition (x, y);

• get the undocked toolbar floating position with the GetFloatingPosition method:

  int x, y; _pToolbar->GetFloatingPosition(&x, &y);

[Top]

Retrieving the Contextual Menu

You can retrieve the contextual menu of a toolbar as follows:

• get the contextual menu with the GetContextualMenu method

  CATDlgContextualMenu * pCtxMenu; pCtxMenu = _pToolbar->GetContextualMenu();

[Top]

Setting a Title to a Toolbar

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]

History

Copyright © 2000, Dassault Systèmes. All rights reserved.