Tizen Native API
3.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) |
Sets an accessible name of the object. | |
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) |
Sets the role of the object in accessibility domain. | |
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 reading information of an accessible object. | |
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) |
Sets widget contextual information. | |
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, Elm_Atspi_Gesture_Cb gesutre_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 highlightable to given widget. | |
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. | |
Typedefs | |
typedef char *(* | Elm_Atspi_Reading_Info_Cb )(void *data, Evas_Object *obj) |
typedef unsigned int | Elm_Atspi_Reading_Info_Type_Mask |
typedef enum _Elm_Atspi_Gesture_Type | Elm_Atspi_Gesture_Type |
typedef enum _Elm_Atspi_Gesture_State | Elm_Atspi_Gesture_State |
typedef struct _Elm_Atspi_Gesture_Info | Elm_Atspi_Gesture_Info |
typedef Eina_Bool(* | Elm_Atspi_Gesture_Cb )(void *data, Elm_Atspi_Gesture_Info gesture_info, Evas_Object *obj) |
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 Documentation
typedef Eina_Bool(* Elm_Atspi_Gesture_Cb)(void *data, Elm_Atspi_Gesture_Info gesture_info, Evas_Object *obj) |
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:
true
if application consumes gesutre,false
if application does not consume gesture, then assistive technology client consumes gesture
- See also:
- elm_atspi_accessible_gesture_cb_set
typedef struct _Elm_Atspi_Gesture_Info Elm_Atspi_Gesture_Info |
Detailed information of gesture that is emitted on assistive technology client side.
typedef enum _Elm_Atspi_Gesture_State Elm_Atspi_Gesture_State |
State of gesture that is emitted on assistive technology client side.
typedef enum _Elm_Atspi_Gesture_Type Elm_Atspi_Gesture_Type |
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.
typedef char*(* Elm_Atspi_Reading_Info_Cb)(void *data, Evas_Object *obj) |
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
typedef unsigned int Elm_Atspi_Reading_Info_Type_Mask |
A Elm_Accessible_Reading_Info_Type mask indicating which types of reading information are requested.
typedef enum _Elm_Atspi_Relation_Type Elm_Atspi_Relation_Type |
Elm_Atspi_Relation_Type describes relation between two objects.
- Since :
- 3.0
typedef enum _Elm_Atspi_Role Elm_Atspi_Role |
Describes the role of an object visible to assistive technology client.
- Since :
- 3.0
typedef enum _Elm_Atspi_State_Type Elm_Atspi_State_Type |
Describes a possible states of an object visible to AT-SPI clients.
- Since :
- 3.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.
- Parameters:
-
[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.
- Returns:
- If
true
, the object is highlightable
void elm_atspi_accessible_can_highlight_set | ( | Elm_Interface_Atspi_Accessible * | obj, |
Eina_Bool | can_highlight | ||
) |
Sets highlightable to given widget.
- Parameters:
-
[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.
- Parameters:
-
[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.
- Since :
- 2.4
- Returns:
- Accessible contextual information
void elm_atspi_accessible_description_set | ( | Elm_Interface_Atspi_Accessible * | obj, |
const char * | description | ||
) |
Sets widget contextual information.
- Since :
- 2.4
- Parameters:
-
[in] description Accessible contextual information
void elm_atspi_accessible_gesture_cb_set | ( | Elm_Interface_Atspi_Accessible * | obj, |
Elm_Atspi_Gesture_Cb | gesutre_cb, | ||
const void * | data | ||
) |
Sets gesture callback to give widget.
- 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.
- Parameters:
-
[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.
- Parameters:
-
[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.
- Since :
- 2.4
- Returns:
- Accessible name
void elm_atspi_accessible_name_set | ( | Elm_Interface_Atspi_Accessible * | obj, |
const char * | name | ||
) |
Sets an accessible name of the object.
- Since :
- 2.4
- Parameters:
-
[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.
- 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 reading information of an accessible object.
- Parameters:
-
[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.
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] 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.
If relation_object is NULL function removes all relations of given type.
- Since :
- 2.4
- Parameters:
-
[in] relation_object Relation object of source 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
- Returns:
- Accessible role
void elm_atspi_accessible_role_set | ( | Elm_Interface_Atspi_Accessible * | obj, |
Elm_Atspi_Role | role | ||
) |
Sets the role of the object in accessibility domain.
- Since :
- 2.4
- Parameters:
-
[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.
- Since :
- 2.4
- 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.
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] domain translation domain