The CMUCL Motif Toolkit - Common Lisp.net

More documents

Recommendations

Info

2.1 Variables controlling connections*DEFAULT-SERVER-HOST* A string naming the machine where the Motifserver is to be found. The default is NIL, which causes a connection to bemade using a Unix domain socket on the local machine. Any other name mustbe a valid machine name, and the client will connect using Internet domainsockets.*DEFAULT-DISPLAY* Determines the display on which to open windows.The default value of NIL instructs the system to consult the DISPLAY environmentvariable. Any other value must be a string naming a valid X display.*DEFAULT-TIMEOUT-INTERVAL* An integer specifying how many secondsthe Lisp process will wait for input before assuming that the connection to theserver has timed out.2.2 Handling ConnectionsOPEN-MOTIF-CONNECTION (hostname xdisplay-name app-name app-class)Opens a connection to a server on the named host and opens a display connectionto the named X display. The app-name and app-class are for definingthe application name and class for use in resource specifications. An optionalprocess-id argument can be passed if a local server process has already beencreated. This returns a MOTIF-CONNECTION object.CLOSE-MOTIF-CONNECTION (connection) This closes a toolkit connectionwhich was created by OPEN-MOTIF-CONNECTION.*MOTIF-CONNECTION* Bound in contexts such as callback handlers to thecurrently active toolkit connection.*X-DISPLAY* Bound in contexts such as callback handlers to the currentlyactive CLX display.WITH-MOTIF-CONNECTION ((connection) &body forms) This macroestablishes the necessary context for invoking toolkit functions outside of callback/eventhandlers.WITH-CLX-REQUESTS (&body forms) Macro that ensures that all CLXrequests made within its body will be flushed to the X server before proceedingso that Motif functions may use the results.RUN-MOTIF-APPLICATION (init-function) This is the standard CLMentry point for creating a Motif application. The init-function argument willbe called to create and realize the interface. It returns the created MOTIF-CONNECTION object. Available keyword arguments are:2
:init-args:application-class:application-name:server-host:displaylist of arguments to pass to init-functionapplication class (default "Lisp")application name (default "lisp")name of Motif server to connect toname of X display to connect toQUIT-APPLICATION () This is the standard function for closing down aMotif application. You can call it within your callbacks to terminate the application.3 The ServerThe C server is run by the motifd program. This will create both Inet andUnix sockets for the Lisp client to connect to. By default, the Inet and Unixsockets will be specific to the user.When a Lisp client connects to the server, it forks a copy of itself. Thus eachLisp application has an exclusive connection to a single C server process. Toterminate the server, just Ĉ it.Switches to change behavior:-global-local-noinet-nounix-nofork-traceSockets created for use by everyone rather than being userspecific.No Inet socket is created and the Unix socket is process-specificInstructs the server not to create an Inet socket.Instructs the server not to create a Unix socket.Will keep the server from forking when connections are made.This is useful when debugging the server or when you wantthe server to die when the application terminates.Will spit out lots of stuff about what the server is doing. This isonly for debugging purposes.Typically, users do not need to be concerned with server switches since, bydefault, servers are created automatically by your Lisp process. However, ifyou wish to share servers, or use servers across the network, you will need torun the server manually.4 Widget creationCREATE-APPLICATION-SHELL (&rest resources)widget for a new Motif application.Creates the applicationShellCREATE-WIDGET, CREATE-MANAGED-WIDGET (name class parent &restresources) These create new widgets. CREATE-WIDGET does not automaticallymanage the created widget, while CREATE-MANAGED-WIDGET does.CREATE- (parent name &rest resources) Conveniencefunction which creates a new widget of class . Forinstance, CREATE-FORM will create a new XmForm widget.3
Page 1: The CMUCL Motif ToolkitApril 17, 20
Page 5 and 6: (with-callback-deferred-actions(wit
Page 7 and 8: 10 A brief exampleThe following giv

The CMUCL Motif Toolkit - Common Lisp.net

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?