https://github.com/hokein/dockprogressbar

Dock progress bar on Mac OS X
https://github.com/hokein/dockprogressbar

dock macos progressbar

Last synced: about 1 month ago
JSON representation

Dock progress bar on Mac OS X

• Host: GitHub
• URL: https://github.com/hokein/dockprogressbar
• Owner: hokein
• Created: 2014-09-19T07:35:32.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2017-11-12T14:32:00.000Z (over 7 years ago)
• Last Synced: 2025-04-26T02:09:02.725Z (about 2 months ago)
• Topics: dock, macos, progressbar
• Language: Objective-C++
• Homepage:
• Size: 61.5 KB
• Stars: 22
• Watchers: 4
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        
# DockProgressBar

DockProgressBar provides different style progress bar on Mac OS X.

With it, developers can show dock progress bar in their application without much efforts.

## DockProgressBar Styles

DockProgressBar is designed as singleton, and provides simple APIs for developers: 

* `shareXXXProgressBar` : Get a ProgressBar instance.

* `setProgress` : Set progress value.

* `updateProgressBar` : Show the ProgressBar.

* `hideProgressBar`: Hide the ProgressBar.

* `clear`: remove the ProgressBar in Dock.

By default, the valid progress range is [0.0, 1.0].  

Below is a usage sample, refer to [AppDelegate.m](https://github.com/hokein/DockProgressBar/blob/master/DockProgressBar/AppDelegate.m)

for more details.

```

// Get a ProgressBar value.

DockCircularProgressBar* progress_bar =

    [DockCircularProgressBar sharedDockCircularProgressBar];

// set progress value

[progress_bar setProgress:0.3];

// Show progress bar in dock

[progress_bar updateProgressBar];

```

### DockDownloadProgressBar

The same style likes the original download bar on Mac OS X.

`DockDownloadProgressBar` is a subclass of `NSProgressIndicator`,

you can use any base class's method to custom your progress bar.

![]( https://github.com/hokein/DockProgressBar/blob/master/images/download_progress_bar.png)

### DockCircularProgressBar

The circular style progress bar like Google Chrome download style.

CicularProgressBar without percent:

![]( https://github.com/hokein/DockProgressBar/blob/master/images/circular_progress_bar.png)

CicularProgressBar with percent:

![]( https://github.com/hokein/DockProgressBar/blob/master/images/circular_progress_bar_with_percent.png)

## License

BSD