Tizen Native API
4.0
|
![panes_inheritance_tree.png](panes_inheritance_tree.png)
![panes.png](panes.png)
The panes widget adds a draggable bar between two contents. When dragged this bar will resize contents' size.
Panes can be split vertically or horizontally, and contents size proportion can be customized (homogeneous by default).
This widget inherits from the Layout one, so that all the functions acting on it also work for panes objects.
This widget emits the following signals, besides the ones sent from Elm_Layout:
"press"
- The panes has been pressed (button wasn't released yet)."unpress"
- The panes was released after being pressed."clicked"
- The panes has been clicked>"clicked,double"
- The panes has been double clicked
Available styles for it:
"default"
Default content parts of the panes widget that you can use are:
- "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.
Supported elm_object common APIs.
Functions | |
void | elm_panes_content_left_size_set (Elm_Panes *obj, double size) |
Set the size proportion of panes widget's left side. | |
double | elm_panes_content_left_size_get (const Elm_Panes *obj) |
Set the size proportion of panes widget's left side. | |
void | elm_panes_horizontal_set (Elm_Panes *obj, Eina_Bool horizontal) |
Set how to split and dispose each content. | |
Eina_Bool | elm_panes_horizontal_get (const Elm_Panes *obj) |
Set how to split and dispose each content. | |
void | elm_panes_fixed_set (Elm_Panes *obj, Eina_Bool fixed) |
Set whether the left and right panes can be resized by user interaction. | |
Eina_Bool | elm_panes_fixed_get (const Elm_Panes *obj) |
Set whether the left and right panes can be resized by user interaction. | |
void | elm_panes_content_right_size_set (Elm_Panes *obj, double size) |
Set the size proportion of panes widget's right side. | |
double | elm_panes_content_right_size_get (const Elm_Panes *obj) |
Set the size proportion of panes widget's right side. | |
void | elm_panes_content_left_min_relative_size_set (Elm_Panes *obj, double size) |
Controls the relative minimum size of panes widget's left side. | |
double | elm_panes_content_left_min_relative_size_get (const Elm_Panes *obj) |
Controls the relative minimum size of panes widget's left side. | |
void | elm_panes_content_right_min_relative_size_set (Elm_Panes *obj, double size) |
Set the relative minimum size of panes widget's right side. | |
double | elm_panes_content_right_min_relative_size_get (const Elm_Panes *obj) |
Set the relative minimum size of panes widget's right side. | |
void | elm_panes_content_left_min_size_set (Elm_Panes *obj, Evas_Coord size) |
Set the absolute minimum size of panes widget's left side. | |
Evas_Coord | elm_panes_content_left_min_size_get (const Elm_Panes *obj) |
Set the absolute minimum size of panes widget's left side. | |
void | elm_panes_content_right_min_size_set (Elm_Panes *obj, Evas_Coord size) |
Control the absolute minimum size of panes widget's right side. | |
Evas_Coord | elm_panes_content_right_min_size_get (const Elm_Panes *obj) |
Control the absolute minimum size of panes widget's right side. | |
Evas_Object * | elm_panes_add (Evas_Object *parent) |
Function Documentation
Evas_Object* elm_panes_add | ( | Evas_Object * | parent | ) |
Add a new panes widget to the given parent Elementary (container) object.
- Parameters:
-
parent The parent object.
- Returns:
- a new panes widget handle or
NULL
, on errors.
This function inserts a new panes widget on the canvas.
- Since :
- 2.3
double elm_panes_content_left_min_relative_size_get | ( | const Elm_Panes * | obj | ) |
Controls the relative minimum size of panes widget's left side.
proportion of minimum size of left side.
- Note:
- If displayed vertically, left content is displayed at top.
- Since :
- 3.0
- Parameters:
-
[in] obj The object.
- Returns:
- value between 0.0 and 1.0 representing size proportion of minimum size of left side.
void elm_panes_content_left_min_relative_size_set | ( | Elm_Panes * | obj, |
double | size | ||
) |
Controls the relative minimum size of panes widget's left side.
proportion of minimum size of left side.
- Note:
- If displayed vertically, left content is displayed at top.
- Since :
- 3.0
- Parameters:
-
[in] obj The object. [in] size value between 0.0 and 1.0 representing size proportion of minimum size of left side.
Evas_Coord elm_panes_content_left_min_size_get | ( | const Elm_Panes * | obj | ) |
Set the absolute minimum size of panes widget's left side.
- Note:
- If displayed vertically, left content is displayed at top.
- Since :
- 3.0
- Parameters:
-
[in] obj The object.
- Returns:
- value representing minimum size of left side in pixels.
void elm_panes_content_left_min_size_set | ( | Elm_Panes * | obj, |
Evas_Coord | size | ||
) |
Set the absolute minimum size of panes widget's left side.
- Note:
- If displayed vertically, left content is displayed at top.
- Since :
- 3.0
- Parameters:
-
[in] obj The object. [in] size value representing minimum size of left side in pixels.
double elm_panes_content_left_size_get | ( | const Elm_Panes * | obj | ) |
Set 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 function. 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.
- Since :
- 2.3
- Parameters:
-
[in] obj The object.
- Returns:
- Value between 0.0 and 1.0 representing size proportion of left side.
void elm_panes_content_left_size_set | ( | Elm_Panes * | obj, |
double | size | ||
) |
Set 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 function. 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.
- Since :
- 2.3
- Parameters:
-
[in] obj The object. [in] size Value between 0.0 and 1.0 representing size proportion of left side.
double elm_panes_content_right_min_relative_size_get | ( | const Elm_Panes * | obj | ) |
Set the relative minimum size of panes widget's right side.
- Note:
- If displayed vertically, right content is displayed at bottom.
- Since :
- 3.0
- Parameters:
-
[in] obj The object.
- Returns:
- value between 0.0 and 1.0 representing size proportion of minimum size of right side.
void elm_panes_content_right_min_relative_size_set | ( | Elm_Panes * | obj, |
double | size | ||
) |
Set the relative minimum size of panes widget's right side.
- Note:
- If displayed vertically, right content is displayed at bottom.
- Since :
- 3.0
- Parameters:
-
[in] obj The object. [in] size value between 0.0 and 1.0 representing size proportion of minimum size of right side.
Evas_Coord elm_panes_content_right_min_size_get | ( | const Elm_Panes * | obj | ) |
Control the absolute minimum size of panes widget's right side.
- Note:
- If displayed vertically, right content is displayed at bottom.
- Since :
- 3.0
- Parameters:
-
[in] obj The object.
- Returns:
- value representing minimum size of right side in pixels.
void elm_panes_content_right_min_size_set | ( | Elm_Panes * | obj, |
Evas_Coord | size | ||
) |
Control the absolute minimum size of panes widget's right side.
- Note:
- If displayed vertically, right content is displayed at bottom.
- Since :
- 3.0
- Parameters:
-
[in] obj The object. [in] size value representing minimum size of right side in pixels.
double elm_panes_content_right_size_get | ( | const Elm_Panes * | obj | ) |
Set 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 function. 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.
- Since :
- 2.3
- Parameters:
-
[in] obj The object.
- Returns:
- Value between 0.0 and 1.0 representing size proportion of right side.
void elm_panes_content_right_size_set | ( | Elm_Panes * | obj, |
double | size | ||
) |
Set 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 function. 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.
- Since :
- 2.3
- Parameters:
-
[in] obj The object. [in] size Value between 0.0 and 1.0 representing size proportion of right side.
Eina_Bool elm_panes_fixed_get | ( | const Elm_Panes * | obj | ) |
Set whether the left and right panes can be resized by user interaction.
By default panes' contents are resizable by user interaction.
- Since :
- 2.3
- Parameters:
-
[in] obj The object.
- Returns:
- Use
true
to fix the left and right panes sizes and make them not to be resized by user interaction. Usefalse
to make them resizable.
void elm_panes_fixed_set | ( | Elm_Panes * | obj, |
Eina_Bool | fixed | ||
) |
Set whether the left and right panes can be resized by user interaction.
By default panes' contents are resizable by user interaction.
- Since :
- 2.3
- Parameters:
-
[in] obj The object. [in] fixed Use true
to fix the left and right panes sizes and make them not to be resized by user interaction. Usefalse
to make them resizable.
Eina_Bool elm_panes_horizontal_get | ( | const Elm_Panes * | obj | ) |
Set how to split and dispose each content.
Use this function to change how your panes is to be disposed: vertically or horizontally. Horizontal panes have "top" and "bottom" contents, vertical panes have "left" and "right" contents.
By default panes is in a vertical mode.
- Since :
- 2.3
- Parameters:
-
[in] obj The object.
- Returns:
- Use
true
to makeobj
to split panes horizontally ("top" and "bottom" contents).false
to make it vertically ("left" and "right" contents).
void elm_panes_horizontal_set | ( | Elm_Panes * | obj, |
Eina_Bool | horizontal | ||
) |
Set how to split and dispose each content.
Use this function to change how your panes is to be disposed: vertically or horizontally. Horizontal panes have "top" and "bottom" contents, vertical panes have "left" and "right" contents.
By default panes is in a vertical mode.
- Since :
- 2.3
- Parameters:
-
[in] obj The object. [in] horizontal Use true
to makeobj
to split panes horizontally ("top" and "bottom" contents).false
to make it vertically ("left" and "right" contents).