CMFCVisualManager::OnDrawStatusBarProgress

The framework calls this method when it draws the progress indicator on the CMFCStatusBar object.

virtual void OnDrawStatusBarProgress(
   CDC* pDC,
   CMFCStatusBar* pStatusBar,
   CRect rectProgress,
   int nProgressTotal,
   int nProgressCurr,
   COLORREF clrBar,
   COLORREF clrProgressBarDest,
   COLORREF clrProgressText,
   BOOL bProgressText
);

Parameters

  • [in] pDC
    A pointer to the device context for the status bar.

  • [in] pStatusBar
    The CMFCStatusBar object that contains the progress bar.

  • [in] rectProgress
    A rectangle that specifies the boundaries of the progress bar.

  • [in] nProgressTotal
    The total number for the progress bar.

  • [in] nProgressCurr
    The current progress for the progress bar.

  • [in] clrBar
    A COLORREF parameter that indicates the initial color for the progress bar. The value is either the start of a color gradient or the complete color of the progress bar.

  • [in] clrProgressBarDest
    A COLORREF parameter that indicates the end of a color gradient for the progress bar. If clrProgressBarDest is -1, the framework does not draw the progress bar as a color gradient. Instead, it fills the whole progress bar with the color specified by clrBar.

  • [in] clrProgressText
    A COLORREF parameter that indicates the text color for the textual representation of the current progress. This parameter is ignored if bProgressText is set to FALSE.

  • [in] bProgressText
    A Boolean parameter that indicates whether to display the textual representation of the current progress.

Remarks

Override this method in a derived visual manager to customize the appearance of the CMFCStatusBar object.

Requirements

Header: afxvisualmanager.h

See Also

Reference

CMFCVisualManager Class

Hierarchy Chart

CMFCStatusBar Class