X-Git-Url: http://pileus.org/git/?a=blobdiff_plain;f=docs%2Fstyles.txt;h=cd5dc911077f757cc5e442b6eb3176c6b5d9b89b;hb=HEAD;hp=0975d6d2b99ea839af518365d2ef43643a06e400;hpb=b2e6c9723a4795baba743cdc2ad2665c444d97c0;p=~andy%2Fgtk diff --git a/docs/styles.txt b/docs/styles.txt index 0975d6d2b..cd5dc9110 100644 --- a/docs/styles.txt +++ b/docs/styles.txt @@ -19,14 +19,12 @@ gtk_widget_set_style () This will override a previously set user style or previously set rc styles. -gtk_widget_set_rc_style () - Set GTK_RC_STYLE to indicate that an rc lookup has been performed. - If there is an rc style for a widget, set it and save the default style, - restore the default style otherwise. - This will override a previously set user style or rc style. +gtk_widget_reset_rc_styles () + Descends through a widget hierarchy and sets the rc style + on all widgets that don't have a user style set. gtk_widget_ensure_style () - Ensure taht the widget either has a user style set, or an rc lookup + Ensure that the widget either has a user style set, or an rc lookup has been performed. gtk_rc_get_style () @@ -38,35 +36,35 @@ gtk_widget_set_name () gtk_widget_realize () Besides realizing the widget this function will: - - perform an rc lookup if neccessary, + - perform an rc lookup if necessary, - attach a widget's style. gtk_widget_get_style () Return a widgets style, this function will perform an rc lookup - if neccessary. + if necessary. gtk_widget_set_parent () This function will perform rc lookups recursively for all widgets that do not have a user style set. gtk_style_copy () - This function can be used to copy a widgets style. - The style can subsequntly be changed (e.g., by modifications to the + This function can be used to copy a widget's style. + The style can subsequently be changed (e.g., by modifications to the red/green/blue values of a certain color) and then be applied to the widget via gtk_widget_set_style(). GtkWidget::style_set This signal will be emitted for a widget once its style changes with - an additional argument previous_style wich will hold the widget->style - avlue from a previous emission. + an additional argument previous_style which will hold the widget->style + value from a previous emission. The initial emission of this signal is guaranteed to happen prior to any GtkWidget::size_request emission, and will have the previous_style argument set to NULL. The GtkWidgetClass implements a default handler for this signal that will set the widget's window's background of widgets that provide their own windows according to the new style. - Derived widgets need to overide this default handler, if: + Derived widgets need to override this default handler, if: - their size requisition depends on the current style. (e.g., on the style's fonts) - they set the background of widget->window to something other than. @@ -79,13 +77,13 @@ GtkWidget::style_set Flag indications: !GTK_RC_STYLE && !GTK_USER_STYLE: - The widget has it's default style set, no rc lookup has been + The widget has its default style set, no rc lookup has been performed, the widget has not been size requested yet and is therefore not yet realized. GTK_USER_STYLE: GTK_RC_STYLE is not set. - The widget has a user style assigned, and it's default style has been + The widget has a user style assigned, and its default style has been saved. GTK_RC_STYLE: