mirrors/QtAwesome
1
0
Fork 0
mirror of https://github.com/gamecreature/QtAwesome.git synced 2024-11-15 13:35:44 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Merge pull request #7 from stennie/tidy

Browse Source 
Tidy up some spellos & grammar
This commit is contained in:
Rick Blommers 2014-06-12 15:12:29 +02:00
commit 771ff741b7
1 changed files with 17 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
README.md
View File

@ -4,9 +4,9 @@ QtAwesome - Font Awesome support for Qt applications
Description Description
----------- -----------
QtAwesome is a simple library that can be used to add Font Awesome icons to your Qt application. QtAwesome is a simple library that can be used to add [Font Awesome](http://fortawesome.github.io/Font-Awesome/) icons to your [Qt application](http://qt-project.org/).
Though the name is QtAwesome and currently it's very Font Awesome based, you can use every other
iconfont you want. NOTE: Though the name is QtAwesome and currently it's very Font Awesome based, you can use every other icon/glyph font you want.
The class can also be used to manage your own dynamic code-drawn icons, by adding named icon-painters. The class can also be used to manage your own dynamic code-drawn icons, by adding named icon-painters.
@ -14,37 +14,39 @@ The class can also be used to manage your own dynamic code-drawn icons, by addin
Updated to FontAwesome 4 and c++11 Updated to FontAwesome 4 and c++11
---------------------------------- ----------------------------------
This library has been udpated to Font Awesome version 4 and now This library has been updated to Font Awesome version 4 and now
requires c++11 specific features. requires c++11 specific features.
You can find the previous FontAwesome 3 library in the fontawesome-3 branch. The current Font Awesome version is **4.1.0**.
You can find the previous FontAwesome 3 library in the [fontawesome-3 branch](https://github.com/gamecreature/QtAwesome/tree/fontawesome-3).
This branch is c++11 free! This branch is c++11 free!
The current Font Awesome version is Version 4.1.0
Installation Installation
------------ ------------
The easiest way to include QtAweome in your project is to copy the QtAwesome directory to your The easiest way to include QtAweome in your project is to copy the QtAwesome directory to your
project tree and add the the following code include to your Qt project file: project tree and add the following `include()` to your Qt project file:
include(QtAwesome/QtAwesome.pri) include(QtAwesome/QtAwesome.pri)
Now your good to go!! Now you are good to go!
Usage Usage
----- -----
You probably want to create a single QtAwesome object for your whole application. You probably want to create a single QtAwesome object for your whole application:
````
QtAwesome* awesome = new QtAwesome( qApp ) QtAwesome* awesome = new QtAwesome( qApp )
awesome->initFontAwesome(); // This line is important as it loads the font and initializes the named icon map awesome->initFontAwesome(); // This line is important as it loads the font and initializes the named icon map
Add an accessor to this object. (a global function, member of your application object whatever you like). ````
Use an icon name from the icon copy-past list [http://fortawesome.github.io/Font-Awesome/3.2.1/cheatsheet/](http://fortawesome.github.io/Font-Awesome/3.2.1/cheatsheet/) * Add an accessor to this object (i.e. a global function, member of your application object, or whatever you like).
* Use an icon name from the [Font Awesome Cheatsheet](http://fortawesome.github.io/Font-Awesome/cheatsheet/).
Example Example
@ -81,7 +83,7 @@ label->setFont( awesome->font(16) );
Example custom painter Example custom painter
---------------------- ----------------------
This example registers a custom painter for supporting a duplicate icon (it draws 2 plus marks) This example registers a custom painter for supporting a duplicate icon (it draws 2 "plus marks"):
```c++ ```c++
class DuplicateIconPainter : public QtAwesomeIconPainter class DuplicateIconPainter : public QtAwesomeIconPainter
@ -131,7 +133,7 @@ setDefaultOption( "scale-factor", 0.9 );
After that the options are expanded/overwritten by the options supplied to the icon. After that the options are expanded/overwritten by the options supplied to the icon.
It is possible to use another glyph per icon-state. For example to make an icon-unlock symbol switch to locked when selected, It is possible to use another glyph per icon-state. For example to make an icon-unlock symbol switch to locked when selected,
you could supply the following option. you could supply the following option:
```c++ ```c++
options.insert("text-selected", QString( fa::lock ) ); options.insert("text-selected", QString( fa::lock ) );