AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-09-21 14:24:19 +00:00
Code Issues Projects Releases Wiki Activity

Improve the migration guide

Browse Source 
Add some hints about dealing with colors.
This commit is contained in:
Matthias Clasen 2010-11-24 21:09:23 -05:00 committed by Carlos Garnacho
parent 53c2114356
commit ab0a8fc17f
1 changed files with 32 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

32
docs/reference/gtk/migrating-GtkStyleContext.xml
View File

@ -140,6 +140,7 @@
although custom widgets may define their own, which themes may
attempt to handle.
</para>
</refsect2>
<refsect2 id="gtk-migrating-GtkStyleContext-parser-extensions">
@ -357,6 +358,37 @@
independently.
</para>
<para>
Access to colors has also changed a bit. With #GtkStyle, the common
way to access colors is:
<informalexample><programlisting>
GdkColor *color1;
GdkColor color2;
color1 = &amp;style->bg[GTK_STATE_PRELIGHT];
gtk_style_lookup_color (style, "focus_color", &amp;color2);
</programlisting></informalexample>
With #GtkStyleContext, you generally use #GdkRGBA instead of #GdkColor
and the code looks like this:
<informalexample><programlisting>
GdkRGBA *color1;
GdkRGBA color2;
gtk_style_context_get (context, GTK_STATE_FLAG_PRELIGHT,
"background-color", &amp;color1,
NULL);
gtk_style_context_lookup_color (context, "focus_color", &amp;color2);
...
gdk_rgba_free (color1);
</programlisting></informalexample>
Note that the memory handling here is different: gtk_style_context_get()
expects the address of a GdkRGBA* and returns a newly allocated struct,
gtk_style_context_lookup_color() expects the address of an existing
struct, and fills it.
</para>
<para>
It is worth mentioning that the new file format does not support
custom keybindings nor stock icon mappings as the RC format did.