| GTK+ Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | Properties | Signals | ||||
#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);
gboolean gtk_plug_get_embedded (GtkPlug *plug);
GdkWindow * gtk_plug_get_socket_window (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.
|
a GtkPlug. |
|
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.
|
a GtkPlug. |
|
the GdkDisplay associated with socket_id's
GtkSocket.
|
|
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().
|
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.
|
the GdkDisplay on which socket_id is displayed
|
|
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().
|
a GtkPlug. |
Returns : |
the window ID for the plug |
gboolean gtk_plug_get_embedded (GtkPlug *plug);
Determines whether the plug is embedded in a socket.
|
a GtkPlug |
Returns : |
TRUE if the plug is embedded in a socket
|
Since 2.14
"embedded" property"embedded" gboolean : Read
TRUE if the plug is embedded in a socket.
Default value: FALSE
Since 2.12
"socket-window" property"socket-window" GdkWindow* : Read
The window of the socket the plug is embedded in.
Since 2.14