LinkedIn


Logo

CircularProgressBar Widget

In this project I'm gonna create a plugin known as custom widget for Qt framework that can be used as a progressbar or even a loading splash screen. I caugh the idea from a person named "Wanderson M. Pimenta" that created same component for pyqt. So I decided to develop same widget for Qt Framework and also create a plugin for it in order to use it as one of Qt Creator toolbox items. I also add some funcionalities to the orginal idea to make widget more applicable for real usage and be customizbale for developers.

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgments

About The Project

[Product Name Screen Shot Product Name Screen Shot]

(back to top)

Built With

(back to top)

Getting Started

This project build using Qt framework 6.3 and also compatible with Qt 5.x; In order to use it, just open the project in Qt Creator(this is a Custom Widget Project type) and compile the project. there will be a library with .so(in case you'r using linux and .dll for windows user) extension in build folder. Copy generated library to a folder for Qt Creator plugins inside the location Qt installed. Path to this folder is something like "/home/vrf/Qt/Tools/QtCreator/lib/Qt/plugins/designer". Just replace the path that Qt installed on your system.

Next, open Qt Creator and if vrf Widgets section is not appear in toolsbox goto "Tools->Form Editor->About Qt Designer Plugins" and then just click Refresh. Now you should see widget(s) in toolsbox.

Warning: please take care that library should built with a compiler compatibale with the one that Qt Creator had built. For more information just check "Help->About Qt Creator".

Now you can drag & drop VCricularProgressBar on main form and customize it's attributes from properties windows on the right side.

You should also add this library and related .h file(VCircularProgressBar.h) to your project in order run the project successfully

Prerequisites

All you need to make use of this library is Qt itself and nothing more

Installation

  1. Install Qt
  2. Clone the repo
    git clone https://github.com/vRFEducation/vcircularprogressbarwidget.git
  3. Open Project and Compile it
  4. Copy .so(in case using linux) to Qt Creator plugins directory
  5. Add .so file to your project
  6. enjoy the widget at design time

(back to top)

Usage

This widget is useful whereever you want to show progress or even a guage in more fashion way then legacy QProgressBar. However this widget can be used as a spalsh screen indicates loading of something in you application

(back to top)

Contributing

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. Push to the Branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Vahid Rahmanifard - rahmanifard@live.com

Project Link: https://github.com/vRFEducation/vcircularprogressbarwidget

(back to top)