~~Title: Efl.Canvas.Object.pointer_mode~~
====== Efl.Canvas.Object.pointer_mode ======

===== Description =====

%%Low-level pointer behaviour.%%

%%This function has a direct effect on event callbacks related to pointers (mouse, ...).%%

%%If the value is %%[[:develop:api:efl:input:object_pointer_mode|Efl.Input.Object_Pointer_Mode.auto_grab]]%% (default), then when mouse is pressed down over this object, events will be restricted to it as source, mouse moves, for example, will be emitted even when the pointer goes outside this objects geometry.%%

%%If the value is %%[[:develop:api:efl:input:object_pointer_mode|Efl.Input.Object_Pointer_Mode.no_grab]]%%, then events will be emitted just when inside this object area.%%

%%See also: %%[[:develop:api:efl:canvas:object:property:pointer_mode_by_device|Efl.Canvas.Object.pointer_mode_by_device.get]]%% and %%[[:develop:api:efl:canvas:object:property:pointer_mode_by_device|Efl.Canvas.Object.pointer_mode_by_device.set]]%% Note: This function will only set/get the mode for the default pointer.%%

//Since 1.22//
{{page>:develop:api-include:efl:canvas:object:property:pointer_mode:description&nouser&nolink&nodate}}

===== Values =====

  * **pointer_mode** - %%Input pointer mode%%

===== Signature =====

<code>
@property pointer_mode @beta {
    get {}
    set {
        return: bool;
    }
    values {
        pointer_mode: Efl.Input.Object_Pointer_Mode (Efl.Input.Object_Pointer_Mode.auto_grab);
    }
}
</code>

===== C signature =====

<code c>
Efl_Input_Object_Pointer_Mode efl_canvas_object_pointer_mode_get(const Eo *obj);
Eina_Bool efl_canvas_object_pointer_mode_set(Eo *obj, Efl_Input_Object_Pointer_Mode pointer_mode);
</code>

===== Implemented by =====

  * [[:develop:api:efl:canvas:object:property:pointer_mode|Efl.Canvas.Object.pointer_mode]]