139 lines
4.9 KiB
Cython
139 lines
4.9 KiB
Cython
# Copyright (C) 2007-2022 various contributors (see AUTHORS)
|
|
#
|
|
# This file is part of Python-EFL.
|
|
#
|
|
# Python-EFL is free software; you can redistribute it and/or
|
|
# modify it under the terms of the GNU Lesser General Public
|
|
# License as published by the Free Software Foundation; either
|
|
# version 3 of the License, or (at your option) any later version.
|
|
#
|
|
# Python-EFL is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
# Lesser General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU Lesser General Public License
|
|
# along with this Python-EFL. If not, see <http://www.gnu.org/licenses/>.
|
|
|
|
include "button_cdef.pxi"
|
|
|
|
cdef class Button(LayoutClass):
|
|
"""
|
|
|
|
This is the class that actually implements the widget.
|
|
|
|
"""
|
|
|
|
def __init__(self, evasObject parent, *args, **kwargs):
|
|
"""
|
|
|
|
:param parent: The parent object
|
|
:type parent: :py:class:`efl.evas.Object`
|
|
:param \**kwargs: All the remaining keyword arguments are interpreted
|
|
as properties of the instance
|
|
|
|
"""
|
|
self._set_obj(elm_button_add(parent.obj))
|
|
self._set_properties_from_keyword_args(kwargs)
|
|
|
|
property autorepeat:
|
|
"""Turn on/off the autorepeat event generated when the button is
|
|
kept pressed
|
|
|
|
When off, no autorepeat is performed and buttons emit a normal
|
|
``clicked`` signal when they are clicked.
|
|
|
|
When on, keeping a button pressed will continuously emit a
|
|
``repeated`` signal until the button is released. The time it takes
|
|
until it starts emitting the signal is given by
|
|
:py:attr:`autorepeat_initial_timeout`, and the time between each new
|
|
emission by :py:attr:`autorepeat_gap_timeout`.
|
|
|
|
:type: bool
|
|
|
|
"""
|
|
def __get__(self):
|
|
return bool(elm_button_autorepeat_get(self.obj))
|
|
def __set__(self, on):
|
|
elm_button_autorepeat_set(self.obj, on)
|
|
|
|
def autorepeat_set(self, on):
|
|
elm_button_autorepeat_set(self.obj, on)
|
|
def autorepeat_get(self):
|
|
return bool(elm_button_autorepeat_get(self.obj))
|
|
|
|
property autorepeat_initial_timeout:
|
|
"""The initial timeout before the autorepeat event is generated
|
|
|
|
Reflects the timeout, in seconds, since the button is pressed until
|
|
the first ``repeated`` signal is emitted. If ``t`` is 0.0 or less,
|
|
there won't be any delay and the event will be fired the moment the
|
|
button is pressed.
|
|
|
|
.. seealso:: :py:attr:`autorepeat`, :py:attr:`autorepeat_gap_timeout`
|
|
|
|
:type: float
|
|
|
|
"""
|
|
def __get__(self):
|
|
return elm_button_autorepeat_initial_timeout_get(self.obj)
|
|
def __set__(self, t):
|
|
elm_button_autorepeat_initial_timeout_set(self.obj, t)
|
|
|
|
def autorepeat_initial_timeout_set(self, t):
|
|
elm_button_autorepeat_initial_timeout_set(self.obj, t)
|
|
def autorepeat_initial_timeout_get(self):
|
|
return elm_button_autorepeat_initial_timeout_get(self.obj)
|
|
|
|
property autorepeat_gap_timeout:
|
|
"""The interval between each generated autorepeat event
|
|
|
|
After the first ``repeated`` event is fired, all subsequent ones will
|
|
follow after a delay of ``t`` seconds for each.
|
|
|
|
.. seealso:: :py:attr:`autorepeat_initial_timeout`
|
|
|
|
:type: float
|
|
|
|
"""
|
|
def __get__(self):
|
|
return elm_button_autorepeat_gap_timeout_get(self.obj)
|
|
def __set__(self, t):
|
|
elm_button_autorepeat_gap_timeout_set(self.obj, t)
|
|
|
|
def autorepeat_gap_timeout_set(self, t):
|
|
elm_button_autorepeat_gap_timeout_set(self.obj, t)
|
|
def autorepeat_gap_timeout_get(self):
|
|
return elm_button_autorepeat_gap_timeout_get(self.obj)
|
|
|
|
def callback_clicked_add(self, func, *args, **kwargs):
|
|
"""The user clicked the button (press/release)."""
|
|
self._callback_add("clicked", func, args, kwargs)
|
|
|
|
def callback_clicked_del(self, func):
|
|
self._callback_del("clicked", func)
|
|
|
|
def callback_repeated_add(self, func, *args, **kwargs):
|
|
"""The user pressed the button without releasing it."""
|
|
self._callback_add("repeated", func, args, kwargs)
|
|
|
|
def callback_repeated_del(self, func):
|
|
self._callback_del("repeated", func)
|
|
|
|
def callback_pressed_add(self, func, *args, **kwargs):
|
|
"""The button was pressed."""
|
|
self._callback_add("pressed", func, args, kwargs)
|
|
|
|
def callback_pressed_del(self, func):
|
|
self._callback_del("pressed", func)
|
|
|
|
def callback_unpressed_add(self, func, *args, **kwargs):
|
|
"""The button was released after being pressed."""
|
|
self._callback_add("unpressed", func, args, kwargs)
|
|
|
|
def callback_unpressed_del(self, func):
|
|
self._callback_del("unpressed", func)
|
|
|
|
|
|
_object_mapping_register("Efl.Ui.Button_Legacy", Button)
|