2007-11-19 10:27:11 -08:00
# ifndef _ECORE_IMF_H
# define _ECORE_IMF_H
2010-01-26 15:32:06 -08:00
# include <Eina.h>
2007-11-19 10:27:11 -08:00
# ifdef EAPI
2008-05-25 22:16:34 -07:00
# undef EAPI
2007-11-19 10:27:11 -08:00
# endif
2008-05-25 22:16:34 -07:00
# ifdef _WIN32
# ifdef EFL_ECORE_IMF_BUILD
# ifdef DLL_EXPORT
# define EAPI __declspec(dllexport)
# else
# define EAPI
# endif /* ! DLL_EXPORT */
2007-11-19 10:27:11 -08:00
# else
# define EAPI __declspec(dllimport)
2008-05-25 22:16:34 -07:00
# endif /* ! EFL_ECORE_IMF_BUILD */
2007-11-19 10:27:11 -08:00
# else
# ifdef __GNUC__
# if __GNUC__ >= 4
# define EAPI __attribute__ ((visibility("default")))
# else
# define EAPI
# endif
# else
# define EAPI
# endif
2008-05-25 22:16:34 -07:00
# endif /* ! _WIN32 */
2007-11-19 10:27:11 -08:00
# ifdef __cplusplus
extern " C " {
# endif
2014-01-05 16:09:53 -08:00
/**
* @ defgroup Ecore_IMF_Lib_Group Ecore_IMF - Ecore Input Method Library Functions
* @ ingroup Ecore
*
* Utility functions that set up and shut down the Ecore Input Method
* library .
*/
2013-01-07 17:57:22 -08:00
/**
* @ defgroup Ecore_IMF_Context_Group Ecore Input Method Context Functions
* @ ingroup Ecore_IMF_Lib_Group
*
* Functions that operate on Ecore Input Method Context objects .
2013-01-28 22:17:13 -08:00
* Ecore Input Method Context Function defines the interface for EFL input methods .
* An input method is used by EFL text input widgets like elm_entry
2013-01-07 17:57:22 -08:00
* ( based on edje_entry ) to map from key events to Unicode character strings .
*
* The default input method can be set through setting the ECORE_IMF_MODULE environment variable .
2013-01-07 18:00:01 -08:00
* eg ) export ECORE_IMF_MODULE = xim ( or scim or ibus )
2013-01-07 17:57:22 -08:00
*
2013-01-28 22:17:13 -08:00
* An input method may consume multiple key events in sequence and finally output the composed result .
* This is called preediting , and an input method may provide feedback about
2013-01-07 17:57:22 -08:00
* this process by displaying the intermediate composition states as preedit text .
*
* Immodule is plugin to connect your application and input method framework such as SCIM , ibus , and so on . @ n
* ecore_imf_init ( ) should be called to initialize and load immodule . @ n
* ecore_imf_shutdown ( ) is used for shutdowning and unloading immodule .
*
* An example of usage of these functions can be found at :
* @ li @ ref ecore_imf_example_c
*/
2012-02-17 17:45:50 -08:00
/**
2012-02-24 22:57:21 -08:00
* @ addtogroup Ecore_IMF_Context_Group
2012-02-17 17:45:50 -08:00
*
* @ {
*/
2014-10-16 21:54:02 -07:00
/**
* @ example ecore_imf_example . c
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* Shows how to write simple editor using the Ecore_IMF library .
2014-10-16 21:54:02 -07:00
*/
2012-07-03 00:39:08 -07:00
/* ecore_imf_context_input_panel_event_callback_add() flag */
2014-10-03 09:28:51 -07:00
/**
* @ typedef Ecore_IMF_Input_Panel_Event
* Enum containing input panel events .
*/
2012-07-03 00:39:08 -07:00
typedef enum
{
2012-07-09 03:20:21 -07:00
ECORE_IMF_INPUT_PANEL_STATE_EVENT , /**< called when the state of the input panel is changed. @since 1.7 */
ECORE_IMF_INPUT_PANEL_LANGUAGE_EVENT , /**< called when the language of the input panel is changed. @since 1.7 */
ECORE_IMF_INPUT_PANEL_SHIFT_MODE_EVENT , /**< called when the shift key state of the input panel is changed @since 1.7 */
ECORE_IMF_INPUT_PANEL_GEOMETRY_EVENT , /**< called when the size of the input panel is changed. @since 1.7 */
ECORE_IMF_CANDIDATE_PANEL_STATE_EVENT , /**< called when the state of the candidate word panel is changed. @since 1.7 */
2017-04-18 00:18:10 -07:00
ECORE_IMF_CANDIDATE_PANEL_GEOMETRY_EVENT , /**< called when the size of the candidate word panel is changed. @since 1.7 */
ECORE_IMF_INPUT_PANEL_KEYBOARD_MODE_EVENT /**< called when the keyboard mode state of the input panel is changed @since 1.20 */
2012-07-03 00:39:08 -07:00
} Ecore_IMF_Input_Panel_Event ;
2014-10-03 09:28:51 -07:00
/**
* @ typedef Ecore_IMF_Input_Panel_State
* Enum containing input panel state notifications .
*/
2012-07-03 00:39:08 -07:00
typedef enum
{
2012-07-09 03:20:21 -07:00
ECORE_IMF_INPUT_PANEL_STATE_SHOW , /**< Notification after the display of the input panel @since 1.7 */
ECORE_IMF_INPUT_PANEL_STATE_HIDE , /**< Notification prior to the dismissal of the input panel @since 1.7 */
2013-01-07 18:05:53 -08:00
ECORE_IMF_INPUT_PANEL_STATE_WILL_SHOW /**< Notification prior to the display of the input panel @since 1.7 */
2012-07-03 00:39:08 -07:00
} Ecore_IMF_Input_Panel_State ;
2014-10-03 09:28:51 -07:00
/**
* @ typedef Ecore_IMF_Input_Panel_Shift_Mode
* Enum containing input shift mode states .
*/
2012-07-03 00:39:08 -07:00
typedef enum
{
2012-07-09 03:20:21 -07:00
ECORE_IMF_INPUT_PANEL_SHIFT_MODE_OFF , /**< @since 1.7 */
2012-07-15 19:10:33 -07:00
ECORE_IMF_INPUT_PANEL_SHIFT_MODE_ON /**< @since 1.7 */
2012-07-03 00:39:08 -07:00
} Ecore_IMF_Input_Panel_Shift_Mode ;
2014-10-03 09:28:51 -07:00
/**
* @ typedef Ecore_IMF_Candidate_Panel_State
* Enum containing candidate word panel state notifications .
*/
2012-07-03 00:39:08 -07:00
typedef enum
{
2012-07-09 03:20:21 -07:00
ECORE_IMF_CANDIDATE_PANEL_SHOW , /**< Notification after the display of the candidate word panel @since 1.7 */
ECORE_IMF_CANDIDATE_PANEL_HIDE /**< Notification prior to the dismissal of the candidate word panel @since 1.7 */
2012-07-03 00:39:08 -07:00
} Ecore_IMF_Candidate_Panel_State ;
2012-02-17 17:45:50 -08:00
2017-04-18 00:18:10 -07:00
/**
* @ typedef Ecore_IMF_Input_Panel_Keyboard_Mode
* Enum containing keyboard mode states .
*/
typedef enum
{
ECORE_IMF_INPUT_PANEL_HW_KEYBOARD_MODE , /**< @since 1.20 */
ECORE_IMF_INPUT_PANEL_SW_KEYBOARD_MODE /**< @since 1.20 */
} Ecore_IMF_Input_Panel_Keyboard_Mode ;
2010-09-24 22:56:01 -07:00
/* Events sent by the Input Method */
typedef struct _Ecore_IMF_Event_Preedit_Start Ecore_IMF_Event_Preedit_Start ;
typedef struct _Ecore_IMF_Event_Preedit_End Ecore_IMF_Event_Preedit_End ;
typedef struct _Ecore_IMF_Event_Preedit_Changed Ecore_IMF_Event_Preedit_Changed ;
typedef struct _Ecore_IMF_Event_Commit Ecore_IMF_Event_Commit ;
typedef struct _Ecore_IMF_Event_Delete_Surrounding Ecore_IMF_Event_Delete_Surrounding ;
2014-01-22 18:02:51 -08:00
typedef struct _Ecore_IMF_Event_Selection Ecore_IMF_Event_Selection ;
2010-09-24 22:56:01 -07:00
/* Events to filter */
typedef struct _Ecore_IMF_Event_Mouse_Down Ecore_IMF_Event_Mouse_Down ;
typedef struct _Ecore_IMF_Event_Mouse_Up Ecore_IMF_Event_Mouse_Up ;
typedef struct _Ecore_IMF_Event_Mouse_In Ecore_IMF_Event_Mouse_In ;
typedef struct _Ecore_IMF_Event_Mouse_Out Ecore_IMF_Event_Mouse_Out ;
typedef struct _Ecore_IMF_Event_Mouse_Move Ecore_IMF_Event_Mouse_Move ;
typedef struct _Ecore_IMF_Event_Mouse_Wheel Ecore_IMF_Event_Mouse_Wheel ;
typedef struct _Ecore_IMF_Event_Key_Down Ecore_IMF_Event_Key_Down ;
typedef struct _Ecore_IMF_Event_Key_Up Ecore_IMF_Event_Key_Up ;
typedef union _Ecore_IMF_Event Ecore_IMF_Event ;
typedef struct _Ecore_IMF_Context Ecore_IMF_Context ; /**< An Input Method Context */
typedef struct _Ecore_IMF_Context_Class Ecore_IMF_Context_Class ; /**< An Input Method Context class */
typedef struct _Ecore_IMF_Context_Info Ecore_IMF_Context_Info ; /**< An Input Method Context info */
2011-02-27 03:20:35 -08:00
/* Preedit attribute info */
typedef struct _Ecore_IMF_Preedit_Attr Ecore_IMF_Preedit_Attr ;
2010-09-24 22:56:01 -07:00
EAPI extern int ECORE_IMF_EVENT_PREEDIT_START ;
EAPI extern int ECORE_IMF_EVENT_PREEDIT_END ;
EAPI extern int ECORE_IMF_EVENT_PREEDIT_CHANGED ;
EAPI extern int ECORE_IMF_EVENT_COMMIT ;
EAPI extern int ECORE_IMF_EVENT_DELETE_SURROUNDING ;
2014-10-03 09:28:51 -07:00
/**
* @ typedef Ecore_IMF_Event_Cb
*
* @ brief Called when a Ecore_IMF event happens .
*
* @ see ecore_imf_context_event_callback_add ( )
*/
2012-01-17 20:38:04 -08:00
typedef void ( * Ecore_IMF_Event_Cb ) ( void * data , Ecore_IMF_Context * ctx , void * event_info ) ;
2012-02-17 17:45:50 -08:00
/**
* @ typedef Ecore_IMF_Callback_Type
*
* Ecore IMF Event callback types .
*
* @ see ecore_imf_context_event_callback_add ( )
*/
2012-01-17 20:38:04 -08:00
typedef enum
{
2012-07-03 07:23:17 -07:00
ECORE_IMF_CALLBACK_PREEDIT_START , /**< "PREEDIT_START" is called when a new preediting sequence starts. @since 1.2 */
ECORE_IMF_CALLBACK_PREEDIT_END , /**< "PREEDIT_END" is called when a preediting sequence has been completed or canceled. @since 1.2 */
ECORE_IMF_CALLBACK_PREEDIT_CHANGED , /**< "PREEDIT_CHANGED" is called whenever the preedit sequence currently being entered has changed. @since 1.2 */
ECORE_IMF_CALLBACK_COMMIT , /**< "COMMIT" is called when a complete input sequence has been entered by the user @since 1.2 */
2014-01-22 18:02:51 -08:00
ECORE_IMF_CALLBACK_DELETE_SURROUNDING , /**< "DELETE_SURROUNDING" is called when the input method needs to delete all or part of the context surrounding the cursor @since 1.2 */
2014-08-29 18:50:48 -07:00
ECORE_IMF_CALLBACK_SELECTION_SET , /**< "SELECTION_SET" is called when the input method needs to set the selection @since 1.9 */
ECORE_IMF_CALLBACK_PRIVATE_COMMAND_SEND /**< "PRIVATE_COMMAND_SEND" is called when the input method sends a private command @since 1.12 */
2012-01-17 20:38:04 -08:00
} Ecore_IMF_Callback_Type ;
2012-02-17 17:45:50 -08:00
/**
* @ typedef Ecore_IMF_Event_Type
*
* Ecore IMF event types .
*
* @ see ecore_imf_context_filter_event ( )
*/
2010-09-24 22:56:01 -07:00
typedef enum
{
2012-02-17 17:45:50 -08:00
ECORE_IMF_EVENT_MOUSE_DOWN , /**< Mouse Down event */
ECORE_IMF_EVENT_MOUSE_UP , /**< Mouse Up event */
ECORE_IMF_EVENT_MOUSE_IN , /**< Mouse In event */
ECORE_IMF_EVENT_MOUSE_OUT , /**< Mouse Out event */
ECORE_IMF_EVENT_MOUSE_MOVE , /**< Mouse Move event */
ECORE_IMF_EVENT_MOUSE_WHEEL , /**< Mouse Wheel event */
ECORE_IMF_EVENT_KEY_DOWN , /**< Key Down event */
ECORE_IMF_EVENT_KEY_UP /**< Key Up event */
2010-09-24 22:56:01 -07:00
} Ecore_IMF_Event_Type ;
2012-04-23 13:09:51 -07:00
/**
* @ typedef Ecore_IMF_Keyboard_Modifiers
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* Types for Ecore_IMF keyboard modifiers
2012-04-23 13:09:51 -07:00
*/
2010-09-24 22:56:01 -07:00
typedef enum
{
ECORE_IMF_KEYBOARD_MODIFIER_NONE = 0 , /**< No active modifiers */
ECORE_IMF_KEYBOARD_MODIFIER_CTRL = 1 < < 0 , /**< "Control" is pressed */
ECORE_IMF_KEYBOARD_MODIFIER_ALT = 1 < < 1 , /**< "Alt" is pressed */
ECORE_IMF_KEYBOARD_MODIFIER_SHIFT = 1 < < 2 , /**< "Shift" is pressed */
2012-06-27 03:47:57 -07:00
ECORE_IMF_KEYBOARD_MODIFIER_WIN = 1 < < 3 , /**< "Win" (between "Ctrl" and "Alt") is pressed */
2012-07-09 03:20:21 -07:00
ECORE_IMF_KEYBOARD_MODIFIER_ALTGR = 1 < < 4 /**< "AltGr" is pressed @since 1.7 */
2010-09-24 22:56:01 -07:00
} Ecore_IMF_Keyboard_Modifiers ;
2012-04-23 13:09:51 -07:00
/**
* @ typedef Ecore_IMF_Keyboard_Locks
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* Types for Ecore_IMF keyboard locks
2012-04-23 13:09:51 -07:00
*/
2010-09-24 22:56:01 -07:00
typedef enum
{
ECORE_IMF_KEYBOARD_LOCK_NONE = 0 , /**< No locks are active */
ECORE_IMF_KEYBOARD_LOCK_NUM = 1 < < 0 , /**< "Num" lock is active */
ECORE_IMF_KEYBOARD_LOCK_CAPS = 1 < < 1 , /**< "Caps" lock is active */
ECORE_IMF_KEYBOARD_LOCK_SCROLL = 1 < < 2 /**< "Scroll" lock is active */
} Ecore_IMF_Keyboard_Locks ;
2012-07-03 07:23:17 -07:00
2012-04-23 13:09:51 -07:00
/**
* @ typedef Ecore_IMF_Mouse_Flags
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* Types for Ecore_IMF mouse flags
2012-04-23 13:09:51 -07:00
*/
2010-09-24 22:56:01 -07:00
typedef enum
{
ECORE_IMF_MOUSE_NONE = 0 , /**< A single click */
ECORE_IMF_MOUSE_DOUBLE_CLICK = 1 < < 0 , /**< A double click */
ECORE_IMF_MOUSE_TRIPLE_CLICK = 1 < < 1 /**< A triple click */
} Ecore_IMF_Mouse_Flags ;
2014-10-03 09:28:51 -07:00
/**
* @ typedef Ecore_IMF_Input_Mode
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* Types for Ecore_IMF input mode
2014-10-03 09:28:51 -07:00
*/
2010-09-24 22:56:01 -07:00
typedef enum
{
ECORE_IMF_INPUT_MODE_ALPHA = 1 < < 0 ,
ECORE_IMF_INPUT_MODE_NUMERIC = 1 < < 1 ,
ECORE_IMF_INPUT_MODE_SPECIAL = 1 < < 2 ,
ECORE_IMF_INPUT_MODE_HEXA = 1 < < 3 ,
ECORE_IMF_INPUT_MODE_TELE = 1 < < 4 ,
ECORE_IMF_INPUT_MODE_FULL = ( ECORE_IMF_INPUT_MODE_ALPHA | ECORE_IMF_INPUT_MODE_NUMERIC | ECORE_IMF_INPUT_MODE_SPECIAL ) ,
ECORE_IMF_INPUT_MODE_INVISIBLE = 1 < < 29 ,
ECORE_IMF_INPUT_MODE_AUTOCAP = 1 < < 30
} Ecore_IMF_Input_Mode ;
2012-02-17 17:45:50 -08:00
/**
* @ typedef Ecore_IMF_Preedit_Type
*
* Ecore IMF Preedit style types
*
* @ see ecore_imf_context_preedit_string_with_attributes_get ( )
*/
2011-02-27 03:20:35 -08:00
typedef enum
{
2012-07-03 07:23:17 -07:00
ECORE_IMF_PREEDIT_TYPE_NONE , /**< None style @since 1.1 */
ECORE_IMF_PREEDIT_TYPE_SUB1 , /**< Substring style 1 @since 1.1 */
ECORE_IMF_PREEDIT_TYPE_SUB2 , /**< Substring style 2 @since 1.1 */
2012-09-09 21:48:28 -07:00
ECORE_IMF_PREEDIT_TYPE_SUB3 , /**< Substring style 3 @since 1.1 */
ECORE_IMF_PREEDIT_TYPE_SUB4 , /**< Substring style 4 @since 1.8 */
ECORE_IMF_PREEDIT_TYPE_SUB5 , /**< Substring style 5 @since 1.8 */
ECORE_IMF_PREEDIT_TYPE_SUB6 , /**< Substring style 6 @since 1.8 */
ECORE_IMF_PREEDIT_TYPE_SUB7 /**< Substring style 7 @since 1.8 */
2011-02-27 03:20:35 -08:00
} Ecore_IMF_Preedit_Type ;
2012-02-17 17:45:50 -08:00
/**
* @ typedef Ecore_IMF_Autocapital_Type
*
* Autocapitalization Types .
*
* @ see ecore_imf_context_autocapital_type_set ( )
*/
2011-04-28 22:16:51 -07:00
typedef enum
{
2012-07-03 07:23:17 -07:00
ECORE_IMF_AUTOCAPITAL_TYPE_NONE , /**< No auto-capitalization when typing @since 1.1 */
ECORE_IMF_AUTOCAPITAL_TYPE_WORD , /**< Autocapitalize each word typed @since 1.1 */
ECORE_IMF_AUTOCAPITAL_TYPE_SENTENCE , /**< Autocapitalize the start of each sentence @since 1.1 */
ECORE_IMF_AUTOCAPITAL_TYPE_ALLCHARACTER , /**< Autocapitalize all letters @since 1.1 */
2011-04-28 22:16:51 -07:00
} Ecore_IMF_Autocapital_Type ;
2012-02-17 17:45:50 -08:00
/**
* @ typedef Ecore_IMF_Input_Panel_Layout
*
* Input panel ( virtual keyboard ) layout types .
2012-02-24 22:57:21 -08:00
*
2012-02-17 17:45:50 -08:00
* @ see ecore_imf_context_input_panel_layout_set ( )
*/
2011-06-02 00:56:58 -07:00
typedef enum
{
ECORE_IMF_INPUT_PANEL_LAYOUT_NORMAL , /**< Default layout */
ECORE_IMF_INPUT_PANEL_LAYOUT_NUMBER , /**< Number layout */
ECORE_IMF_INPUT_PANEL_LAYOUT_EMAIL , /**< Email layout */
ECORE_IMF_INPUT_PANEL_LAYOUT_URL , /**< URL layout */
ECORE_IMF_INPUT_PANEL_LAYOUT_PHONENUMBER , /**< Phone Number layout */
ECORE_IMF_INPUT_PANEL_LAYOUT_IP , /**< IP layout */
ECORE_IMF_INPUT_PANEL_LAYOUT_MONTH , /**< Month layout */
ECORE_IMF_INPUT_PANEL_LAYOUT_NUMBERONLY , /**< Number Only layout */
2012-01-03 19:41:10 -08:00
ECORE_IMF_INPUT_PANEL_LAYOUT_INVALID , /**< Never use this */
ECORE_IMF_INPUT_PANEL_LAYOUT_HEX , /**< Hexadecimal layout @since 1.2 */
2013-01-07 17:57:22 -08:00
ECORE_IMF_INPUT_PANEL_LAYOUT_TERMINAL , /**< Command-line terminal layout including ESC, Alt, Ctrl key, so on (no auto-correct, no auto-capitalization) @since 1.2 */
2013-05-27 00:14:52 -07:00
ECORE_IMF_INPUT_PANEL_LAYOUT_PASSWORD , /**< Like normal, but no auto-correct, no auto-capitalization etc. @since 1.2 */
2014-02-26 20:46:16 -08:00
ECORE_IMF_INPUT_PANEL_LAYOUT_DATETIME , /**< Date and time layout @since 1.8 */
2016-08-03 00:40:24 -07:00
ECORE_IMF_INPUT_PANEL_LAYOUT_EMOTICON , /**< Emoticon layout @since 1.10 */
ECORE_IMF_INPUT_PANEL_LAYOUT_VOICE /**< Voice layout, but if the IME does not support voice layout, then normal layout will be shown @since 1.19 */
2011-06-02 00:56:58 -07:00
} Ecore_IMF_Input_Panel_Layout ;
2012-02-17 17:45:50 -08:00
/**
* @ typedef Ecore_IMF_Input_Panel_Lang
*
* Input panel ( virtual keyboard ) language modes .
2012-02-24 22:57:21 -08:00
*
2012-02-17 17:45:50 -08:00
* @ see ecore_imf_context_input_panel_language_set ( )
*/
2011-06-02 00:56:58 -07:00
typedef enum
{
2012-02-15 16:35:14 -08:00
ECORE_IMF_INPUT_PANEL_LANG_AUTOMATIC , /**< Automatic @since 1.2 */
ECORE_IMF_INPUT_PANEL_LANG_ALPHABET /**< Alphabet @since 1.2 */
2011-06-02 00:56:58 -07:00
} Ecore_IMF_Input_Panel_Lang ;
2012-02-17 17:45:50 -08:00
/**
* @ typedef Ecore_IMF_Input_Panel_Return_Key_Type
*
* " Return " Key types on the input panel ( virtual keyboard ) .
2012-02-24 22:57:21 -08:00
*
2012-02-17 17:45:50 -08:00
* @ see ecore_imf_context_input_panel_return_key_type_set ( )
*/
2012-02-14 17:22:28 -08:00
typedef enum
{
2012-02-15 16:35:14 -08:00
ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_DEFAULT , /**< Default @since 1.2 */
ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_DONE , /**< Done @since 1.2 */
ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_GO , /**< Go @since 1.2 */
ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_JOIN , /**< Join @since 1.2 */
ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_LOGIN , /**< Login @since 1.2 */
ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_NEXT , /**< Next @since 1.2 */
ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_SEARCH , /**< Search or magnifier icon @since 1.2 */
2012-09-03 16:56:06 -07:00
ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_SEND , /**< Send @since 1.2 */
2012-09-03 19:16:43 -07:00
ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_SIGNIN /**< Sign-in @since 1.8 */
2012-02-14 17:22:28 -08:00
} Ecore_IMF_Input_Panel_Return_Key_Type ;
2014-08-29 20:45:38 -07:00
/**
* @ typedef Ecore_IMF_Input_Hints
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ brief Enumeration for defining the types of Ecore_IMF Input Hints .
2014-08-29 20:45:38 -07:00
* @ since 1.12
*/
typedef enum
{
ECORE_IMF_INPUT_HINT_NONE = 0 , /**< No active hints @since 1.12 */
ECORE_IMF_INPUT_HINT_AUTO_COMPLETE = 1 < < 0 , /**< Suggest word auto completion @since 1.12 */
ECORE_IMF_INPUT_HINT_SENSITIVE_DATA = 1 < < 1 , /**< Typed text should not be stored. @since 1.12 */
2016-05-17 23:20:05 -07:00
ECORE_IMF_INPUT_HINT_MULTILINE = 1 < < 2 , /**< Multiline text @since 1.18 */
2014-08-29 20:45:38 -07:00
} Ecore_IMF_Input_Hints ;
2014-10-17 05:34:08 -07:00
enum
{
ECORE_IMF_INPUT_PANEL_LAYOUT_NORMAL_VARIATION_NORMAL , /**< The plain normal layout @since 1.12 */
ECORE_IMF_INPUT_PANEL_LAYOUT_NORMAL_VARIATION_FILENAME , /**< Filename layout. Symbols such as '/' should be disabled. @since 1.12 */
ECORE_IMF_INPUT_PANEL_LAYOUT_NORMAL_VARIATION_PERSON_NAME /**< The name of a person. @since 1.12 */
} ;
2013-03-26 18:15:42 -07:00
enum
{
2014-07-28 00:01:07 -07:00
ECORE_IMF_INPUT_PANEL_LAYOUT_NUMBERONLY_VARIATION_NORMAL , /**< The plain normal number layout @since 1.8 */
ECORE_IMF_INPUT_PANEL_LAYOUT_NUMBERONLY_VARIATION_SIGNED , /**< The number layout to allow a positive or negative sign at the start @since 1.8 */
ECORE_IMF_INPUT_PANEL_LAYOUT_NUMBERONLY_VARIATION_DECIMAL , /**< The number layout to allow decimal point to provide fractional value @since 1.8 */
ECORE_IMF_INPUT_PANEL_LAYOUT_NUMBERONLY_VARIATION_SIGNED_AND_DECIMAL /**< The number layout to allow decimal point and negative sign @since 1.8 */
2013-03-26 18:15:42 -07:00
} ;
2014-10-17 05:34:08 -07:00
enum
{
ECORE_IMF_INPUT_PANEL_LAYOUT_PASSWORD_VARIATION_NORMAL , /**< The normal password layout @since 1.12 */
ECORE_IMF_INPUT_PANEL_LAYOUT_PASSWORD_VARIATION_NUMBERONLY /**< The password layout to allow only number @since 1.12 */
} ;
2015-03-23 18:26:20 -07:00
2014-09-22 18:18:35 -07:00
/**
* @ typedef Ecore_IMF_BiDi_Direction
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ brief Enumeration for defining the types of Ecore_IMF bidirectionality .
2014-09-22 18:18:35 -07:00
* @ since 1.12
*/
typedef enum
{
ECORE_IMF_BIDI_DIRECTION_NEUTRAL , /**< The Neutral mode @since 1.12 */
ECORE_IMF_BIDI_DIRECTION_LTR , /**< The Left to Right mode @since 1.12 */
ECORE_IMF_BIDI_DIRECTION_RTL /**< The Right to Left mode @since 1.12 */
} Ecore_IMF_BiDi_Direction ;
2015-03-23 18:26:20 -07:00
typedef enum _Ecore_IMF_Device_Class
{
ECORE_IMF_DEVICE_CLASS_NONE , /**< Not a device @since 1.14 */
ECORE_IMF_DEVICE_CLASS_SEAT , /**< The user/seat (the user themselves) @since 1.14 */
ECORE_IMF_DEVICE_CLASS_KEYBOARD , /**< A regular keyboard, numberpad or attached buttons @since 1.14 */
ECORE_IMF_DEVICE_CLASS_MOUSE , /**< A mouse, trackball or touchpad relative motion device @since 1.14 */
ECORE_IMF_DEVICE_CLASS_TOUCH , /**< A touchscreen with fingers or stylus @since 1.14 */
ECORE_IMF_DEVICE_CLASS_PEN , /**< A special pen device @since 1.14 */
ECORE_IMF_DEVICE_CLASS_POINTER , /**< A laser pointer, wii-style or "minority report" pointing device @since 1.14 */
ECORE_IMF_DEVICE_CLASS_GAMEPAD /**< A gamepad controller or joystick @since 1.14 */
} Ecore_IMF_Device_Class ; /**< A general class of device @since 1.14 */
typedef enum _Ecore_IMF_Device_Subclass
{
ECORE_IMF_DEVICE_SUBCLASS_NONE , /**< Not a device @since 1.14 */
ECORE_IMF_DEVICE_SUBCLASS_FINGER , /**< The normal flat of your finger @since 1.14 */
ECORE_IMF_DEVICE_SUBCLASS_FINGERNAIL , /**< A fingernail @since 1.14 */
ECORE_IMF_DEVICE_SUBCLASS_KNUCKLE , /**< A Knuckle @since 1.14 */
ECORE_IMF_DEVICE_SUBCLASS_PALM , /**< The palm of a users hand @since 1.14 */
ECORE_IMF_DEVICE_SUBCLASS_HAND_SIZE , /**< The side of your hand @since 1.14 */
ECORE_IMF_DEVICE_SUBCLASS_HAND_FLAT , /**< The flat of your hand @since 1.14 */
ECORE_IMF_DEVICE_SUBCLASS_PEN_TIP , /**< The tip of a pen @since 1.14 */
ECORE_IMF_DEVICE_SUBCLASS_TRACKPAD , /**< A trackpad style mouse @since 1.14 */
ECORE_IMF_DEVICE_SUBCLASS_TRACKPOINT , /**< A trackpoint style mouse @since 1.14 */
ECORE_IMF_DEVICE_SUBCLASS_TRACKBALL , /**< A trackball style mouse @since 1.14 */
} Ecore_IMF_Device_Subclass ; /**< A general subclass of device @since 1.14 */
2014-10-03 09:28:51 -07:00
/**
* @ struct _Ecore_IMF_Event_Preedit_Start
* @ brief The structure type used with the Preedit_Start Input Method event
*/
2010-09-24 22:56:01 -07:00
struct _Ecore_IMF_Event_Preedit_Start
{
Ecore_IMF_Context * ctx ;
} ;
2014-10-03 09:28:51 -07:00
/**
* @ struct _Ecore_IMF_Event_Preedit_End
* @ brief The structure type used with the Preedit_End Input Method event
*/
2010-09-24 22:56:01 -07:00
struct _Ecore_IMF_Event_Preedit_End
{
Ecore_IMF_Context * ctx ;
} ;
2014-10-03 09:28:51 -07:00
/**
* @ struct _Ecore_IMF_Event_Preedit_Changed
* @ brief The structure type used with the Preedit_Changed Input Method event
*/
2010-09-24 22:56:01 -07:00
struct _Ecore_IMF_Event_Preedit_Changed
{
Ecore_IMF_Context * ctx ;
} ;
2014-10-03 09:28:51 -07:00
/**
* @ struct _Ecore_IMF_Event_Commit
* @ brief The structure type used with the Commit Input Method event
*/
2010-09-24 22:56:01 -07:00
struct _Ecore_IMF_Event_Commit
{
Ecore_IMF_Context * ctx ;
2010-09-25 19:24:36 -07:00
char * str ;
2010-09-24 22:56:01 -07:00
} ;
2014-10-03 09:28:51 -07:00
/**
* @ struct _Ecore_IMF_Event_Delete_Surrounding
* @ brief The structure type used with the Delete_Surrounding Input Method event
*/
2010-09-24 22:56:01 -07:00
struct _Ecore_IMF_Event_Delete_Surrounding
{
Ecore_IMF_Context * ctx ;
2010-09-25 19:24:36 -07:00
int offset ;
int n_chars ;
2010-09-24 22:56:01 -07:00
} ;
2014-10-03 09:28:51 -07:00
/**
* @ struct _Ecore_IMF_Event_Selection
* @ brief The structure type used with the Selection Input Method event
*/
2014-01-22 18:02:51 -08:00
struct _Ecore_IMF_Event_Selection
{
Ecore_IMF_Context * ctx ;
int start ;
int end ;
} ;
2014-10-03 09:28:51 -07:00
/**
* @ struct _Ecore_IMF_Event_Mouse_Down
* @ brief The structure type used with the Mouse_Down event
*/
2010-09-24 22:56:01 -07:00
struct _Ecore_IMF_Event_Mouse_Down
{
int button ; /**< The button which has been pressed */
struct {
int x , y ;
} output ;
struct {
int x , y ;
} canvas ;
Ecore_IMF_Keyboard_Modifiers modifiers ; /**< The keyboard modifiers active when the event has been emitted */
Ecore_IMF_Keyboard_Locks locks ; /**< The keyboard locks active when the event has been emitted */
Ecore_IMF_Mouse_Flags flags ; /**< The flags corresponding the mouse click (single, double or triple click) */
unsigned int timestamp ; /**< The timestamp when the event occurred */
} ;
2014-10-03 09:28:51 -07:00
/**
* @ struct _Ecore_IMF_Event_Mouse_Up
* @ brief The structure type used with the Mouse_Up event
*/
2010-09-24 22:56:01 -07:00
struct _Ecore_IMF_Event_Mouse_Up
{
2015-03-13 02:59:38 -07:00
int button ; /**< The button which has been released */
2010-09-24 22:56:01 -07:00
struct {
int x , y ;
} output ;
struct {
int x , y ;
} canvas ;
Ecore_IMF_Keyboard_Modifiers modifiers ; /**< The keyboard modifiers active when the event has been emitted */
Ecore_IMF_Keyboard_Locks locks ; /**< The keyboard locks active when the event has been emitted */
Ecore_IMF_Mouse_Flags flags ; /**< The flags corresponding the mouse click (single, double or triple click) */
unsigned int timestamp ; /**< The timestamp when the event occurred */
} ;
2014-10-03 09:28:51 -07:00
/**
* @ struct _Ecore_IMF_Event_Mouse_In
* @ brief The structure type used with the Mouse_In event
*/
2010-09-24 22:56:01 -07:00
struct _Ecore_IMF_Event_Mouse_In
{
int buttons ;
struct {
int x , y ;
} output ;
struct {
int x , y ;
} canvas ;
Ecore_IMF_Keyboard_Modifiers modifiers ; /**< The keyboard modifiers active when the event has been emitted */
Ecore_IMF_Keyboard_Locks locks ; /**< The keyboard locks active when the event has been emitted */
unsigned int timestamp ; /**< The timestamp when the event occurred */
} ;
2014-10-03 09:28:51 -07:00
/**
* @ struct _Ecore_IMF_Event_Mouse_Out
* @ brief The structure type used with the Mouse_Out event
*/
2010-09-24 22:56:01 -07:00
struct _Ecore_IMF_Event_Mouse_Out
{
int buttons ;
struct {
int x , y ;
} output ;
struct {
int x , y ;
} canvas ;
Ecore_IMF_Keyboard_Modifiers modifiers ; /**< The keyboard modifiers active when the event has been emitted */
Ecore_IMF_Keyboard_Locks locks ; /**< The keyboard locks active when the event has been emitted */
unsigned int timestamp ; /**< The timestamp when the event occurred */
} ;
2014-10-03 09:28:51 -07:00
/**
* @ struct _Ecore_IMF_Event_Mouse_Move
* @ brief The structure type used with the Mouse_Move event
*/
2010-09-24 22:56:01 -07:00
struct _Ecore_IMF_Event_Mouse_Move
{
int buttons ;
struct {
struct {
int x , y ;
} output ;
struct {
int x , y ;
} canvas ;
} cur , prev ;
Ecore_IMF_Keyboard_Modifiers modifiers ; /**< The keyboard modifiers active when the event has been emitted */
Ecore_IMF_Keyboard_Locks locks ; /**< The keyboard locks active when the event has been emitted */
unsigned int timestamp ; /**< The timestamp when the event occurred */
} ;
2014-10-03 09:28:51 -07:00
/**
* @ struct _Ecore_IMF_Event_Mouse_Wheel
* @ brief The structure type used with the Mouse_Wheel event
*/
2010-09-24 22:56:01 -07:00
struct _Ecore_IMF_Event_Mouse_Wheel
{
int direction ; /* 0 = default up/down wheel */
int z ; /* ...,-2,-1 = down, 1,2,... = up */
struct {
int x , y ;
} output ;
struct {
int x , y ;
} canvas ;
Ecore_IMF_Keyboard_Modifiers modifiers ; /**< The keyboard modifiers active when the event has been emitted */
Ecore_IMF_Keyboard_Locks locks ; /**< The keyboard locks active when the event has been emitted */
unsigned int timestamp ; /**< The timestamp when the event occurred */
} ;
2014-10-03 09:28:51 -07:00
/**
* @ struct _Ecore_IMF_Event_Key_Down
* @ brief The structure type used with the Key_Down event
*/
2010-09-24 22:56:01 -07:00
struct _Ecore_IMF_Event_Key_Down
{
2010-09-25 19:24:36 -07:00
const char * keyname ; /**< The string name of the key pressed */
Ecore_IMF_Keyboard_Modifiers modifiers ; /**< The keyboard modifiers active when the event has been emitted */
Ecore_IMF_Keyboard_Locks locks ; /**< The keyboard locks active when the event has been emitted */
const char * key ; /**< The logical key : (eg shift+1 == exclamation) */
const char * string ; /**< A UTF8 string if this keystroke has produced a visible string to be ADDED */
const char * compose ; /**< A UTF8 string if this keystroke has modified a string in the middle of being composed - this string replaces the previous one */
unsigned int timestamp ; /**< The timestamp when the event occurred */
2015-04-07 20:28:34 -07:00
const char * dev_name ; /**< The device name of the key pressed @since 1.14 */
Ecore_IMF_Device_Class dev_class ; /**< The device class of the key pressed @since 1.14 */
Ecore_IMF_Device_Subclass dev_subclass ; /**< The device subclass of the key pressed @since 1.14 */
2010-09-24 22:56:01 -07:00
} ;
2014-10-03 09:28:51 -07:00
/**
* @ struct _Ecore_IMF_Event_Key_Up
* @ brief The structure type used with the Key_Up event
*/
2010-09-24 22:56:01 -07:00
struct _Ecore_IMF_Event_Key_Up
{
2015-03-13 02:59:38 -07:00
const char * keyname ; /**< The string name of the key released */
2010-09-25 19:24:36 -07:00
Ecore_IMF_Keyboard_Modifiers modifiers ; /**< The keyboard modifiers active when the event has been emitted */
Ecore_IMF_Keyboard_Locks locks ; /**< The keyboard locks active when the event has been emitted */
const char * key ; /**< The logical key : (eg shift+1 == exclamation) */
const char * string ; /**< A UTF8 string if this keystroke has produced a visible string to be ADDED */
const char * compose ; /**< A UTF8 string if this keystroke has modified a string in the middle of being composed - this string replaces the previous one */
unsigned int timestamp ; /**< The timestamp when the event occurred */
2015-04-07 20:28:34 -07:00
const char * dev_name ; /**< The device name of the key released @since 1.14 */
Ecore_IMF_Device_Class dev_class ; /**< The device class of the key released @since 1.14 */
Ecore_IMF_Device_Subclass dev_subclass ; /**< The device subclass of the key released @since 1.14 */
2010-09-24 22:56:01 -07:00
} ;
2014-10-03 09:28:51 -07:00
/**
* @ brief A union of IMF events .
*/
2010-09-24 22:56:01 -07:00
union _Ecore_IMF_Event
{
2010-09-25 19:24:36 -07:00
Ecore_IMF_Event_Mouse_Down mouse_down ;
Ecore_IMF_Event_Mouse_Up mouse_up ;
Ecore_IMF_Event_Mouse_In mouse_in ;
Ecore_IMF_Event_Mouse_Out mouse_out ;
Ecore_IMF_Event_Mouse_Move mouse_move ;
2010-09-24 22:56:01 -07:00
Ecore_IMF_Event_Mouse_Wheel mouse_wheel ;
2010-09-25 19:24:36 -07:00
Ecore_IMF_Event_Key_Down key_down ;
Ecore_IMF_Event_Key_Up key_up ;
2010-09-24 22:56:01 -07:00
} ;
2014-10-03 09:28:51 -07:00
/**
* @ struct _Ecore_IMF_Preedit_Attr
* @ brief Structure that contains preedit attribute information .
*/
2011-02-27 03:20:35 -08:00
struct _Ecore_IMF_Preedit_Attr
{
2012-02-05 21:10:18 -08:00
Ecore_IMF_Preedit_Type preedit_type ; /**< preedit style type */
2012-02-06 18:30:36 -08:00
unsigned int start_index ; /**< start index of the range (in bytes) */
unsigned int end_index ; /**< end index of the range (in bytes) */
2011-02-27 03:20:35 -08:00
} ;
2014-10-03 09:28:51 -07:00
/**
* @ struct _Ecore_IMF_Context_Class
* @ brief Structure used when creating a new Input Method Context . This
* structure is mainly used by modules implementing the Input Method Context
* interface .
*
*/
2010-09-24 22:56:01 -07:00
struct _Ecore_IMF_Context_Class
{
2014-10-03 09:28:51 -07:00
void ( * add ) ( Ecore_IMF_Context * ctx ) ; /**< Create the Input Method Context */
void ( * del ) ( Ecore_IMF_Context * ctx ) ; /**< Delete the Input Method Context */
void ( * client_window_set ) ( Ecore_IMF_Context * ctx , void * window ) ; /**< Set the client window for the Input Method Context */
void ( * client_canvas_set ) ( Ecore_IMF_Context * ctx , void * canvas ) ; /**< Set the client canvas for the Input Method Context */
void ( * show ) ( Ecore_IMF_Context * ctx ) ; /**< Show the Input Method Context */
void ( * hide ) ( Ecore_IMF_Context * ctx ) ; /**< Hide the Input Method Context */
void ( * preedit_string_get ) ( Ecore_IMF_Context * ctx , char * * str , int * cursor_pos ) ; /**< Return current preedit string and cursor position */
void ( * focus_in ) ( Ecore_IMF_Context * ctx ) ; /**< Input Method context widget has gained focus */
void ( * focus_out ) ( Ecore_IMF_Context * ctx ) ; /**< Input Method context widget has lost focus */
void ( * reset ) ( Ecore_IMF_Context * ctx ) ; /**< A change has been made */
void ( * cursor_position_set ) ( Ecore_IMF_Context * ctx , int cursor_pos ) ; /**< Cursor position changed */
void ( * use_preedit_set ) ( Ecore_IMF_Context * ctx , Eina_Bool use_preedit ) ; /**< Use preedit string to display feedback */
void ( * input_mode_set ) ( Ecore_IMF_Context * ctx , Ecore_IMF_Input_Mode input_mode ) ; /**< Set the input mode */
Eina_Bool ( * filter_event ) ( Ecore_IMF_Context * ctx , Ecore_IMF_Event_Type type , Ecore_IMF_Event * event ) ; /**< Internally handle an event */
void ( * preedit_string_with_attributes_get ) ( Ecore_IMF_Context * ctx , char * * str , Eina_List * * attrs , int * cursor_pos ) ; /**< return current preedit string, attributes, and cursor position */
void ( * prediction_allow_set ) ( Ecore_IMF_Context * ctx , Eina_Bool prediction ) ; /**< Allow text prediction */
void ( * autocapital_type_set ) ( Ecore_IMF_Context * ctx , Ecore_IMF_Autocapital_Type autocapital_type ) ; /**< Set auto-capitalization type */
void ( * control_panel_show ) ( Ecore_IMF_Context * ctx ) ; /**< Show the control panel */
void ( * control_panel_hide ) ( Ecore_IMF_Context * ctx ) ; /**< Hide the control panel */
void ( * input_panel_layout_set ) ( Ecore_IMF_Context * ctx , Ecore_IMF_Input_Panel_Layout layout ) ; /**< Set the layout of the input panel */
Ecore_IMF_Input_Panel_Layout ( * input_panel_layout_get ) ( Ecore_IMF_Context * ctx ) ; /**< Return the current layout of the input panel */
void ( * input_panel_language_set ) ( Ecore_IMF_Context * ctx , Ecore_IMF_Input_Panel_Lang lang ) ; /**< Set the language of the input panel */
Ecore_IMF_Input_Panel_Lang ( * input_panel_language_get ) ( Ecore_IMF_Context * ctx ) ; /**< Get the current language of the input panel */
void ( * cursor_location_set ) ( Ecore_IMF_Context * ctx , int x , int y , int w , int h ) ; /**< Set the cursor location */
void ( * input_panel_imdata_set ) ( Ecore_IMF_Context * ctx , const void * data , int len ) ; /**< Set panel-specific data to the input panel */
void ( * input_panel_imdata_get ) ( Ecore_IMF_Context * ctx , void * data , int * len ) ; /**< Get current panel-specific data from the input panel */
void ( * input_panel_return_key_type_set ) ( Ecore_IMF_Context * ctx , Ecore_IMF_Input_Panel_Return_Key_Type return_key_type ) ; /**< Set the return key theme of the input panel based on return key type provided */
void ( * input_panel_return_key_disabled_set ) ( Ecore_IMF_Context * ctx , Eina_Bool disabled ) ; /**< Disable return key of the input panel */
void ( * input_panel_caps_lock_mode_set ) ( Ecore_IMF_Context * ctx , Eina_Bool mode ) ; /**< Set input panel caps lock mode */
void ( * input_panel_geometry_get ) ( Ecore_IMF_Context * ctx , int * x , int * y , int * w , int * h ) ; /**< Return input panel geometry */
Ecore_IMF_Input_Panel_State ( * input_panel_state_get ) ( Ecore_IMF_Context * ctx ) ; /**< Return input panel state */
void ( * input_panel_event_callback_add ) ( Ecore_IMF_Context * ctx , Ecore_IMF_Input_Panel_Event type , void ( * func ) ( void * data , Ecore_IMF_Context * ctx , int value ) , void * data ) ; /**< Add a callback on input panel state,language,mode change */
void ( * input_panel_event_callback_del ) ( Ecore_IMF_Context * ctx , Ecore_IMF_Input_Panel_Event type , void ( * func ) ( void * data , Ecore_IMF_Context * ctx , int value ) ) ; /**< Delete the input panel event callback */
void ( * input_panel_language_locale_get ) ( Ecore_IMF_Context * ctx , char * * lang ) ; /**< Return the current language locale */
void ( * candidate_panel_geometry_get ) ( Ecore_IMF_Context * ctx , int * x , int * y , int * w , int * h ) ; /**< Return the candidate panel geometry */
void ( * input_hint_set ) ( Ecore_IMF_Context * ctx , Ecore_IMF_Input_Hints input_hints ) ; /**< Sets input hint to fine-tune input methods behavior */
void ( * bidi_direction_set ) ( Ecore_IMF_Context * ctx , Ecore_IMF_BiDi_Direction direction ) ; /**< Set bidirectionality at the cursor position */
2017-04-18 00:18:10 -07:00
Ecore_IMF_Input_Panel_Keyboard_Mode ( * keyboard_mode_get ) ( Ecore_IMF_Context * ctx ) ; /**< Return the current keyboard mode of the input panel */
2010-09-24 22:56:01 -07:00
} ;
2014-10-03 09:28:51 -07:00
/**
* @ struct _Ecore_IMF_Context_Info
* @ brief A IMF structure containing context information .
*/
2010-09-24 22:56:01 -07:00
struct _Ecore_IMF_Context_Info
{
const char * id ; /* ID */
const char * description ; /* Human readable description */
const char * default_locales ; /* Languages for which this context is the default, separated by : */
const char * canvas_type ; /* The canvas type used by the input method. Eg.: evas */
int canvas_required ; /* Whether the canvas usage is required for this input method */
} ;
2012-04-02 21:10:24 -07:00
/**
* @ }
*/
2013-01-07 19:56:09 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Lib_Group
* @ brief Initialises the Ecore_IMF library .
2013-01-07 19:56:09 -08:00
* @ return Number of times the library has been initialised without being
* shut down .
*/
2010-09-24 22:56:01 -07:00
EAPI int ecore_imf_init ( void ) ;
2013-01-07 19:56:09 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Lib_Group
* @ brief Shuts down the Ecore_IMF library .
2013-01-07 19:56:09 -08:00
* @ return Number of times the library has been initialised without being
* shut down .
*/
2010-09-24 22:56:01 -07:00
EAPI int ecore_imf_shutdown ( void ) ;
2014-10-03 09:28:51 -07:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Lib_Group
* @ brief Registers an Ecore_IMF module .
2014-10-03 09:28:51 -07:00
*
* @ param info An Ecore_IMF_Context_Info structure
* @ param imf_module_create A function to call at the creation
* @ param imf_module_exit A function to call when exiting
*
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_module_register ( const Ecore_IMF_Context_Info * info , Ecore_IMF_Context * ( * imf_module_create ) ( void ) , Ecore_IMF_Context * ( * imf_module_exit ) ( void ) ) ;
2013-04-13 01:01:56 -07:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Lib_Group
* @ brief Hides the input panel .
2013-04-13 01:01:56 -07:00
* @ return EINA_TRUE if the input panel will be hidden
EINA_FALSE if the input panel is already in hidden state
2013-11-11 03:02:51 -08:00
* @ since 1.8 .0
2013-04-13 01:01:56 -07:00
*/
EAPI Eina_Bool ecore_imf_input_panel_hide ( void ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets the list of the available Input Method Context ids .
2013-01-07 17:57:22 -08:00
*
* Note that the caller is responsible for freeing the Eina_List
* when finished with it . There is no need to finish the list strings .
*
* @ return Return an Eina_List of strings ;
* on failure it returns NULL .
*/
2010-09-24 22:56:01 -07:00
EAPI Eina_List * ecore_imf_context_available_ids_get ( void ) ;
2014-10-03 09:28:51 -07:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets the list of the available Input Method Context ids by canvas type .
2014-10-03 09:28:51 -07:00
*
* Note that the caller is responsible for freeing the Eina_List
* when finished with it . There is no need to finish the list strings .
*
* @ param canvas_type A string containing the canvas type .
* @ return Return an Eina_List of strings ;
* on failure it returns NULL .
*/
2010-09-24 22:56:01 -07:00
EAPI Eina_List * ecore_imf_context_available_ids_by_canvas_type_get ( const char * canvas_type ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets the id of the default Input Method Context .
2013-01-07 17:57:22 -08:00
* The id may to used to create a new instance of an Input Method
* Context object .
*
* @ return Return a string containing the id of the default Input
* Method Context ; on failure it returns NULL .
*/
2010-09-24 22:56:01 -07:00
EAPI const char * ecore_imf_context_default_id_get ( void ) ;
2014-10-03 09:28:51 -07:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets the id of the default Input Method Context corresponding to a canvas
2014-10-03 09:28:51 -07:00
* type .
* The id may be used to create a new instance of an Input Method
* Context object .
*
* @ param canvas_type A string containing the canvas type .
* @ return Return a string containing the id of the default Input
* Method Context ; on failure it returns NULL .
*/
2010-09-24 22:56:01 -07:00
EAPI const char * ecore_imf_context_default_id_by_canvas_type_get ( const char * canvas_type ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Retrieves the info for the Input Method Context with @ p id .
2013-01-07 17:57:22 -08:00
*
* @ param id The Input Method Context id to query for .
* @ return Return a # Ecore_IMF_Context_Info for the Input Method Context with @ p id ;
* on failure it returns NULL .
2013-01-28 22:17:13 -08:00
*
2013-01-07 17:57:22 -08:00
* Example
* @ code
*
* const char * ctx_id ;
* const Ecore_IMF_Context_Info * ctx_info ;
* Ecore_IMF_Context * imf_context ;
* ctx_id = ecore_imf_context_default_id_get ( ) ;
* if ( ctx_id )
* {
* ctx_info = ecore_imf_context_info_by_id_get ( ctx_id ) ;
* if ( ! ctx_info - > canvas_type | |
* strcmp ( ctx_info - > canvas_type , " evas " ) = = 0 )
* {
* imf_context = ecore_imf_context_add ( ctx_id ) ;
* }
* else
* {
* ctx_id = ecore_imf_context_default_id_by_canvas_type_get ( " evas " ) ;
* if ( ctx_id )
* {
* imf_context = ecore_imf_context_add ( ctx_id ) ;
* }
* }
* }
* @ endcode
*/
2010-09-24 22:56:01 -07:00
EAPI const Ecore_IMF_Context_Info * ecore_imf_context_info_by_id_get ( const char * id ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Creates a new Input Method Context defined by the given id .
2013-01-07 17:57:22 -08:00
*
* @ param id The Input Method Context id .
* @ return A newly allocated Input Method Context ;
* on failure it returns NULL .
*/
2010-09-24 22:56:01 -07:00
EAPI Ecore_IMF_Context * ecore_imf_context_add ( const char * id ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Retrieves the info for the given Input Method Context .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ return Return a # Ecore_IMF_Context_Info for the given Input Method Context ;
* on failure it returns NULL .
*/
2010-09-24 22:56:01 -07:00
EAPI const Ecore_IMF_Context_Info * ecore_imf_context_info_get ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Deletes the given Input Method Context and free its memory .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_context_del ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Sets the client window for the Input Method Context ; this is the
2013-01-07 17:57:22 -08:00
* Ecore_X_Window when using X11 , Ecore_Win32_Window when using Win32 , etc .
* This window is used in order to correctly position status windows , and may
* also be used for purposes internal to the Input Method Context .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param window The client window . This may be @ c NULL to indicate
* that the previous client window no longer exists .
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_context_client_window_set ( Ecore_IMF_Context * ctx , void * window ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets the client window of the Input Method Context .
2013-01-07 17:57:22 -08:00
*
* See @ ref ecore_imf_context_client_window_set for more details .
*
* @ param ctx An # Ecore_IMF_Context .
* @ return Return the client window .
* @ since 1.1 .0
*/
2011-02-20 22:22:37 -08:00
EAPI void * ecore_imf_context_client_window_get ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Sets the client canvas for the Input Method Context ; this is the
2013-01-07 17:57:22 -08:00
* canvas in which the input appears .
* The canvas type can be determined by using the context canvas type .
* Actually only canvas with type " evas " ( Evas * ) is supported .
* This canvas may be used in order to correctly position status windows , and may
* also be used for purposes internal to the Input Method Context .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param canvas The client canvas . This may be @ c NULL to indicate
* that the previous client canvas no longer exists .
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_context_client_canvas_set ( Ecore_IMF_Context * ctx , void * canvas ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets the client canvas of the Input Method Context .
2013-01-07 17:57:22 -08:00
*
* See @ ref ecore_imf_context_client_canvas_set for more details .
*
* @ param ctx An # Ecore_IMF_Context .
* @ return Return the client canvas .
* @ since 1.1 .0
*/
2011-02-20 22:22:37 -08:00
EAPI void * ecore_imf_context_client_canvas_get ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Asks the Input Method Context to show itself .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_context_show ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Asks the Input Method Context to hide itself .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_context_hide ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Retrieves the current preedit string and cursor position
2013-01-07 17:57:22 -08:00
* for the Input Method Context .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param str Location to store the retrieved string . The
* string retrieved must be freed with free ( ) .
* @ param cursor_pos Location to store position of cursor ( in characters )
* within the preedit string .
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_context_preedit_string_get ( Ecore_IMF_Context * ctx , char * * str , int * cursor_pos ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Retrieves the current preedit string , attributes and
2013-01-07 17:57:22 -08:00
* cursor position for the Input Method Context .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param str Location to store the retrieved string . The
* string retrieved must be freed with free ( ) .
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ param attrs An Eina_List of attributes
2013-01-07 17:57:22 -08:00
* @ param cursor_pos Location to store position of cursor ( in characters )
* within the preedit string .
*
* Example
* @ code
* char * preedit_string ;
* int cursor_pos ;
* Eina_List * attrs = NULL , * l = NULL ;
* Ecore_IMF_Preedit_Attr * attr ;
*
* ecore_imf_context_preedit_string_with_attributes_get ( imf_context ,
* & preedit_string ,
* & attrs , & cursor_pos ) ;
* if ( ! preedit_string ) return ;
*
* if ( strlen ( preedit_string ) > 0 )
* {
* if ( attrs )
* {
* EINA_LIST_FOREACH ( attrs , l , attr )
* {
* if ( attr - > preedit_type = = ECORE_IMF_PREEDIT_TYPE_SUB1 )
* {
* // Something to do
* }
* else if ( attr - > preedit_type = = ECORE_IMF_PREEDIT_TYPE_SUB2 )
* {
* // Something to do
* }
* else if ( attr - > preedit_type = = ECORE_IMF_PREEDIT_TYPE_SUB3 )
* {
* // Something to do
* }
* }
* }
* }
2013-01-28 22:17:13 -08:00
*
2013-01-07 17:57:22 -08:00
* // delete attribute list
* EINA_LIST_FREE ( attrs , attr ) free ( attr ) ;
*
* free ( preedit_string ) ;
* @ endcode
* @ since 1.1 .0
*/
2011-02-27 03:20:35 -08:00
EAPI void ecore_imf_context_preedit_string_with_attributes_get ( Ecore_IMF_Context * ctx , char * * str , Eina_List * * attrs , int * cursor_pos ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Notifies the Input Method Context that the widget to which its
2013-01-07 17:57:22 -08:00
* correspond has gained focus .
*
* @ param ctx An # Ecore_IMF_Context .
*
* Example
* @ code
* static void
* _focus_in_cb ( void * data , Evas_Object * o , const char * emission , const char * source )
* {
2013-01-28 18:43:42 -08:00
* Ecore_IMF_Context * imf_context = data ;
2013-01-07 17:57:22 -08:00
* ecore_imf_context_focus_in ( imf_context ) ;
* }
*
2013-01-28 18:43:42 -08:00
* evas_object_event_callback_add ( obj , EVAS_CALLBACK_FOCUS_IN , _focus_in_cb , imf_context ) ;
2013-01-07 17:57:22 -08:00
* @ endcode
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_context_focus_in ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Notifies the Input Method Context that the widget to which its
2013-01-07 17:57:22 -08:00
* correspond has lost focus .
*
* @ param ctx An # Ecore_IMF_Context .
*
* Example
* @ code
* static void
* _focus_out_cb ( void * data , Evas_Object * o , const char * emission , const char * source )
* {
2013-01-28 18:43:42 -08:00
* Ecore_IMF_Context * imf_context = data ;
2013-01-07 17:57:22 -08:00
* ecore_imf_context_reset ( imf_context ) ;
* ecore_imf_context_focus_out ( imf_context ) ;
* }
*
* evas_object_event_callback_add ( obj , EVAS_CALLBACK_FOCUS_OUT , _focus_out_cb , ed ) ;
* @ endcode
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_context_focus_out ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Notifies the Input Method Context that a change such as a
2013-01-07 17:57:22 -08:00
* change in cursor position has been made . This will typically
2013-01-28 18:43:42 -08:00
* cause the Input Method Context to clear the preedit state or commit the preedit string .
*
2013-01-28 22:17:13 -08:00
* The operation of ecore_imf_context_reset ( ) depends on the specific characteristics of
2013-01-28 18:52:53 -08:00
* each language . For example , the preedit string is cleared in the Chinese and Japanese Input Method Engine .
2013-01-28 18:43:42 -08:00
* However , The preedit string is committed and then cleared in the Korean Input Method Engine .
*
* This function should be called in case of the focus - out and mouse down event callback function .
* In addition , it should be called before inserting some text .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
2013-01-28 22:17:13 -08:00
*
2013-01-07 17:57:22 -08:00
* Example
* @ code
* static void
* _focus_out_cb ( void * data , Evas_Object * o , const char * emission , const char * source )
* {
2013-01-28 18:43:42 -08:00
* Ecore_IMF_Context * imf_context = data ;
2013-01-07 17:57:22 -08:00
* ecore_imf_context_reset ( imf_context ) ;
* ecore_imf_context_focus_out ( imf_context ) ;
* }
*
2013-01-28 18:43:42 -08:00
* evas_object_event_callback_add ( obj , EVAS_CALLBACK_FOCUS_OUT , _focus_out_cb , imf_context ) ;
2013-01-07 17:57:22 -08:00
* @ endcode
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_context_reset ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Notifies the Input Method Context that a change in the cursor
2013-01-07 17:57:22 -08:00
* position has been made .
*
2013-01-28 18:43:42 -08:00
* This function should be called when cursor position is changed or mouse up event is generated .
2013-02-05 05:43:47 -08:00
* Some input methods that do a heavy job using this event can give a critical performance latency problem .
* For better typing performance , we suggest that the cursor position change events need to be occurred
* only if the cursor position is on a confirmed status not on moving status .
2013-01-28 18:43:42 -08:00
*
2013-01-07 17:57:22 -08:00
* @ param ctx An # Ecore_IMF_Context .
* @ param cursor_pos New cursor position in characters .
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_context_cursor_position_set ( Ecore_IMF_Context * ctx , int cursor_pos ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Notifies the Input Method Context that a change in the cursor
2013-01-07 17:57:22 -08:00
* location has been made . The location is relative to the canvas .
2013-01-28 22:17:13 -08:00
* The cursor location can be used to determine the position of
2013-01-07 17:57:22 -08:00
* candidate word window in the immodule .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param x cursor x position .
* @ param y cursor y position .
* @ param w cursor width .
* @ param h cursor height .
* @ since 1.1 .0
*/
2011-07-06 23:23:46 -07:00
EAPI void ecore_imf_context_cursor_location_set ( Ecore_IMF_Context * ctx , int x , int y , int w , int h ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Sets whether the IM context should use the preedit string
2013-01-07 17:57:22 -08:00
* to display feedback . If @ c use_preedit is @ c EINA_FALSE ( default
* is @ c EINA_TRUE ) , then the IM context may use some other method to display
* feedback , such as displaying it in a child of the root window .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param use_preedit Whether the IM context should use the preedit string .
*/
2010-09-29 02:29:36 -07:00
EAPI void ecore_imf_context_use_preedit_set ( Ecore_IMF_Context * ctx , Eina_Bool use_preedit ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Sets the callback to be used on surrounding_get request .
2013-01-07 17:57:22 -08:00
*
* This callback will be called when the Input Method Context
* module requests the surrounding context .
2014-09-15 22:22:19 -07:00
* Input methods typically want context in order to constrain input text based on existing text ;
* this is important for languages such as Thai where only some sequences of characters are allowed .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ param func The callback to be called .
* @ param data The data pointer to be passed to @ p func
*/
2010-09-25 22:42:56 -07:00
EAPI void ecore_imf_context_retrieve_surrounding_callback_set ( Ecore_IMF_Context * ctx , Eina_Bool ( * func ) ( void * data , Ecore_IMF_Context * ctx , char * * text , int * cursor_pos ) , const void * data ) ;
2013-01-07 17:57:22 -08:00
2014-01-22 17:44:00 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Sets the callback to be used on selection_get request .
2014-01-22 17:44:00 -08:00
*
* This callback will be called when the Input Method Context
* module requests the selection context .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param func The callback to be called .
* @ param data The data pointer to be passed to @ p func
* @ since 1.9 .0
*/
EAPI void ecore_imf_context_retrieve_selection_callback_set ( Ecore_IMF_Context * ctx , Eina_Bool ( * func ) ( void * data , Ecore_IMF_Context * ctx , char * * text ) , const void * data ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Sets the input mode used by the Ecore Input Context .
2013-01-07 17:57:22 -08:00
*
* The input mode can be one of the input modes defined in
* Ecore_IMF_Input_Mode . The default input mode is
* ECORE_IMF_INPUT_MODE_FULL .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param input_mode The input mode to be used by @ p ctx .
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_context_input_mode_set ( Ecore_IMF_Context * ctx , Ecore_IMF_Input_Mode input_mode ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets the input mode being used by the Ecore Input Context .
2013-01-07 17:57:22 -08:00
*
* See @ ref ecore_imf_context_input_mode_set for more details .
*
* @ param ctx An # Ecore_IMF_Context .
* @ return The input mode being used by @ p ctx .
*/
2010-09-24 22:56:01 -07:00
EAPI Ecore_IMF_Input_Mode ecore_imf_context_input_mode_get ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Allows an Ecore Input Context to internally handle an event .
2013-01-07 17:57:22 -08:00
* If this function returns @ c EINA_TRUE , then no further processing
* should be done for this event .
*
* Input methods must be able to accept all types of events ( simply
* returning @ c EINA_FALSE if the event was not handled ) , but there is no
* obligation of any events to be submitted to this function .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param type The type of event defined by # Ecore_IMF_Event_Type .
* @ param event The event itself .
* @ return @ c EINA_TRUE if the event was handled ; otherwise @ c EINA_FALSE .
*
* Example
* @ code
* static void
* _key_down_cb ( void * data , Evas * e , Evas_Object * obj , void * event_info )
* {
* Evas_Event_Key_Down * ev = event_info ;
2013-07-30 23:13:40 -07:00
* if ( ! ev - > key ) return ;
2013-01-07 17:57:22 -08:00
*
* if ( imf_context )
* {
* Ecore_IMF_Event_Key_Down ecore_ev ;
* ecore_imf_evas_event_key_down_wrap ( ev , & ecore_ev ) ;
* if ( ecore_imf_context_filter_event ( imf_context ,
* ECORE_IMF_EVENT_KEY_DOWN ,
* ( Ecore_IMF_Event * ) & ecore_ev ) )
* return ;
* }
* }
*
* evas_object_event_callback_add ( obj , EVAS_CALLBACK_KEY_DOWN , _key_down_cb , data ) ;
* @ endcode
*/
2010-09-25 22:42:56 -07:00
EAPI Eina_Bool ecore_imf_context_filter_event ( Ecore_IMF_Context * ctx , Ecore_IMF_Event_Type type , Ecore_IMF_Event * event ) ;
2010-09-24 22:56:01 -07:00
/* plugin specific functions */
2013-01-07 17:57:22 -08:00
/**
* @ defgroup Ecore_IMF_Context_Module_Group Ecore Input Method Context Module Functions
* @ ingroup Ecore_IMF_Lib_Group
*
* Functions that should be used by Ecore Input Method Context modules .
*/
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Module_Group
* @ brief Creates a new Input Method Context with klass specified by @ p ctxc .
2013-01-07 17:57:22 -08:00
*
* This method should be used by modules implementing the Input
* Method Context interface .
*
* @ param ctxc An # Ecore_IMF_Context_Class .
* @ return A new # Ecore_IMF_Context ; on failure it returns NULL .
*/
2010-09-24 22:56:01 -07:00
EAPI Ecore_IMF_Context * ecore_imf_context_new ( const Ecore_IMF_Context_Class * ctxc ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Module_Group
* Sets the Input Method Context specific data .
2013-01-07 17:57:22 -08:00
*
* Note that this method should be used by modules to set
* the Input Method Context specific data and it ' s not meant to
* be used by applications to store application specific data .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param data The Input Method Context specific data .
* @ return A new # Ecore_IMF_Context ; on failure it returns NULL .
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_context_data_set ( Ecore_IMF_Context * ctx , void * data ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Module_Group
* @ brief Gets the Input Method Context specific data .
2013-01-07 17:57:22 -08:00
*
* See @ ref ecore_imf_context_data_set for more details .
*
* @ param ctx An # Ecore_IMF_Context .
* @ return The Input Method Context specific data .
*/
2010-09-24 22:56:01 -07:00
EAPI void * ecore_imf_context_data_get ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Module_Group
* @ brief Retrieves context around insertion point .
2013-01-28 22:17:13 -08:00
* Input methods typically want context in order to constrain input text based on existing text ;
2013-01-07 17:57:22 -08:00
* this is important for languages such as Thai where only some sequences of characters are allowed .
* In addition , the text around the insertion point can be used for supporting autocapital feature .
*
* This function is implemented by calling the
* Ecore_IMF_Context : : retrieve_surrounding_func (
* set using # ecore_imf_context_retrieve_surrounding_callback_set ) .
*
* There is no obligation for a widget to respond to the
* retrieve_surrounding_func , so input methods must be prepared
* to function without context .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param text Location to store a UTF - 8 encoded string of text
* holding context around the insertion point .
* If the function returns @ c EINA_TRUE , then you must free
* the result stored in this location with free ( ) .
* @ param cursor_pos Location to store the position in characters of
* the insertion cursor within @ p text .
* @ return @ c EINA_TRUE if surrounding text was provided ; otherwise
* @ c EINA_FALSE .
*/
2010-09-25 22:42:56 -07:00
EAPI Eina_Bool ecore_imf_context_surrounding_get ( Ecore_IMF_Context * ctx , char * * text , int * cursor_pos ) ;
2013-01-07 17:57:22 -08:00
2014-01-22 17:44:00 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Module_Group
* @ brief Retrieves the selected text .
2014-01-22 17:44:00 -08:00
*
* This function is implemented by calling the
* Ecore_IMF_Context : : retrieve_selection_func (
* set using # ecore_imf_context_retrieve_selection_callback_set ) .
*
* There is no obligation for a widget to respond to the
* retrieve_surrounding_func , so input methods must be prepared
* to function without context .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param text Location to store a UTF - 8 encoded string of the selected text .
* If the function returns @ c EINA_TRUE , then you must free
* the result stored in this location with free ( ) .
* @ return @ c EINA_TRUE if selected text was provided ; otherwise
* @ c EINA_FALSE .
* @ since 1.9 .0
*/
EAPI Eina_Bool ecore_imf_context_selection_get ( Ecore_IMF_Context * ctx , char * * text ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Module_Group
* @ brief Adds ECORE_IMF_EVENT_PREEDIT_START to the event queue .
2013-01-07 17:57:22 -08:00
*
* ECORE_IMF_EVENT_PREEDIT_START should be added when a new preedit sequence starts .
* It ' s asynchronous method to put event to the event queue .
* ecore_imf_context_event_callback_call ( ) can be used as synchronous method .
*
* @ param ctx An # Ecore_IMF_Context .
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_context_preedit_start_event_add ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Module_Group
* @ brief Adds ECORE_IMF_EVENT_PREEDIT_END to the event queue .
2013-01-07 17:57:22 -08:00
*
* ECORE_IMF_EVENT_PREEDIT_END should be added when a new preedit sequence has been completed or canceled .
* It ' s asynchronous method to put event to the event queue .
* ecore_imf_context_event_callback_call ( ) can be used as synchronous method .
*
* @ param ctx An # Ecore_IMF_Context .
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_context_preedit_end_event_add ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Module_Group
* @ brief Adds ECORE_IMF_EVENT_PREEDIT_CHANGED to the event queue .
2013-01-07 17:57:22 -08:00
*
* It ' s asynchronous method to put event to the event queue .
* ecore_imf_context_event_callback_call ( ) can be used as synchronous method .
*
* @ param ctx An # Ecore_IMF_Context .
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_context_preedit_changed_event_add ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Module_Group
* @ brief Adds ECORE_IMF_EVENT_COMMIT to the event queue .
2013-01-07 17:57:22 -08:00
*
* It ' s asynchronous method to put event to the event queue .
* ecore_imf_context_event_callback_call ( ) can be used as synchronous method .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param str The committed string .
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_context_commit_event_add ( Ecore_IMF_Context * ctx , const char * str ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Module_Group
* @ brief Adds ECORE_IMF_EVENT_DELETE_SURROUNDING to the event queue .
2013-01-07 17:57:22 -08:00
*
* Asks the widget that the input context is attached to to delete characters around the cursor position
* by adding the ECORE_IMF_EVENT_DELETE_SURROUNDING to the event queue .
* Note that offset and n_chars are in characters not in bytes .
*
* It ' s asynchronous method to put ECORE_IMF_EVENT_DELETE_SURROUNDING event to the event queue .
* ecore_imf_context_event_callback_call ( ) can be used as synchronous method .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param offset The start offset of surrounding to be deleted .
* @ param n_chars The number of characters to be deleted .
*/
2010-09-24 22:56:01 -07:00
EAPI void ecore_imf_context_delete_surrounding_event_add ( Ecore_IMF_Context * ctx , int offset , int n_chars ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Adds ( registers ) a callback function to a given context event .
2013-01-07 17:57:22 -08:00
*
* This function adds a function callback to the context @ p ctx when the
* event of type @ p type occurs on it . The function pointer is @ p
* func .
*
* The event type @ p type to trigger the function may be one of
* # ECORE_IMF_CALLBACK_PREEDIT_START , # ECORE_IMF_CALLBACK_PREEDIT_END ,
* # ECORE_IMF_CALLBACK_PREEDIT_CHANGED , # ECORE_IMF_CALLBACK_COMMIT and
* # ECORE_IMF_CALLBACK_DELETE_SURROUNDING .
*
* @ param ctx Ecore_IMF_Context to attach a callback to .
* @ param type The type of event that will trigger the callback
* @ param func The ( callback ) function to be called when the event is
* triggered
* @ param data The data pointer to be passed to @ p func
* @ since 1.2 .0
*
* Example
* @ code
* static void
* _imf_event_commit_cb ( void * data , Ecore_IMF_Context * ctx , void * event_info )
* {
* char * commit_str = event_info ;
* // something to do
* }
*
* ecore_imf_context_event_callback_add ( en - > imf_context , ECORE_IMF_CALLBACK_COMMIT , _imf_event_commit_cb , data ) ;
* @ endcode
*/
2012-01-17 20:38:04 -08:00
EAPI void ecore_imf_context_event_callback_add ( Ecore_IMF_Context * ctx , Ecore_IMF_Callback_Type type , Ecore_IMF_Event_Cb func , const void * data ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Deletes ( unregisters ) a callback function registered to a given
2013-01-07 17:57:22 -08:00
* context event .
*
* This function removes a function callback from the context @ p ctx when the
* event of type @ p type occurs on it . The function pointer is @ p
* func .
*
* @ see ecore_imf_context_event_callback_add ( ) for more details
*
* @ param ctx Ecore_IMF_Context to remove a callback from .
* @ param type The type of event that was triggering the callback
* @ param func The ( callback ) function that was to be called when the event was triggered
* @ return the data pointer
* @ since 1.2 .0
*/
2012-01-17 20:38:04 -08:00
EAPI void * ecore_imf_context_event_callback_del ( Ecore_IMF_Context * ctx , Ecore_IMF_Callback_Type type , Ecore_IMF_Event_Cb func ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Module_Group
* @ brief Calls a given callback on the context @ p ctx .
2013-01-07 17:57:22 -08:00
*
2013-01-28 22:17:13 -08:00
* ecore_imf_context_preedit_start_event_add ( ) , ecore_imf_context_preedit_end_event_add ( ) ,
2013-01-07 17:57:22 -08:00
* ecore_imf_context_preedit_changed_event_add ( ) , ecore_imf_context_commit_event_add ( ) and
2013-01-28 22:17:13 -08:00
* ecore_imf_context_delete_surrounding_event_add ( ) APIs are asynchronous
2013-01-07 17:57:22 -08:00
* because those API adds each event to the event queue .
*
* This API provides the way to call each callback function immediately .
*
* @ param ctx Ecore_IMF_Context .
* @ param type The type of event that will trigger the callback
* @ param event_info The pointer to event specific struct or information to
* pass to the callback functions registered on this event
* @ since 1.2 .0
*/
2012-01-17 20:38:04 -08:00
EAPI void ecore_imf_context_event_callback_call ( Ecore_IMF_Context * ctx , Ecore_IMF_Callback_Type type , void * event_info ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Sets whether the IM context should allow to use the text prediction .
2013-01-07 17:57:22 -08:00
* If @ p prediction is @ c EINA_FALSE ( default is @ c EINA_TRUE ) , then the IM
* context will not display the text prediction window .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param prediction Whether the IM context should allow to use the text prediction .
* @ note Default value is EINA_TRUE .
* @ since 1.1 .0
*/
2011-04-28 22:16:51 -07:00
EAPI void ecore_imf_context_prediction_allow_set ( Ecore_IMF_Context * ctx , Eina_Bool prediction ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets whether the IM context should allow to use the text prediction .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ return @ c EINA_TRUE if it allows to use the text prediction , otherwise
* @ c EINA_FALSE .
* @ since 1.1 .0
*/
2011-04-28 22:16:51 -07:00
EAPI Eina_Bool ecore_imf_context_prediction_allow_get ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Sets the autocapitalization type on the immodule .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ param autocapital_type the autocapitalization type .
* @ note Default type is ECORE_IMF_AUTOCAPITAL_TYPE_SENTENCE .
* @ since 1.1 .0
*/
2011-04-28 22:16:51 -07:00
EAPI void ecore_imf_context_autocapital_type_set ( Ecore_IMF_Context * ctx , Ecore_IMF_Autocapital_Type autocapital_type ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets the autocapitalization type .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ return The autocapital type being used by @ p ctx .
* @ since 1.1 .0
*/
2011-04-28 22:16:51 -07:00
EAPI Ecore_IMF_Autocapital_Type ecore_imf_context_autocapital_type_get ( Ecore_IMF_Context * ctx ) ;
2014-08-29 20:45:38 -07:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
2014-08-29 20:45:38 -07:00
* @ brief Sets the input hint which allows input methods to fine - tune their behavior .
*
* @ param ctx An # Ecore_IMF_Context
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ param hints Input hint
2014-08-29 20:45:38 -07:00
* @ note The default input hint is @ c ECORE_IMF_INPUT_HINT_AUTO_COMPLETE .
* @ since 1.12
*/
EAPI void ecore_imf_context_input_hint_set ( Ecore_IMF_Context * ctx , Ecore_IMF_Input_Hints hints ) ;
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
2014-08-29 20:45:38 -07:00
* @ brief Gets the value of input hint .
*
* @ param ctx An # Ecore_IMF_Context
* @ return The value of input hint
* @ since 1.12
*/
EAPI Ecore_IMF_Input_Hints ecore_imf_context_input_hint_get ( Ecore_IMF_Context * ctx ) ;
2010-09-24 22:56:01 -07:00
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Asks the Input Method Context to show the control panel of using Input Method .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ since 1.1 .0
*/
2011-06-02 00:56:58 -07:00
EAPI void ecore_imf_context_control_panel_show ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Asks the Input Method Context to hide the control panel of using Input Method .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ since 1.1 .0
*/
2011-06-02 00:56:58 -07:00
EAPI void ecore_imf_context_control_panel_hide ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Asks the Input Method Context to show the input panel ( virtual keyboard ) .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ since 1.1 .0
*/
2011-06-02 00:56:58 -07:00
EAPI void ecore_imf_context_input_panel_show ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Asks the Input Method Context to hide the input panel .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ since 1.1 .0
*/
2011-06-02 00:56:58 -07:00
EAPI void ecore_imf_context_input_panel_hide ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Sets the layout of the input panel .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ param layout see # Ecore_IMF_Input_Panel_Layout
* @ note Default layout type is ECORE_IMF_INPUT_PANEL_LAYOUT_NORMAL .
* @ since 1.1 .0
*/
2011-06-02 00:56:58 -07:00
EAPI void ecore_imf_context_input_panel_layout_set ( Ecore_IMF_Context * ctx , Ecore_IMF_Input_Panel_Layout layout ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets the layout of the current active input panel .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ return layout see # Ecore_IMF_Input_Panel_Layout
* @ since 1.1 .0
*/
2011-06-02 00:56:58 -07:00
EAPI Ecore_IMF_Input_Panel_Layout ecore_imf_context_input_panel_layout_get ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
2013-03-26 18:15:42 -07:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Sets the layout variation of the current active input panel .
2013-03-26 18:15:42 -07:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ param variation the layout variation
* @ note Default layout variation type is NORMAL .
* @ since 1.8 .0
*/
EAPI void ecore_imf_context_input_panel_layout_variation_set ( Ecore_IMF_Context * ctx , int variation ) ;
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets the layout variation of the current active input panel .
2013-03-26 18:15:42 -07:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ return the layout variation
* @ since 1.8 .0
*/
EAPI int ecore_imf_context_input_panel_layout_variation_get ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Sets the language of the input panel .
2013-01-07 17:57:22 -08:00
* This API can be used when you want to show the English keyboard .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param lang the language to be set to the input panel .
* @ since 1.1 .0
*/
2011-06-02 00:56:58 -07:00
EAPI void ecore_imf_context_input_panel_language_set ( Ecore_IMF_Context * ctx , Ecore_IMF_Input_Panel_Lang lang ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets the language of the input panel .
2013-01-07 17:57:22 -08:00
*
* See @ ref ecore_imf_context_input_panel_language_set for more details .
*
* @ param ctx An # Ecore_IMF_Context .
* @ return Ecore_IMF_Input_Panel_Lang
* @ since 1.1 .0
*/
2011-06-02 00:56:58 -07:00
EAPI Ecore_IMF_Input_Panel_Lang ecore_imf_context_input_panel_language_get ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Sets whether the Input Method Context should request to show the input panel automatically
2013-01-07 17:57:22 -08:00
* when the widget has focus .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param enabled If true , the input panel will be shown when the widget is clicked or has focus .
* @ since 1.1 .0
*/
2014-01-05 16:29:02 -08:00
EAPI void ecore_imf_context_input_panel_enabled_set ( Ecore_IMF_Context * ctx , Eina_Bool enabled ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets whether the Input Method Context requests to show the input panel automatically .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ return Return the attribute to show the input panel automatically
* @ since 1.1 .0
*/
2011-06-20 00:17:24 -07:00
EAPI Eina_Bool ecore_imf_context_input_panel_enabled_get ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Sets the input panel - specific data to deliver to the input panel .
2013-01-07 17:57:22 -08:00
* This API is used by applications to deliver specific data to the input panel .
* The data format MUST be negotiated by both application and the input panel .
* The size and format of data are defined by the input panel .
*
* @ param ctx An # Ecore_IMF_Context .
* @ 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
* @ since 1.2 .0
*/
2012-02-06 01:46:38 -08:00
EAPI void ecore_imf_context_input_panel_imdata_set ( Ecore_IMF_Context * ctx , const void * data , int len ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets the specific data of the current active input panel .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ param data The specific data to be got from the input panel
* @ param len The length of data
* @ since 1.2 .0
*/
2012-02-06 01:46:38 -08:00
EAPI void ecore_imf_context_input_panel_imdata_get ( Ecore_IMF_Context * ctx , void * data , int * len ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Sets the " return " key type . This type is used to set string or icon on the " return " key of the input panel .
2013-01-07 17:57:22 -08:00
*
2016-08-23 01:09:37 -07:00
* An input panel displays the string or icon associated with this type . @ n
* Regardless of return key type , return key event will be generated when pressing return key .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ param return_key_type The type of " return " key on the input panel
* @ note Default type is ECORE_IMF_INPUT_PANEL_RETURN_KEY_TYPE_DEFAULT .
* @ since 1.2 .0
*/
2012-03-05 18:46:09 -08:00
EAPI void ecore_imf_context_input_panel_return_key_type_set ( Ecore_IMF_Context * ctx , Ecore_IMF_Input_Panel_Return_Key_Type return_key_type ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets the " return " key type .
2013-01-07 17:57:22 -08:00
*
* @ see ecore_imf_context_input_panel_return_key_type_set ( ) for more details
*
* @ param ctx An # Ecore_IMF_Context .
* @ return The type of " return " key on the input panel
* @ since 1.2 .0
*/
2012-02-14 17:22:28 -08:00
EAPI Ecore_IMF_Input_Panel_Return_Key_Type ecore_imf_context_input_panel_return_key_type_get ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Sets the return key on the input panel to be disabled .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ param disabled The state
* @ since 1.2 .0
*/
2012-02-14 17:22:28 -08:00
EAPI void ecore_imf_context_input_panel_return_key_disabled_set ( Ecore_IMF_Context * ctx , Eina_Bool disabled ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets whether the return key on the input panel should be disabled or not .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ return @ c EINA_TRUE if it should be disabled .
* @ since 1.2 .0
*/
2012-02-14 17:22:28 -08:00
EAPI Eina_Bool ecore_imf_context_input_panel_return_key_disabled_get ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Sets the caps lock mode on the input panel .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ param mode Turn on caps lock on the input panel if @ c EINA_TRUE .
* @ since 1.2 .0
*/
2012-02-28 20:37:33 -08:00
EAPI void ecore_imf_context_input_panel_caps_lock_mode_set ( Ecore_IMF_Context * ctx , Eina_Bool mode ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets the caps lock mode on the input panel .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ return @ c EINA_TRUE if the caps lock is turned on .
* @ since 1.2 .0
*/
2012-02-28 20:37:33 -08:00
EAPI Eina_Bool ecore_imf_context_input_panel_caps_lock_mode_get ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets the position of the current active input panel .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ param x top - left x co - ordinate of the input panel
* @ param y top - left y co - ordinate of the input panel
* @ param w width of the input panel
* @ param h height of the input panel
* @ since 1.3
*/
2012-07-03 00:39:08 -07:00
EAPI void ecore_imf_context_input_panel_geometry_get ( Ecore_IMF_Context * ctx , int * x , int * y , int * w , int * h ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets state of current active input panel .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ return The state of input panel .
* @ since 1.3
*/
2012-07-03 00:39:08 -07:00
EAPI Ecore_IMF_Input_Panel_State ecore_imf_context_input_panel_state_get ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Registers a callback function which will be called if there is change in input panel state , language , mode etc .
2013-01-28 22:17:13 -08:00
* In order to deregister the callback function
2013-01-07 17:57:22 -08:00
* Use @ ref ecore_imf_context_input_panel_event_callback_del .
*
* @ param ctx An # Ecore_IMF_Context
* @ param type event type
* @ param func the callback function
* @ param data application - input panel specific data .
* @ since 1.3
*/
2012-07-03 00:39:08 -07:00
EAPI void ecore_imf_context_input_panel_event_callback_add ( Ecore_IMF_Context * ctx , Ecore_IMF_Input_Panel_Event type , void ( * func ) ( void * data , Ecore_IMF_Context * ctx , int value ) , const void * data ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Unregisters a callback function which will be called if there is change in input panel state , language , mode etc .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ param type An # Ecore_IMF_Input_Panel_Event .
* @ param func the callback function
* @ since 1.3
*/
2012-07-03 00:39:08 -07:00
EAPI void ecore_imf_context_input_panel_event_callback_del ( Ecore_IMF_Context * ctx , Ecore_IMF_Input_Panel_Event type , void ( * func ) ( void * data , Ecore_IMF_Context * ctx , int value ) ) ;
2013-01-07 17:57:22 -08:00
2013-04-13 01:11:32 -07:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Calls a given input panel callback on the context @ p ctx .
2013-04-13 01:11:32 -07:00
*
* @ param ctx Ecore_IMF_Context .
* @ param type The type of event that will trigger the callback
* @ param value the event value
* @ since 1.8 .0
*/
EAPI void ecore_imf_context_input_panel_event_callback_call ( Ecore_IMF_Context * ctx , Ecore_IMF_Input_Panel_Event type , int value ) ;
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Deletes all input panel callback on the context @ p ctx .
2013-04-13 01:11:32 -07:00
*
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* Deletes all input panel callback to be registered by ecore_imf_context_input_panel_event_callback_add ( )
2013-04-13 01:11:32 -07:00
*
* @ param ctx Ecore_IMF_Context .
* @ since 1.8 .0
*/
EAPI void ecore_imf_context_input_panel_event_callback_clear ( Ecore_IMF_Context * ctx ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets the current language locale of the input panel .
2013-01-07 17:57:22 -08:00
*
* ex ) fr_FR
*
* @ param ctx An # Ecore_IMF_Context .
* @ param lang Location to store the retrieved language string . The
* string retrieved must be freed with free ( ) .
* @ since 1.3
*/
2012-07-03 00:39:08 -07:00
EAPI void ecore_imf_context_input_panel_language_locale_get ( Ecore_IMF_Context * ctx , char * * lang ) ;
2013-01-07 17:57:22 -08:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets the geometry information of the candidate panel .
2013-01-07 17:57:22 -08:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ param x top - left x co - ordinate of the candidate panel
* @ param y top - left y co - ordinate of the candidate panel
* @ param w width of the candidate panel
* @ param h height of the candidate panel
* @ since 1.3
*/
2012-07-03 00:39:08 -07:00
EAPI void ecore_imf_context_candidate_panel_geometry_get ( Ecore_IMF_Context * ctx , int * x , int * y , int * w , int * h ) ;
2011-06-02 00:56:58 -07:00
2013-08-12 23:27:29 -07:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Sets whether the Input Method Context should request to show the input panel in case of only an user ' s explicit Mouse Up event .
2013-08-12 23:27:29 -07:00
* It doesn ' t request to show the input panel even though the Input Method Context has focus .
*
* @ param ctx An # Ecore_IMF_Context .
* @ param ondemand If true , the input panel will be shown in case of only Mouse up event . ( Focus event will be ignored . )
* @ since 1.8 .0
*/
EAPI void ecore_imf_context_input_panel_show_on_demand_set ( Ecore_IMF_Context * ctx , Eina_Bool ondemand ) ;
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
* @ brief Gets whether the Input Method Context should request to show the input panel in case of only an user ' s explicit Mouse Up event .
2013-08-12 23:27:29 -07:00
*
* @ param ctx An # Ecore_IMF_Context .
* @ return @ c EINA_TRUE if the input panel will be shown in case of only Mouse up event .
* @ since 1.8 .0
*/
EAPI Eina_Bool ecore_imf_context_input_panel_show_on_demand_get ( Ecore_IMF_Context * ctx ) ;
2014-09-22 18:18:35 -07:00
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
2014-09-22 18:18:35 -07:00
* @ brief Sets the bidirectionality at the current cursor position .
*
* @ since 1.12 .0
*
* @ param [ in ] ctx An # Ecore_IMF_Context
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ param [ in ] direction The direction mode
2014-09-22 18:18:35 -07:00
*/
EAPI void ecore_imf_context_bidi_direction_set ( Ecore_IMF_Context * ctx , Ecore_IMF_BiDi_Direction direction ) ;
/**
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ ingroup Ecore_IMF_Context_Group
2014-09-22 18:18:35 -07:00
* @ brief Gets the bidirectionality at the current cursor position .
*
* @ since 1.12 .0
*
* @ param [ in ] ctx An # Ecore_IMF_Context
docs: Fix typos and some wrong expressions
Covers: Ecore_Drm, Ecore_Evas, Ecore_File, Ecore_IMF, and
Ecore_IMF_Evas API reference doxygen.
Summary: I had fixed some typos and wrong expressions, such
as capital letters, singular Etc. in Ecore_Drm, Ecore_Evas,
Ecore_File, Ecore_IMF, and Ecore_IMF_Evas API reference doxygen.
Test Plan: Doxygen Revision
Reviewers: stefan, cedric, raster, jpeg, Jaehyun_Cho
Subscribers: conr2d
Differential Revision: https://phab.enlightenment.org/D4680
2017-02-27 02:35:52 -08:00
* @ return The direction mode
2014-09-22 18:18:35 -07:00
*/
EAPI Ecore_IMF_BiDi_Direction ecore_imf_context_bidi_direction_get ( Ecore_IMF_Context * ctx ) ;
2017-04-18 00:18:10 -07:00
/**
* @ ingroup Ecore_IMF_Context_Group
* @ brief Get the keyboard mode on the input panel .
*
* @ since 1.20 .0
*
* @ param [ in ] ctx An # Ecore_IMF_Context
* @ return the keyboard mode
*/
EAPI Ecore_IMF_Input_Panel_Keyboard_Mode ecore_imf_context_keyboard_mode_get ( Ecore_IMF_Context * ctx ) ;
2010-09-24 22:56:01 -07:00
/* The following entry points must be exported by each input method module
*/
/*
* int imf_module_init ( const Ecore_IMF_Context_Info * * info ) ;
* void imf_module_exit ( void ) ;
* Ecore_IMF_Context * imf_module_create ( void ) ;
*/
2007-11-19 10:27:11 -08:00
# ifdef __cplusplus
}
# endif
2015-04-28 05:24:48 -07:00
# undef EAPI
# define EAPI
2007-11-19 10:27:11 -08:00
# endif