AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2024-11-17 06:10:15 +00:00
Code Issues Projects Releases Wiki Activity

Trivial: Some doc rewording

Browse Source
This commit is contained in:
Matthias Clasen 2015-11-19 13:40:57 -05:00
parent 2b5d4455b8
commit 040723ec2d
1 changed files with 12 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
gtk/gtkcssnode.c
View File

@ -44,22 +44,23 @@
* - gtk_css_node_get_previous/next_sibling
*
* Every widget has one or more CSS nodes - the first one gets created
* automatically by GtkStyleContext. To set the name of the main node,
* call gtk_widget_class_set_css_name() in class_init. Widget implementations
* automatically by GtkStyleContext. To set the name of the main node,
* call gtk_widget_class_set_css_name() in class_init(). Widget implementations
* can and should add subnodes as suitable.
*
* Best practice is:
* - for permanent subnodes, create them in init(), and keep a pointer
* - For permanent subnodes, create them in init(), and keep a pointer
* to the node (you don't have to keep a reference, cleanup will be
* automatic by means of the parent node getting cleaned up by the
* style context
* - for transient nodes, create/destroy them when the conditions that warrant
* their existence change.
* - keep the state of all your nodes up-to-date. This probably requires
* a state-flags-changed (and possibly direction-changed) handler, as well
* as code to update the state in other places
* - the draw function should just use gtk_style_context_save_to_node to
* 'switch' to the right node, not make any other changes to the style context
* style context).
* - For transient nodes, create/destroy them when the conditions that
* warrant their existence change.
* - Keep the state of all your nodes up-to-date. This probably requires
* a ::state-flags-changed (and possibly ::direction-changed) handler,
* as well as code to update the state in other places.
* - The draw function should just use gtk_style_context_save_to_node() to
* 'switch' to the right node, not make any other changes to the style
* context.
*/
/* When these change we do a full restyling. Otherwise we try to figure out