struct Gio::SocketClient::EventSignal

• Gio::SocketClient::EventSignal
• GObject::Signal
• Struct
• Value
• Object

Overview

Emitted when client's activity on connectable changes state. Among other things, this can be used to provide progress information about a network connection in the UI. The meanings of the different event values are as follows:

• %G_SOCKET_CLIENT_RESOLVING: client is about to look up connectable in DNS. connection will be nil.

• %G_SOCKET_CLIENT_RESOLVED: client has successfully resolved connectable in DNS. connection will be nil.

• %G_SOCKET_CLIENT_CONNECTING: client is about to make a connection to a remote host; either a proxy server or the destination server itself. connection is the #GSocketConnection, which is not yet connected. Since GLib 2.40, you can access the remote address via g_socket_connection_get_remote_address().

• %G_SOCKET_CLIENT_CONNECTED: client has successfully connected to a remote host. connection is the connected #GSocketConnection.

• %G_SOCKET_CLIENT_PROXY_NEGOTIATING: client is about to negotiate with a proxy to get it to connect to connectable. connection is the #GSocketConnection to the proxy server.

• %G_SOCKET_CLIENT_PROXY_NEGOTIATED: client has negotiated a connection to connectable through a proxy server. connection is the stream returned from g_proxy_connect(), which may or may not be a #GSocketConnection.

• %G_SOCKET_CLIENT_TLS_HANDSHAKING: client is about to begin a TLS handshake. connection is a #GTlsClientConnection.

• %G_SOCKET_CLIENT_TLS_HANDSHAKED: client has successfully completed the TLS handshake. connection is a #GTlsClientConnection.

• %G_SOCKET_CLIENT_COMPLETE: client has either successfully connected to connectable (in which case connection is the #GSocketConnection that it will be returning to the caller) or has failed (in which case connection is nil and the client is about to return an error).

Each event except %G_SOCKET_CLIENT_COMPLETE may be emitted multiple times (or not at all) for a given connectable (in particular, if client ends up attempting to connect to more than one address). However, if client emits the #GSocketClient::event signal at all for a given connectable, then it will always emit it with %G_SOCKET_CLIENT_COMPLETE when it is done.

Note that there may be additional #GSocketClientEvent values in the future; unrecognized event values should be ignored.

Defined in:

Instance Method Summary

• #connect(*, after : Bool = false, &block : Proc(Gio::SocketClientEvent, Gio::SocketConnectable, Gio::IOStream | Nil, Nil)) : GObject::SignalConnection
• #connect(handler : Proc(Gio::SocketClientEvent, Gio::SocketConnectable, Gio::IOStream | Nil, Nil), *, after : Bool = false) : GObject::SignalConnection
• #connect(handler : Proc(Gio::SocketClient, Gio::SocketClientEvent, Gio::SocketConnectable, Gio::IOStream | Nil, Nil), *, after : Bool = false) : GObject::SignalConnection
• #emit(event : Gio::SocketClientEvent, connectable : Gio::SocketConnectable, connection : Gio::IOStream | Nil) : Nil
• #name : String

  The signal name

Instance Method Detail