Socket
open class Socket : Object, SocketProtocol
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.
The Socket
type acts as a reference-counted owner of an underlying AtkSocket
instance.
It provides the methods that can operate on this data type through SocketProtocol
conformance.
Use Socket
as a strong reference or owner of a AtkSocket
instance.
-
Designated initialiser from the underlying `C` data type.
This creates an instance without performing an unbalanced retain i.e., ownership is transferred to the
Socket
instance.Declaration
Swift
@inlinable public init(_ op: UnsafeMutablePointer<AtkSocket>)
Parameters
op
pointer to the underlying object
-
Designated initialiser from a constant pointer to the underlying
C
data type. This creates an instance without performing an unbalanced retain i.e., ownership is transferred to theSocket
instance.Declaration
Swift
@inlinable public init(_ op: UnsafePointer<AtkSocket>)
Parameters
op
pointer to the underlying object
-
Optional initialiser from a non-mutating
gpointer
to the underlyingC
data type. This creates an instance without performing an unbalanced retain i.e., ownership is transferred to theSocket
instance.Declaration
Swift
@inlinable override public init!(gpointer op: gpointer?)
Parameters
op
gpointer to the underlying object
-
Optional initialiser from a non-mutating
gconstpointer
to the underlyingC
data type. This creates an instance without performing an unbalanced retain i.e., ownership is transferred to theSocket
instance.Declaration
Swift
@inlinable override public init!(gconstpointer op: gconstpointer?)
Parameters
op
pointer to the underlying object
-
Optional initialiser from a constant pointer to the underlying
C
data type. This creates an instance without performing an unbalanced retain i.e., ownership is transferred to theSocket
instance.Declaration
Swift
@inlinable public init!(_ op: UnsafePointer<AtkSocket>?)
Parameters
op
pointer to the underlying object
-
Optional initialiser from the underlying
C
data type. This creates an instance without performing an unbalanced retain i.e., ownership is transferred to theSocket
instance.Declaration
Swift
@inlinable public init!(_ op: UnsafeMutablePointer<AtkSocket>?)
Parameters
op
pointer to the underlying object
-
Designated initialiser from the underlying
C
data type. Will retainAtkSocket
. i.e., ownership is transferred to theSocket
instance.Declaration
Swift
@inlinable public init(retaining op: UnsafeMutablePointer<AtkSocket>)
Parameters
op
pointer to the underlying object
-
Reference intialiser for a related type that implements
SocketProtocol
Will retainAtkSocket
.Declaration
Swift
@inlinable public init<T>(socket other: T) where T : SocketProtocol
Parameters
other
an instance of a related type that implements
SocketProtocol
-
Unsafe typed initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
SocketProtocol
.Declaration
Swift
@inlinable override public init<T>(cPointer p: UnsafeMutablePointer<T>)
Parameters
cPointer
pointer to the underlying object
-
Unsafe typed, retaining initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
SocketProtocol
.Declaration
Swift
@inlinable override public init<T>(retainingCPointer cPointer: UnsafeMutablePointer<T>)
Parameters
cPointer
pointer to the underlying object
-
Unsafe untyped initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
SocketProtocol
.Declaration
Swift
@inlinable override public init(raw p: UnsafeRawPointer)
Parameters
p
raw pointer to the underlying object
-
Unsafe untyped, retaining initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
SocketProtocol
.Declaration
Swift
@inlinable override public init(retainingRaw raw: UnsafeRawPointer)
-
Unsafe untyped initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
SocketProtocol
.Declaration
Swift
@inlinable public required init(raw p: UnsafeMutableRawPointer)
Parameters
p
mutable raw pointer to the underlying object
-
Unsafe untyped, retaining initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
SocketProtocol
.Declaration
Swift
@inlinable required public init(retainingRaw raw: UnsafeMutableRawPointer)
Parameters
raw
mutable raw pointer to the underlying object
-
Unsafe untyped initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
SocketProtocol
.Declaration
Swift
@inlinable override public init(opaquePointer p: OpaquePointer)
Parameters
p
opaque pointer to the underlying object
-
Unsafe untyped, retaining initialiser. Do not use unless you know the underlying data type the pointer points to conforms to
SocketProtocol
.Declaration
Swift
@inlinable override public init(retainingOpaquePointer p: OpaquePointer)
Parameters
p
opaque pointer to the underlying object
-
Creates a new
AtkSocket
.Declaration
Swift
@inlinable public init()