2011-12-29 23:20:48 -08:00
|
|
|
/**
|
|
|
|
* @defgroup Frame Frame
|
|
|
|
*
|
|
|
|
* @image html img/widget/frame/preview-00.png
|
|
|
|
* @image latex img/widget/frame/preview-00.eps
|
|
|
|
*
|
|
|
|
* @brief Frame is a widget that holds some content and has a title.
|
|
|
|
*
|
2012-02-14 00:50:33 -08:00
|
|
|
* The default look is a frame with a title, but Frame supports multiple
|
2011-12-29 23:20:48 -08:00
|
|
|
* styles:
|
|
|
|
* @li default
|
|
|
|
* @li pad_small
|
|
|
|
* @li pad_medium
|
|
|
|
* @li pad_large
|
|
|
|
* @li pad_huge
|
|
|
|
* @li outdent_top
|
|
|
|
* @li outdent_bottom
|
|
|
|
*
|
2012-01-03 16:41:37 -08:00
|
|
|
* Of all this styles only default shows the title.
|
|
|
|
*
|
|
|
|
* Smart callbacks one can listen to:
|
|
|
|
* - @c "clicked" - The user has clicked the frame's label
|
2011-12-29 23:20:48 -08:00
|
|
|
*
|
2012-02-27 18:39:31 -08:00
|
|
|
* Default content parts of the frame widget that you can use for are:
|
2011-12-29 23:20:48 -08:00
|
|
|
* @li "default" - A content of the frame
|
|
|
|
*
|
|
|
|
* Default text parts of the frame widget that you can use for are:
|
2012-01-08 22:55:51 -08:00
|
|
|
* @li "default" - Label of the frame
|
|
|
|
*
|
|
|
|
* Supported elm_object common APIs.
|
|
|
|
* @li elm_object_part_text_set
|
|
|
|
* @li elm_object_part_text_get
|
|
|
|
* @li elm_object_part_content_set
|
|
|
|
* @li elm_object_part_content_get
|
|
|
|
* @li elm_object_part_content_unset
|
2011-12-29 23:20:48 -08:00
|
|
|
*
|
|
|
|
* For a detailed example see the @ref tutorial_frame.
|
|
|
|
*
|
|
|
|
* @{
|
|
|
|
*/
|
2011-12-29 22:49:28 -08:00
|
|
|
|
2011-12-29 23:20:48 -08:00
|
|
|
/**
|
|
|
|
* @brief Add a new frame to the parent
|
|
|
|
*
|
|
|
|
* @param parent The parent object
|
|
|
|
* @return The new object or NULL if it cannot be created
|
|
|
|
*/
|
2011-12-30 01:48:46 -08:00
|
|
|
EAPI Evas_Object *elm_frame_add(Evas_Object *parent);
|
2011-12-29 22:49:28 -08:00
|
|
|
|
2012-01-03 19:03:15 -08:00
|
|
|
/**
|
|
|
|
* @brief Toggle autocollapsing of a frame
|
|
|
|
* @param obj The frame
|
2012-02-20 04:54:14 -08:00
|
|
|
* @param autocollapse Whether to enable autocollapse
|
2012-01-03 19:03:15 -08:00
|
|
|
*
|
|
|
|
* When @p enable is EINA_TRUE, clicking a frame's label will collapse the frame
|
|
|
|
* vertically, shrinking it to the height of the label.
|
|
|
|
* By default, this is DISABLED.
|
|
|
|
*/
|
2012-02-20 04:54:14 -08:00
|
|
|
//XXX: really need to provide this API?
|
|
|
|
//XXX: How about elm_frame_autofold_set() ?
|
|
|
|
EAPI void elm_frame_autocollapse_set(Evas_Object *obj, Eina_Bool autocollapse);
|
2012-01-03 19:03:15 -08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @brief Determine autocollapsing of a frame
|
|
|
|
* @param obj The frame
|
|
|
|
* @return Whether autocollapse is enabled
|
|
|
|
*
|
|
|
|
* When this returns EINA_TRUE, clicking a frame's label will collapse the frame
|
|
|
|
* vertically, shrinking it to the height of the label.
|
|
|
|
* By default, this is DISABLED.
|
|
|
|
*/
|
2012-02-20 04:54:14 -08:00
|
|
|
//XXX: ... really need to provide this API?
|
|
|
|
//XXX: How about elm_frame_autofold_get() ?
|
|
|
|
EAPI Eina_Bool elm_frame_autocollapse_get(const Evas_Object *obj);
|
2012-01-03 19:03:15 -08:00
|
|
|
|
|
|
|
/**
|
2012-01-13 20:12:45 -08:00
|
|
|
* @brief Manually collapse a frame without animations
|
2012-01-03 19:03:15 -08:00
|
|
|
* @param obj The frame
|
2012-01-13 20:24:02 -08:00
|
|
|
* @param collapse true to collapse, false to expand
|
2012-01-03 19:03:15 -08:00
|
|
|
*
|
2012-01-13 20:12:45 -08:00
|
|
|
* Use this to toggle the collapsed state of a frame, bypassing animations.
|
2012-01-03 19:03:15 -08:00
|
|
|
*/
|
2012-02-20 04:54:14 -08:00
|
|
|
//XXX: How about elm_frame_fold_set() ?
|
2012-01-13 20:24:02 -08:00
|
|
|
EAPI void elm_frame_collapse_set(Evas_Object *obj, Eina_Bool collapse);
|
2012-01-03 19:03:15 -08:00
|
|
|
|
2012-01-13 20:12:45 -08:00
|
|
|
/**
|
|
|
|
* @brief Manually collapse a frame with animations
|
|
|
|
* @param obj The frame
|
2012-01-13 20:24:02 -08:00
|
|
|
* @param collapse true to collapse, false to expand
|
2012-01-13 20:12:45 -08:00
|
|
|
*
|
|
|
|
* Use this to toggle the collapsed state of a frame, triggering animations.
|
|
|
|
*/
|
2012-02-20 04:54:14 -08:00
|
|
|
//XXX: ... really need to provide this API?
|
2012-02-20 04:56:26 -08:00
|
|
|
//XXX: How about elm_frame_fold_transition_go()?
|
2012-01-13 20:24:02 -08:00
|
|
|
EAPI void elm_frame_collapse_go(Evas_Object *obj, Eina_Bool collapse);
|
2012-01-13 20:12:45 -08:00
|
|
|
|
2012-01-03 19:03:15 -08:00
|
|
|
/**
|
|
|
|
* @brief Determine the collapse state of a frame
|
|
|
|
* @param obj The frame
|
|
|
|
* @return true if collapsed, false otherwise
|
|
|
|
*
|
|
|
|
* Use this to determine the collapse state of a frame.
|
|
|
|
*/
|
2012-02-20 04:54:14 -08:00
|
|
|
//XXX: ... How about elm_frame_fold_get() ?
|
|
|
|
EAPI Eina_Bool elm_frame_collapse_get(const Evas_Object *obj);
|
2011-12-29 23:20:48 -08:00
|
|
|
/**
|
|
|
|
* @}
|
|
|
|
*/
|