| /* |
| Copyright (C) 2010 ProFUSION embedded systems |
| Copyright (C) 2010 Samsung Electronics |
| |
| This library is free software; you can redistribute it and/or |
| modify it under the terms of the GNU Library General Public |
| License as published by the Free Software Foundation; either |
| version 2 of the License, or (at your option) any later version. |
| |
| This library is distributed in the hope that it will be useful, |
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| Library General Public License for more details. |
| |
| You should have received a copy of the GNU Library General Public License |
| along with this library; see the file COPYING.LIB. If not, write to |
| the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, |
| Boston, MA 02110-1301, USA. |
| */ |
| |
| /** |
| * @file ewk_contextmenu.h |
| * @brief Describes the context menu API. |
| * |
| * The following signals (see evas_object_smart_callback_add()) are emitted: |
| * |
| * - "contextmenu,customize", Eina_List *: customize context menu is taken |
| * and it gives a list with items of context menu as an argument. |
| * - "contextmenu,free", Ewk_Context_Menu *: a context menu is freed. |
| * - "contextmenu,item,appended", Ewk_Context_Menu *: a new item was added to |
| * the context menu. |
| * - "contextmenu,new", Ewk_Context_Menu *: a new context menu was created |
| * and it gives the context menu as an argument. |
| * - "contextmenu,show", Ewk_Context_Menu *: a context menu is shown. |
| */ |
| |
| #ifndef ewk_contextmenu_h |
| #define ewk_contextmenu_h |
| |
| #include <Eina.h> |
| #include <Evas.h> |
| |
| #ifdef __cplusplus |
| extern "C" { |
| #endif |
| |
| /** |
| * \enum _Ewk_Context_Menu_Action |
| * @brief Provides the actions of items for the context menu. |
| * @info Keep this in sync with ContextMenuItem.h |
| */ |
| enum _Ewk_Context_Menu_Action { |
| EWK_CONTEXT_MENU_ITEM_TAG_NO_ACTION = 0, // this item is not actually in web_uidelegate.h |
| EWK_CONTEXT_MENU_ITEM_TAG_OPEN_LINK_IN_NEW_WINDOW = 1, |
| EWK_CONTEXT_MENU_ITEM_TAG_DOWNLOAD_LINK_TO_DISK, |
| EWK_CONTEXT_MENU_ITEM_TAG_COPY_LINK_TO_CLIPBOARD, |
| EWK_CONTEXT_MENU_ITEM_TAG_OPEN_IMAGE_IN_NEW_WINDOW, |
| EWK_CONTEXT_MENU_ITEM_TAG_DOWNLOAD_IMAGE_TO_DISK, |
| EWK_CONTEXT_MENU_ITEM_TAG_COPY_IMAGE_TO_CLIPBOARD, |
| EWK_CONTEXT_MENU_ITEM_TAG_COPY_IMAGE_URL_TO_CLIPBOARD, |
| EWK_CONTEXT_MENU_ITEM_TAG_OPEN_FRAME_IN_NEW_WINDOW, |
| EWK_CONTEXT_MENU_ITEM_TAG_COPY, |
| EWK_CONTEXT_MENU_ITEM_TAG_GO_BACK, |
| EWK_CONTEXT_MENU_ITEM_TAG_GO_FORWARD, |
| EWK_CONTEXT_MENU_ITEM_TAG_STOP, |
| EWK_CONTEXT_MENU_ITEM_TAG_RELOAD, |
| EWK_CONTEXT_MENU_ITEM_TAG_CUT, |
| EWK_CONTEXT_MENU_ITEM_TAG_PASTE, |
| EWK_CONTEXT_MENU_ITEM_TAG_SELECT_ALL, |
| EWK_CONTEXT_MENU_ITEM_TAG_SPELLING_GUESS, |
| EWK_CONTEXT_MENU_ITEM_TAG_NO_GUESSES_FOUND, |
| EWK_CONTEXT_MENU_ITEM_TAG_IGNORE_SPELLING, |
| EWK_CONTEXT_MENU_ITEM_TAG_LEARN_SPELLING, |
| EWK_CONTEXT_MENU_ITEM_TAG_OTHER, |
| EWK_CONTEXT_MENU_ITEM_TAG_SEARCH_IN_SPOTLIGHT, |
| EWK_CONTEXT_MENU_ITEM_TAG_SEARCH_WEB, |
| EWK_CONTEXT_MENU_ITEM_TAG_LOOK_UP_IN_DICTIONARY, |
| EWK_CONTEXT_MENU_ITEM_TAG_OPEN_WITH_DEFAULT_APPLICATION, |
| EWK_CONTEXT_MENU_ITEM_PDFACTUAL_SIZE, |
| EWK_CONTEXT_MENU_ITEM_PDFZOOM_IN, |
| EWK_CONTEXT_MENU_ITEM_PDFZOOM_OUT, |
| EWK_CONTEXT_MENU_ITEM_PDFAUTO_SIZE, |
| EWK_CONTEXT_MENU_ITEM_PDFSINGLE_PAGE, |
| EWK_CONTEXT_MENU_ITEM_PDFFACING_PAGES, |
| EWK_CONTEXT_MENU_ITEM_PDFCONTINUOUS, |
| EWK_CONTEXT_MENU_ITEM_PDFNEXT_PAGE, |
| EWK_CONTEXT_MENU_ITEM_PDFPREVIOUS_PAGE, |
| EWK_CONTEXT_MENU_ITEM_TAG_OPEN_LINK = 2000, |
| EWK_CONTEXT_MENU_ITEM_TAG_IGNORE_GRAMMAR, |
| EWK_CONTEXT_MENU_ITEM_TAG_SPELLING_MENU, /**< spelling or spelling/grammar sub-menu */ |
| EWK_CONTEXT_MENU_ITEM_TAG_SHOW_SPELLING_PANEL, |
| EWK_CONTEXT_MENU_ITEM_TAG_CHECK_SPELLING, |
| EWK_CONTEXT_MENU_ITEM_TAG_CHECK_SPELLING_WHILE_TYPING, |
| EWK_CONTEXT_MENU_ITEM_TAG_CHECK_GRAMMAR_WITH_SPELLING, |
| EWK_CONTEXT_MENU_ITEM_TAG_FONT_MENU, /**< font sub-menu */ |
| EWK_CONTEXT_MENU_ITEM_TAG_SHOW_FONTS, |
| EWK_CONTEXT_MENU_ITEM_TAG_BOLD, |
| EWK_CONTEXT_MENU_ITEM_TAG_ITALIC, |
| EWK_CONTEXT_MENU_ITEM_TAG_UNDERLINE, |
| EWK_CONTEXT_MENU_ITEM_TAG_OUTLINE, |
| EWK_CONTEXT_MENU_ITEM_TAG_STYLES, |
| EWK_CONTEXT_MENU_ITEM_TAG_SHOW_COLORS, |
| EWK_CONTEXT_MENU_ITEM_TAG_SPEECH_MENU, /**< speech sub-menu */ |
| EWK_CONTEXT_MENU_ITEM_TAG_START_SPEAKING, |
| EWK_CONTEXT_MENU_ITEM_TAG_STOP_SPEAKING, |
| EWK_CONTEXT_MENU_ITEM_TAG_WRITING_DIRECTION_MENU, /**< writing direction sub-menu */ |
| EWK_CONTEXT_MENU_ITEM_TAG_DEFAULT_DIRECTION, |
| EWK_CONTEXT_MENU_ITEM_TAG_LEFT_TO_RIGHT, |
| EWK_CONTEXT_MENU_ITEM_TAG_RIGHT_TO_LEFT, |
| EWK_CONTEXT_MENU_ITEM_TAG_PDFSINGLE_PAGE_SCROLLING, |
| EWK_CONTEXT_MENU_ITEM_TAG_PDFFACING_PAGES_SCROLLING, |
| EWK_CONTEXT_MENU_ITEM_TAG_INSPECT_ELEMENT, |
| EWK_CONTEXT_MENU_ITEM_TAG_TEXT_DIRECTION_MENU, /**< text direction sub-menu */ |
| EWK_CONTEXT_MENU_ITEM_TAG_TEXT_DIRECTION_DEFAULT, |
| EWK_CONTEXT_MENU_ITEM_TAG_TEXT_DIRECTION_LEFT_TO_RIGHT, |
| EWK_CONTEXT_MENU_ITEM_TAG_TEXT_DIRECTION_RIGHT_TO_LEFT, |
| EWK_CONTEXT_MENU_ITEM_OPEN_MEDIA_IN_NEW_WINDOW, |
| EWK_CONTEXT_MENU_ITEM_TAG_COPY_MEDIA_LINK_TO_CLIPBOARD, |
| EWK_CONTEXT_MENU_ITEM_TAG_TOGGLE_MEDIA_CONTROLS, |
| EWK_CONTEXT_MENU_ITEM_TAG_TOGGLE_MEDIA_LOOP, |
| EWK_CONTEXT_MENU_ITEM_TAG_ENTER_VIDEO_FULLSCREEN, |
| EWK_CONTEXT_MENU_ITEM_TAG_MEDIA_PLAY_PAUSE, |
| EWK_CONTEXT_MENU_ITEM_TAG_MEDIA_MUTE, |
| EWK_CONTEXT_MENU_ITEM_BASE_CUSTOM_TAG = 5000, |
| EWK_CONTEXT_MENU_ITEM_CUSTOM_TAG_NO_ACTION = 5998, |
| EWK_CONTEXT_MENU_ITEM_LAST_CUSTOM_TAG = 5999, |
| EWK_CONTEXT_MENU_ITEM_BASE_APPLICATION_TAG = 10000 |
| }; |
| /** Creates a type name for _Ewk_Context_Menu_Action */ |
| typedef enum _Ewk_Context_Menu_Action Ewk_Context_Menu_Action; |
| |
| /** |
| * \enum _Ewk_Context_Menu_Item_Type |
| * @brief Defines the types of the items for the context menu. |
| * @info Keep this in sync with ContextMenuItem.h |
| */ |
| enum _Ewk_Context_Menu_Item_Type { |
| EWK_ACTION_TYPE, |
| EWK_CHECKABLE_ACTION_TYPE, |
| EWK_SEPARATOR_TYPE, |
| EWK_SUBMENU_TYPE |
| }; |
| /** Creates a type name for _Ewk_Context_Menu_Item_Type */ |
| typedef enum _Ewk_Context_Menu_Item_Type Ewk_Context_Menu_Item_Type; |
| |
| /** Creates a type name for _Ewk_Context_Menu */ |
| typedef struct _Ewk_Context_Menu Ewk_Context_Menu; |
| |
| /** Creates a type name for _Ewk_Context_Menu_Item */ |
| typedef struct _Ewk_Context_Menu_Item Ewk_Context_Menu_Item; |
| |
| |
| |
| /************************** Exported functions ***********************/ |
| |
| /** |
| * Increases the reference count of the given object. |
| * |
| * @param menu the context menu object to increase the reference count |
| */ |
| EAPI void ewk_context_menu_ref(Ewk_Context_Menu *menu); |
| |
| /** |
| * Decreases the reference count of the given object, possibly freeing it. |
| * |
| * When the reference count reaches 0, the menu with all its items are freed. |
| * |
| * @param menu the context menu object to decrease the reference count |
| */ |
| EAPI void ewk_context_menu_unref(Ewk_Context_Menu *menu); |
| |
| /** |
| * Destroys the context menu object. |
| * |
| * @param menu the context menu object to destroy |
| * @return @c EINA_TRUE on success, @c EINA_FALSE on failure |
| * |
| * @see ewk_context_menu_item_free |
| */ |
| EAPI Eina_Bool ewk_context_menu_destroy(Ewk_Context_Menu *menu); |
| |
| /** |
| * Gets the list of items. |
| * |
| * @param o the context menu object to get list of the items |
| * @return the list of the items on success or @c NULL on failure |
| */ |
| EAPI const Eina_List *ewk_context_menu_item_list_get(const Ewk_Context_Menu *o); |
| |
| /** |
| * Creates a new item of the context menu. |
| * |
| * @param type specifies a type of the item |
| * @param action specifies a action of the item |
| * @param parent_menu specifies a parent menu of the item |
| * @param submenu specifies a submenu of the item |
| * @param title specifies a title of the item |
| * @param checked @c EINA_TRUE if the item should be toggled or @c EINA_FALSE if not |
| * @param enabled @c EINA_TRUE to enable the item or @c EINA_FALSE to disable |
| * @return the pointer to the new item on success or @c NULL on failure |
| * |
| * @note The return value @b should @b be freed after use. |
| */ |
| EAPI Ewk_Context_Menu_Item *ewk_context_menu_item_new(Ewk_Context_Menu_Item_Type type, Ewk_Context_Menu_Action action, Ewk_Context_Menu *parent_menu, Ewk_Context_Menu *submenu, const char *title, Eina_Bool checked, Eina_Bool enabled); |
| |
| /** |
| * Destroys the item of the context menu object. |
| * |
| * @param item the item to destroy |
| * |
| * @see ewk_context_menu_destroy |
| * @see ewk_context_menu_unref |
| */ |
| EAPI void ewk_context_menu_item_free(Ewk_Context_Menu_Item *item); |
| |
| /** |
| * Selects the item from the context menu object. |
| * |
| * @param menu the context menu object |
| * @param item the item is selected |
| * @return @c EINA_TRUE on success or @c EINA_FALSE on failure |
| */ |
| EAPI Eina_Bool ewk_context_menu_item_select(Ewk_Context_Menu *menu, Ewk_Context_Menu_Item *item); |
| |
| /** |
| * Gets type of the item. |
| * |
| * @param o the item to get the type |
| * @return type of the item on success or @c EWK_ACTION_TYPE on failure |
| * |
| * @see ewk_context_menu_item_type_set |
| */ |
| EAPI Ewk_Context_Menu_Item_Type ewk_context_menu_item_type_get(const Ewk_Context_Menu_Item *o); |
| |
| /** |
| * Sets the type of item. |
| * |
| * @param o the item to set the type |
| * @param type a new type for the item object |
| * @return @c EINA_TRUE on success, or @c EINA_FALSE on failure |
| * |
| * @see ewk_context_menu_item_type_get |
| */ |
| EAPI Eina_Bool ewk_context_menu_item_type_set(Ewk_Context_Menu_Item *o, Ewk_Context_Menu_Item_Type type); |
| |
| /** |
| * Gets an action of the item. |
| * |
| * @param o the item to get the action |
| * @return an action of the item on success or @c EWK_CONTEXT_MENU_ITEM_TAG_NO_ACTION on failure |
| * |
| * @see ewk_context_menu_item_action_set |
| */ |
| EAPI Ewk_Context_Menu_Action ewk_context_menu_item_action_get(const Ewk_Context_Menu_Item *o); |
| |
| /** |
| * Sets an action of the item. |
| * |
| * @param o the item to set the action |
| * @param action a new action for the item object |
| * @return @c EINA_TRUE on success, or @c EINA_FALSE on failure |
| * |
| * @see ewk_context_menu_item_action_get |
| */ |
| EAPI Eina_Bool ewk_context_menu_item_action_set(Ewk_Context_Menu_Item *o, Ewk_Context_Menu_Action action); |
| |
| /** |
| * Gets a title of the item. |
| * |
| * @param o the item to get the title |
| * @return a title of the item on success, or @c NULL on failure |
| * |
| * @see ewk_context_menu_item_title_set |
| */ |
| EAPI const char *ewk_context_menu_item_title_get(const Ewk_Context_Menu_Item *o); |
| |
| /** |
| * Sets a title of the item. |
| * |
| * @param o the item to set the title |
| * @param title a new title for the item object |
| * @return a new title of the item on success or @c NULL on failure |
| * |
| * @see ewk_context_menu_item_title_get |
| */ |
| EAPI const char *ewk_context_menu_item_title_set(Ewk_Context_Menu_Item *o, const char *title); |
| |
| /** |
| * Queries if the item is toggled. |
| * |
| * @param o the item to query if the item is toggled |
| * @return @c EINA_TRUE if the item is toggled or @c EINA_FALSE if not or on failure |
| */ |
| EAPI Eina_Bool ewk_context_menu_item_checked_get(const Ewk_Context_Menu_Item *o); |
| |
| /** |
| * Sets if the item should be toggled. |
| * |
| * @param o the item to be toggled |
| * @param checked @c EINA_TRUE if the item should be toggled or @c EINA_FALSE if not |
| * @return @c EINA_TRUE on success or @c EINA_FALSE on failure |
| */ |
| EAPI Eina_Bool ewk_context_menu_item_checked_set(Ewk_Context_Menu_Item *o, Eina_Bool checked); |
| |
| /** |
| * Gets if the item is enabled. |
| * |
| * @param o the item to get enabled state |
| * @return @c EINA_TRUE if it's enabled, @c EINA_FALSE if not or on failure |
| * |
| * @see ewk_context_menu_item_enabled_set |
| */ |
| EAPI Eina_Bool ewk_context_menu_item_enabled_get(const Ewk_Context_Menu_Item *o); |
| |
| /** |
| * Enables/disables the item. |
| * |
| * @param o the item to enable/disable |
| * @param enabled @c EINA_TRUE to enable the item or @c EINA_FALSE to disable |
| * @return @c EINA_TRUE on success, or @c EINA_FALSE on failure |
| * |
| * @see ewk_context_menu_item_enabled_get |
| */ |
| EAPI Eina_Bool ewk_context_menu_item_enabled_set(Ewk_Context_Menu_Item *o, Eina_Bool enabled); |
| |
| /** |
| * Gets the parent menu for context menu item. |
| * |
| * @param o the context menu item object |
| * @return a context menu object on success or @c NULL on failure |
| */ |
| EAPI Ewk_Context_Menu *ewk_context_menu_item_parent_get(const Ewk_Context_Menu_Item *o); |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| #endif // ewk_contextmenu_h |