3D PLM Enterprise Architecture

CATDialog
  |
  +---CATDlgMenuItem
        |
        +---CATDlgPushItem

The Push Item

or

The push item is dedicated to execute a command when the user pushes, or clicks, it, in a menu or a submenu, as depicted on the first image, or in a toolbar or in an icon box, as depicted on the second image. As soon as the user pushes on the push item using the mouse key one, a notification is sent that you can catch by means of the callback mechanism and trigger then the appropriate command.

Use push items whenever you propose to the end user an action to execute in a menu, a submenu, a toolbar, or an icon box.

[Top]

[Top]

Programmer's Guide

The push item is dedicated to executing a command when it is clicked.

[Top]

Constructing a Push Item

The push item should have for parent either the menu, submenu, toolbar, or icon box in which it appears:

_pPushItem = new CATDlgPushItem (iParent, "PushItemId");

[Top]

Setting a Callback on a Push Item

Set a callback on a push item for the click interaction as follows:

AddAnalyseNotificationCB(
  _pPushItem,                                     // push item 
  _pPushButton->GetMenuIActivateNotification(),   // notification
  (CATCommand)&Container::MethodToExecute,        // method to execute 
  CATCommandClientData iUsefulData);              // useful data for this method 

[Top]

Setting a Title to a Push Item

The push item title should be set by the resource file using a key built with the identifier you declare as the second parameter of the push item constructor.

[Top]

History

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