/usr/include/elementary-1/elc_popup.h is in libelementary-dev 1.8.5-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 | /**
* @defgroup Popup Popup
* @ingroup Elementary
*
* @image html popup_inheritance_tree.png
* @image latex popup_inheritance_tree.eps
*
* This widget is an enhancement of @ref Notify. In addition to
* content area, there are two optional sections, namely title area and
* action area.
*
* The popup widget displays its content with a particular orientation in
* the parent area. This orientation can be one among top, center,
* bottom, left, top-left, top-right, bottom-left and bottom-right.
* Content part of Popup can be an Evas Object set by application or
* it can be Text set by application or set of items containing an
* icon and/or text. The content/item-list can be removed using
* elm_object_content_set with second parameter passed as NULL.
*
* The following figures show the textual layouts of popup in which Title
* Area and Action area are optional ones. Action area can have
* up to 3 buttons handled using elm_object common APIs mentioned
* below. If user wants to have more than 3 buttons then these buttons
* can be put inside the items of a list as content. User needs to
* handle the clicked signal of these action buttons if required. No
* event is processed by the widget automatically when clicked on
* these action buttons.
*
* <pre>
*
*|---------------------| |---------------------| |---------------------|
*| Title Area | | Title Area | | Title Area |
*|Icon| Text | |Icon| Text | |Icon| Text |
*|---------------------| |---------------------| |---------------------|
*| Item 1 | | | | |
*|---------------------| | | | |
*| Item 2 | | | | Description |
*|---------------------| | Content | | |
*| Item 3 | | | | |
*|---------------------| | | | |
*| . | |---------------------| |---------------------|
*| . | | Action Area | | Action Area |
*| . | | Btn1 |Btn2|. |Btn3 | | Btn1 |Btn2| |Btn3 |
*|---------------------| |---------------------| |---------------------|
*| Item N | Content Based Layout Description based Layout
*|---------------------|
*| Action Area |
*| Btn1 |Btn2|. |Btn3 |
*|---------------------|
* Item Based Layout
*
* </pre>
*
* Timeout can be set on expiry of which popup instance hides and
* sends a smart signal "timeout" to the user. The visible region of
* popup is surrounded by a translucent region called Blocked Event
* area. By clicking on Blocked Event area, the signal
* "block,clicked" is sent to the application. This block event area
* can be avoided by using API elm_popup_allow_events_set. When gets
* hidden, popup does not get destroyed automatically, application
* should destroy the popup instance after use. To control the
* maximum height of the internal scroller for item, we use the height
* of the action area which is passed by theme based on the number of
* buttons currently set to popup.
*
* Popup sets the focus to itself when evas_object_show is called on popup.
* To set the focus into popup's contents and buttons automatically,
* evas_object_show on popup should be called after setting all the contents
* and buttons of popup.
*
* This widget inherits from the @ref Layout one, so that all the
* functions acting on it also work for popup objects (@since 1.8).
*
* This widget emits the following signals, besides the ones sent from
* @ref Layout:
* @li @c "timeout" - whenever popup is closed as a result of timeout.
* @li @c "block,clicked" - whenever user taps on Blocked Event area.
* @li @c "focused" - When the popup has received focus. (since 1.8)
* @li @c "unfocused" - When the popup has lost focus. (since 1.8)
* @li "language,changed" - the program's language changed (since 1.8)
*
* Styles available for Popup
* @li "default"
*
* Default contents parts of the popup widget that you can use are:
* @li "default" - The content of the popup
* @li "title,icon" - Title area's icon
* @li "button1" - 1st button of the action area
* @li "button2" - 2nd button of the action area
* @li "button3" - 3rd button of the action area
*
* Default text parts of the popup widget that you can use are:
* @li "title,text" - This operates on Title area's label
* @li "default" - content-text set in the content area of the widget
*
* Default contents parts of the popup items that you can use are:
* @li "default" -Item's icon
*
* Default text parts of the popup items that you can use are:
* @li "default" - Item's label
*
* Supported elm_object_item common APIs.
* @li @ref elm_object_item_part_text_set
* @li @ref elm_object_item_part_text_get
* @li @ref elm_object_item_part_content_set
* @li @ref elm_object_item_part_content_get
* @li @ref elm_object_item_disabled_set
* @li @ref elm_object_item_disabled_get
* @li @ref elm_object_item_del
* @li @ref elm_object_item_signal_emit
*
* Here are some sample code to illustrate Popup usage:
* @li @ref popup_example_01_c
* @li @ref popup_example_02_c
* @li @ref popup_example_03_c
*/
#include "elc_popup_common.h"
#ifdef EFL_EO_API_SUPPORT
#include "elc_popup_eo.h"
#endif
#ifndef EFL_NOLEGACY_API_SUPPORT
#include "elc_popup_legacy.h"
#endif
|