summaryrefslogtreecommitdiff
path: root/xml
diff options
context:
space:
mode:
authorMike Gorse <mgorse@suse.com>2023-05-03 17:13:02 -0500
committerMike Gorse <mgorse@suse.com>2023-05-03 17:13:02 -0500
commit6e4b76546950d53d1db61ce562952b812fe731e9 (patch)
treec3446ebcfaed54944d199011f8719bb35644f32a /xml
parentf6d5fe5a442348c9631e0214048d2037834f4779 (diff)
downloadat-spi2-core-6e4b76546950d53d1db61ce562952b812fe731e9.tar.gz
Use internal names when possible for localized role names
This matches the behavior of atspi_accessible_get_role_name. We already hav translations from atk, so we can use those. Also, move the table for role name translations into atspi, since it seems that atk is increasingly becoming a legacy tool. Add a note to the xml indicating that it is optional to implement GetRoleName and GetLocalizedRoleName. Fixes #110
Diffstat (limited to 'xml')
-rw-r--r--xml/Accessible.xml8
1 files changed, 6 insertions, 2 deletions
diff --git a/xml/Accessible.xml b/xml/Accessible.xml
index 2ada7005..25e16994 100644
--- a/xml/Accessible.xml
+++ b/xml/Accessible.xml
@@ -729,7 +729,9 @@
Gets a UTF-8 string corresponding to the name of the role played by an object.
This method will return useful values for roles that fall outside the
- enumeration used in the GetRole method.
+ enumeration used in the GetRole method. Implementing this method is
+ optional, and it may be removed in a future version of the API.
+ Libatspi will only call id in the event of an unknown role.
-->
<method name="GetRoleName">
<arg direction="out" type="s"/>
@@ -741,7 +743,9 @@
Gets a UTF-8 string corresponding to the name of the role played by an object, translated
to the current locale.
This method will return useful values for roles that fall outside the
- enumeration used in the GetRole method.
+ enumeration used in the GetRole method. Implementing this method is
+ optional, and it may be removed in a future version of the API.
+ Libatspi will only call id in the event of an unknown role.
-->
<method name="GetLocalizedRoleName">
<arg direction="out" type="s"/>