## GtkPlug

GtkPlug — Toplevel for embedding into other processes

## Synopsis

    #include <gtk/gtk.h>

                        GtkPlug;
    void                gtk_plug_construct                  (GtkPlug *plug,
                                                             GdkNativeWindow socket_id);
    void                gtk_plug_construct_for_display      (GtkPlug *plug,
                                                             GdkDisplay *display,
                                                             GdkNativeWindow socket_id);
    GtkWidget*          gtk_plug_new                        (GdkNativeWindow socket_id);
    GtkWidget*          gtk_plug_new_for_display            (GdkDisplay *display,
                                                             GdkNativeWindow socket_id);
    GdkNativeWindow     gtk_plug_get_id                     (GtkPlug *plug);
    gboolean            gtk_plug_get_embedded               (GtkPlug *plug);
    GdkWindow *         gtk_plug_get_socket_window          (GtkPlug *plug);

## Object Hierarchy

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

## Implemented Interfaces

GtkPlug implements AtkImplementorIface and GtkBuildable.

## Properties

      "embedded"                 gboolean              : Read
      "socket-window"            GdkWindow*            : Read

## Signals

      "embedded"                                       : Run Last

## Description

Together with GtkSocket, GtkPlug 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 GtkSocket widget and, passes the ID of that widgets window to the other process, which then creates a GtkPlug with that window ID. Any widgets contained in the GtkPlug then will appear inside the first applications window.

### Note

The GtkPlug and GtkSocket widgets are currently not available on all platforms supported by GTK+.

## Details

### GtkPlug

    typedef struct _GtkPlug GtkPlug;

### gtk_plug_construct ()

    void                gtk_plug_construct                  (GtkPlug *plug,
                                                             GdkNativeWindow socket_id);

Finish the initialization of `plug` for a given GtkSocket identified by `socket_id`. This function will generally only be used by classes deriving from GtkPlug.

`plug` : | a GtkPlug.
`socket_id` : | the XID of the socket's window.

### gtk_plug_construct_for_display ()

    void                gtk_plug_construct_for_display      (GtkPlug *plug,
                                                             GdkDisplay *display,
                                                             GdkNativeWindow socket_id);

Finish the initialization of `plug` for a given GtkSocket identified by `socket_id` which is currently displayed on `display`. This function will generally only be used by classes deriving from GtkPlug.

`plug` : | a GtkPlug.
`display` : | the GdkDisplay associated with `socket_id`'s GtkSocket.
`socket_id` : | the XID of the socket's window.

Since 2.2

### gtk_plug_new ()

    GtkWidget*          gtk_plug_new                        (GdkNativeWindow socket_id);

Creates a new plug widget inside the GtkSocket identified by `socket_id`. If `socket_id` is 0, the plug is left "unplugged" and can later be plugged into a GtkSocket by `gtk_socket_add_id()`.

`socket_id` : | the window ID of the socket, or 0.
Returns : | the new GtkPlug widget.

### gtk_plug_new_for_display ()

    GtkWidget*          gtk_plug_new_for_display            (GdkDisplay *display,
                                                             GdkNativeWindow socket_id);

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

`display` : | the GdkDisplay on which `socket_id` is displayed
`socket_id` : | the XID of the socket's window.
Returns : | the new GtkPlug widget.

Since 2.2

### gtk_plug_get_id ()

    GdkNativeWindow     gtk_plug_get_id                     (GtkPlug *plug);

Gets the window ID of a GtkPlug widget, which can then be used to embed this window inside another window, for instance with `gtk_socket_add_id()`.

`plug` : | a GtkPlug.
Returns : | the window ID for the plug

### gtk_plug_get_embedded ()

    gboolean            gtk_plug_get_embedded               (GtkPlug *plug);

Determines whether the plug is embedded in a socket.

`plug` : | a GtkPlug
Returns : | `TRUE` if the plug is embedded in a socket

Since 2.14

### gtk_plug_get_socket_window ()

    GdkWindow *         gtk_plug_get_socket_window          (GtkPlug *plug);

Retrieves the socket the plug is embedded in.

`plug` : | a GtkPlug
Returns : | the window of the socket, or `NULL`

Since 2.14

## Property Details

### The `"embedded"` property

      "embedded"                 gboolean              : Read

`TRUE` if the plug is embedded in a socket.

Default value: FALSE

Since 2.12

### The `"socket-window"` property

      "socket-window"            GdkWindow*            : Read

The window of the socket the plug is embedded in.

Since 2.14

## Signal Details

### The `"embedded"` signal

    void                user_function                      (GtkPlug *plug,
                                                            gpointer user_data)      : Run Last

Gets emitted when the plug becomes embedded in a socket and when the embedding ends.

`plug` : | the object on which the signal was emitted
`user_data` : | user data set when the signal handler was connected.

## See Also

GtkSocket | the widget that a GtkPlug plugs into.