X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=src%2Flib%2Felm_entry.h;h=1ab29a75fc12673c30e4846104b7ae04694df357;hb=01d0d3d0698d197d1f8445a85b198e9ed20999c9;hp=366ef06ff22d07c230fbbb79baac6ef8c94b1451;hpb=5f7aa70a3f94d380e121e824e02ac0fa9bdcb108;p=framework%2Fuifw%2Felementary.git
diff --git a/src/lib/elm_entry.h b/src/lib/elm_entry.h
index 366ef06..1ab29a7 100644
--- a/src/lib/elm_entry.h
+++ b/src/lib/elm_entry.h
@@ -1,79 +1,6 @@
-typedef enum
-{
- ELM_TEXT_FORMAT_PLAIN_UTF8,
- ELM_TEXT_FORMAT_MARKUP_UTF8
-} Elm_Text_Format;
-
-/**
- * Line wrapping types.
- */
-typedef enum
-{
- ELM_WRAP_NONE = 0, /**< No wrap - value is zero */
- ELM_WRAP_CHAR, /**< Char wrap - wrap between characters */
- ELM_WRAP_WORD, /**< Word wrap - wrap in allowed wrapping points (as defined in the unicode standard) */
- ELM_WRAP_MIXED, /**< Mixed wrap - Word wrap, and if that fails, char wrap. */
- ELM_WRAP_LAST
-} Elm_Wrap_Type; /**< Type of word or character wrapping to use */
-
-typedef enum
-{
- ELM_INPUT_PANEL_LAYOUT_NORMAL, /**< Default layout */
- ELM_INPUT_PANEL_LAYOUT_NUMBER, /**< Number layout */
- ELM_INPUT_PANEL_LAYOUT_EMAIL, /**< Email layout */
- ELM_INPUT_PANEL_LAYOUT_URL, /**< URL layout */
- ELM_INPUT_PANEL_LAYOUT_PHONENUMBER, /**< Phone Number layout */
- ELM_INPUT_PANEL_LAYOUT_IP, /**< IP layout */
- ELM_INPUT_PANEL_LAYOUT_MONTH, /**< Month layout */
- ELM_INPUT_PANEL_LAYOUT_NUMBERONLY, /**< Number Only layout */
- ELM_INPUT_PANEL_LAYOUT_INVALID, /**< Never use this */
- ELM_INPUT_PANEL_LAYOUT_HEX, /**< Hexadecimal layout */
- ELM_INPUT_PANEL_LAYOUT_TERMINAL, /**< Command-line terminal layout */
- ELM_INPUT_PANEL_LAYOUT_PASSWORD /**< Like normal, but no auto-correct, no auto-capitalization etc. */
-} Elm_Input_Panel_Layout; /**< Type of input panel (virtual keyboard) to use - this is a hint and may not provide exactly what is desired. */
-
-typedef enum
-{
- ELM_INPUT_PANEL_LANG_AUTOMATIC, /**< Automatic */
- ELM_INPUT_PANEL_LANG_ALPHABET /**< Alphabet */
-} Elm_Input_Panel_Lang;
-
-typedef enum
-{
- ELM_AUTOCAPITAL_TYPE_NONE, /**< No auto-capitalization when typing */
- ELM_AUTOCAPITAL_TYPE_WORD, /**< Autocapitalize each word typed */
- ELM_AUTOCAPITAL_TYPE_SENTENCE, /**< Autocapitalize the start of each sentence */
- ELM_AUTOCAPITAL_TYPE_ALLCHARACTER, /**< Autocapitalize all letters */
-} Elm_Autocapital_Type; /**< Choose method of auto-capitalization */
-
-typedef enum
-{
- ELM_INPUT_PANEL_RETURN_KEY_TYPE_DEFAULT,
- ELM_INPUT_PANEL_RETURN_KEY_TYPE_DONE,
- ELM_INPUT_PANEL_RETURN_KEY_TYPE_GO,
- ELM_INPUT_PANEL_RETURN_KEY_TYPE_JOIN,
- ELM_INPUT_PANEL_RETURN_KEY_TYPE_LOGIN,
- ELM_INPUT_PANEL_RETURN_KEY_TYPE_NEXT,
- ELM_INPUT_PANEL_RETURN_KEY_TYPE_SEARCH,
- ELM_INPUT_PANEL_RETURN_KEY_TYPE_SEND
-} Elm_Input_Panel_Return_Key_Type;
-
-/**
- * @enum _Elm_CNP_Mode
- * @typedef Elm_CNP_Mode
- * Enum of entry's copy & paste policy.
- *
- * @see elm_entry_cnp_mode_set()
- * @see elm_entry_cnp_mode_get()
- */
- typedef enum _Elm_CNP_Mode {
- ELM_CNP_MODE_MARKUP = 0, /**< copy & paste text with markup tag */
- ELM_CNP_MODE_NO_IMAGE = 1, /**< copy & paste text without item(image) tag */
- ELM_CNP_MODE_PLAINTEXT = 2 /**< copy & paste text without markup tag */
- } Elm_CNP_Mode;
-
/**
* @defgroup Entry Entry
+ * @ingroup Elementary
*
* @image html img/widget/entry/preview-00.png
* @image latex img/widget/entry/preview-00.eps width=\textwidth
@@ -86,15 +13,15 @@ typedef enum
*
* An entry is a convenience widget which shows a box that the user can
* enter text into. Entries by default don't scroll, so they grow to
- * accomodate the entire text, resizing the parent window as needed. This
+ * accommodate the entire text, resizing the parent window as needed. This
* can be changed with the elm_entry_scrollable_set() function.
*
* They can also be single line or multi line (the default) and when set
* to multi line mode they support text wrapping in any of the modes
- * indicated by Elm_Wrap_Type.
+ * indicated by #Elm_Wrap_Type.
*
* Other features include password mode, filtering of inserted text with
- * elm_entry_text_filter_append() and related functions, inline "items" and
+ * elm_entry_markup_filter_append() and related functions, inline "items" and
* formatted markup text.
*
* @section entry-markup Formatted text
@@ -111,12 +38,12 @@ typedef enum
* enclosed text.
* @li \...\: Sets the @b bold style for the enclosed text.
* @li \...\: Underlines the enclosed text.
- * @li \...\: Hilights the enclosed text.
+ * @li \...\: Highlights the enclosed text.
*
* @section entry-special Special markups
*
* Besides those used to format text, entries support two special markup
- * tags used to insert clickable portions of text or items inlined within
+ * tags used to insert click-able portions of text or items inlined within
* the text.
*
* @subsection entry-anchors Anchors
@@ -161,7 +88,7 @@ typedef enum
* @li relsize: Size is adjusted for the item to fit within the current
* line height.
*
- * Besides their size, items are specificed a @c vsize value that affects
+ * Besides their size, items are specified a @c vsize value that affects
* how their final size and position are calculated. The possible values
* are:
* @li ascent: Item will be placed within the line's baseline and its
@@ -243,7 +170,7 @@ typedef enum
*
* @section entry-files Loading and saving files
*
- * Entries have convinience functions to load text from a file and save
+ * Entries have convenience functions to load text from a file and save
* changes back to it after a short delay. The automatic saving is enabled
* by default, but can be disabled with elm_entry_autosave_set() and files
* can be loaded directly as plain text or have any markup in them
@@ -287,7 +214,7 @@ typedef enum
* @li "preedit,changed": The preedit string has changed.
* @li "language,changed": Program language changed.
*
- * Default contents parts of the entry items that you can use for are:
+ * Default content parts of the entry items that you can use for are:
* @li "icon" - An icon in the entry
* @li "end" - A content in the end of the entry
*
@@ -295,25 +222,124 @@ typedef enum
* @li "default" - text of the entry
*
* Supported elm_object common APIs.
- * @li elm_object_signal_emit
- * @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
- * @li elm_object_signal_callback_add
- * @li elm_object_signal_callback_del
- * @li elm_object_disabled_set
- * @li elm_object_disabled_get
+ * @li @ref elm_object_signal_emit
+ * @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_signal_callback_add
+ * @li @ref elm_object_signal_callback_del
+ * @li @ref elm_object_disabled_set
+ * @li @ref elm_object_disabled_get
*
* @section entry-examples
*
- * An overview of the Entry API can be seen in @ref entry_example_01
+ * An overview of the Entry API can be seen in @ref entry_example
*
* @{
*/
/**
+ * @typedef Elm_Text_Format
+ *
+ * Text Format types.
+ *
+ * @see elm_entry_file_set()
+ */
+typedef enum
+{
+ ELM_TEXT_FORMAT_PLAIN_UTF8, /**< Plain UTF8 type */
+ ELM_TEXT_FORMAT_MARKUP_UTF8 /**< Markup UTF8 type */
+} Elm_Text_Format;
+
+/**
+ * @typedef Elm_Wrap_Type
+ *
+ * Line wrapping types.
+ *
+ * @see elm_entry_line_wrap_set()
+ */
+typedef enum
+{
+ ELM_WRAP_NONE = 0, /**< No wrap - value is zero */
+ ELM_WRAP_CHAR, /**< Char wrap - wrap between characters */
+ ELM_WRAP_WORD, /**< Word wrap - wrap in allowed wrapping points (as defined in the unicode standard) */
+ ELM_WRAP_MIXED, /**< Mixed wrap - Word wrap, and if that fails, char wrap. */
+ ELM_WRAP_LAST
+} Elm_Wrap_Type; /**< Type of word or character wrapping to use */
+
+/**
+ * @typedef Elm_Input_Panel_Layout
+ *
+ * Input panel (virtual keyboard) layout types.
+ *
+ * @see elm_entry_input_panel_layout_set()
+ */
+typedef enum
+{
+ ELM_INPUT_PANEL_LAYOUT_NORMAL, /**< Default layout */
+ ELM_INPUT_PANEL_LAYOUT_NUMBER, /**< Number layout */
+ ELM_INPUT_PANEL_LAYOUT_EMAIL, /**< Email layout */
+ ELM_INPUT_PANEL_LAYOUT_URL, /**< URL layout */
+ ELM_INPUT_PANEL_LAYOUT_PHONENUMBER, /**< Phone Number layout */
+ ELM_INPUT_PANEL_LAYOUT_IP, /**< IP layout */
+ ELM_INPUT_PANEL_LAYOUT_MONTH, /**< Month layout */
+ ELM_INPUT_PANEL_LAYOUT_NUMBERONLY, /**< Number Only layout */
+ ELM_INPUT_PANEL_LAYOUT_INVALID, /**< Never use this */
+ ELM_INPUT_PANEL_LAYOUT_HEX, /**< Hexadecimal layout */
+ ELM_INPUT_PANEL_LAYOUT_TERMINAL, /**< Command-line terminal layout */
+ ELM_INPUT_PANEL_LAYOUT_PASSWORD /**< Like normal, but no auto-correct, no auto-capitalization etc. */
+} Elm_Input_Panel_Layout; /**< Type of input panel (virtual keyboard) to use - this is a hint and may not provide exactly what is desired. */
+
+/**
+ * @typedef Elm_Input_Panel_Lang
+ *
+ * Input panel (virtual keyboard) language modes.
+ *
+ * @see elm_entry_input_panel_language_set()
+ */
+typedef enum
+{
+ ELM_INPUT_PANEL_LANG_AUTOMATIC, /**< Automatic */
+ ELM_INPUT_PANEL_LANG_ALPHABET /**< Alphabet */
+} Elm_Input_Panel_Lang;
+
+/**
+ * @typedef Elm_Autocapital_Type
+ *
+ * Autocapitalization Types.
+ *
+ * @see elm_entry_autocapital_type_set()
+ */
+typedef enum
+{
+ ELM_AUTOCAPITAL_TYPE_NONE, /**< No auto-capitalization when typing */
+ ELM_AUTOCAPITAL_TYPE_WORD, /**< Autocapitalize each word typed */
+ ELM_AUTOCAPITAL_TYPE_SENTENCE, /**< Autocapitalize the start of each sentence */
+ ELM_AUTOCAPITAL_TYPE_ALLCHARACTER, /**< Autocapitalize all letters */
+} Elm_Autocapital_Type; /**< Choose method of auto-capitalization */
+
+/**
+ * @typedef Elm_Input_Panel_Return_Key_Type
+ *
+ * "Return" Key types on the input panel (virtual keyboard).
+ *
+ * @see elm_entry_input_panel_return_key_type_set()
+ */
+typedef enum
+{
+ ELM_INPUT_PANEL_RETURN_KEY_TYPE_DEFAULT, /**< Default */
+ ELM_INPUT_PANEL_RETURN_KEY_TYPE_DONE, /**< Done */
+ ELM_INPUT_PANEL_RETURN_KEY_TYPE_GO, /**< Go */
+ ELM_INPUT_PANEL_RETURN_KEY_TYPE_JOIN, /**< Join */
+ ELM_INPUT_PANEL_RETURN_KEY_TYPE_LOGIN, /**< Login */
+ ELM_INPUT_PANEL_RETURN_KEY_TYPE_NEXT, /**< Next */
+ ELM_INPUT_PANEL_RETURN_KEY_TYPE_SEARCH, /**< Search string or magnifier icon */
+ ELM_INPUT_PANEL_RETURN_KEY_TYPE_SEND /**< Send */
+} Elm_Input_Panel_Return_Key_Type;
+
+/**
* @typedef Elm_Entry_Anchor_Info
*
* The info sent in the callback for the "anchor,clicked" signals emitted
@@ -338,14 +364,74 @@ struct _Elm_Entry_Anchor_Info
};
/**
+ * @typedef Elm_Entry_Anchor_Hover_Info
+ *
+ * The info sent in the callback for "anchor,clicked" signals emitted by
+ * the Anchor_Hover widget.
+ */
+typedef struct _Elm_Entry_Anchor_Hover_Info Elm_Entry_Anchor_Hover_Info;
+
+/**
+ * @struct _Elm_Entry_Anchor_Hover_Info
+ *
+ * The info sent in the callback for "anchor,clicked" signals emitted by
+ * the Anchor_Hover widget.
+ */
+struct _Elm_Entry_Anchor_Hover_Info
+{
+ const Elm_Entry_Anchor_Info *anchor_info; /**< The actual anchor info. */
+ Evas_Object *hover; /**< The hover object to use for the popup */
+ struct
+ {
+ Evas_Coord x, y, w, h;
+ } hover_parent; /**< Geometry of the object used as parent by the
+ hover */
+ Eina_Bool hover_left : 1; /**< Hint indicating if there's space
+ for content on the left side of
+ the hover. Before calling the
+ callback, the widget will make the
+ necessary calculations to check
+ which sides are fit to be set with
+ content, based on the position the
+ hover is activated and its distance
+ to the edges of its parent object
+ */
+ Eina_Bool hover_right : 1; /**< Hint indicating content fits on
+ the right side of the hover.
+ See @ref hover_left */
+ Eina_Bool hover_top : 1; /**< Hint indicating content fits on top
+ of the hover. See @ref hover_left */
+ Eina_Bool hover_bottom : 1; /**< Hint indicating content fits
+ below the hover. See @ref
+ hover_left */
+};
+
+/**
+ * @typedef Elm_Entry_Item_Provider_Cb
+ * This callback type is used to provide items.
+ * If it returns an object handle other than NULL (it should create an
+ * object to do this), then this object is used to replace the current item.
+ * If not the next provider is called until one provides an item object, or the
+ * default provider in entry does.
+ * @param data The data specified as the last param when adding the provider
+ * @param entry The entry object
+ * @param text A pointer to the item href string in the text
+ * @return The object to be placed in the entry like an icon, or other element
+ * @see elm_entry_item_provider_append
+ * @see elm_entry_item_provider_prepend
+ * @see elm_entry_item_provider_remove
+ */
+typedef Evas_Object * (*Elm_Entry_Item_Provider_Cb)(void *data, Evas_Object * entry, const char *item);
+
+/**
* @typedef Elm_Entry_Filter_Cb
* This callback type is used by entry filters to modify text.
* @param data The data specified as the last param when adding the filter
* @param entry The entry object
- * @param text A pointer to the location of the text being filtered. This data can be modified,
- * but any additional allocations must be managed by the user.
- * @see elm_entry_text_filter_append
- * @see elm_entry_text_filter_prepend
+ * @param text A pointer to the location of the text being filtered. The type of text is always markup. This data can be modified, but any additional allocations must be managed by the user.
+ * @see elm_entry_markup_filter_append
+ * @see elm_entry_markup_filter_prepend
+ * @see elm_entry_markup_filter_remove
*/
typedef void (*Elm_Entry_Filter_Cb)(void *data, Evas_Object *entry, char **text);
@@ -367,6 +453,8 @@ typedef Edje_Entry_Change_Info Elm_Entry_Change_Info;
*
* @param parent The parent object
* @return The new object or NULL if it cannot be created
+ *
+ * @ingroup Entry
*/
EAPI Evas_Object *elm_entry_add(Evas_Object *parent);
@@ -384,6 +472,8 @@ EAPI Evas_Object *elm_entry_add(Evas_Object *parent);
* @param obj The entry object
* @param single_line If true, the text in the entry
* will be on a single line.
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_single_line_set(Evas_Object *obj, Eina_Bool single_line);
@@ -395,6 +485,8 @@ EAPI void elm_entry_single_line_set(Evas_Object *obj, Eina_Bool si
* on a single line.
*
* @see elm_entry_single_line_set()
+ *
+ * @ingroup Entry
*/
EAPI Eina_Bool elm_entry_single_line_get(const Evas_Object *obj);
@@ -406,6 +498,8 @@ EAPI Eina_Bool elm_entry_single_line_get(const Evas_Object *obj);
*
* @param obj The entry object
* @param password If true, password mode is enabled.
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_password_set(Evas_Object *obj, Eina_Bool password);
@@ -417,6 +511,8 @@ EAPI void elm_entry_password_set(Evas_Object *obj, Eina_Bool passw
* as asterisks (*).
*
* @see elm_entry_password_set()
+ *
+ * @ingroup Entry
*/
EAPI Eina_Bool elm_entry_password_get(const Evas_Object *obj);
@@ -427,6 +523,8 @@ EAPI Eina_Bool elm_entry_password_get(const Evas_Object *obj);
* @param entry The text to be displayed
*
* @note Using this function bypasses text filters
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_entry_set(Evas_Object *obj, const char *entry);
@@ -436,6 +534,8 @@ EAPI void elm_entry_entry_set(Evas_Object *obj, const char *entry)
*
* @param obj The entry object
* @return The currently displayed text or NULL on failure
+ *
+ * @ingroup Entry
*/
EAPI const char *elm_entry_entry_get(const Evas_Object *obj);
@@ -450,7 +550,9 @@ EAPI const char *elm_entry_entry_get(const Evas_Object *obj);
* @param obj The entry object
* @param entry The text to be displayed
*
- * @see elm_entry_text_filter_append()
+ * @see elm_entry_markup_filter_append()
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_entry_append(Evas_Object *obj, const char *entry);
@@ -463,6 +565,8 @@ EAPI void elm_entry_entry_append(Evas_Object *obj, const char *ent
*
* @param obj The entry object
* @return EINA_TRUE if the entry is empty, EINA_FALSE otherwise.
+ *
+ * @ingroup Entry
*/
EAPI Eina_Bool elm_entry_is_empty(const Evas_Object *obj);
@@ -479,6 +583,8 @@ EAPI Eina_Bool elm_entry_is_empty(const Evas_Object *obj);
*
* @param obj The entry object
* @return The selected text within the entry or NULL on failure
+ *
+ * @ingroup Entry
*/
EAPI const char *elm_entry_selection_get(const Evas_Object *obj);
@@ -508,6 +614,8 @@ EAPI const char *elm_entry_selection_get(const Evas_Object *obj);
*
* @param obj The entry object
* @return The textblock object.
+ *
+ * @ingroup Entry
*/
EAPI Evas_Object * elm_entry_textblock_get(Evas_Object *obj);
@@ -520,6 +628,8 @@ EAPI Evas_Object * elm_entry_textblock_get(Evas_Object *obj);
* @param obj The entry object
*
* @see elm_entry_textblock_get()
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_calc_force(Evas_Object *obj);
@@ -539,7 +649,9 @@ EAPI void elm_entry_calc_force(Evas_Object *obj);
* @param obj The entry object
* @param entry The text to insert
*
- * @see elm_entry_text_filter_append()
+ * @see elm_entry_markup_filter_append()
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_entry_insert(Evas_Object *obj, const char *entry);
@@ -566,6 +678,8 @@ EAPI void elm_entry_line_wrap_set(Evas_Object *obj, Elm_Wrap_Type
* @return Wrap type
*
* @see also elm_entry_line_wrap_set()
+ *
+ * @ingroup Entry
*/
EAPI Elm_Wrap_Type elm_entry_line_wrap_get(const Evas_Object *obj);
@@ -584,6 +698,8 @@ EAPI Elm_Wrap_Type elm_entry_line_wrap_get(const Evas_Object *obj);
* @param obj The entry object
* @param editable If EINA_TRUE, user input will be inserted in the entry,
* if not, the entry is read-only and no user input is allowed.
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_editable_set(Evas_Object *obj, Eina_Bool editable);
@@ -595,6 +711,8 @@ EAPI void elm_entry_editable_set(Evas_Object *obj, Eina_Bool edita
* If false, it is not editable by the user
*
* @see elm_entry_editable_set()
+ *
+ * @ingroup Entry
*/
EAPI Eina_Bool elm_entry_editable_get(const Evas_Object *obj);
@@ -602,6 +720,8 @@ EAPI Eina_Bool elm_entry_editable_get(const Evas_Object *obj);
* This drops any existing text selection within the entry.
*
* @param obj The entry object
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_select_none(Evas_Object *obj);
@@ -609,6 +729,8 @@ EAPI void elm_entry_select_none(Evas_Object *obj);
* This selects all text within the entry.
*
* @param obj The entry object
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_select_all(Evas_Object *obj);
@@ -617,6 +739,8 @@ EAPI void elm_entry_select_all(Evas_Object *obj);
*
* @param obj The entry object
* @return EINA_TRUE upon success, EINA_FALSE upon failure
+ *
+ * @ingroup Entry
*/
EAPI Eina_Bool elm_entry_cursor_next(Evas_Object *obj);
@@ -625,6 +749,8 @@ EAPI Eina_Bool elm_entry_cursor_next(Evas_Object *obj);
*
* @param obj The entry object
* @return EINA_TRUE upon success, EINA_FALSE upon failure
+ *
+ * @ingroup Entry
*/
EAPI Eina_Bool elm_entry_cursor_prev(Evas_Object *obj);
@@ -633,6 +759,8 @@ EAPI Eina_Bool elm_entry_cursor_prev(Evas_Object *obj);
*
* @param obj The entry object
* @return EINA_TRUE upon success, EINA_FALSE upon failure
+ *
+ * @ingroup Entry
*/
EAPI Eina_Bool elm_entry_cursor_up(Evas_Object *obj);
@@ -641,6 +769,8 @@ EAPI Eina_Bool elm_entry_cursor_up(Evas_Object *obj);
*
* @param obj The entry object
* @return EINA_TRUE upon success, EINA_FALSE upon failure
+ *
+ * @ingroup Entry
*/
EAPI Eina_Bool elm_entry_cursor_down(Evas_Object *obj);
@@ -648,6 +778,8 @@ EAPI Eina_Bool elm_entry_cursor_down(Evas_Object *obj);
* This moves the cursor to the beginning of the entry.
*
* @param obj The entry object
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_cursor_begin_set(Evas_Object *obj);
@@ -655,6 +787,8 @@ EAPI void elm_entry_cursor_begin_set(Evas_Object *obj);
* This moves the cursor to the end of the entry.
*
* @param obj The entry object
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_cursor_end_set(Evas_Object *obj);
@@ -662,6 +796,8 @@ EAPI void elm_entry_cursor_end_set(Evas_Object *obj);
* This moves the cursor to the beginning of the current line.
*
* @param obj The entry object
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_cursor_line_begin_set(Evas_Object *obj);
@@ -669,6 +805,8 @@ EAPI void elm_entry_cursor_line_begin_set(Evas_Object *obj);
* This moves the cursor to the end of the current line.
*
* @param obj The entry object
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_cursor_line_end_set(Evas_Object *obj);
@@ -677,6 +815,8 @@ EAPI void elm_entry_cursor_line_end_set(Evas_Object *obj);
* the user were holding down the mouse button to make a selection.
*
* @param obj The entry object
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_cursor_selection_begin(Evas_Object *obj);
@@ -685,6 +825,8 @@ EAPI void elm_entry_cursor_selection_begin(Evas_Object *obj);
* the user had just released the mouse button while making a selection.
*
* @param obj The entry object
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_cursor_selection_end(Evas_Object *obj);
@@ -702,6 +844,8 @@ EAPI void elm_entry_cursor_selection_end(Evas_Object *obj);
* EINA_FALSE otherwise.
*
* @see elm_entry_cursor_is_visible_format_get()
+ *
+ * @ingroup Entry
*/
EAPI Eina_Bool elm_entry_cursor_is_format_get(const Evas_Object *obj);
@@ -713,6 +857,8 @@ EAPI Eina_Bool elm_entry_cursor_is_format_get(const Evas_Object *obj);
* if it's an invisible one or no format exists.
*
* @see elm_entry_cursor_is_format_get()
+ *
+ * @ingroup Entry
*/
EAPI Eina_Bool elm_entry_cursor_is_visible_format_get(const Evas_Object *obj);
@@ -726,6 +872,8 @@ EAPI Eina_Bool elm_entry_cursor_is_visible_format_get(const Evas_Object
*
* @param obj The entry object
* @return The text pointed by the cursors.
+ *
+ * @ingroup Entry
*/
EAPI char *elm_entry_cursor_content_get(const Evas_Object *obj);
@@ -742,6 +890,8 @@ EAPI char *elm_entry_cursor_content_get(const Evas_Object *obj);
* @param w returned geometry
* @param h returned geometry
* @return EINA_TRUE upon success, EINA_FALSE upon failure
+ *
+ * @ingroup Entry
*/
EAPI Eina_Bool elm_entry_cursor_geometry_get(const Evas_Object *obj, Evas_Coord *x, Evas_Coord *y, Evas_Coord *w, Evas_Coord *h);
@@ -753,6 +903,8 @@ EAPI Eina_Bool elm_entry_cursor_geometry_get(const Evas_Object *obj, Ev
*
* @param obj The entry object
* @param pos The position of the cursor
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_cursor_pos_set(Evas_Object *obj, int pos);
@@ -761,6 +913,8 @@ EAPI void elm_entry_cursor_pos_set(Evas_Object *obj, int pos);
*
* @param obj The entry object
* @return The cursor position
+ *
+ * @ingroup Entry
*/
EAPI int elm_entry_cursor_pos_get(const Evas_Object *obj);
@@ -768,6 +922,8 @@ EAPI int elm_entry_cursor_pos_get(const Evas_Object *obj);
* This executes a "cut" action on the selected text in the entry.
*
* @param obj The entry object
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_selection_cut(Evas_Object *obj);
@@ -775,6 +931,8 @@ EAPI void elm_entry_selection_cut(Evas_Object *obj);
* This executes a "copy" action on the selected text in the entry.
*
* @param obj The entry object
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_selection_copy(Evas_Object *obj);
@@ -782,6 +940,8 @@ EAPI void elm_entry_selection_copy(Evas_Object *obj);
* This executes a "paste" action in the entry.
*
* @param obj The entry object
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_selection_paste(Evas_Object *obj);
@@ -792,6 +952,8 @@ EAPI void elm_entry_selection_paste(Evas_Object *obj);
* @param obj The entry object
*
* @see elm_entry_context_menu_item_add()
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_context_menu_clear(Evas_Object *obj);
@@ -813,6 +975,8 @@ EAPI void elm_entry_context_menu_clear(Evas_Object *obj);
* @param icon_type The item's icon type
* @param func The callback to execute when the item is clicked
* @param data The data to associate with the item for related functions
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_context_menu_item_add(Evas_Object *obj, const char *label, const char *icon_file, Elm_Icon_Type icon_type, Evas_Smart_Cb func, const void *data);
@@ -821,6 +985,8 @@ EAPI void elm_entry_context_menu_item_add(Evas_Object *obj, const
*
* @param obj The entry object
* @param disabled If true, the menu is disabled
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_context_menu_disabled_set(Evas_Object *obj, Eina_Bool disabled);
@@ -830,24 +996,10 @@ EAPI void elm_entry_context_menu_disabled_set(Evas_Object *obj, Ei
*
* @param obj The entry object
* @return If true, the menu is disabled
- */
-EAPI Eina_Bool elm_entry_context_menu_disabled_get(const Evas_Object *obj);
-
-/**
- * This disables the entry's magnifer feature.
*
- * @param obj The entry object
- * @param disabled If true, the magnifier is not displayed
+ * @ingroup Entry
*/
-
-EAPI void elm_entry_magnifier_disabled_set(Evas_Object *obj, Eina_Bool disabled);
-/**
- * This returns whether the entry's magnifier feature is disabled.
- *
- * @param obj The entry object
- * @return If true, the feature is disabled
- */
-EAPI Eina_Bool elm_entry_magnifier_disabled_get(const Evas_Object *obj);
+EAPI Eina_Bool elm_entry_context_menu_disabled_get(const Evas_Object *obj);
/**
* This appends a custom item provider to the list for that entry
@@ -864,8 +1016,10 @@ EAPI Eina_Bool elm_entry_magnifier_disabled_get(const Evas_Object *obj);
* @param data The data passed to @p func
*
* @see @ref entry-items
+ *
+ * @ingroup Entry
*/
-EAPI void elm_entry_item_provider_append(Evas_Object *obj, Evas_Object * (*func)(void *data, Evas_Object * entry, const char *item), void *data);
+EAPI void elm_entry_item_provider_append(Evas_Object *obj, Elm_Entry_Item_Provider_Cb func, void *data);
/**
* This prepends a custom item provider to the list for that entry
@@ -876,8 +1030,10 @@ EAPI void elm_entry_item_provider_append(Evas_Object *obj, Evas_Ob
* @param obj The entry object
* @param func The function called to provide the item object
* @param data The data passed to @p func
+ *
+ * @ingroup Entry
*/
-EAPI void elm_entry_item_provider_prepend(Evas_Object *obj, Evas_Object * (*func)(void *data, Evas_Object * entry, const char *item), void *data);
+EAPI void elm_entry_item_provider_prepend(Evas_Object *obj, Elm_Entry_Item_Provider_Cb func, void *data);
/**
* This removes a custom item provider to the list for that entry
@@ -888,16 +1044,19 @@ EAPI void elm_entry_item_provider_prepend(Evas_Object *obj, Evas_O
* @param obj The entry object
* @param func The function called to provide the item object
* @param data The data passed to @p func
+ *
+ * @ingroup Entry
*/
-EAPI void elm_entry_item_provider_remove(Evas_Object *obj, Evas_Object * (*func)(void *data, Evas_Object * entry, const char *item), void *data);
+EAPI void elm_entry_item_provider_remove(Evas_Object *obj, Elm_Entry_Item_Provider_Cb func, void *data);
/**
- * Append a filter function for text inserted in the entry
+ * Append a markup filter function for text inserted in the entry
*
* Append the given callback to the list. This functions will be called
* whenever any text is inserted into the entry, with the text to be inserted
- * as a parameter. The callback function is free to alter the text in any way
- * it wants, but it must remember to free the given pointer and update it.
+ * as a parameter. The type of given text is always markup.
+ * The callback function is free to alter the text in any way it wants, but
+ * it must remember to free the given pointer and update it.
* If the new text is to be discarded, the function can free it and set its
* text parameter to NULL. This will also prevent any following filters from
* being called.
@@ -905,32 +1064,38 @@ EAPI void elm_entry_item_provider_remove(Evas_Object *obj, Evas_Ob
* @param obj The entry object
* @param func The function to use as text filter
* @param data User data to pass to @p func
+ *
+ * @ingroup Entry
*/
-EAPI void elm_entry_text_filter_append(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
+EAPI void elm_entry_markup_filter_append(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
/**
- * Prepend a filter function for text insdrted in the entry
+ * Prepend a markup filter function for text inserted in the entry
*
- * Prepend the given callback to the list. See elm_entry_text_filter_append()
+ * Prepend the given callback to the list. See elm_entry_markup_filter_append()
* for more information
*
* @param obj The entry object
* @param func The function to use as text filter
* @param data User data to pass to @p func
+ *
+ * @ingroup Entry
*/
-EAPI void elm_entry_text_filter_prepend(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
+EAPI void elm_entry_markup_filter_prepend(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
/**
- * Remove a filter from the list
+ * Remove a markup filter from the list
*
* Removes the given callback from the filter list. See
- * elm_entry_text_filter_append() for more information.
+ * elm_entry_markup_filter_append() for more information.
*
* @param obj The entry object
* @param func The filter function to remove
* @param data The user data passed when adding the function
+ *
+ * @ingroup Entry
*/
-EAPI void elm_entry_text_filter_remove(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
+EAPI void elm_entry_markup_filter_remove(Evas_Object *obj, Elm_Entry_Filter_Cb func, void *data);
/**
* This converts a markup (HTML-like) string into UTF-8.
@@ -940,6 +1105,8 @@ EAPI void elm_entry_text_filter_remove(Evas_Object *obj, Elm_Entry
*
* @param s The string (in markup) to be converted
* @return The converted string (in UTF-8). It should be freed.
+ *
+ * @ingroup Entry
*/
EAPI char *elm_entry_markup_to_utf8(const char *s);
@@ -951,6 +1118,8 @@ EAPI char *elm_entry_markup_to_utf8(const char *s);
*
* @param s The string (in UTF-8) to be converted
* @return The converted string (in markup). It should be freed.
+ *
+ * @ingroup Entry
*/
EAPI char *elm_entry_utf8_to_markup(const char *s);
@@ -966,8 +1135,11 @@ EAPI char *elm_entry_utf8_to_markup(const char *s);
* @param obj The entry object
* @param file The path to the file to load and save
* @param format The file format
+ * @return @c EINA_TRUE on success, @c EINA_FALSE otherwise
+ *
+ * @ingroup Entry
*/
-EAPI void elm_entry_file_set(Evas_Object *obj, const char *file, Elm_Text_Format format);
+EAPI Eina_Bool elm_entry_file_set(Evas_Object *obj, const char *file, Elm_Text_Format format);
/**
* Gets the file being edited by the entry.
@@ -978,6 +1150,8 @@ EAPI void elm_entry_file_set(Evas_Object *obj, const char *file, E
* @param obj The entry object
* @param file The path to the file to load and save
* @param format The file format
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_file_get(const Evas_Object *obj, const char **file, Elm_Text_Format *format);
@@ -986,6 +1160,8 @@ EAPI void elm_entry_file_get(const Evas_Object *obj, const char **
* elm_entry_file_set()
*
* @param obj The entry object
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_file_save(Evas_Object *obj);
@@ -996,6 +1172,8 @@ EAPI void elm_entry_file_save(Evas_Object *obj);
* @param autosave Autosave the loaded file or not
*
* @see elm_entry_file_set()
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_autosave_set(Evas_Object *obj, Eina_Bool autosave);
@@ -1006,72 +1184,10 @@ EAPI void elm_entry_autosave_set(Evas_Object *obj, Eina_Bool autos
* @return Autosave the loaded file or not
*
* @see elm_entry_file_set()
- */
-EAPI Eina_Bool elm_entry_autosave_get(const Evas_Object *obj);
-
-/**
- * Control pasting of text and images for the widget.
- *
- * Normally the entry allows both text and images to be pasted.
- * By setting textonly to be ELM_CNP_MODE_NO_IMAGE, this prevents images from being copy or past.
- * By setting textonly to be ELM_CNP_MODE_PLAINTEXT, this remove all tags in text .
- *
- * @note this only changes the behaviour of text.
- *
- * @param obj The entry object
- * @param mode One of #Elm_CNP_Mode: #ELM_CNP_MODE_MARKUP,
- * #ELM_CNP_MODE_NO_IMAGE, #ELM_CNP_MODE_PLAINTEXT.
- */
-EAPI void elm_entry_cnp_mode_set(Evas_Object *obj, Elm_CNP_Mode cnp_mode);
-
-/**
- * Getting elm_entry text paste/drop mode.
- *
- * Normally the entry allows both text and images to be pasted.
- * This gets the copy & paste mode of the entry.
- *
- * @param obj The entry object
- * @return mode One of #Elm_CNP_Mode: #ELM_CNP_MODE_MARKUP,
- * #ELM_CNP_MODE_NO_IMAGE, #ELM_CNP_MODE_PLAINTEXT.
- */
-EAPI Elm_CNP_Mode elm_entry_cnp_mode_get(const Evas_Object *obj);
-
-/**
- * Control pasting of text and images for the widget.
- *
- * Normally the entry allows both text and images to be pasted. By setting
- * textonly to be true, this prevents images from being pasted.
- *
- * Note this only changes the behaviour of text.
- *
- * @param obj The entry object
- * @param textonly paste mode - EINA_TRUE is text only, EINA_FALSE is
- * text+image+other.
- */
-
-/**
- * Control pasting of text and images for the widget.
- *
- * Normally the entry allows both text and images to be pasted. By setting
- * textonly to be true, this prevents images from being pasted.
- *
- * Note this only changes the behaviour of text.
*
- * @param obj The entry object
- * @param textonly paste mode - EINA_TRUE is text only, EINA_FALSE is
- * text+image+other.
- */
-EAPI void elm_entry_cnp_textonly_set(Evas_Object *obj, Eina_Bool textonly);
-
-/**
- * Getting elm_entry text paste/drop mode.
- *
- * In textonly mode, only text may be pasted or dropped into the widget.
- *
- * @param obj The entry object
- * @return If the widget only accepts text from pastes.
+ * @ingroup Entry
*/
-EAPI Eina_Bool elm_entry_cnp_textonly_get(const Evas_Object *obj);
+EAPI Eina_Bool elm_entry_autosave_get(const Evas_Object *obj);
/**
* Enable or disable scrolling in entry
@@ -1080,6 +1196,8 @@ EAPI Eina_Bool elm_entry_cnp_textonly_get(const Evas_Object *obj);
*
* @param obj The entry object
* @param scroll EINA_TRUE if it is to be scrollable, EINA_FALSE otherwise
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_scrollable_set(Evas_Object *obj, Eina_Bool scroll);
@@ -1091,40 +1209,48 @@ EAPI void elm_entry_scrollable_set(Evas_Object *obj, Eina_Bool scr
*
* @param obj The entry object
* @return The scrollable state
+ *
+ * @ingroup Entry
*/
EAPI Eina_Bool elm_entry_scrollable_get(const Evas_Object *obj);
/**
- * Sets the visibility of the left-side widget of the scrolled entry,
- * set by elm_entry_icon_set().
+ * Sets the visibility of the left-side widget of the entry,
+ * set by elm_object_part_content_set().
*
- * @param obj The scrolled entry object
+ * @param obj The entry object
* @param setting EINA_TRUE if the object should be displayed,
* EINA_FALSE if not.
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_icon_visible_set(Evas_Object *obj, Eina_Bool setting);
/**
- * Sets the visibility of the end widget of the scrolled entry, set by
+ * Sets the visibility of the end widget of the entry, set by
* elm_object_part_content_set(ent, "end", content).
*
- * @param obj The scrolled entry object
+ * @param obj The entry object
* @param setting EINA_TRUE if the object should be displayed,
* EINA_FALSE if not.
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_end_visible_set(Evas_Object *obj, Eina_Bool setting);
/**
- * This sets the scrolled entry's scrollbar policy (ie. enabling/disabling
+ * This sets the entry's scrollbar policy (i.e. enabling/disabling
* them).
*
* Setting an entry to single-line mode with elm_entry_single_line_set()
* will automatically disable the display of scrollbars when the entry
* moves inside its scroller.
*
- * @param obj The scrolled entry object
+ * @param obj The entry object
* @param h The horizontal scrollbar policy to apply
* @param v The vertical scrollbar policy to apply
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_scrollbar_policy_set(Evas_Object *obj, Elm_Scroller_Policy h, Elm_Scroller_Policy v);
@@ -1134,9 +1260,11 @@ EAPI void elm_entry_scrollbar_policy_set(Evas_Object *obj, Elm_Scr
* This function sets whether the entry will bounce when scrolling reaches
* the end of the contained entry.
*
- * @param obj The scrolled entry object
+ * @param obj The entry object
* @param h_bounce The horizontal bounce state
* @param v_bounce The vertical bounce state
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce);
@@ -1146,6 +1274,8 @@ EAPI void elm_entry_bounce_set(Evas_Object *obj, Eina_Bool h_bounc
* @param obj The Entry object
* @param h_bounce Allow bounce horizontally
* @param v_bounce Allow bounce vertically
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_bounce_get(const Evas_Object *obj, Eina_Bool *h_bounce, Eina_Bool *v_bounce);
@@ -1154,6 +1284,8 @@ EAPI void elm_entry_bounce_get(const Evas_Object *obj, Eina_Bool *
*
* @param obj The entry object
* @param layout layout type
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_input_panel_layout_set(Evas_Object *obj, Elm_Input_Panel_Layout layout);
@@ -1164,6 +1296,8 @@ EAPI void elm_entry_input_panel_layout_set(Evas_Object *obj, E
* @return layout type
*
* @see elm_entry_input_panel_layout_set
+ *
+ * @ingroup Entry
*/
EAPI Elm_Input_Panel_Layout elm_entry_input_panel_layout_get(const Evas_Object *obj);
@@ -1172,6 +1306,8 @@ EAPI Elm_Input_Panel_Layout elm_entry_input_panel_layout_get(const Evas_Object *
*
* @param obj The entry object
* @param autocapital_type The type of autocapitalization
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_autocapital_type_set(Evas_Object *obj, Elm_Autocapital_Type autocapital_type);
@@ -1180,6 +1316,8 @@ EAPI void elm_entry_autocapital_type_set(Evas_Object *obj, Elm
*
* @param obj The entry object
* @return autocapitalization type
+ *
+ * @ingroup Entry
*/
EAPI Elm_Autocapital_Type elm_entry_autocapital_type_get(const Evas_Object *obj);
@@ -1188,6 +1326,8 @@ EAPI Elm_Autocapital_Type elm_entry_autocapital_type_get(const Evas_Object *ob
*
* @param obj The entry object
* @param enabled If true, the input panel is appeared when entry is clicked or has a focus
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_input_panel_enabled_set(Evas_Object *obj, Eina_Bool enabled);
@@ -1196,6 +1336,8 @@ EAPI void elm_entry_input_panel_enabled_set(Evas_Object *obj,
*
* @param obj The entry object
* @return EINA_TRUE if input panel will be appeared when the entry is clicked or has a focus, EINA_FALSE otherwise
+ *
+ * @ingroup Entry
*/
EAPI Eina_Bool elm_entry_input_panel_enabled_get(const Evas_Object *obj);
@@ -1203,9 +1345,11 @@ EAPI Eina_Bool elm_entry_input_panel_enabled_get(const Evas_Object
* Show the input panel (virtual keyboard) based on the input panel property of entry such as layout, autocapital types, and so on.
*
* Note that input panel is shown or hidden automatically according to the focus state of entry widget.
- * This API can be used in the case of manually controling by using elm_entry_input_panel_enabled_set(en, EINA_FALSE)
+ * This API can be used in the case of manually controlling by using elm_entry_input_panel_enabled_set(en, EINA_FALSE).
*
* @param obj The entry object
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_input_panel_show(Evas_Object *obj);
@@ -1213,19 +1357,23 @@ EAPI void elm_entry_input_panel_show(Evas_Object *obj);
* Hide the input panel (virtual keyboard).
*
* Note that input panel is shown or hidden automatically according to the focus state of entry widget.
- * This API can be used in the case of manually controling by using elm_entry_input_panel_enabled_set(en, EINA_FALSE)
+ * This API can be used in the case of manually controlling by using elm_entry_input_panel_enabled_set(en, EINA_FALSE)
*
* @param obj The entry object
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_input_panel_hide(Evas_Object *obj);
/**
* Set the language mode of the input panel.
*
- * This API can be used if you want to show the alphabet keyboard mode.
+ * This API can be used if you want to show the alphabet keyboard mode.
*
* @param obj The entry object
* @param lang language to be set to the input panel.
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_input_panel_language_set(Evas_Object *obj, Elm_Input_Panel_Lang lang);
@@ -1236,6 +1384,8 @@ EAPI void elm_entry_input_panel_language_set(Evas_Object *obj,
*
* @param obj The entry object
* @return input panel language type
+ *
+ * @ingroup Entry
*/
EAPI Elm_Input_Panel_Lang elm_entry_input_panel_language_get(const Evas_Object *obj);
@@ -1249,17 +1399,21 @@ EAPI Elm_Input_Panel_Lang elm_entry_input_panel_language_get(const Evas_Object
* @param obj The entry object
* @param data The specific data to be set to the input panel.
* @param len the length of data, in bytes, to send to the input panel
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_input_panel_imdata_set(Evas_Object *obj, const void *data, int len);
/**
* Get the specific data of the current input panel.
*
- * See @ref elm_entry_input_panel_imdata_set for more details.
+ * See @ref elm_entry_input_panel_imdata_set for more details.
*
* @param obj The entry object
* @param data The specific data to be got from the input panel
* @param len The length of data
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_input_panel_imdata_get(const Evas_Object *obj, void *data, int *len);
@@ -1270,6 +1424,8 @@ EAPI void elm_entry_input_panel_imdata_get(const Evas_Object *
*
* @param obj The entry object
* @param return_key_type The type of "return" key on the input panel
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_input_panel_return_key_type_set(Evas_Object *obj, Elm_Input_Panel_Return_Key_Type return_key_type);
@@ -1280,6 +1436,8 @@ EAPI void elm_entry_input_panel_return_key_type_set(Evas_Objec
*
* @param obj The entry object
* @return The type of "return" key on the input panel
+ *
+ * @ingroup Entry
*/
EAPI Elm_Input_Panel_Return_Key_Type elm_entry_input_panel_return_key_type_get(const Evas_Object *obj);
@@ -1288,7 +1446,9 @@ EAPI Elm_Input_Panel_Return_Key_Type elm_entry_input_panel_return_key_type_get(c
*
* @param obj The entry object
* @param disabled The state to put in in: @c EINA_TRUE for
- * disabled, @c EINA_FALSE for enabled
+ * disabled, @c EINA_FALSE for enabled
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_input_panel_return_key_disabled_set(Evas_Object *obj, Eina_Bool disabled);
@@ -1297,14 +1457,33 @@ EAPI void elm_entry_input_panel_return_key_disabled_set(Evas_O
*
* @param obj The entry object
* @return EINA_TRUE if it should be disabled
+ *
+ * @ingroup Entry
*/
EAPI Eina_Bool elm_entry_input_panel_return_key_disabled_get(const Evas_Object *obj);
/**
- * Reset the input method context of the entry if needed.
+ * Set whether the return key on the input panel is disabled automatically when entry has no text.
+ *
+ * If @p enabled is EINA_TRUE, The return key on input panel is disabled when the entry has no text.
+ * The return key on the input panel is automatically enabled when the entry has text.
+ * The default value is EINA_FALSE.
*
- * This can be necessary in the case where modifying the buffer would confuse on-going input method behavior
* @param obj The entry object
+ * @param enabled If @p enabled is EINA_TRUE, the return key is automatically disabled when the entry has no text.
+ *
+ * @ingroup Entry
+ */
+EAPI void elm_entry_input_panel_return_key_autoenabled_set(Evas_Object *obj, Eina_Bool enabled);
+
+/**
+ * Reset the input method context of the entry if needed.
+ *
+ * This can be necessary in the case where modifying the buffer would confuse on-going input method behavior.
+ * This will typically cause the Input Method Context to clear the preedit state.
+ * @param obj The entry object
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_imf_context_reset(Evas_Object *obj);
@@ -1313,6 +1492,8 @@ EAPI void elm_entry_imf_context_reset(Evas_Object *obj);
*
* @param obj The entry object
* @param prediction Whether the entry should allow to use the text prediction.
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_prediction_allow_set(Evas_Object *obj, Eina_Bool prediction);
@@ -1321,6 +1502,8 @@ EAPI void elm_entry_prediction_allow_set(Evas_Object *obj, Ein
*
* @param obj The entry object
* @return EINA_TRUE if it allows to use the text prediction, otherwise EINA_FALSE.
+ *
+ * @ingroup Entry
*/
EAPI Eina_Bool elm_entry_prediction_allow_get(const Evas_Object *obj);
@@ -1348,15 +1531,17 @@ struct _Elm_Entry_Filter_Limit_Size
* Filter inserted text based on user defined character and byte limits
*
* Add this filter to an entry to limit the characters that it will accept
- * based the the contents of the provided #Elm_Entry_Filter_Limit_Size.
- * The funtion works on the UTF-8 representation of the string, converting
+ * based the contents of the provided #Elm_Entry_Filter_Limit_Size.
+ * The function works on the UTF-8 representation of the string, converting
* it from the set markup, thus not accounting for any format in it.
*
* The user must create an #Elm_Entry_Filter_Limit_Size structure and pass
* it as data when setting the filter. In it, it's possible to set limits
* by character count or bytes (any of them is disabled if 0), and both can
* be set at the same time. In that case, it first checks for characters,
- * then bytes.
+ * then bytes. The #Elm_Entry_Filter_Limit_Size structure must be alive and
+ * valid for as long as the entry is alive AND the elm_entry_filter_limit_size
+ * filter is set.
*
* The function will cut the inserted text in order to allow only the first
* number of characters that are still allowed. The cut is made in
@@ -1365,6 +1550,8 @@ struct _Elm_Entry_Filter_Limit_Size
*
* This filter, like any others, does not apply when setting the entry text
* directly with elm_object_text_set().
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_filter_limit_size(void *data, Evas_Object *entry, char **text);
@@ -1392,7 +1579,8 @@ struct _Elm_Entry_Filter_Accept_Set
* Add this filter to an entry to restrict the set of accepted characters
* based on the sets in the provided #Elm_Entry_Filter_Accept_Set.
* This structure contains both accepted and rejected sets, but they are
- * mutually exclusive.
+ * mutually exclusive. This structure must be available for as long as
+ * the entry is alive AND the elm_entry_filter_accept_set is being used.
*
* The @c accepted set takes preference, so if it is set, the filter will
* only work based on the accepted characters, ignoring anything in the
@@ -1403,13 +1591,157 @@ struct _Elm_Entry_Filter_Accept_Set
*
* This filter, like any others, does not apply when setting the entry text
* directly with elm_object_text_set()
+ *
+ * @ingroup Entry
*/
EAPI void elm_entry_filter_accept_set(void *data, Evas_Object *entry, char **text);
-EAPI void elm_entry_autocapitalization_set(Evas_Object *obj, Eina_Bool autocap);
-EINA_DEPRECATED EAPI void elm_entry_autoperiod_set(Evas_Object *obj, Eina_Bool autoperiod);
-EINA_DEPRECATED EAPI void elm_entry_autoenable_returnkey_set(Evas_Object *obj, Eina_Bool on);
-EAPI Ecore_IMF_Context *elm_entry_imf_context_get(Evas_Object *obj);
+/**
+ * Returns the input method context of the entry.
+ *
+ * This function exposes the internal input method context.
+ *
+ * IMPORTANT: Many functions may change (i.e delete and create a new one)
+ * the internal input method context. Do NOT cache the returned object.
+ *
+ * @param obj The entry object
+ * @return The input method context (Ecore_IMF_Context *) in entry.
+ *
+ * @ingroup Entry
+ */
+EAPI void *elm_entry_imf_context_get(Evas_Object *obj);
+
+/**
+ * @typedef Elm_Cnp_Mode
+ * Enum of entry's copy & paste policy.
+ *
+ * @see elm_entry_cnp_mode_set()
+ * @see elm_entry_cnp_mode_get()
+ */
+typedef enum {
+ ELM_CNP_MODE_MARKUP, /**< copy & paste text with markup tag */
+ ELM_CNP_MODE_NO_IMAGE, /**< copy & paste text without item(image) tag */
+ ELM_CNP_MODE_PLAINTEXT /**< copy & paste text without markup tag */
+} Elm_Cnp_Mode;
+
+/**
+ * Control pasting of text and images for the widget.
+ *
+ * Normally the entry allows both text and images to be pasted.
+ * By setting cnp_mode to be ELM_CNP_MODE_NO_IMAGE, this prevents images from being copy or past.
+ * By setting cnp_mode to be ELM_CNP_MODE_PLAINTEXT, this remove all tags in text .
+ *
+ * @note this only changes the behaviour of text.
+ *
+ * @param obj The entry object
+ * @param cnp_mode One of #Elm_Cnp_Mode: #ELM_CNP_MODE_MARKUP,
+ * #ELM_CNP_MODE_NO_IMAGE, #ELM_CNP_MODE_PLAINTEXT.
+ *
+ * @ingroup Entry
+ */
+EAPI void elm_entry_cnp_mode_set(Evas_Object *obj, Elm_Cnp_Mode cnp_mode);
+
+/**
+ * Getting elm_entry text paste/drop mode.
+ *
+ * Normally the entry allows both text and images to be pasted.
+ * This gets the copy & paste mode of the entry.
+ *
+ * @param obj The entry object
+ * @return mode One of #Elm_Cnp_Mode: #ELM_CNP_MODE_MARKUP,
+ * #ELM_CNP_MODE_NO_IMAGE, #ELM_CNP_MODE_PLAINTEXT.
+ *
+ * @ingroup Entry
+ */
+EAPI Elm_Cnp_Mode elm_entry_cnp_mode_get(const Evas_Object *obj);
+
+/**
+ * Set the parent of the hover popup
+ *
+ * Sets the parent object to use by the hover created by the entry
+ * when an anchor is clicked. See @ref Hover for more details on this.
+ *
+ * @param obj The entry object
+ * @param parent The object to use as parent for the hover
+ *
+ * @ingroup Entry
+ */
+EAPI void elm_entry_anchor_hover_parent_set(Evas_Object *obj, Evas_Object *parent);
+
+/**
+ * Get the parent of the hover popup
+ *
+ * Get the object used as parent for the hover created by the entry
+ * widget. See @ref Hover for more details on this.
+ * If no parent is set, the same entry object will be used.
+ *
+ * @param obj The entry object
+ * @return The object used as parent for the hover, NULL if none is set.
+ *
+ * @ingroup Entry
+ */
+EAPI Evas_Object *elm_entry_anchor_hover_parent_get(const Evas_Object *obj);
+
+/**
+ * Set the style that the hover should use
+ *
+ * When creating the popup hover, entry will request that it's
+ * themed according to @p style.
+ *
+ * Setting style no NULL means disabling automatic hover.
+ *
+ * @param obj The entry object
+ * @param style The style to use for the underlying hover
+ *
+ * @see elm_object_style_set()
+ *
+ * @ingroup Entry
+ */
+EAPI void elm_entry_anchor_hover_style_set(Evas_Object *obj, const char *style);
+
+/**
+ * Get the style that the hover should use
+ *
+ * Get the style, the hover created by entry will use.
+ *
+ * @param obj The entry object
+ * @return The style to use by the hover. NULL means the default is used.
+ *
+ * @see elm_object_style_set()
+ *
+ * @ingroup Entry
+ */
+EAPI const char *elm_entry_anchor_hover_style_get(const Evas_Object *obj);
+
+/**
+ * Ends the hover popup in the entry
+ *
+ * When an anchor is clicked, the entry widget will create a hover
+ * object to use as a popup with user provided content. This function
+ * terminates this popup, returning the entry to its normal state.
+ *
+ * @param obj The entry object
+ *
+ * @ingroup Entry
+ */
+EAPI void elm_entry_anchor_hover_end(Evas_Object *obj);
+
+/**
+ * This disables the entry's magnifer feature.
+ *
+ * @param obj The entry object
+ * @param disabled If true, the magnifier is not displayed
+ */
+
+EAPI void elm_entry_magnifier_disabled_set(Evas_Object *obj, Eina_Bool disabled);
+/**
+ * This returns whether the entry's magnifier feature is disabled.
+ *
+ * @param obj The entry object
+ * @return If true, the feature is disabled
+ */
+EAPI Eina_Bool elm_entry_magnifier_disabled_get(const Evas_Object *obj);
+
EAPI void elm_entry_magnifier_type_set(Evas_Object *obj, int type);
/**