Functions

Types and Values

Object Hierarchy

    GObject
    ╰── AtkObject
        ╰── AtkSocket

Implemented Interfaces

AtkSocket implements AtkComponent.

Includes

#include <atk/atk.h>

Description

Together with AtkPlug, AtkSocket provides the ability to embed accessibles from one process into another in a fashion that is transparent to assistive technologies. AtkSocket works as the container of AtkPlug, embedding it using the method atk_socket_embed(). Any accessible contained in the AtkPlug will appear to the assistive technologies as being inside the application that created the AtkSocket.

The communication between a AtkSocket and a AtkPlug is done by the IPC layer of the accessibility framework, normally implemented by the D-Bus based implementation of AT-SPI (at-spi2). If that is the case, at-spi-atk2 is the responsible to implement the abstract methods atk_plug_get_id() and atk_socket_embed(), so an ATK implementor shouldn't reimplement them. The process that contains the AtkPlug is responsible to send the ID returned by atk_plug_id() to the process that contains the AtkSocket, so it could call the method atk_socket_embed() in order to embed it.

For the same reasons, an implementor doesn't need to implement atk_object_get_n_accessible_children() and atk_object_ref_accessible_child(). All the logic related to those functions will be implemented by the IPC layer.

Functions

AtkObject *
atk_socket_new (void);

void
atk_socket_embed (AtkSocket *obj,
                  const gchar *plug_id);

gboolean
atk_socket_is_occupied (AtkSocket *obj);

Types and Values

struct AtkSocket;

See Also

AtkPlug