Legacy Document

Inside Macintosh: Cyberdog Programmer's Kit / Part 3 - Cyberdog Reference

Chapter 7 - Classes and Methods / CyberProgressReceiver

SetProgressMode

Sets the progress mode associated with an asynchronous process.

void SetProgressMode (in short mode, 
in CyberProgressBroadcaster broadcaster);

mode

The progress mode of the process. Valid values for this parameter are kUnmeteredProgress or kMeteredProgress.

broadcaster

The progress broadcaster broadcasting the change.

DISCUSSION

This method is called by the CyberProgressBroadcaster::SetProgressMode method to broadcast a new progress mode to all progress receivers attached to the broadcaster.

The progress mode of the process indicates whether the total amount of work to be performed is known and can be measured. For example, if you know in advance the number of bytes to be downloaded, the progress mode is metered. In contrast, if you don't know in advance the number of bytes to be downloaded, the progress mode is unmetered. The default progress mode is unmetered.

If you subclass CyberProgressReceiver, you must override this method. Your override must not call its inherited method; that is, your override method must implement this method's functionality completely.

SEE ALSO

The CyberProgressBroadcaster::SetProgressMode method (page 310).