AuroraMiddleware/gtk2
1
0
Fork 0
forked from AuroraMiddleware/gtk
Code Issues Pull Requests Projects Releases Wiki Activity
e5cea4e39d
gtk2/gtk/a11y/gtkatspirootprivate.h

67 lines
2.0 KiB
C
Raw Normal View History

a11y: Register the accessible root object When we create the first AT-SPI context we also need to register the accessible root on the accessibility bus. The accessible root object is the main entry point of an accessible application, and it holds the global state to present to the ATs that connect to the bus.
2020-10-09 11:32:09 +00:00
/* gtkatspirootprivate.h: AT-SPI root object
*
* Copyright 2020 GNOME Foundation
*
* SPDX-License-Identifier: LGPL-2.1-or-later
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library; if not, see <http://www.gnu.org/licenses/>.
*/
#pragma once
#include <gio/gio.h>
a11y: Implement atspi.Cache The AT-SPI cache interface is used to quickly populate the accessible objects tree. The tricky bit is ensuring that we emit change notifications on the cache only when the cache is available, which means waiting until the root is asynchronously registered.
2020-11-16 15:23:37 +00:00
#include "gtkatcontextprivate.h"
#include "gtkatspiprivate.h"
a11y: Add AT-SPI cache object Right now, the cache is unused, and we still need to implement the serialisation method and emit the signals.
2020-10-09 13:20:43 +00:00
a11y: Register the accessible root object When we create the first AT-SPI context we also need to register the accessible root on the accessibility bus. The accessible root object is the main entry point of an accessible application, and it holds the global state to present to the ATs that connect to the bus.
2020-10-09 11:32:09 +00:00
G_BEGIN_DECLS
#define GTK_TYPE_AT_SPI_ROOT (gtk_at_spi_root_get_type())
G_DECLARE_FINAL_TYPE (GtkAtSpiRoot, gtk_at_spi_root, GTK, AT_SPI_ROOT, GObject)
GtkAtSpiRoot *
gtk_at_spi_root_new (const char *bus_address);
a11y: Defer object registration after root registration The root accessible object is registered asynchronously, as it needs to call a method on the AT-SPI registry daemon. This means we need to defer registering the GtkAtSpiContext on the accessibility bus and in the cache until after the registration is complete. Fixes: #4825
2022-04-19 15:12:08 +00:00
typedef void (* GtkAtSpiRootRegisterFunc) (GtkAtSpiRoot *root,
GtkAtSpiContext *context);
a11y: Move ATContext to an explicit realization model We are doing too much work during the construction phase of the AT-SPI backend for GtkATContext. Instead of having the AtSpiContext register itself at construction time, let's add explicit realize and unrealize operations, and connect the ATContext realization to the rooting operation of a GtkWidget.
2020-10-19 16:44:50 +00:00
void
a11y: Implement atspi.Cache The AT-SPI cache interface is used to quickly populate the accessible objects tree. The tricky bit is ensuring that we emit change notifications on the cache only when the cache is available, which means waiting until the root is asynchronously registered.
2020-11-16 15:23:37 +00:00
gtk_at_spi_root_queue_register (GtkAtSpiRoot *self,
a11y: Defer object registration after root registration The root accessible object is registered asynchronously, as it needs to call a method on the AT-SPI registry daemon. This means we need to defer registering the GtkAtSpiContext on the accessibility bus and in the cache until after the registration is complete. Fixes: #4825
2022-04-19 15:12:08 +00:00
GtkAtSpiContext *context,
GtkAtSpiRootRegisterFunc func);
a11y: Implement atspi.Cache The AT-SPI cache interface is used to quickly populate the accessible objects tree. The tricky bit is ensuring that we emit change notifications on the cache only when the cache is available, which means waiting until the root is asynchronously registered.
2020-11-16 15:23:37 +00:00
void
gtk_at_spi_root_unregister (GtkAtSpiRoot *self,
GtkAtSpiContext *context);
a11y: Move ATContext to an explicit realization model We are doing too much work during the construction phase of the AT-SPI backend for GtkATContext. Instead of having the AtSpiContext register itself at construction time, let's add explicit realize and unrealize operations, and connect the ATContext realization to the rooting operation of a GtkWidget.
2020-10-19 16:44:50 +00:00
a11y: Register the accessible root object When we create the first AT-SPI context we also need to register the accessible root on the accessibility bus. The accessible root object is the main entry point of an accessible application, and it holds the global state to present to the ATs that connect to the bus.
2020-10-09 11:32:09 +00:00
GDBusConnection *
gtk_at_spi_root_get_connection (GtkAtSpiRoot *self);
a11y: Add AT-SPI cache object Right now, the cache is unused, and we still need to implement the serialisation method and emit the signals.
2020-10-09 13:20:43 +00:00
GtkAtSpiCache *
gtk_at_spi_root_get_cache (GtkAtSpiRoot *self);
a11y: Compute the base path in the root object The root path is shared by all AtSpiContext instances, so we should compute it once, instead of every time we instantiate a new context. This allows us to defer the path creation at realization time and ensure that we have a registered application.
2020-11-16 14:17:28 +00:00
const char *
gtk_at_spi_root_get_base_path (GtkAtSpiRoot *self);
a11y: Convenience API for referencing ATSPI root node We turn the root node into a reference fairly often, so it's worth it to have a utility function that does this for us.
2020-10-10 12:23:21 +00:00
GVariant *
gtk_at_spi_root_to_ref (GtkAtSpiRoot *self);
a11y: Add method to extract desktop data We are going to need the desktop name and path to populate the parent property of AtSpiContexts associated to top level widgets.
2020-10-09 21:38:08 +00:00
a11y: Improve child notification for toplevels We need to translate the list model position into an accessible tree position, since hidden toplevels will be skipped. While we are at it, add an api for this notification that will be used in the next commit.
2020-10-24 17:13:07 +00:00
void
gtk_at_spi_root_child_changed (GtkAtSpiRoot *self,
a11y: More State<>Change confusion We should really avoid this needless duplication - the 'state' is never stored anywhere.
2020-10-25 03:12:36 +00:00
GtkAccessibleChildChange change,
Cosmetics Make gtk_at_spi_root_child_changed take a GtkAccessible for the child.
2020-10-25 01:35:35 +00:00
GtkAccessible *child);
a11y: Improve child notification for toplevels We need to translate the list model position into an accessible tree position, since hidden toplevels will be skipped. While we are at it, add an api for this notification that will be used in the next commit.
2020-10-24 17:13:07 +00:00
a11y: Register the accessible root object When we create the first AT-SPI context we also need to register the accessible root on the accessibility bus. The accessible root object is the main entry point of an accessible application, and it holds the global state to present to the ATs that connect to the bus.
2020-10-09 11:32:09 +00:00
G_END_DECLS
Reference in New Issue Copy Permalink