#
Prev |  | Next

# plug

## Name

plug -- Toplevel to embed into another process

## Synopsis

plug [`-option` `value`...]

## Options

-child

  type: widget-ID

  Widget ID of the child.

-socketID

  type: string (default: "")

  ID of the window in which to embed. This cannot be changed after creation.

-visible

  type: boolean (default: 1)

  Whether or not the item is visible.

-onDestroy

  type: string (default: "")

  Tcl command which is executed if the widget is destroyed. Before evaluation the following percent strings are substituated: TABLE %% | % %w | widget name. TABLE

## Description

With a plug widget a process can be embedded in another process using the XEMBED protocol. The GUI of the other process does not have to be written in GTK+ or Gnocl. Qt, Tcl/Tk or pure X should work just fine. If the other side uses Gnocl, it should use the socket widget. The plug widget can either be embedded by setting the -socketID option, or by setting the -plugID option of the socket. REMARK: embedding in Tk does not work. Any hint why is appreciated.

## Commands

`id` delete

  Deletes the widget and the associated tcl command.

`id` configure [`-option` `value`...]

  Configures the widget. Option may have any of the values accepted on creation of the widget.

`id` getID

  Returns the window ID of the plug widget.

## See also

socket, `GtkPlug`

Prev | Home | Next
eventBox | Up | socket