Package: gtk

Class gtk:plug

Superclasses

gtk:window, gtk:bin, gtk:container, gtk:widget, gtk:buildable, gobject:object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

None

Direct Slots

embedded
The embedded property of type :boolean (Read)
True if the plug is embedded in a socket.
Default value: false
socket-window
The socket-window property of type gdk:window (Read)
The window of the socket the plug is embedded in.

Details

Together with the gtk:socket widget, the gtk:plug widget 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 gtk:socket widget and passes the ID of that widget's window to the other process, which then creates a gtk:plug widget with that window ID. Any widgets contained in the gtk:plug widget then will appear inside the first application's window.

The communication between a gtk:socket and a gtk:plug widget follows the XEmbed protocol. This protocol has also been implemented in other toolkits, e.g. Qt, allowing the same level of integration when embedding a Qt widget in GTK or vice versa.

The gtk:plug and gtk:socket widgets are only available when GTK is compiled for the X11 platform and GDK_WINDOWING_X11 is defined. They can only be used on a GdkX11Display object.

Signal Details

The "embedded" signal
lambda (plug)    :run-last      
Gets emitted when the plug becomes embedded in a socket.
plug
The gtk:plug widget on which the signal was emitted.
 

Slot Access Functions

Inherited Slot Access Functions

gtk:widget-app-paintable
gtk:widget-can-default
gtk:widget-can-focus
gtk:widget-composite-child
gtk:widget-double-buffered
gtk:widget-events
gtk:widget-expand
gtk:widget-focus-on-click
gtk:widget-halign
gtk:widget-has-default
gtk:widget-has-focus
gtk:widget-has-tooltip
gtk:widget-height-request
gtk:widget-hexpand
gtk:widget-hexpand-set
gtk:widget-is-focus
gtk:widget-margin
gtk:widget-margin-bottom
gtk:widget-margin-end
gtk:widget-margin-left
gtk:widget-margin-right
gtk:widget-margin-start
gtk:widget-margin-top
gtk:widget-name
gtk:widget-no-show-all
gtk:widget-opacity
gtk:widget-parent
gtk:widget-receives-default
gtk:widget-scale-factor
gtk:widget-sensitive
gtk:widget-style
gtk:widget-tooltip-markup
gtk:widget-tooltip-text
gtk:widget-valign
gtk:widget-vexpand
gtk:widget-vexpand-set
gtk:widget-visible
gtk:widget-width-request
gtk:widget-window
gtk:window-accept-focus
gtk:window-application
gtk:window-attached-to
gtk:window-decorated
gtk:window-default-height
gtk:window-default-width
gtk:window-deletable
gtk:window-destroy-with-parent
gtk:window-focus-on-map
gtk:window-focus-visible
gtk:window-gravity
gtk:window-has-resize-grip
gtk:window-has-toplevel-focus
gtk:window-hide-titlebar-when-maximized
gtk:window-icon
gtk:window-icon-name
gtk:window-is-active
gtk:window-mnemonics-visible
gtk:window-modal
gtk:window-opacity
gtk:window-resizable
gtk:window-resize-grip-visible
gtk:window-role
gtk:window-screen
gtk:window-skip-pager-hint
gtk:window-skip-taskbar-hint
gtk:window-startup-id
gtk:window-title
gtk:window-transient-for
gtk:window-type
gtk:window-type-hint
gtk:window-urgency-hint
gtk:window-window-position
gtk:container-border-width
gtk:container-child
gtk:container-resize-mode
g:object-has-reference
g:object-pointer

See also

#2023-2-28