|
|
|
GTK+ Reference Manual | |
|---|---|---|---|---|
#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);
GObject
+----GInitiallyUnowned
+----GtkObject
+----GtkWidget
+----GtkContainer
+----GtkBin
+----GtkWindow
+----GtkPlug
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.
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. |
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
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. |
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
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 |
void user_function (GtkPlug *plug, gpointer user_data) : Run Last
plug : |
the object which received the signal. |
user_data : |
user data set when the signal handler was connected. |