Next: , Previous: , Up: Top   [Contents]

1 Using an External Client Widget

There are three different implementations of the external client widget. One is designed for use in Motif applications and is linked with the option -lextcli_Xm. Another is designed for non-Motif applications that still use the X toolkit; it is linked with the option -lextcli_Xt. The third is designed for applications that do not use the X toolkit; it is linked with the option -lextcli_Xlib. In order to use an external client widget in a client program that uses the X toolkit (i.e. either of the first two options described above), simply create an instance of widget type ExternalClient and link your program with the appropriate library. The corresponding header file is called ExternalClient.h.

Documentation still needs to be provided for using the raw Xlib version of the external client widget.

The external client widget will not do anything until an instance of Emacs is told about this particular widget. To do that, call the function make-frame, specifying a value for the frame parameter window-id. This value should be a string containing the decimal representation of the widget’s X window ID number (this can be obtained by the Xt function XtWindow()).

Once make-frame has been called, Emacs will create a frame that occupies the client widget’s window. This frame can be used just like any other frame in Emacs.