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

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

Bases: efl.elementary.__init__.LayoutClass

This is the class that actually implements the widget.

Parameters
  • parent (efl.evas.Object) – The parent object

  • **kwargs – All the remaining keyword arguments are interpreted as properties of the instance

callback_clicked_add(func, *args, **kwargs)

The panes has been clicked.

callback_clicked_del(func)
callback_clicked_double_add(func, *args, **kwargs)

The panes has been double clicked.

callback_clicked_double_del(func)
callback_press_add(func, *args, **kwargs)

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

callback_press_del(func)
callback_unpress_add(func, *args, **kwargs)

The panes was released after being pressed.

callback_unpress_del(func)
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