Differences

This shows you the differences between two versions of the page.

--- qt:mainwindow-buildicon [2011/05/12 15:12] – mithat
+++ qt:mainwindow-buildicon [2011/05/13 12:32] (current) – mithat
@@ Line 1: / Line 1: @@
+Something like this:
 <code cpp-qt MainWindow::buildIcon>
 /**
- * Append a regularly defined set of differently sized icon images to a QIcon.
+ * @brief Append a regularly defined set of sized icon images to a QIcon.
- * Example:
+ *
- * Assumes the resources ":myIcons/16x16/exit.png", ":myIcons/24x24/exit.png", and ":myIcons/32x32/exit.png" are available.
+ * The following usage example assumes the resources ":myIcons/16x16/exit.png",
- *    QList<int> sizes; sizes << 16 << 24 << 32;
+ * ":myIcons/24x24/exit.png", and ":myIcons/32x32/exit.png" are available and
- *    QIcon exitIcon;
+ * that we want to bundle them together into exitIcon.
- *    buildIcon(&exitIcon, ":myIcons/%size%/exit.png", sizes);
+ *
- * buildIcon() does NOT check whether the referenced resources actually exist.
+ * \code
+ *   QList<int> sizes; sizes << 16 << 24 << 32;
+ *   QIcon exitIcon;
+ *   buildIcon(&exitIcon, ":myIcons/%size%/exit.png", sizes);
+ * \endcode
+ *
+ * Does NOT check whether the referenced resources actually exist.
+ *
+ * @param theIcon Pointer to the icon that will be built/appened to.
+ * @param iconRscTemplate A tag-based template string for the icon resource.
+ *                        Two tags are recognized in iconRscTemplate: \%size\%
+ *                        and \%dim\%. When the iconRscTemplate is expanded, the
+ *                        tag \%dim\% will be replaced by {iconSize} and
+ *                        \%size\% will be replaced by {iconSize}x{iconSize},
+ *                        where {iconSize} is a string cast of an element in
+ *                        sizeList.
+ * @param sizeList A list of single-dimension sizes to be added to the icon.
  *
- * @param theIcon pointer to the icon that will be built/appened to
- * @param iconRscTemplate a tag-based template string for the icon resource. Two tags are recognized in iconRscTemplate: %size and %dim%. When the iconRscTemplate is expanded, the tag %dim% will be replaced by {iconSize} and %size% will be replaced by {iconSize}x{iconSize}, where {iconSize} is a string cast of an element in sizeList.
- * @param sizeList contains a list of single-dimension sizes to be added to the icon.
  * @return void
  */
-void MainWindow::buildIcon(QIcon* const theIcon, QString const &iconRscTemplate, QList const &sizeList)
+void MainWindow::buildIcon(QIcon* const theIcon,
-{
+                           QString const &iconRscTemplate,
-    foreach (const int iconSize in sizeList)
+                           QList<int> const &sizeList)
-    {
-        QString theResource = iconRscTemplate;
-        theResource.replace(QString("%size%"), iconSize+"x"+iconSize);  // does this work?
-        theResource.replace(QString("%dim%"), iconSize+"");             // does this work?
-        theIcon->addFile(theResource, QSize(iconSize, iconSize))
-    }
-}</code>
-<code cpp-qt MainWindow::buildIcon>
-/**
- * Append a regularly defined set of differently sized icon images to a QIcon.
- * Example:
- * Assumes the resources ":myIcons/16x16/exit.png", ":myIcons/24x24/exit.png", and ":myIcons/32x32/exit.png" are available.
- *    QList<int> sizes; sizes << 16 << 24 << 32;
- *    QIcon exitIcon;
- *    buildIcon(&exitIcon, ":myIcons/%size%/exit.png", sizes);
- * buildIcon() does NOT check whether the referenced resources actually exist.
- */
-void MainWindow::buildIcon(QIcon* const theIcon,           ///< Pointer to the icon that will be built/appened to
-                           QString const &iconRscTemplate, ///< A tag-based template string for the icon resource. Two tags are recognized in iconRscTemplate: %size and %dim%. When the iconRscTemplate is expanded, the tag %dim% will be replaced by {iconSize} and %size% will be replaced by {iconSize}x{iconSize}, where {iconSize} is a string cast of an element in sizeList.
-                           QList const &sizeList)          ///< A list of single-dimension sizes to be added to the icon
 {
-    foreach (const int iconSize in sizeList)
+    foreach (const int iconSize, sizeList)
     {
         QString theResource = iconRscTemplate;
-        theResource.replace(QString("%size%"), iconSize+"x"+iconSize);  // does this work?
+        QString dim; dim.setNum(iconSize);
-        theResource.replace(QString("%dim%"), iconSize+"");             // does this work?
+        theResource.replace(QString("%dim%"), dim);
+        theResource.replace(QString("%size%"), dim +"x"+dim);
-        theIcon->addFile(theResource, QSize(iconSize, iconSize))
+        theIcon->addFile(theResource, QSize(iconSize, iconSize));
     }
 }</code>