python-efl/efl/elementary/panes.pxi

208 lines
6.7 KiB
Cython

# Copyright (C) 2007-2016 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 "panes_cdef.pxi"
cdef class Panes(LayoutClass):
"""
This is the class that actually implements the widget.
"""
def __init__(self, evasObject parent, *args, **kwargs):
"""Panes(...)
: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_panes_add(parent.obj))
self._set_properties_from_keyword_args(kwargs)
property fixed:
"""Whether the left and right panes resize homogeneously or not.
By default panes are resized homogeneously.
.. seealso:: :py:attr:`content_left_size` :py:attr:`content_right_size`
:type: bool
"""
def __set__(self, fixed):
elm_panes_fixed_set(self.obj, fixed)
def __get__(self):
return bool(elm_panes_fixed_get(self.obj))
property content_left_size:
"""The size proportion of panes widget's left side.
By default it's homogeneous, i.e., both sides have the same size.
If something different is required, it can be set with this property.
For example, if the left content should be displayed over
75% of the panes size, ``size`` should be passed as ``0.75``.
This way, right content will be resized to 25% of panes size.
If displayed vertically, left content is displayed at top, and
right content at bottom.
.. note:: This proportion will change when user drags the panes bar.
:type: float
"""
def __get__(self):
return elm_panes_content_left_size_get(self.obj)
def __set__(self, size):
elm_panes_content_left_size_set(self.obj, size)
property content_right_size:
"""The size proportion of panes widget's right side.
By default it's homogeneous, i.e., both sides have the same size.
If something different is required, it can be set with this property.
For example, if the right content should be displayed over
75% of the panes size, ``size`` should be passed as ``0.75.``
This way, left content will be resized to 25% of panes size.
If displayed vertically, left content is displayed at top, and
right content at bottom.
.. note:: This proportion will change when user drags the panes bar.
:type: float
"""
def __get__(self):
return elm_panes_content_right_size_get(self.obj)
def __set__(self, size):
elm_panes_content_right_size_set(self.obj, size)
property content_left_min_relative_size:
"""The relative minimum size of panes widget's left side.
The value must be between 0.0 and 1.0 representing size
proportion of minimum size of left side.
:type: float
.. versionadded:: 1.11
"""
def __get__(self):
return elm_panes_content_left_min_relative_size_get(self.obj)
def __set__(self, size):
elm_panes_content_left_min_relative_size_set(self.obj, size)
property content_right_min_relative_size:
"""The relative minimum size of panes widget's right side.
The value must be between 0.0 and 1.0 representing size
proportion of minimum size of right side.
:type: float
.. versionadded:: 1.11
"""
def __get__(self):
return elm_panes_content_right_min_relative_size_get(self.obj)
def __set__(self, size):
elm_panes_content_right_min_relative_size_set(self.obj, size)
property content_left_min_size:
"""The absolute minimum size of panes widget's left side.
The value represent the minimum size of left side in pixels.
:type: int
.. versionadded:: 1.11
"""
def __get__(self):
return elm_panes_content_left_min_size_get(self.obj)
def __set__(self, size):
elm_panes_content_left_min_size_set(self.obj, size)
property content_right_min_size:
"""The absolute minimum size of panes widget's right side.
The value represent the minimum size of right side in pixels.
:type: int
.. versionadded:: 1.11
"""
def __get__(self):
return elm_panes_content_right_min_size_get(self.obj)
def __set__(self, size):
elm_panes_content_right_min_size_set(self.obj, size)
property horizontal:
"""The orientation of a given panes widget.
Use this property to change how your panes is to be disposed:
vertically or horizontally.
By default it's displayed horizontally.
:type: bool
"""
def __set__(self, horizontal):
elm_panes_horizontal_set(self.obj, horizontal)
def __get__(self):
return bool(elm_panes_horizontal_get(self.obj))
def callback_press_add(self, func, *args, **kwargs):
"""The panes has been pressed (button wasn't released yet)."""
self._callback_add("press", func, args, kwargs)
def callback_press_del(self, func):
self._callback_del("press", func)
def callback_unpress_add(self, func, *args, **kwargs):
"""The panes was released after being pressed."""
self._callback_add("unpress", func, args, kwargs)
def callback_unpress_del(self, func):
self._callback_del("unpress", func)
def callback_clicked_add(self, func, *args, **kwargs):
"""The panes has been clicked."""
self._callback_add("clicked", func, args, kwargs)
def callback_clicked_del(self, func):
self._callback_del("clicked", func)
def callback_clicked_double_add(self, func, *args, **kwargs):
"""The panes has been double clicked."""
self._callback_add("clicked,double", func, args, kwargs)
def callback_clicked_double_del(self, func):
self._callback_del("clicked,double", func)
_object_mapping_register("Efl.Ui.Panes_Legacy", Panes)