gtk.Plug

gtk.Plug — A toplevel window for embedding into other processes.

Synopsis

class gtk.Plug(gtk.Window):
    gtk.Plug(socket_id)
def construct(socket_id)
def get_id()
Functions

    def gtk.plug_new_for_display(display, socket_id)

Ancestry

+-- gobject.GObject
  +-- gtk.Object
    +-- gtk.Widget
      +-- gtk.Container
        +-- gtk.Bin
          +-- gtk.Window
            +-- gtk.Plug

gtk.Plug Properties

gtk.Object Properties

gtk.Widget Properties

gtk.Container Properties

gtk.Window Properties

gtk.Plug Style Properties

gtk.Widget Style Properties

gtk.Plug Signal Prototypes

gobject.GObject Signal Prototypes

gtk.Object Signal Prototypes

gtk.Widget Signal Prototypes

gtk.Container Signal Prototypes

gtk.Window Signal Prototypes

"embedded" def callback(plug, user_param1, ...)

Description

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

Constructor

    gtk.Plug(socket_id)
socket_id : the window ID of the socket, or 0.
Returns :a gtk.Widget

Creates a new gtk.Plug widget inside the gtk.Socket identified by socket_id. If socket_id is 0, the plug is left "unplugged" and can later be plugged into a gtk.Socket by the gtk.Socket.add_id() method.

Methods

gtk.Plug.construct

    def construct(socket_id)
socket_id :the window ID of the socket

Warning

This method is not available in PyGTK 2.2 and above.

The construct() method finishes the initialization of plug for the gtk.Socket identified by socket_id. This method will generally only be used by subclasses of gtk.Plug.

gtk.Plug.get_id

    def get_id()
Returns :the window ID for the plug

The get_id() method returns the window ID of the gtk.Plug widget, which can be used to embed this window inside another window, for instance with gtk.Socket.add_id().

Functions

gtk.plug_new_for_display

    def gtk.plug_new_for_display(display, socket_id)
display :the gtk.gdk.Display associated with socket_id's.
socket_id : the window ID of the socket's window.
Returns :a gtk.Plug object

Note

This function is available in PyGTK 2.2 and above.

The gtk.plug_new_for_display() function creates a new plug widget inside the gtk.Socket specified by socket_id on the gtk.gdk.Display specified by display.

Signals

The "embedded" gtk.Plug Signal

    def callback(plug, user_param1, ...)
plug :the plug that received the signal
user_param1 :the first user parameter (if any) specified with the connect() method
... :additional user parameters (if any)

The "embedded" signal is emitted when the plug window is reparented to the socket window.