Derived from MFC's CProgressCtrl, SECProgressCtrl offers several enhancements to the existing progress control, including

• Smooth fill with percentages.

• Multidirectional progressions (left to right, right to left, bottom to top, or top to bottom).

• Fully configurable foreground and background coloring.

• Custom status text with configurable fonts.

The progress control also offers powerful virtual hooks for you to provide your own customizations easily.

In addition, SECProgressCtrl supports the automatic advancing of the progress status in response to timer events. Refer to StepOnTimer() in the Objective Toolkit Class Reference for more information.

4.14.1 Using SECProgressCtrl

You can use objects instantiated from SECProgressCtrl anywhere you can use CProgressCtrl. You can attach an SECProgressCtrl object to an existing CProgressCtrl control via the AttachProgress() method or you can create the control dynamically via the Create() method.

To attach an SECProgressCtrl instance to an progress control resource:

Call the AttachProgress() method with the control ID of the progress control you want to attach.

m_wndProgress.AttachProgress(IDC_PROGRESS,this);

To create an SECProgressCtrl instance dynamically:

1. Create a unique control ID for the control. In Visual Studio, you can create a control ID in the Resource Includes dialog.

2. Call the Create() method.

   CRect rect(0,0,100,50); // initial rectangle m_wndProgress.Create(WS_CHILD|WS_VISIBLE,rect, this,IDC_PROGRESS1);

4.14.2 Customizing SECProgressCtrl

You can use the following extended styles to customize the progress control.

Table 22: Extended Styles for SECProgressCtrl

You can specify these styles as parameters to the Create() and SetExStyle() methods. By default, the progress bar is horizontal and progresses left to right with centered percentages. You can use the preceding flags to modify the default behavior. In addition, the application can configure the font, foreground, and background color at run time.

4.14.3 Extending SECProgressCtrl

Almost every method in SECProgressCtrl is virtual so you can override them. Some of the virtual callbacks provided by this class include:

Table 23: Virtual Callbacks in SECProgressCtrl