The history behind this class is that it was part of QWinTaskbarButton
, thus it was inherently tightly coupled with that class. You can see the relevant upstream commit that began the refactoring and hence decoupling:
Refactor QWinTaskbarProgress out of QWinTaskbarButton
You are right that it is not too explicit in QWinTaskbarProgress' documentation, so this could be potentially improved upstream, but the QWinTaskbarButton example as well as the Music Player example shows the point, namely you have to replace this line:
QWinTaskbarProgress * pTaskbarProgress = new QWinTaskbarProgress(this);
with:
QWinTaskbarButton * pTaskbarButton = new QWinTaskbarButton(this);
pTaskbarButton->setWindow(windowHandle());
QWinTaskbarProgress * pTaskbarProgress = pTaskbarButton->progress();
You may wish to set the overlay icon as well for the taskbar button with either a custom image or something like what the Music Player examples does:
pTaskbarButton->setOverlayIcon(style()->standardIcon(QStyle::SP_MediaPlay));