Panes

../_images/panes-preview.png

Widget description

The panes widget adds a draggable bar between two contents. When dragged this bar will resize contents’ size.

Panes can be displayed vertically or horizontally, and contents size proportion can be customized (homogeneous by default).

Emitted signals

  • press - The panes has been pressed (button wasn’t released yet).
  • unpressed - The panes was released after being pressed.
  • clicked - The panes has been clicked.
  • clicked,double - The panes has been double clicked.

Layout content parts

  • left - A leftside content of the panes
  • right - A rightside content of the panes
  • top - A top content of the vertical panes
  • bottom - A bottom content of the vertical panes

If panes are displayed vertically, left content will be displayed on top.

Inheritance diagram

class efl.elementary.Panes(Object parent, *args, **kwargs)

Bases: efl.elementary.__init__.LayoutClass

Parameters:
  • parent (efl.evas.Object) – The parent object
  • **kwargs – All the remaining keyword arguments are interpreted as properties of the instance
callback_clicked_add

The panes has been clicked.

callback_clicked_del
callback_clicked_double_add

The panes has been double clicked.

callback_clicked_double_del
callback_press_add

The panes has been pressed (button wasn’t released yet).

callback_press_del
callback_unpress_add

The panes was released after being pressed.

callback_unpress_del
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

New in version 1.11.

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

New in version 1.11.

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
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

New in version 1.11.

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

New in version 1.11.

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
fixed

Whether the left and right panes resize homogeneously or not.

By default panes are resized homogeneously.

Type:bool
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