[gtk+] Document -gtk-recolor syntax
- From: Matthias Clasen <matthiasc src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [gtk+] Document -gtk-recolor syntax
- Date: Thu, 14 Jan 2016 21:08:13 +0000 (UTC)
commit 5842e68a0d820f2179daf4d97d335deef3e770d5
Author: Matthias Clasen <mclasen redhat com>
Date: Thu Jan 14 16:06:16 2016 -0500
Document -gtk-recolor syntax
docs/reference/gtk/css-overview.xml | 27 ++++++++++++++++++++++++---
1 files changed, 24 insertions(+), 3 deletions(-)
---
diff --git a/docs/reference/gtk/css-overview.xml b/docs/reference/gtk/css-overview.xml
index 497368c..7756213 100644
--- a/docs/reference/gtk/css-overview.xml
+++ b/docs/reference/gtk/css-overview.xml
@@ -717,7 +717,7 @@ label {
GTK+ extends the CSS syntax for images and also uses it for specifying icons.
</para>
-<literallayout><code>〈gtk image〉 = 〈gtk gradient〉 | 〈themed icon〉 | 〈scaled image〉 | 〈win32 theme
part〉</code>
+<literallayout><code>〈gtk image〉 = 〈gtk gradient〉 | 〈themed icon〉 | 〈scaled image〉 | 〈recolored image〉 |
〈win32 theme part〉</code>
</literallayout>
<para>
@@ -806,8 +806,8 @@ label {
<title>Using themed icons in CSS</title>
<programlisting><![CDATA[
spinner {
- -gtk-icon-source: -gtk-icontheme('process-working');
- -gtk-icon-style: symbolic;
+ -gtk-icon-source: -gtk-icontheme('process-working-symbolic');
+ -gtk-icon-palette: success blue, error magenta;
}
arrow.fancy {
-gtk-icon-source: -gtk-icontheme('pan-down');
@@ -841,6 +841,27 @@ arrow {
]]></programlisting>
</example>
+<literallayout><code>〈recolored image〉 = -gtk-recolored( 〈url〉[, 〈color palette〉] )</code>
+</literallayout>
+
+ <para>
+ Symbolic icons from the icon theme are recolored according to the
+ -gtk-icon-palette property. The recoloring is sometimes needed for images
+ that are not part of an icon theme, and the -gtk-recolor syntax makes
+ this available. -gtk-recolor requires a url as first argument. The
+ remaining arguments specify the color palette to use. If the palette
+ is not explicitly specified, the current value of the -gtk-icon-palette
+ property is used.
+ </para>
+
+ <example>
+ <title>Recoloring an image</title>
+ <programlisting><![CDATA[
+arrow {
+ -gtk-icon-source: -gtk-recolor(url('check.svg'), success blue, error rgb(255,0,0));
+}
+]]></programlisting>
+ </example>
<para>
On Windows, GTK+ allows to refer to system theme parts as images, as follows:
</para>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]