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