StyleContext.notifyStateChange

Notifies a state change on @context, so if the current style makes use of transition animations, one will be started so all rendered elements under @region_id are animated for state @state being set to value @state_value.

The @window parameter is used in order to invalidate the rendered area as the animation runs, so make sure it is the same window that is being rendered on by the gtk_render_*() functions.

If @region_id is %NULL, all rendered elements using @context will be affected by this state transition.

As a practical example, a #GtkButton notifying a state transition on the prelight state: |[ <!-- language="C" --> gtk_style_context_notify_state_change (context, gtk_widget_get_window (widget), NULL, GTK_STATE_PRELIGHT, button->in_button); ]|

Can be handled in the CSS file like this: |[ <!-- language="CSS" --> button { background-color: #f00 }

button:hover { background-color: #fff; transition: 200ms linear } ]|

This combination will animate the button background from red to white if a pointer enters the button, and back to red if the pointer leaves the button.

Note that @state is used when finding the transition parameters, which is why the style places the transition under the :hover pseudo-class.

More...
class StyleContext
void
notifyStateChange

Parameters

window Window

a #GdkWindow

regionId void*

animatable region to notify on, or %NULL. See gtk_style_context_push_animatable_region()

state GtkStateType

state to trigger transition for

stateValue bool

%TRUE if @state is the state we are changing to, %FALSE if we are changing away from it

Detailed Description

Deprecated: This function does nothing.

Meta