Review Request 112079: Add utility function to paint icon overlays

Martin Klapetek martin.klapetek at gmail.com
Wed Aug 21 14:41:13 UTC 2013



> On Aug. 19, 2013, 9:52 a.m., Kevin Ottens wrote:
> > staging/kguiaddons/src/util/qiconoverlay.h, line 29
> > <http://git.reviewboard.kde.org/r/112079/diff/1/?file=179563#file179563line29>
> >
> >     Apidox is missing for those two functions.

The dox is in the .cpp file, I got used to that from Qt. Should it be in the .h then?


- Martin


-----------------------------------------------------------
This is an automatically generated e-mail. To reply, visit:
http://git.reviewboard.kde.org/r/112079/#review38113
-----------------------------------------------------------


On Aug. 14, 2013, 10:49 a.m., Martin Klapetek wrote:
> 
> -----------------------------------------------------------
> This is an automatically generated e-mail. To reply, visit:
> http://git.reviewboard.kde.org/r/112079/
> -----------------------------------------------------------
> 
> (Updated Aug. 14, 2013, 10:49 a.m.)
> 
> 
> Review request for KDE Frameworks.
> 
> 
> Description
> -------
> 
> As this was rejected from QIcon, I decided to implement it in frameworks. The idea is new private icon engine (KOverlayIconEngine), which paints the overlays itself, and then an utility function in KIconUtils:: namespace, which takes the base icon and the overlay icons as parameters and constructs new QIcon using KOverlayIconEngine. As QPixmapIconEngine (QIcon default) is private in Qt and couldn't be simply extended, the KOverlayIconEngine simply forwards the calls to QIcon, which then forwards those calls internally to QPixmapIconEngine (QIcon is really mostly just a wrapper around an engine).
> 
> There are two functions
> 
> QIcon KIconUtils::kIconAddOverlay(const QIcon &icon, const QIcon &overlay, Qt::Corner position);
> 
> and
> 
> QIcon KIconUtils::kIconAddOverlay(const QIcon &icon, QHash<Qt::Corner, QIcon> overlays);
> 
> The first one serves for single overlay icon, the second one is then for multiple overlays, requires the QHash to be built up before passing though.
> 
> 
> Diffs
> -----
> 
>   staging/kguiaddons/src/CMakeLists.txt fc8941a 
>   staging/kguiaddons/src/util/qiconoverlay.h PRE-CREATION 
>   staging/kguiaddons/src/util/qiconoverlay.cpp PRE-CREATION 
> 
> Diff: http://git.reviewboard.kde.org/r/112079/diff/
> 
> 
> Testing
> -------
> 
> I have a small testing app with 3 QLabels, testing both ::paint() and ::pixmap() methods, all works \o/ I'm thinking about bundling the app with kguiaddons and/or additionally creating a unittest for it (I have one for Qt already), but I'll do that later as I'm off to vacation and I'd like to get comments for the code.
> 
> 
> Thanks,
> 
> Martin Klapetek
> 
>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.kde.org/pipermail/kde-frameworks-devel/attachments/20130821/6d34c848/attachment.html>


More information about the Kde-frameworks-devel mailing list