3D PLM Enterprise Architecture

CATDialog
  |
  +---CATDlgControl
        |
        +---CATDlgProgress

The Progress

The progress indicator shows to the end user that a lengthy operation is taking place, and also shows the progress from the beginning to the end of this operation by filling in a rectangle with a pattern whose length, compared to the rectangle length, indicates the lengthy operation completion rate.

Use progress indicators whenever you want to show that a lengthy opeation is currently running.

[Top]

Programmer's Guide

The progress indicator is dedicated to show a lengthy operation progress. You can manage the value range and the step, as well as the current value shown by the progress indicator.

[Top]

Constructing a Progress Indicator

The progress indicator has only a default style.:

_pProgress = new CATDlgProgress (this, "Progress");

[Top]

Managing the Value Range

You can do the following:

• You can retrieve the value range with the GetRange method:

  int *oStart, *oEnd; MyProgress->GetRange(oStart, oEnd);

• You can set the value range with the SetRange method:

  int iStart = 0: int iEnd = 100; MyProgress->SetRange(iStart, iEnd);

• You can retrieve the step with the GetStep method:

  int Step; Step = MyProgress->GetStep();

• You can set the number of steps with the SetStep method:

  int iStep; MyProgress->SetStep(iStep);

[Top]

Managing the Current Value

You can do the following:

• You can retrieve the current value with the GetPos method:

  int CurrentValue; CurrentValue = MyProgress->GetPos();

• You can set the current value with the SetPos method:

  int iCurrentValue = 30: MyProgress->SetPos(iCurrentValue);

• You can shift the current value of a given number of steps with the OffsetPos method:

  int iNStep; MyProgress->OffsetPos();

• You can increment the current value of one step with the StepIt method:

  MyProgress->StepIt();

[Top]

Setting a Title to a Progress Indicator

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

[Top]

History

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