AbstractButton: add support for icons

This patch adds the following properties to AbstractButton:

- icon.name
- icon.source
- icon.width
- icon.height
- icon.color

Derived types implement the behavior behind these properties
using the new private IconImage type.

[ChangeLog][Controls][AbstractButton] Added support for icons. The
following properties are now available for derived types to use:
icon.name, icon.source, icon.width, icon.height, icon.color.

Task-number: QTBUG-49820
Change-Id: I3b5e4eaac390543deef60883e13539646a6bb060
Reviewed-by: J-P Nurmi <jpnurmi@qt.io>

1 files changed, 36 insertions, 0 deletions

diff --git a/src/imports/controls/doc/src/includes/qquickicon.qdocinc b/src/imports/controls/doc/src/includes/qquickicon.qdocinc
new file mode 100644
index 00000000..1bfa0119
--- /dev/null
+++ b/src/imports/controls/doc/src/includes/qquickicon.qdocinc
@@ -0,0 +1,36 @@
+//! [grouped-properties]
+\table
+\header
+    \li Name
+    \li Description
+\row
+    \li name
+    \li This property holds the name of the icon to use.
+
+    The icon will be loaded from the platform theme. If the icon is found
+    in the theme, it will always be used; even if \l icon.source is also set.
+    If the icon is not found, \l icon.source will be used instead.
+
+    For more information on theme icons, see \l {QIcon::fromTheme()}.
+\row
+    \li source
+    \li This property holds the name of the icon to use.
+
+    The icon will be loaded as a regular image.
+
+    If \l icon.name is set and refers to a valid theme icon, it will always
+    be used instead of this property.
+\row
+    \li width
+    \li This property holds the width of the icon.
+
+        The icon's width will never exceed this value, though it will
+        shrink when necessary.
+\row
+    \li height
+    \li This property holds the height of the icon.
+
+        The icon's height will never exceed this value, though it will
+        shrink when necessary.
+\endtable
+//! [grouped-properties]