Public Member Functions | |
| (void) | - setMaxProgress: |
| (unsigned long long) | - maxProgress |
| (void) | - setUserInfo: |
| (NSDictionary *) | - userInfo |
| (void) | - setProgressIndicator: |
| (NSProgressIndicator *) | - progressIndicator |
| (void) | - beginTrackingProgress |
| (void) | - endTrackingProgress |
| (void) | - noteFinished: |
| (void) | - requestCancel: |
| (void) | - setDelegate: |
| (id) | - delegate |
The thread is expected to write directly into the public currentProgress field (perhaps with atomic functions) as it makes progress. Once beginTrackingProgress is called, the HFProgressTracker will poll currentProgress until endTrackingProgress is called.
The thread is also expected to read directly from cancelRequested, which is set by the requestCancel method. If requestCancel is set, it should end the operation.
Lastly, the thread is expected to call noteFinished: when it is done, either through cancellation or completing normally.
On the client side, you can set a delegate. progressTracker: didChangeProgressTo: is called on your delegate at regular intervals in the main thread, as the progress changes. Likewise, progressTrackerDidFinish: is called on the main thread after noteFinished: is called.
There is also a progressIndicator property, which if set to an NSProgressIndicator will cause it to be updated regularly.
| - (void) setMaxProgress: | (unsigned long long) | max |
HFProgressTracker determines the progress as an unsigned long long, but passes the progress to the delegate as a double, which is computed as the current progress divided by the max progress.
| - (unsigned long long) maxProgress |
| - (void) setUserInfo: | (NSDictionary *) | info |
The userInfo property is a convenience to allow passing information to the thread. The property is not thread safe - the expectation is that the main thread will set it before the operation starts, and the background thread will read it once after the operation starts.
| - (NSDictionary *) userInfo |
| - (void) setProgressIndicator: | (NSProgressIndicator *) | indicator |
The progressIndicator property allows an NSProgressIndicator to be associated with the HFProgressTracker. The progress indicator should have values in the range 0 to 1, and it will be updated with the fraction currentProgress / maxProgress.
| - (NSProgressIndicator *) progressIndicator |
| - (void) beginTrackingProgress |
Called to indicate you want to begin tracking the progress, which means that the progress indicator will be updated, and the delegate callbacks may fire.
| - (void) endTrackingProgress |
Called to indicate you want to end tracking progress. The progress indicator will no longer be updated.
| - (void) noteFinished: | (id) | sender |
noteFinished: should be called by the thread when it is done. It is safe to call this from the background thread.
| - (void) requestCancel: | (id) | sender |
requestCancel: may be called to mark the cancelRequested variable. The thread should poll this variable to determine if it needs to cancel.
| - (void) setDelegate: | (id) | delegate |
Set and get the delegate, which may implement the optional methods below.
| - (id) delegate |
1.5.9