3D PLM Enterprise Architecture

CATDialog
  |
  +---CATDlgWindow

CATDlgWindow is the base class for all dialog window classes. All the tasks described here consequently apply to any dialog window instance. Its derived classes are:

• CATDlgDocument
• CATDlgDialog
• CATDlgNotify
• CATDlgFile.

[Top]

[Top]

Programmer's Guide

The methods described below are valid for the derived classes CATDlgDocument and CATDlgDialog only, because CATDlgNotify and CATDlgFile do not allow for dialog children.

The programming tasks fall into the following topics:

• Constructing a Dialog Window
• Managing the Window Size
• Setting a Callback on a Dialog Window
• Managing the Window Layout Using a Grid
• Setting a Title to a Dialog Window

[Top]

Constructing a Dialog Window

A CATDlgWindow can be constructed as the base class of one of its derived class only.

[Top]

Managing the Window Size

You can do the following to manage the size of a dialog window.

int Height, Width;
_pWindow->GetMaximumSize(&Height, &Width);

// The window content occupies the full screen
_pWindow->SetFullScreen(1);
// The window is restored to its previous size
_pWindow->SetFullScreen(0);

_pWindow->Maximize();

_pWindow->Minimize();

_pWindow->Restore();

if (_pWindow->IsMaximized())
  ... // The window is maximized
else
  ... // The window is NOT maximized

if (_pWindow->IsMinimized())
  ... // The window is minimized
else
  ... // The window is NOT minimized

[Top]

Setting a Callback on a Dialog Window

Set a callback on a dialog window as follows:

AddAnalyseNotificationCB(
  _pWindow,                                     // window 
  _pWindow->GetWindCloseNotification(),         // notification
  (CATCommand)&Container::MethodToExecute,      // method to execute 
  CATCommandClientData iUsefulData);            // useful data for this method 

[Top]

Managing the Window Layout Using a Grid

This is explained in Arranging Dialog Objects Using Grid. Layout using a grid is available only if the CATDlgGridLayout style is used in the window constructor. 

[Top]

Setting a Title to a Dialog Window

The dialog window title should be on the derived class instance and set by the resource file using a key built with the identifier you declare as the second parameter of the dialog window constructor.

[Top]

History

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