3D PLM Enterprise Architecture

CATDialog
  |
  +---CATDlgBox
        |
        +---CATDlgTabContainer

The Tab Container

The tab container is a dialog box used to show, and possibly to modify the properties of an object, or of an application. Its is also known as a property sheet. It contains tab pages, also known as property pages. It enables the end user to work with many properties gathered in a single place, rather than to display several dialog boxes accessed each from a different menu. Each property page contains various controls to set values or options for the property. When the end user clicks on a tab,  the corresponding property page comes to the foreground and hides the others.

Use tab containers whenever you propose properties of objects or applications that must be presented consistently, even if they can be accessed from different commands or menus.

[Top]

Programmer's Guide

Each tab container is an instance of the CATDlgTabContainer class. It contains tab pages which are instances of the CATDlgTabPage class.

[Top]

Constructing a Tab Container

You should construct a tab container as follows.

pTabContainer  = new CATDlgTabContainer (iParent, iName);

[Top]

Managing the Tab Pages

You can manage the tab pages with the following methods:

• get the number of pages using the GetPageCount method:

  int NumberOfPages = pTabContainer->GetPageCount();

• get the selected page index using the GetSelectedPage method:

  int SelectedPageIndex = pTabContainer->GetSelectedPage();

• get a pointer to the selected page using the GetSelectedPagePtr method:

  CATDlgTabPage * pSelectedPage; pSelectedPage = pTabContainer->GetSelectedPagePtr();

• set the selected page using either its index or a pointer:

  using its index	int PageToSelectIndex = 3; pTabContainer->SetSelectedPage(PageToSelectIndex);
  using a pointer	CATDlgTabPage * pPageToSelect = ... pTabContainer->SetSelectedPage(pPageToSelect);

[Top]

Setting a Callback on an Editor

Set a callback on an editor to be informed whenever the end user modify the text as follows:

AddAnalyseNotificationCB(
  pTabContainer,                              // tab container 
  pTabContainer->GetTabSelectNotification(),  // notification
  (CATCommand)&Container::MethodToExecute,    // method to execute 
  CATCommandClientData iUsefulData);          // useful data for this method 

[Top]

History

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