Announcement signal is missing politeness level
The Announcement
signal, possibly meant to replace how live regions work, seem to not carry the concept of a politeness level. Its current signature, as defined in xml/Event.xml
looks like this:
<signal name="Announcement">
<arg name="text" type="s"/>
<arg type="i"/>
<arg type="i"/>
<arg type="v"/>
<arg name="properties" type="a{sv}"/>
<annotation name="org.qtproject.QtDBus.QtTypeName.In0" value="QSpiEvent"/>
</signal>
Where is the politeness level supposed to be placed? Are we supposed to store it using the undocumented container-live
attribute inside the properties
field?
If nothing was decided yet, I'd suggest introducing a new enum to describe politeness level:
typedef enum
{
ATSPI_LIVE_OFF,
ATSPI_LIVE_POLITE,
ATSPI_LIVE_ASSERTIVE,
} AtspiLive;
It could then be stored inside the anydata
(v
) field of the signal.
See orca#365 for more context.