|
Tizen Native API
10.0
|
Functions | |
| Eina_Bool | elm_atspi_accessible_relationship_append (Elm_Interface_Atspi_Accessible *obj, Elm_Atspi_Relation_Type type, const Elm_Interface_Atspi_Accessible *relation_object) |
| Defines the relationship between two accessible objects. | |
| void | elm_atspi_accessible_relationship_remove (Elm_Interface_Atspi_Accessible *obj, Elm_Atspi_Relation_Type type, const Elm_Interface_Atspi_Accessible *relation_object) |
| Removes the relationship between two accessible objects. | |
| const char * | elm_atspi_accessible_translation_domain_get (const Elm_Interface_Atspi_Accessible *obj) |
| Gets the translation domain of "name" and "description" properties. | |
| void | elm_atspi_accessible_translation_domain_set (Elm_Interface_Atspi_Accessible *obj, const char *domain) |
| Sets the translation domain of "name" and "description" properties. | |
| void | elm_atspi_accessible_name_set (Elm_Interface_Atspi_Accessible *obj, const char *name) |
| Gets an localized string describing accessible object role name. | |
| const char * | elm_atspi_accessible_name_get (const Elm_Interface_Atspi_Accessible *obj) |
| Gets an accessible name of the object. | |
| void | elm_atspi_accessible_name_cb_set (Elm_Interface_Atspi_Accessible *obj, Elm_Atspi_Reading_Info_Cb name_cb, const void *data) |
| Sets name information callback about widget. | |
| void | elm_atspi_accessible_role_set (Elm_Interface_Atspi_Accessible *obj, Elm_Atspi_Role role) |
| Gets an all relations between accessible object and other accessible objects. | |
| Elm_Atspi_Role | elm_atspi_accessible_role_get (const Elm_Interface_Atspi_Accessible *obj) |
| Gets the role of the object in accessibility domain. | |
| void | elm_atspi_accessible_reading_info_type_set (Elm_Interface_Atspi_Accessible *obj, Elm_Atspi_Reading_Info_Type_Mask reading_info) |
| Gets object's accessible children. | |
| Elm_Atspi_Reading_Info_Type_Mask | elm_atspi_accessible_reading_info_type_get (const Elm_Interface_Atspi_Accessible *obj) |
| Gets reading information types of an accessible object. | |
| void | elm_atspi_accessible_description_set (Elm_Interface_Atspi_Accessible *obj, const char *description) |
| Gets index of the child in parent's children list. | |
| const char * | elm_atspi_accessible_description_get (const Elm_Interface_Atspi_Accessible *obj) |
| Gets contextual information about object. | |
| void | elm_atspi_accessible_description_cb_set (Elm_Interface_Atspi_Accessible *obj, Elm_Atspi_Reading_Info_Cb description_cb, const void *data) |
| Sets contextual information callback about widget. | |
| void | elm_atspi_accessible_gesture_cb_set (Elm_Interface_Atspi_Accessible *obj, Efl_Access_Gesture_Cb gesture_cb, const void *data) |
| Sets gesture callback to give widget. | |
| void | elm_atspi_accessible_can_highlight_set (Elm_Interface_Atspi_Accessible *obj, Eina_Bool can_highlight) |
| Sets object's accessible parent. | |
| Eina_Bool | elm_atspi_accessible_can_highlight_get (const Elm_Interface_Atspi_Accessible *obj) |
| Gets highlightable of given widget. | |
| void | elm_atspi_accessible_attribute_append (Elm_Interface_Atspi_Accessible *obj, const char *key, const char *value) |
| Add key-value pair identifying widget extra attribute. | |
| void | elm_atspi_accessible_relationships_clear (Elm_Interface_Atspi_Accessible *obj) |
| Removes all attributes in accessible object. | |
| void | elm_atspi_relation_set_free (Elm_Atspi_Relation_Set *set) |
| Notifies assistive technology clients about current state of the accessible object. | |
| Elm_Atspi_Relation_Set | elm_atspi_relation_set_clone (const Elm_Atspi_Relation_Set *set) |
| void | elm_atspi_relation_free (Efl_Access_Relation *relation) |
| Efl_Access_Relation * | elm_atspi_relation_clone (const Efl_Access_Relation *relation) |
| Eina_Bool | elm_atspi_relation_set_relation_append (Elm_Atspi_Relation_Set *set, Elm_Atspi_Relation_Type type, const Eo *rel_obj) |
| void | elm_atspi_relation_set_relation_remove (Elm_Atspi_Relation_Set *set, Elm_Atspi_Relation_Type type, const Eo *rel_obj) |
| void | elm_atspi_relation_set_relation_type_remove (Elm_Atspi_Relation_Set *set, Elm_Atspi_Relation_Type type) |
| void | elm_atspi_attributes_list_free (Eina_List *list) |
| Eina_Bool | elm_atspi_component_highlight_grab (Efl_Access_Component *obj) |
| Highlights accessible widget. returns true if highlight grab has successed, false otherwise. | |
| Eina_Bool | elm_atspi_component_highlight_clear (Efl_Access_Component *obj) |
| Clears highlight of accessible widget. returns true if clear has successed, false otherwise. | |
Typedefs | |
| typedef enum _Elm_Atspi_Role | Elm_Atspi_Role |
| typedef enum _Elm_Atspi_State_Type | Elm_Atspi_State_Type |
| typedef enum _Elm_Atspi_Relation_Type | Elm_Atspi_Relation_Type |
| typedef Efl_Access_Gesture | Elm_Atspi_Gesture_Type |
| typedef Efl_Access_Gesture_State | Elm_Atspi_Gesture_State |
| typedef unsigned int | Elm_Atspi_Reading_Info_Type_Mask |
| typedef char *(* | Elm_Atspi_Reading_Info_Cb )(void *data, Eo *obj) |
| typedef uint64_t | Elm_Atspi_State_Set |
Defines | |
| #define | Elm_Atspi_Gesture_Info Efl_Access_Gesture_Info |
| #define | Elm_Atspi_Gesture_Cb Efl_Access_Gesture_Cb |
Define Documentation
| #define Elm_Atspi_Gesture_Cb Efl_Access_Gesture_Cb |
- Deprecated:
- Deprecated since 10.0. This callback type is used to provide accessibility gesture information.
- Parameters:
-
data The data specified as the last param when setting this callback obj The accessible object specified as the fisrt param when setting this callback
- Returns:
trueif application consumes gesutre,falseif application does not consume gesture, then assistive technology client consumes gesture
- See also:
- elm_atspi_accessible_gesture_cb_set
- Since :
- 4.0
| #define Elm_Atspi_Gesture_Info Efl_Access_Gesture_Info |
- Deprecated:
- Deprecated since 10.0. Detailed information of gesture that is emitted on assistive technology client side.
- Since :
- 4.0
Typedef Documentation
| typedef Efl_Access_Gesture_State Elm_Atspi_Gesture_State |
- Deprecated:
- Deprecated since 10.0. State of gesture that is emitted on assistive technology client side.
- Since :
- 4.0
| typedef Efl_Access_Gesture Elm_Atspi_Gesture_Type |
- Deprecated:
- Deprecated since 10.0. Type of gesture that is emitted on assistive technology client side.
- Warning:
- do not use ELM_ATSPI_GESTURE_TWO_FINGERS_FLICK_*, and ELM_ATSPI_GESTURE_TWO_FINGERS_HOVER. These gestures are not emitted on assistive technology client side. The window manager emits mouse event directly. So if you need to check these gestures, you have to handle mouse events. If you want to make highlighted object to get mouse events directly, then please use elm_atspi_accessible_attribute_append as below.
elm_atspi_accessible_attribute_append(obj, "gesture_required", "scroll");
- Since :
- 4.0
| typedef char*(* Elm_Atspi_Reading_Info_Cb)(void *data, Eo *obj) |
- Deprecated:
- Deprecated since 10.0. This callback type is used to provide accessibility reading information.
- Parameters:
-
data The data specified as the last param when setting this callback obj The accessible object specified as the fisrt param when setting this callback
- Returns:
- The information to be used by accessibilty client
- Since :
- 4.0
| typedef unsigned int Elm_Atspi_Reading_Info_Type_Mask |
- Deprecated:
- Deprecated since 10.0. A Elm_Accessible_Reading_Info_Type mask indicating which types of reading information are requested.
- Since :
- 4.0
| typedef enum _Elm_Atspi_Relation_Type Elm_Atspi_Relation_Type |
- Deprecated:
- Deprecated since 10.0. Elm_Atspi_Relation_Type describes relation between two objects.
- Since :
- 3.0
| typedef enum _Elm_Atspi_Role Elm_Atspi_Role |
- Deprecated:
- Deprecated since 10.0. Describes the role of an object visible to assistive technology client.
- Since :
- 3.0
| typedef uint64_t Elm_Atspi_State_Set |
AT-SPI object state set.
| typedef enum _Elm_Atspi_State_Type Elm_Atspi_State_Type |
- Deprecated:
- Deprecated since 10.0. Describes a possible states of an object visible to AT-SPI clients.
- Since :
- 3.0
Enumeration Type Documentation
The accessible Reading information type that can be read.
- Deprecated:
- Deprecated since 10.0.
- Since :
- 4.0
Function Documentation
| void elm_atspi_accessible_attribute_append | ( | Elm_Interface_Atspi_Accessible * | obj, |
| const char * | key, | ||
| const char * | value | ||
| ) |
Add key-value pair identifying widget extra attribute.
- Deprecated:
- Deprecated since 10.0.
- Since :
- 4.0
- Parameters:
-
[in] obj The object. [in] key The string key to give extra information [in] value The string value to give extra information
| Eina_Bool elm_atspi_accessible_can_highlight_get | ( | const Elm_Interface_Atspi_Accessible * | obj | ) |
Gets highlightable of given widget.
- Deprecated:
- Deprecated since 10.0.
- Since :
- 4.0
- Parameters:
-
[in] obj The object.
- Returns:
- If
true, the object is highlightable
| void elm_atspi_accessible_can_highlight_set | ( | Elm_Interface_Atspi_Accessible * | obj, |
| Eina_Bool | can_highlight | ||
| ) |
Sets object's accessible parent.
Gets object's accessible parent. Gets set describing object accessible states.
- Deprecated:
- Deprecated since 10.0.
Sets highlightable to given widget.
- Since :
- 4.0
- Parameters:
-
[in] obj The object. [in] can_highlight If true, the object is highlightable
| void elm_atspi_accessible_description_cb_set | ( | Elm_Interface_Atspi_Accessible * | obj, |
| Elm_Atspi_Reading_Info_Cb | description_cb, | ||
| const void * | data | ||
| ) |
Sets contextual information callback about widget.
- Deprecated:
- Deprecated since 10.0.
- Since :
- 4.0
- Parameters:
-
[in] obj The object. [in] description_cb The function called to provide the accessible description [in] data The data passed to description_cb
| const char* elm_atspi_accessible_description_get | ( | const Elm_Interface_Atspi_Accessible * | obj | ) |
Gets contextual information about object.
- Deprecated:
- Deprecated since 10.0.
- Since :
- 2.4
- Parameters:
-
[in] obj The object.
- Returns:
- Accessible contextual information
| void elm_atspi_accessible_description_set | ( | Elm_Interface_Atspi_Accessible * | obj, |
| const char * | description | ||
| ) |
Gets index of the child in parent's children list.
Sets widget contextual information.
- Since :
- 2.4
- Parameters:
-
[in] obj The object. [in] description Accessible contextual information
| void elm_atspi_accessible_gesture_cb_set | ( | Elm_Interface_Atspi_Accessible * | obj, |
| Efl_Access_Gesture_Cb | gesture_cb, | ||
| const void * | data | ||
| ) |
Sets gesture callback to give widget.
- Deprecated:
- Deprecated since 10.0.
- Warning:
- Please do not abuse this API. The purpose of this API is to support special application such as screen-reader guidance. Before using this API, please check if there is another way.
- Since :
- 4.0
- Parameters:
-
[in] obj The object. [in] gesutre_cb The function called to get gesture information [in] data The data passed to description_cb
| void elm_atspi_accessible_name_cb_set | ( | Elm_Interface_Atspi_Accessible * | obj, |
| Elm_Atspi_Reading_Info_Cb | name_cb, | ||
| const void * | data | ||
| ) |
Sets name information callback about widget.
- Deprecated:
- Deprecated since 10.0.
- Since :
- 4.0
- Parameters:
-
[in] obj The object. [in] name_cb The function called to provide the accessible name [in] data The data passed to name_cb
| const char* elm_atspi_accessible_name_get | ( | const Elm_Interface_Atspi_Accessible * | obj | ) |
Gets an accessible name of the object.
- Deprecated:
- Deprecated since 10.0.
- Since :
- 2.4
- Parameters:
-
[in] obj The object.
- Returns:
- Accessible name
| void elm_atspi_accessible_name_set | ( | Elm_Interface_Atspi_Accessible * | obj, |
| const char * | name | ||
| ) |
Gets an localized string describing accessible object role name.
- Deprecated:
- Deprecated since 10.0.
Sets an accessible name of the object.
- Since :
- 2.4
- Parameters:
-
[in] obj The object. [in] name Accessible name
| Elm_Atspi_Reading_Info_Type_Mask elm_atspi_accessible_reading_info_type_get | ( | const Elm_Interface_Atspi_Accessible * | obj | ) |
Gets reading information types of an accessible object.
- Deprecated:
- Deprecated since 10.0.
- Since :
- 4.0
- Parameters:
-
[in] obj The object.
- Returns:
- Reading information types
| void elm_atspi_accessible_reading_info_type_set | ( | Elm_Interface_Atspi_Accessible * | obj, |
| Elm_Atspi_Reading_Info_Type_Mask | reading_info | ||
| ) |
Gets object's accessible children.
Gets human-readable string indentifying widget accessibility role. Gets key-value pairs identifying object extra attributes. Must be free by a user.
- Deprecated:
- Deprecated since 10.0.
Gets reading information of an accessible object.
- Since :
- 4.0
- Parameters:
-
[in] obj The object. [in] reading_info Reading information types
| Eina_Bool elm_atspi_accessible_relationship_append | ( | Elm_Interface_Atspi_Accessible * | obj, |
| Elm_Atspi_Relation_Type | type, | ||
| const Elm_Interface_Atspi_Accessible * | relation_object | ||
| ) |
Defines the relationship between two accessible objects.
- Deprecated:
- Deprecated since 10.0.
Adds unique relation between source object and relation_object of a given type.
Relationships can be queried by Assistive Technology clients to provide customized feedback, improving overall user experience.
Relationship_append API is asymmetric, which means that appending, for example, relation ELM_ATSPI_RELATION_FLOWS_TO from object A to B, do NOT append relation ELM_ATSPI_RELATION_FLOWS_FROM from object B to object A.
return: EINA_TRUE is relationship was successfully appended, EINA_FALSE otherwise
- Since :
- 2.4
- Parameters:
-
[in] obj The object. [in] type Relation type between two objects [in] relation_object Relation object of source object
| void elm_atspi_accessible_relationship_remove | ( | Elm_Interface_Atspi_Accessible * | obj, |
| Elm_Atspi_Relation_Type | type, | ||
| const Elm_Interface_Atspi_Accessible * | relation_object | ||
| ) |
Removes the relationship between two accessible objects.
- Deprecated:
- Deprecated since 10.0.
If relation_object is NULL function removes all relations of given type.
- Since :
- 2.4
- Parameters:
-
[in] obj The object. [in] type Relation type between two objects [in] relation_object Relation object of source object
| void elm_atspi_accessible_relationships_clear | ( | Elm_Interface_Atspi_Accessible * | obj | ) |
Removes all attributes in accessible object.
Register accessibility event listener Deregister accessibility event listener Emit accessibility event which could occur atspi event Removes all relationships in accessible object.
- Since :
- 4.0
- Parameters:
-
[in] obj The object.
| Elm_Atspi_Role elm_atspi_accessible_role_get | ( | const Elm_Interface_Atspi_Accessible * | obj | ) |
Gets the role of the object in accessibility domain.
- Since :
- 2.4
- Parameters:
-
[in] obj The object.
- Returns:
- Accessible role
| void elm_atspi_accessible_role_set | ( | Elm_Interface_Atspi_Accessible * | obj, |
| Elm_Atspi_Role | role | ||
| ) |
Gets an all relations between accessible object and other accessible objects.
- Deprecated:
- Deprecated since 10.0.
Sets the role of the object in accessibility domain.
- Since :
- 2.4
- Parameters:
-
[in] obj The object. [in] role Accessible role
| const char* elm_atspi_accessible_translation_domain_get | ( | const Elm_Interface_Atspi_Accessible * | obj | ) |
Gets the translation domain of "name" and "description" properties.
- Deprecated:
- Deprecated since 10.0.
- Since :
- 2.4
- Parameters:
-
[in] obj The object.
- Returns:
- translation domain
| void elm_atspi_accessible_translation_domain_set | ( | Elm_Interface_Atspi_Accessible * | obj, |
| const char * | domain | ||
| ) |
Sets the translation domain of "name" and "description" properties.
- Deprecated:
- Deprecated since 10.0.
Translation domain should be set if application wants to support i18n for accessibily "name" and "description" properties.
When translation domain is set values of "name" and "description" properties will be translated with dgettext function using current translation domain as "domainname" parameter.
It is application developer responsibility to ensure that translation files are loaded and binded to translation domain when accessibility is enabled.
- Since :
- 2.4
- Parameters:
-
[in] obj The object. [in] domain translation domain
| void elm_atspi_attributes_list_free | ( | Eina_List * | list | ) |
- Deprecated:
- Deprecated since 10.0. Free Elm_Atspi_Attributes_List
- Since :
- 3.0
| Eina_Bool elm_atspi_component_highlight_clear | ( | Efl_Access_Component * | obj | ) |
Clears highlight of accessible widget. returns true if clear has successed, false otherwise.
- Deprecated:
- Deprecated since 10.0.
- Since :
- 4.0
- Parameters:
-
[in] obj The object.
()
| Eina_Bool elm_atspi_component_highlight_grab | ( | Efl_Access_Component * | obj | ) |
Highlights accessible widget. returns true if highlight grab has successed, false otherwise.
- Deprecated:
- Deprecated since 10.0.
- Since :
- 4.0
- Parameters:
-
[in] obj The object.
()
| Efl_Access_Relation* elm_atspi_relation_clone | ( | const Efl_Access_Relation * | relation | ) |
- Deprecated:
- Deprecated since 10.0. Clones relation.
- Since :
- 3.0
| void elm_atspi_relation_free | ( | Efl_Access_Relation * | relation | ) |
- Deprecated:
- Deprecated since 10.0. Frees relation.
- Since :
- 3.0
- Deprecated:
- Deprecated since 10.0. Clones Elm_Atspi_Relation_Set
- Since :
- 3.0
| void elm_atspi_relation_set_free | ( | Elm_Atspi_Relation_Set * | set | ) |
Notifies assistive technology clients about current state of the accessible object.
Function limits information broadcast to clients to types specified by state_types_mask parameter.
if recursive parameter is set, function will traverse all accessible children and call state_notify function on them. Frees Elm_Atspi_Relation_Set
- Since :
- 3.0
| Eina_Bool elm_atspi_relation_set_relation_append | ( | Elm_Atspi_Relation_Set * | set, |
| Elm_Atspi_Relation_Type | type, | ||
| const Eo * | rel_obj | ||
| ) |
- Deprecated:
- Deprecated since 10.0. Appends relation to relation set
- Since :
- 3.0
| void elm_atspi_relation_set_relation_remove | ( | Elm_Atspi_Relation_Set * | set, |
| Elm_Atspi_Relation_Type | type, | ||
| const Eo * | rel_obj | ||
| ) |
- Deprecated:
- Deprecated since 10.0. Removes relation from relation set
- Since :
- 3.0
| void elm_atspi_relation_set_relation_type_remove | ( | Elm_Atspi_Relation_Set * | set, |
| Elm_Atspi_Relation_Type | type | ||
| ) |
- Deprecated:
- Deprecated since 10.0. Removes all relation from relation set of a given type
- Since :
- 3.0