~ubuntu-branches/ubuntu/natty/pygtk/natty-proposed

« back to all changes in this revision

Viewing changes to docs/html/class-gtksocket.html

  • Committer: Bazaar Package Importer
  • Author(s): Sebastien Bacher
  • Date: 2010-01-07 11:08:47 UTC
  • mfrom: (1.2.8 upstream)
  • Revision ID: james.westby@ubuntu.com-20100107110847-f5av7e1ttudh7ra6
Tags: 2.17.0-0ubuntu1
New upstream version

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.Socket</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="gtk-class-reference.html" title="The gtk Class Reference"><link rel="prev" href="class-gtksizegroup.html" title="gtk.SizeGroup"><link rel="next" href="class-gtkspinbutton.html" title="gtk.SpinButton"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">gtk.Socket</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtksizegroup.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkspinbutton.html">Next</a></td></tr></table><hr></div><div class="refentry" lang="en"><a name="class-gtksocket"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.Socket</h2><p>gtk.Socket — a container for widgets from other processes.</p></div><div class="refsect1" lang="en"><a name="id3684036"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.Socket</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a></span></span>):
2
 
<code class="constructorsynopsis">    <span class="methodname"><a class="link" href="class-gtksocket.html#constructor-gtksocket" title="Constructor">gtk.Socket</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtksocket.html#method-gtksocket--add-id" title="gtk.Socket.add_id">add_id</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>window_id</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtksocket.html#method-gtksocket--get-id" title="gtk.Socket.get_id">get_id</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtksocket.html#method-gtksocket--get-plug-window" title="gtk.Socket.get_plug_window">get_plug_window</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table></div><div class="refsect1" lang="en"><a name="id3684152"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
 
1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.Socket</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"><link rel="home" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="gtk-class-reference.html" title="The gtk Class Reference"><link rel="prev" href="class-gtksizegroup.html" title="gtk.SizeGroup"><link rel="next" href="class-gtkspinbutton.html" title="gtk.SpinButton"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">gtk.Socket</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtksizegroup.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkspinbutton.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.Socket"><a name="class-gtksocket"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.Socket</h2><p>gtk.Socket — a container for widgets from other processes.</p></div><div class="refsect1" title="Synopsis"><a name="id3994031"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.Socket</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a></span></span>):
 
2
<code class="constructorsynopsis">    <span class="methodname"><a class="link" href="class-gtksocket.html#constructor-gtksocket" title="Constructor">gtk.Socket</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtksocket.html#method-gtksocket--add-id" title="gtk.Socket.add_id">add_id</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>window_id</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtksocket.html#method-gtksocket--get-id" title="gtk.Socket.get_id">get_id</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtksocket.html#method-gtksocket--get-plug-window" title="gtk.Socket.get_plug_window">get_plug_window</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table></div><div class="refsect1" title="Ancestry"><a name="id3994147"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
3
3
  +-- <a class="link" href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>
4
4
    +-- <a class="link" href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a>
5
5
      +-- <a class="link" href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a>
6
6
        +-- <a class="link" href="class-gtksocket.html" title="gtk.Socket">gtk.Socket</a>
7
 
</pre></div><div class="refsect1" lang="en"><a name="id3684197"></a><h2>Implemented Interfaces</h2><p>
 
7
</pre></div><div class="refsect1" title="Implemented Interfaces"><a name="id3994192"></a><h2>Implemented Interfaces</h2><p>
8
8
                        <a class="link" href="class-gtksocket.html" title="gtk.Socket"><code class="classname">gtk.Socket</code></a>
9
9
                        implements 
10
10
                        <a class="link" href="class-gtkbuildable.html" title="gtk.Buildable"><code class="classname">gtk.Buildable</code></a>
11
 
                </p></div><div class="refsect1" lang="en"><a name="properties-gtksocket"></a><h2>gtk.Socket Properties</h2><p><a class="link" href="class-gtkobject.html#properties-gtkobject" title="gtk.Object Properties">gtk.Object Properties</a></p><p><a class="link" href="class-gtkwidget.html#properties-gtkwidget" title="gtk.Widget Properties">gtk.Widget Properties</a></p><p><a class="link" href="class-gtkcontainer.html#properties-gtkcontainer" title="gtk.Container Properties">gtk.Container Properties</a></p></div><div class="refsect1" lang="en"><a name="style-properties-gtksocket"></a><h2>gtk.Socket Style Properties</h2><p><a class="link" href="class-gtkwidget.html#style-properties-gtkwidget" title="gtk.Widget Style Properties">gtk.Widget Style Properties</a></p></div><div class="refsect1" lang="en"><a name="signal-prototypes-gtksocket"></a><h2>gtk.Socket Signal Prototypes</h2><p><PYGTKDOCLINK HREF="signal-prototypes-gobject">gobject.GObject Signal Prototypes</PYGTKDOCLINK></p><p><a class="link" href="class-gtkobject.html#signal-prototypes-gtkobject" title="gtk.Object Signal Prototypes">gtk.Object Signal Prototypes</a></p><p><a class="link" href="class-gtkwidget.html#signal-prototypes-gtkwidget" title="gtk.Widget Signal Prototypes">gtk.Widget Signal Prototypes</a></p><p><a class="link" href="class-gtkcontainer.html#signal-prototypes-gtkcontainer" title="gtk.Container Signal Prototypes">gtk.Container Signal Prototypes</a></p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">"<a class="link" href="class-gtksocket.html#signal-gtksocket--plug-added" title='The "plug-added" gtk.Socket Signal'>plug-added</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>socket</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtksocket.html#signal-gtksocket--plug-removed" title='The "plug-removed" gtk.Socket Signal'>plug-removed</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>socket</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr></tbody></table></div><div class="refsect1" lang="en"><a name="id3684446"></a><h2>Description</h2><p>Together with a <a class="link" href="class-gtkplug.html" title="gtk.Plug"><code class="classname">gtk.Plug</code></a>, a <a class="link" href="class-gtksocket.html" title="gtk.Socket"><code class="classname">gtk.Socket</code></a> provides
 
11
                </p></div><div class="refsect1" title="gtk.Socket Properties"><a name="properties-gtksocket"></a><h2>gtk.Socket Properties</h2><p><a class="link" href="class-gtkobject.html#properties-gtkobject" title="gtk.Object Properties">gtk.Object Properties</a></p><p><a class="link" href="class-gtkwidget.html#properties-gtkwidget" title="gtk.Widget Properties">gtk.Widget Properties</a></p><p><a class="link" href="class-gtkcontainer.html#properties-gtkcontainer" title="gtk.Container Properties">gtk.Container Properties</a></p></div><div class="refsect1" title="gtk.Socket Style Properties"><a name="style-properties-gtksocket"></a><h2>gtk.Socket Style Properties</h2><p><a class="link" href="class-gtkwidget.html#style-properties-gtkwidget" title="gtk.Widget Style Properties">gtk.Widget Style Properties</a></p></div><div class="refsect1" title="gtk.Socket Signal Prototypes"><a name="signal-prototypes-gtksocket"></a><h2>gtk.Socket Signal Prototypes</h2><p><PYGTKDOCLINK HREF="signal-prototypes-gobject">gobject.GObject Signal Prototypes</PYGTKDOCLINK></p><p><a class="link" href="class-gtkobject.html#signal-prototypes-gtkobject" title="gtk.Object Signal Prototypes">gtk.Object Signal Prototypes</a></p><p><a class="link" href="class-gtkwidget.html#signal-prototypes-gtkwidget" title="gtk.Widget Signal Prototypes">gtk.Widget Signal Prototypes</a></p><p><a class="link" href="class-gtkcontainer.html#signal-prototypes-gtkcontainer" title="gtk.Container Signal Prototypes">gtk.Container Signal Prototypes</a></p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">"<a class="link" href="class-gtksocket.html#signal-gtksocket--plug-added" title='The "plug-added" gtk.Socket Signal'>plug-added</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>socket</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtksocket.html#signal-gtksocket--plug-removed" title='The "plug-removed" gtk.Socket Signal'>plug-removed</a>"</span></p></td><td><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>socket</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr></tbody></table></div><div class="refsect1" title="Description"><a name="id3994440"></a><h2>Description</h2><p>Together with a <a class="link" href="class-gtkplug.html" title="gtk.Plug"><code class="classname">gtk.Plug</code></a>, a <a class="link" href="class-gtksocket.html" title="gtk.Socket"><code class="classname">gtk.Socket</code></a> provides
12
12
the ability to embed widgets from one process into another process in a
13
13
fashion that is transparent to the user. One process creates a <a class="link" href="class-gtksocket.html" title="gtk.Socket"><code class="classname">gtk.Socket</code></a> widget
14
14
and, passes the that widget's window ID to the other process, which then
22
22
therefore, be prepared for your sockets to be destroyed at any time when the
23
23
main event loop is running. The communication between a <a class="link" href="class-gtksocket.html" title="gtk.Socket"><code class="classname">gtk.Socket</code></a> and a
24
24
<a class="link" href="class-gtkplug.html" title="gtk.Plug"><code class="classname">gtk.Plug</code></a> follows
25
 
the XEmbed protocol.</p></div><div class="refsect1" lang="en"><a name="constructor-gtksocket"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis">    <span class="methodname">gtk.Socket</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the new <a class="link" href="class-gtksocket.html" title="gtk.Socket"><code class="classname">gtk.Socket</code></a>.</td></tr></tbody></table><p>Creates a new <a class="link" href="class-gtksocket.html" title="gtk.Socket"><code class="classname">gtk.Socket</code></a>.</p></div><div class="refsect1" lang="en"><a name="id3684601"></a><h2>Methods</h2><div class="refsect2" lang="en"><a name="method-gtksocket--add-id"></a><h3>gtk.Socket.add_id</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_id</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>window_id</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>window_id</code></strong> :</span></p></td><td>the window ID of a client participating in the
 
25
the XEmbed protocol.</p></div><div class="refsect1" title="Constructor"><a name="constructor-gtksocket"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis">    <span class="methodname">gtk.Socket</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the new <a class="link" href="class-gtksocket.html" title="gtk.Socket"><code class="classname">gtk.Socket</code></a>.</td></tr></tbody></table><p>Creates a new <a class="link" href="class-gtksocket.html" title="gtk.Socket"><code class="classname">gtk.Socket</code></a>.</p></div><div class="refsect1" title="Methods"><a name="id3994596"></a><h2>Methods</h2><div class="refsect2" title="gtk.Socket.add_id"><a name="method-gtksocket--add-id"></a><h3>gtk.Socket.add_id</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_id</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>window_id</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>window_id</code></strong> :</span></p></td><td>the window ID of a client participating in the
26
26
XEMBED protocol.</td></tr></tbody></table><p>The <code class="methodname">add_id</code>() method adds an XEMBED
27
27
client specified by <em class="parameter"><code>window_id</code></em>, such as a <a class="link" href="class-gtkplug.html" title="gtk.Plug"><code class="classname">gtk.Plug</code></a>, to the <a class="link" href="class-gtksocket.html" title="gtk.Socket"><code class="classname">gtk.Socket</code></a>.  The
28
28
client may be in the same process or in a different process.</p><p>
29
29
To embed a <a class="link" href="class-gtkplug.html" title="gtk.Plug"><code class="classname">gtk.Plug</code></a> in a <a class="link" href="class-gtksocket.html" title="gtk.Socket"><code class="classname">gtk.Socket</code></a>, you can
30
 
either:</p><div class="itemizedlist"><ul type="disc"><li><p>create the <a class="link" href="class-gtkplug.html" title="gtk.Plug"><code class="classname">gtk.Plug</code></a> by calling
 
30
either:</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>create the <a class="link" href="class-gtkplug.html" title="gtk.Plug"><code class="classname">gtk.Plug</code></a> by calling
31
31
<a class="link" href="class-gtkplug.html#constructor-gtkplug" title="Constructor">gtk.Plug</a>(), then call <a class="link" href="class-gtkplug.html#method-gtkplug--get-id" title="gtk.Plug.get_id"><code class="methodname">gtk.Plug.get_id</code>()</a> 
32
32
to get the window ID of the plug, and finally pass that to the <a class="link" href="class-gtksocket.html#method-gtksocket--add-id" title="gtk.Socket.add_id"><code class="function">gtk.Socket.add_id()</code></a>; 
33
 
or,</p></li><li><p>call the <a class="link" href="class-gtksocket.html#method-gtksocket--get-id" title="gtk.Socket.get_id"><code class="function">gtk.Socket.get_id()</code></a> 
 
33
or,</p></li><li class="listitem"><p>call the <a class="link" href="class-gtksocket.html#method-gtksocket--get-id" title="gtk.Socket.get_id"><code class="function">gtk.Socket.get_id()</code></a> 
34
34
method to get the window ID for the socket, then create the <a class="link" href="class-gtkplug.html" title="gtk.Plug"><code class="classname">gtk.Plug</code></a> by calling
35
35
<a class="link" href="class-gtkplug.html#constructor-gtkplug" title="Constructor">gtk.Plug</a>() passing in that ID.
36
36
The <a class="link" href="class-gtksocket.html" title="gtk.Socket"><code class="classname">gtk.Socket</code></a>
37
37
must have already be added into a toplevel window before you can make this
38
 
call.</p></li></ul></div></div><div class="refsect2" lang="en"><a name="method-gtksocket--get-id"></a><h3>gtk.Socket.get_id</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_id</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the window ID for the
 
38
call.</p></li></ul></div></div><div class="refsect2" title="gtk.Socket.get_id"><a name="method-gtksocket--get-id"></a><h3>gtk.Socket.get_id</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_id</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the window ID for the
39
39
socket</td></tr></tbody></table><p>The <code class="methodname">get_id</code>() method gets the window ID
40
40
of a <a class="link" href="class-gtksocket.html" title="gtk.Socket"><code class="classname">gtk.Socket</code></a> widget,
41
41
which can then be used to create a client embedded inside the socket, for
42
42
instance with <a class="link" href="class-gtkplug.html#constructor-gtkplug" title="Constructor">gtk.Plug</a>(). The
43
43
<a class="link" href="class-gtksocket.html" title="gtk.Socket"><code class="classname">gtk.Socket</code></a>
44
44
must have already be added into a toplevel window before you can make this
45
 
call.</p></div><div class="refsect2" lang="en"><a name="method-gtksocket--get-plug-window"></a><h3>gtk.Socket.get_plug_window</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_plug_window</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the window of the plug if available, or
 
45
call.</p></div><div class="refsect2" title="gtk.Socket.get_plug_window"><a name="method-gtksocket--get-plug-window"></a><h3>gtk.Socket.get_plug_window</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_plug_window</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the window of the plug if available, or
46
46
          <code class="literal">None</code>.</td></tr></tbody></table><p>
47
47
        The <code class="methodname">get_plug_window</code>() method retrieves the
48
48
        window of the plug. Use this to check if the plug has been created
49
49
        inside of the socket.
50
 
      </p></div></div><div class="refsect1" lang="en"><a name="id3684951"></a><h2>Signals</h2><div class="refsect2" lang="en"><a name="signal-gtksocket--plug-added"></a><h3>The "plug-added" gtk.Socket Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>socket</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>socket</code></em> :</span></p></td><td>the socket that received the
 
50
      </p></div></div><div class="refsect1" title="Signals"><a name="id3994946"></a><h2>Signals</h2><div class="refsect2" title='The "plug-added" gtk.Socket Signal'><a name="signal-gtksocket--plug-added"></a><h3>The "plug-added" gtk.Socket Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>socket</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>socket</code></em> :</span></p></td><td>the socket that received the
51
51
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
52
52
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
53
53
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
54
54
any)</td></tr></tbody></table><p>The "plug-added" signal is emitted when a plug is added to the
55
 
socket.</p></div><div class="refsect2" lang="en"><a name="signal-gtksocket--plug-removed"></a><h3>The "plug-removed" gtk.Socket Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>socket</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>socket</code></em> :</span></p></td><td>the socket that received the
 
55
socket.</p></div><div class="refsect2" title='The "plug-removed" gtk.Socket Signal'><a name="signal-gtksocket--plug-removed"></a><h3>The "plug-removed" gtk.Socket Signal</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>socket</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>socket</code></em> :</span></p></td><td>the socket that received the
56
56
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
57
57
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
58
58
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if