DWebBrowserEvents2::ProgressChange Event

  • Article

Fires when the progress of a download operation is updated on the object.

Syntax

void ProgressChange(
    long Progress,
    long ProgressMax
);

Parameters

  • Progress
    [in] A long that specifies the amount of total progress to show, or -1 when progress is complete.
  • ProgressMax
    [in] A long that specifies the maximum progress value.

Return Value

No return value.

Event DISPID

DISPID_PROGRESSCHANGE

The DISPID for this event is defined in exdispid.h. Use this value to identify the event handler when implementing IDispatch::Invoke.

Remarks

The container can use the information provided by this event to display the number of bytes downloaded or to update a progress indicator.

To calculate the percent of progress to show in a progress indicator, multiply the value of Progress by 100, and divide by the value of ProgressMax; unless Progress is -1, in which case the container indicates that the operation is finished or hides the progress indicator.

See Also

DWebBrowserEvents2::DownloadBegin, DWebBrowserEvents2::DownloadComplete, IWebBrowser2::Navigate