~ubuntu-branches/ubuntu/raring/gtk+2.0/raring-proposed

<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a> * <a class="link" href="GtkSocket.html#gtk-socket-new" title="gtk_socket_new ()">gtk_socket_new</a> (<code>void</code>);

void <a class="link" href="GtkSocket.html#gtk-socket-steal" title="gtk_socket_steal ()">gtk_socket_steal</a> (<code><a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a> *socket_</code>,

<code><a href="../gdk/gdk-Event-Structures.html#GdkNativeWindow">GdkNativeWindow</a> wid</code>);

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkNativeWindow">GdkNativeWindow</a> wid</code>);

void <a class="link" href="GtkSocket.html#gtk-socket-add-id" title="gtk_socket_add_id ()">gtk_socket_add_id</a> (<code><a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a> *socket_</code>,

<code><a href="../gdk/gdk-Event-Structures.html#GdkNativeWindow">GdkNativeWindow</a> window_id</code>);

<a href="../gdk/gdk-Event-Structures.html#GdkNativeWindow">GdkNativeWindow</a> <a class="link" href="GtkSocket.html#gtk-socket-get-id" title="gtk_socket_get_id ()">gtk_socket_get_id</a> (<code><a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a> *socket_</code>);

<a href="../gdk/gdk-Windows.html#GdkWindow">GdkWindow</a> * <a class="link" href="GtkSocket.html#gtk-socket-get-plug-window" title="gtk_socket_get_plug_window ()">gtk_socket_get_plug_window</a> (<code><a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a> *socket_</code>);

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkNativeWindow">GdkNativeWindow</a> window_id</code>);

<a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkNativeWindow">GdkNativeWindow</a> <a class="link" href="GtkSocket.html#gtk-socket-get-id" title="gtk_socket_get_id ()">gtk_socket_get_id</a> (<code><a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a> *socket_</code>);

<a href="http://library.gnome.org/devel/gdk3/gdk-Windows.html#GdkWindow">GdkWindow</a> * <a class="link" href="GtkSocket.html#gtk-socket-get-plug-window" title="gtk_socket_get_plug_window ()">gtk_socket_get_plug_window</a> (<code><a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a> *socket_</code>);

</pre>

</div>

101

102

103

104

<a name="id1232494"></a>Example 59. Obtaining the window ID of a socket.

104

<a name="id1329033"></a>Example 59. Obtaining the window ID of a socket.

105

106

107

<tbody>

124

* the ancestors of the socket is not yet visible.

125

*/

126

<a href="GtkWidget.html#gtk-widget-realize">gtk_widget_realize</a> (socket);

127

<a href="http://library.gnome.org/devel/glib/unstable/glib-Warnings-and-Assertions.html#g-print">g_print</a> ("The ID of the sockets window is %<GTKDOCLINK HREF="x">x</GTKDOCLINK>\n",

127

g_print ("The ID of the sockets window is %<GTKDOCLINK HREF="x">x</GTKDOCLINK>\n",

128

<a href="GtkSocket.html#gtk-socket-get-id">gtk_socket_get_id</a> (socket));</pre></td>

129

</tr>

130

</tbody>

143

consequence being that the plug will appear as a

144

separate toplevel window. You can check if the plug

145

has been created by using <a class="link" href="GtkSocket.html#gtk-socket-get-plug-window" title="gtk_socket_get_plug_window ()"><code class="function">gtk_socket_get_plug_window()</code></a>. If

146

it returns a non-<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> value, then the plug has been

146

it returns a non-<a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a> value, then the plug has been

147

successfully created inside of the socket.

148

149

207

208

<a name="gtk-socket-steal"></a><h3>gtk_socket_steal ()</h3>

209

<pre class="programlisting">void gtk_socket_steal (<code><a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a> *socket_</code>,

210

<code><a href="../gdk/gdk-Event-Structures.html#GdkNativeWindow">GdkNativeWindow</a> wid</code>);</pre>

210

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkNativeWindow">GdkNativeWindow</a> wid</code>);</pre>

211

212

<h3 class="title">Warning</h3>

213

<code class="literal">gtk_socket_steal</code> is deprecated and should not be used in newly-written code.

244

245

<a name="gtk-socket-add-id"></a><h3>gtk_socket_add_id ()</h3>

246

<pre class="programlisting">void gtk_socket_add_id (<code><a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a> *socket_</code>,

247

<code><a href="../gdk/gdk-Event-Structures.html#GdkNativeWindow">GdkNativeWindow</a> window_id</code>);</pre>

247

<code><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkNativeWindow">GdkNativeWindow</a> window_id</code>);</pre>

248

249

Adds an XEMBED client, such as a <a class="link" href="GtkPlug.html" title="GtkPlug">GtkPlug</a>, to the <a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a>. The

250

client may be in the same process or in a different process.

282

<hr>

283

284

<a name="gtk-socket-get-id"></a><h3>gtk_socket_get_id ()</h3>

285

<pre class="programlisting"><a href="../gdk/gdk-Event-Structures.html#GdkNativeWindow">GdkNativeWindow</a> gtk_socket_get_id (<code><a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a> *socket_</code>);</pre>

285

<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk3/gdk-Event-Structures.html#GdkNativeWindow">GdkNativeWindow</a> gtk_socket_get_id (<code><a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a> *socket_</code>);</pre>

286

287

Gets the window ID of a <a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a> widget, which can then

288

be used to create a client embedded inside the socket, for

312

<hr>

313

314

<a name="gtk-socket-get-plug-window"></a><h3>gtk_socket_get_plug_window ()</h3>

315

<pre class="programlisting"><a href="../gdk/gdk-Windows.html#GdkWindow">GdkWindow</a> * gtk_socket_get_plug_window (<code><a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a> *socket_</code>);</pre>

315

<pre class="programlisting"><a href="http://library.gnome.org/devel/gdk3/gdk-Windows.html#GdkWindow">GdkWindow</a> * gtk_socket_get_plug_window (<code><a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a> *socket_</code>);</pre>

316

317

Retrieves the window of the plug. Use this to check if the plug has

318

been created inside of the socket.

329

</tr>

330

<tr>

331

<td>Returns :</td>

332

<td>the window of the plug if available, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

332

<td>the window of the plug if available, or <a href="/home/mclasen/gnome/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL--CAPS"><code class="literal">NULL</code></a>. [<acronym title="Don't free data after the code is done.">transfer none</acronym>]

333

</td>

334

</tr>

335

</tbody>

342

343

<a name="GtkSocket-plug-added"></a><h3>The <code class="literal">"plug-added"</code> signal</h3>

344

<pre class="programlisting">void user_function (<a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a> *socket_,

345

<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer">gpointer</a> user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>

345

gpointer user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>

346

347

This signal is emitted when a client is successfully

348

added to the socket.

367

<hr>

368

369

<a name="GtkSocket-plug-removed"></a><h3>The <code class="literal">"plug-removed"</code> signal</h3>

370

<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean">gboolean</a> user_function (<a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a> *socket_,

371

370

<pre class="programlisting">gboolean user_function (<a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a> *socket_,

371

gpointer user_data) : <a href="http://library.gnome.org/devel/gobject/unstable/gobject-Signals.html#G-SIGNAL-RUN-LAST:CAPS"><code class="literal">Run Last</code></a></pre>

372

373

This signal is emitted when a client is removed from the socket.

374

The default action is to destroy the <a class="link" href="GtkSocket.html" title="GtkSocket">GtkSocket</a> widget, so if you

375

want to reuse it you must add a signal handler that returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>.

375

want to reuse it you must add a signal handler that returns <code class="literal">TRUE</code>.

376

377

378

391

<tr>

392

<td>Returns :</td>

393

<td>

394

<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to stop other handlers from being invoked.</td>

394

<code class="literal">TRUE</code> to stop other handlers from being invoked.</td>

395

</tr>

396

</tbody>

397

</table></div>

404

</div>

405

406

<hr>

407

Generated by GTK-Doc V1.18</div>

407

Generated by GTK-Doc V1.18.1</div>

408

</body>

409

</html>

b'\\ No newline at end of file'

Older »