GI.Atk.Objects.Socket

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

The communication between a Socket and a Plug 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 plugGetId and socketEmbed, so an ATK implementor shouldn't reimplement them. The process that contains the Plug is responsible to send the ID returned by atk_plug_id() to the process that contains the Socket, so it could call the method socketEmbed in order to embed it.

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

Exported types

newtype Socket

Constructors

Socket (ManagedPtr Socket)

Instances

GObject Socket

Methods

gobjectType :: Socket -> IO GType

IsObject Socket

IsObject Socket

IsComponent Socket

IsSocket Socket

((~) * info (ResolveSocketMethod t Socket), MethodInfo * info Socket p) => IsLabel t (Socket -> p)

Methods

fromLabel :: Proxy# Symbol t -> Socket -> p

((~) * info (ResolveSocketMethod t Socket), MethodInfo * info Socket p) => IsLabelProxy t (Socket -> p)

Methods

fromLabelProxy :: Proxy Symbol t -> Socket -> p

HasAttributeList * Socket

type AttributeList Socket

type AttributeList Socket

type SignalList Socket

type SignalList Socket

class GObject o => IsSocket o

Instances

(GObject a, UnknownAncestorError Constraint Socket a) => IsSocket a

IsSocket Socket

toSocket :: IsSocket o => o -> IO Socket

noSocket :: Maybe Socket

Methods

embed

data SocketEmbedMethodInfo

Instances

((~) * signature (Text -> m ()), MonadIO m, IsSocket a) => MethodInfo * SocketEmbedMethodInfo a signature

Methods

overloadedMethod :: MethodProxy SocketEmbedMethodInfo a -> signature -> s

socketEmbed

Arguments

:: (HasCallStack, MonadIO m, IsSocket a)

=> a

obj: an Socket

-> Text

plugId: the ID of an Plug

-> m ()

Embeds the children of an Plug as the children of the Socket. The plug may be in the same process or in a different process.

The class item used by this function should be filled in by the IPC layer (usually at-spi2-atk). The implementor of the AtkSocket should call this function and pass the id for the plug as returned by plugGetId. It is the responsibility of the application to pass the plug id on to the process implementing the Socket as needed.

Since: 1.30

isOccupied

data SocketIsOccupiedMethodInfo

Instances

((~) * signature (m Bool), MonadIO m, IsSocket a) => MethodInfo * SocketIsOccupiedMethodInfo a signature

Methods

overloadedMethod :: MethodProxy SocketIsOccupiedMethodInfo a -> signature -> s

socketIsOccupied

Arguments

:: (HasCallStack, MonadIO m, IsSocket a)

=> a

obj: an Socket

-> m Bool

Returns: TRUE if a plug is embedded in the socket

Determines whether or not the socket has an embedded plug.

Since: 1.30

new

socketNew :: (HasCallStack, MonadIO m) => m Socket

No description available in the introspection data.