MateComponentPlug

## MateComponentPlug MateComponentPlug — Toplevel for embedding into other processes. |

## Synopsis

    struct              MateComponentPlug;
                        MateComponentPlugPrivate;
                        MateComponentPlugClass;
    void                matecomponent_plug_construct               (MateComponentPlug *plug,
                                                             guint32 socket_id);
    GtkWidget *         matecomponent_plug_new                     (guint32 socket_id);

## Object Hierarchy

      GObject
       +----GInitiallyUnowned
             +----GtkObject
                   +----GtkWidget
                         +----GtkContainer
                               +----GtkBin
                                     +----GtkWindow
                                           +----GtkPlug
                                                 +----MateComponentPlug

## Implemented Interfaces

MateComponentPlug implements AtkImplementorIface and GtkBuildable.

## Properties

      "event-forwarding"         gboolean              : Read / Write

## Description

This is an internal support routine of the X code in MateComponent.

Together with MateComponentSocket, MateComponentPlug provides the ability to embed widgets from one process into another process in a fashion that is transparent to the user. One process creates a MateComponentSocket widget and, passes the XID of that widgets window to the other process, which then creates a MateComponentPlug window with that XID. Any widgets contained in the MateComponentPlug then will appear inside the first applications window.

This code is a modified copy of GtkPlug, it is included in matecomponent since this forked version could be effectively bug fixed, and integrated with the MateComponentControl / MateComponentControlframe CORBA pipe, to ensure synchronization between the X and CORBA transports.

## Details

### struct MateComponentPlug

    struct MateComponentPlug;

### MateComponentPlugPrivate

    typedef struct _MateComponentPlugPrivate MateComponentPlugPrivate;

### MateComponentPlugClass

    typedef struct {
    	GtkPlugClass parent_class;

    	gpointer dummy[4];
    } MateComponentPlugClass;

### matecomponent_plug_construct ()

    void                matecomponent_plug_construct               (MateComponentPlug *plug,
                                                             guint32 socket_id);

Finish the creation of a MateComponentPlug widget. This function will generally only be used by classes deriving from MateComponentPlug.

`plug` : | The MateComponentPlug.
`socket_id` : | the XID of the socket's window.

### matecomponent_plug_new ()

    GtkWidget *         matecomponent_plug_new                     (guint32 socket_id);

Create a new plug widget inside the GtkSocket identified by `socket_id`.

`socket_id` : | the XID of the socket's window.
Returns : | the new MateComponentPlug widget.

## Property Details

### The `"event-forwarding"` property

      "event-forwarding"         gboolean              : Read / Write

Whether X events should be forwarded.

Default value: TRUE

## See Also

MateComponentSocket, MateComponentControlFrame.