2011-12-29 23:20:48 -08:00
|
|
|
/**
|
2016-03-16 08:05:31 -07:00
|
|
|
* @defgroup Elm_File_Selector_Button File Selector Button
|
2012-04-16 18:35:46 -07:00
|
|
|
* @ingroup Elementary
|
2011-12-29 23:20:48 -08:00
|
|
|
*
|
2012-06-05 15:41:21 -07:00
|
|
|
* @image html fileselector_button_inheritance_tree.png
|
|
|
|
* @image latex fileselector_button_inheritance_tree.eps
|
|
|
|
*
|
2011-12-29 23:20:48 -08:00
|
|
|
* @image html img/widget/fileselector_button/preview-00.png
|
|
|
|
* @image latex img/widget/fileselector_button/preview-00.eps
|
|
|
|
* @image html img/widget/fileselector_button/preview-01.png
|
|
|
|
* @image latex img/widget/fileselector_button/preview-01.eps
|
|
|
|
* @image html img/widget/fileselector_button/preview-02.png
|
|
|
|
* @image latex img/widget/fileselector_button/preview-02.eps
|
|
|
|
*
|
|
|
|
* This is a button that, when clicked, creates an Elementary
|
|
|
|
* window (or inner window) <b> with a @ref Fileselector "file
|
|
|
|
* selector widget" within</b>. When a file is chosen, the (inner)
|
|
|
|
* window is closed and the button emits a signal having the
|
2014-07-19 09:50:03 -07:00
|
|
|
* selected file as it's @p event_info.
|
2011-12-29 23:20:48 -08:00
|
|
|
*
|
|
|
|
* This widget encapsulates operations on its internal file
|
|
|
|
* selector on its own API. There is less control over its file
|
2012-02-14 00:50:20 -08:00
|
|
|
* selector than that one would have instantiating one directly.
|
2011-12-29 23:20:48 -08:00
|
|
|
*
|
|
|
|
* The following styles are available for this button:
|
|
|
|
* @li @c "default"
|
|
|
|
* @li @c "anchor"
|
|
|
|
* @li @c "hoversel_vertical"
|
|
|
|
* @li @c "hoversel_vertical_entry"
|
|
|
|
*
|
2012-05-03 15:44:01 -07:00
|
|
|
* This widget inherits from the @ref Button one, so that all the
|
|
|
|
* functions acting on it also work for file selector button objects.
|
|
|
|
*
|
|
|
|
* This widget emits the following signals, besides the ones sent from
|
|
|
|
* @ref Button:
|
2011-12-29 23:20:48 -08:00
|
|
|
* - @c "file,chosen" - the user has selected a path, whose string
|
2014-07-19 09:50:03 -07:00
|
|
|
* pointer comes as the @p event_info data (a stringshared
|
2011-12-29 23:20:48 -08:00
|
|
|
* string)
|
2013-04-23 05:00:50 -07:00
|
|
|
* - @c "language,changed" - the program's language changed
|
2014-01-22 01:25:55 -08:00
|
|
|
* - @c "focused" - When the fileselector button has received focus. (since 1.8)
|
|
|
|
* - @c "unfocused" - When the fileselector button has lost focus. (since 1.8)
|
2011-12-29 23:20:48 -08:00
|
|
|
*
|
2012-01-02 04:53:29 -08:00
|
|
|
* Default text parts of the fileselector_button widget that you can use for
|
|
|
|
* are:
|
2014-09-04 09:11:58 -07:00
|
|
|
* @li "default" - A label of the fileselector_button
|
2012-01-02 04:53:29 -08:00
|
|
|
*
|
2012-02-27 18:39:31 -08:00
|
|
|
* Default content parts of the fileselector_button widget that you can use for
|
2012-01-09 00:06:43 -08:00
|
|
|
* are:
|
|
|
|
* @li "icon" - Icon of the fileselector_button
|
|
|
|
*
|
2012-01-02 04:53:29 -08:00
|
|
|
* Supported elm_object common APIs.
|
2012-04-17 13:33:59 -07:00
|
|
|
* @li @ref elm_object_part_text_set
|
|
|
|
* @li @ref elm_object_part_text_get
|
|
|
|
* @li @ref elm_object_part_content_set
|
|
|
|
* @li @ref elm_object_part_content_get
|
|
|
|
* @li @ref elm_object_part_content_unset
|
|
|
|
* @li @ref elm_object_disabled_set
|
|
|
|
* @li @ref elm_object_disabled_get
|
2012-01-02 04:53:29 -08:00
|
|
|
*
|
2011-12-29 23:20:48 -08:00
|
|
|
* Here is an example on its usage:
|
|
|
|
* @li @ref fileselector_button_example
|
|
|
|
*
|
|
|
|
* @see @ref File_Selector_Entry for a similar widget.
|
|
|
|
* @{
|
|
|
|
*/
|
2011-12-29 22:49:28 -08:00
|
|
|
|
2013-04-27 23:02:06 -07:00
|
|
|
#ifndef EFL_NOLEGACY_API_SUPPORT
|
|
|
|
#include "elc_fileselector_button_legacy.h"
|
|
|
|
#endif
|
2011-12-29 23:20:48 -08:00
|
|
|
/**
|
|
|
|
* @}
|
|
|
|
*/
|