gtkenums: Correctly document AnnouncementPriority

This commit is contained in:
Maximiliano Sandoval 2024-05-25 18:19:38 +02:00
parent 6b0b3a4db7
commit e24630bd18
No known key found for this signature in database
GPG Key ID: D64A8D747F6FE706

View File

@ -1821,16 +1821,17 @@ typedef enum { /*< prefix=GTK_ACCESSIBLE_SORT >*/
/**
* GtkAccessibleAnnouncementPriority:
* @GTK_ANNOUNCEMENT_PRIORITY_LOW: The announcement is low priority, and might be read only
* on the user's request.
* @GTK_ANNOUNCEMENT_PRIORITY_MEDIUM: The announcement is of medium priority, and is usually
* spoken at the next opportunity, such as at the end of speaking the current sentence
* or when the user pauses typing.
* @GTK_ANNOUNCEMENT_PRIORITY_HIGH: The announcement is of high priority, and is usually
* spoken immediately. Because an interruption might disorient users or cause them to
* not complete their current task, authors SHOULD NOT use high priority announcements
* unless the interruption is imperative. An example would be a notification about a
* critical battery power level.
* @GTK_ACCESSIBLE_ANNOUNCEMENT_PRIORITY_LOW: The announcement is low priority,
* and might be read only on the user's request.
* @GTK_ACCESSIBLE_ANNOUNCEMENT_PRIORITY_MEDIUM: The announcement is of medium
* priority, and is usually spoken at the next opportunity, such as at the
* end of speaking the current sentence or when the user pauses typing.
* @GTK_ACCESSIBLE_ANNOUNCEMENT_PRIORITY_HIGH: The announcement is of high
* priority, and is usually spoken immediately. Because an interruption
* might disorient users or cause them to not complete their current task,
* authors SHOULD NOT use high priority announcements unless the
* interruption is imperative. An example would be a notification about a
* critical battery power level.
*
* The priority of an accessibility announcement.
*