Expand the docs on when you would want to use this API

This commit is contained in:
Lukáš Tyrychtr
2023-10-06 16:25:04 +02:00
committed by Matthias Clasen
parent 3921398e66
commit bff31f58a8

View File

@@ -756,7 +756,15 @@ gtk_accessible_reset_relation (GtkAccessible *self,
* @self: a `GtkAccessible`
* @message: the string to announce
* @priority: the priority of the announcement
*
* Requests the user's screen reader to announce the given message.
* This kind of notification is useful for messages that
* either have only a visual representation or that are not
* exposed visually at all, e.g. a notification about a
* successful operation.
*
* Also, by using this API, you can ensure that the message
* does not interrupts the user's current screen reader output.
*
* Since: 4.14
*/