callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Speak of window IDs rather than XIDs in the docs.

Browse Source 
* gtk/gtkplug.c, gtk/gtksocket.c: Speak of window IDs rather
        than XIDs in the docs.

        * gtk/gtkclipboard.c (gtk_clipboard_clear): Fix docs.

        * gtk/tmpl/gtksocket.sgml, gtk/tmpl/gtkplug.sgml: speak of
        window IDs rather than XIDs.
This commit is contained in:
Matthias Clasen
2002-01-09 00:02:30 +00:00
parent 9f35f36661
commit 4127a267f1
13 changed files with 80 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
docs/reference/ChangeLog
View File

@ -1,3 +1,8 @@
2002-01-08 Matthias Clasen <matthiasc@poet.de>
* gtk/tmpl/gtksocket.sgml, gtk/tmpl/gtkplug.sgml: speak of
window IDs rather than XIDs.
2002-01-07 Matthias Clasen <matthiasc@poet.de>
* gtk/tmpl/gtksocket.sgml: Mention gtk_socket_get_id()

15
docs/reference/gtk/tmpl/gtkplug.sgml
View File

@ -10,8 +10,8 @@ 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
XID of that widgets window to the other process,
which then creates a #GtkPlug window with that XID.
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.
</para>
@ -36,22 +36,23 @@ inside the first applications window.
<!-- ##### FUNCTION gtk_plug_construct ##### -->
<para>
Finish the creation of a #GtkPlug widget. This function
Finishes the creation of a #GtkPlug widget. This function
will generally only be used by classes deriving
from #GtkPlug.
</para>
@plug: a #GtkPlug widget.
@socket_id: the XID of the socket's window.
@socket_id: the window ID of the socket.
<!-- ##### FUNCTION gtk_plug_new ##### -->
<para>
Create a new plug widget inside the #GtkSocket identified
by @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().
</para>
@socket_id: the XID of the socket's window.
@socket_id: the window ID of the socket, or 0.
@Returns: the new #GtkPlug widget.

19
docs/reference/gtk/tmpl/gtksocket.sgml
View File

@ -10,20 +10,20 @@ Together with #GtkPlug, #GtkSocket 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
XID of that widget's window to the other process,
which then creates a #GtkPlug window with that XID.
that widget's window ID 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.
</para>
<para>
The XID of the socket's window is obtained by using
The socket's window ID is obtained by using
gtk_socket_get_id(). Before using this function,
the socket must have been realized, and for hence,
have been added to its parent.
<example>
<title>Obtaining the XID of a socket.</title>
<title>Obtaining the window ID of a socket.</title>
<programlisting>
GtkWidget *socket = gtk_socket_new (<!>);
gtk_widget_show (socket);
@ -33,14 +33,14 @@ gtk_container_add (GTK_CONTAINER (parent), socket);
* the ancestors of the socket is not yet visible.
*/
gtk_widget_realize (socket);
g_print ("The XID of the sockets window is %#x\n",
g_print ("The ID of the sockets window is %#x\n",
gtk_socket_get_id (socket));
</programlisting>
</example>
</para>
<para>
Note that if you pass the XID of the socket to another
Note that if you pass the window ID of the socket to another
process that will create a plug in the socket, you
must make sure that the socket widget is not destroyed
until that plug is created. Violating this rule will
@ -82,13 +82,12 @@ as between a #GtkPlug and a #GtkSocket.</para>
<!-- ##### STRUCT GtkSocket ##### -->
<para>
The #GtkSocket structure contains the following field.
(This field should be considered read-only. It should
The #GtkSocket structure contains the <structfield>plug_window</structfield>
field. (This field should be considered read-only. It should
never be set by an application.)
</para>
@plug_window:
the window embedded inside this #GtkSocket.
@plug_window: the window embedded inside this #GtkSocket.
<!-- ##### FUNCTION gtk_socket_new ##### -->