set_motion_events_enabled
Description:
Sets whether per-actor motion events (and relative crossing events) should be disabled or not.
The default is true
.
If enable
is false
the following signals will not be emitted by the actors children of
this:
- motion_event - enter_event - leave_event
The events will still be delivered to the Stage.
The main side effect of this function is that disabling the motion events will disable picking to detect the Actor underneath the pointer for each motion event. This is useful, for instance, when dragging a Actor across the this: the actor underneath the pointer is not going to change, so it's meaningless to perform a pick.
Parameters:
this |
a Stage |
enabled |
|