Evas_Event_Freezing_Group (3) - Linux Manuals

Evas_Event_Freezing_Group: Functions that deal with the freezing of event processing of an evas.

NAME

Evas Event Freezing Functions - Functions that deal with the freezing of event processing of an evas.

Functions

EAPI void evas_event_freeze (Evas *e)
Freeze all event processing.
EAPI void evas_event_thaw (Evas *e)
Thaw a canvas out after freezing.
EAPI int evas_event_freeze_get (const Evas *e)
Return the freeze count of a given canvas.

Detailed Description

Functions that deal with the freezing of event processing of an evas.

Function Documentation

EAPI void evas_event_freeze (Evas * e)

Freeze all event processing.

Parameters:

e The canvas to freeze event processing on

This function will indicate to evas that the canvas e is to have all event processing frozen until a matching evas_event_thaw() function is called on the same canvas. Every freeze call must be matched by a thaw call in order to completely thaw out a canvas.

Example:

 extern Evas *evas;
 extern Evas_Object *object;

 evas_event_freeze(evas);
 evas_object_move(object, 50, 100);
 evas_object_resize(object, 200, 200);
 evas_event_thaw(evas);

EAPI int evas_event_freeze_get (const Evas * e)

Return the freeze count of a given canvas.

Parameters:

e The canvas to fetch the freeze count from

This returns the number of times the canvas has been told to freeze events. It is possible to call evas_event_freeze() multiple times, and these must be matched by evas_event_thaw() calls. This call allows the program to discover just how many times things have been frozen in case it may want to break out of a deep freeze state where the count is high.

Example:

 extern Evas *evas;

 while (evas_event_freeze_get(evas) > 0) evas_event_thaw(evas);

EAPI void evas_event_thaw (Evas * e)

Thaw a canvas out after freezing.

Parameters:

e The canvas to thaw out

This will thaw out a canvas after a matching evas_event_freeze() call. If this call completely thaws out a canvas, events will start being processed again after this call, but this call will not invole any 'missed' events to be evaluated.

See evas_event_freeze() for an example.

Author

Generated automatically by Doxygen for Evas from the source code.