Grabs pointer events, after the grab is done all pointer related events (press, motion, release, enter, leave and scroll) are delivered to this actor directly without passing through both capture and bubble phases of the event delivery chain.
The source set in the event will be the actor that would have received the event if the pointer grab was not in effect.
Grabs completely override the entire event delivery chain done by Clutter. Pointer grabs should only be used as a last resource; using the captured_event signal should always be the preferred way to intercept event delivery to reactive actors.
This function should rarely be used.
If a grab is required, you are strongly encouraged to use a specific input device by calling grab.
| actor |
a Actor |