GXimCore

typedef struct _GXimCore GXimCore;

An abstract implementation of XIM protocol event handling class.

struct GXimCoreClass

struct GXimCoreClass {
	GObjectClass parent_class;
};

G_XIM_CORE_ERROR

#define G_XIM_CORE_ERROR		g_xim_core_get_error_quark()

g_xim_core_add_client_message_filter ()

void                g_xim_core_add_client_message_filter
                                                        (GXimCore *core,
                                                         GdkAtom atom);

Deals with the event when atom is specified as the message_type in "client-event".

g_xim_core_get_connection_gtype ()

GType               g_xim_core_get_connection_gtype     (GXimCore *core);

Obtains a GType of the class inherited from GXimConnection. This function is typically used to create an instance of the connection.

g_xim_core_get_display ()

GdkDisplay *        g_xim_core_get_display              (GXimCore *core);

Obtains the GdkDisplay that currently use.

g_xim_core_get_error_quark ()

GQuark              g_xim_core_get_error_quark          (void);

g_xim_core_get_protocol_signal_connector ()

GSList *            g_xim_core_get_protocol_signal_connector
                                                        (GXimCore *core);

Obtains a list of the signal callbacks. This function is typically used to initialize the signal connectioon after creating an instance of the connection.

g_xim_core_get_selection_window ()

GdkWindow *         g_xim_core_get_selection_window     (GXimCore *core);

Obtains a selection window. this function may be necessary when you want to communicate the XIM server or clients through XIM protocol.

g_xim_core_lookup_client_message_filter ()

gboolean            g_xim_core_lookup_client_message_filter
                                                        (GXimCore *core,
                                                         GdkAtom atom);

Looks up atom if it's registered to deal with it in "client-event".

g_xim_core_remove_client_message_filter ()

void                g_xim_core_remove_client_message_filter
                                                        (GXimCore *core,
                                                         GdkAtom atom);

Removes atom from the table and the event filter won't deals with it even when it's specified to the message_type in "client-event".

g_xim_core_setup_connection ()

void                g_xim_core_setup_connection         (GXimCore *core,
                                                         GXimConnection *conn);

Initialize a conn's connection to get it working.

g_xim_core_unwatch_event ()

void                g_xim_core_unwatch_event            (GXimCore *core,
                                                         GdkWindow *window);

Removes the event filter from window and finishes watching events at core. This has to be done after finishing the protocol connection. otherwise some events will be lost and another application may be frozen in worst case.

g_xim_core_watch_event ()

void                g_xim_core_watch_event              (GXimCore *core,
                                                         GdkWindow *window);

Adds the event filter to window and catches up events with core's event handler. This has to be done before starting the protocol negotiation. otherwise it will be lost and another application may be frozen in worst case.

The "connection-gtype" property

  "connection-gtype"         GType*                : Read / Write / Construct Only

a GType inherited from GXimConnection. this will be a instance and determines the connection type when the connection is requested.

Allowed values: GXimConnection

The "display" property

  "display"                  GdkDisplay*           : Read / Write / Construct Only

Gdk display to use.

The "proto-signals" property

  "proto-signals"            gpointer              : Read / Write

a set of GXimLazySignalConnector to connect signals to a instance of "connection-gtype" when the connection is negothating.

The "selection-window" property

  "selection-window"         GdkWindow*            : Read

a GdkWindow to communicate with the XIM server or the client application.

The "client-event" signal

gboolean            user_function                      (GXimCore *core,
                                                        GdkEvent *event,
                                                        gpointer  user_data)      : Run Last

The ::client-event signal will be emitted when the core's window receives a message (via ClientMessage event) from another application. all of XIM protocol is delivered with this signal.

The "destroy-event" signal

gboolean            user_function                      (GXimCore *core,
                                                        GdkEvent *event,
                                                        gpointer  user_data)      : Run Last

The ::destroy-event signal will be emitted when a GdkWindow is destroyed. typically you will see that when the client connection is disconnected from the client side.

The "expose-event" signal

gboolean            user_function                      (GXimCore *gximcore,
                                                        GdkEvent *arg1,
                                                        gpointer  user_data)      : Run Last

The "selection-clear-event" signal

gboolean            user_function                      (GXimCore *core,
                                                        GdkEvent *event,
                                                        gpointer  user_data)      : Run Last

The ::selection-clear-event signal will be emitted when the core's window has lost ownership of a selection. this signal won't appears in the client instance, such as inherited from GXimClientTemplate.

The "selection-notify-event" signal

gboolean            user_function                      (GXimCore *core,
                                                        GdkEvent *event,
                                                        gpointer  user_data)      : Run Last

The ::selection-notify-event signal will be emitted when the the XIM server responded requests to get the supported locales and the transport-specific names. this signal won't appears in the server instance, such as inherited from GXimServerTemplate.

The "selection-request-event" signal

gboolean            user_function                      (GXimCore *core,
                                                        GdkEvent *event,
                                                        gpointer  user_data)      : Run Last

The ::selection-request-event signal will be emitted when the client applications requests a set of names of the supported locales and the preregistered formats for transport-specific names. this signal won't appears in the client instance, such as inherited from GXimClientTemplate.