next up previous contents
Next: Recompiling the System Up: More Advanced Features Previous: Using XLISP-STAT With NT

Other Functions

The function msw-free-mem returns the total amount of free global memory that is available in Windows.

The system function takes a command string and an optional state argument and WinExec's the command string. If the command starts a windows application then the application starts iconified if the state arguments is nil and normal if the argument is t, the default. Thus

(system "clock")
starts up a clock in normal state and
(system "clock" nil)
starts up an iconified clock. The result returned is either t if the WinExec succeeds or nil if it fails. On failure, a numerical error code is returned as the second value.

The function msw-win-help provides a minimal interface to the windows WinHelp function. Two arguments are required, a string naming the help file to be used, and a symbol specifying the type of help requested. The keyword symbols :help, :context, :index, :key, and :quit are currently supported. Context help requires an additional integer argument, and key help requires an additional key string. For example,

(msw-win-help "calc.hlp" :index)
opens help for the calculator application at the contents section. No Windows help file for XLISP-STAT is available at this time, but this function provides the necessary hook for using such a file if it becomes available.

The functions msw-tile, msw-cascade, msw-close-all, and msw-arrange-icons implement the corresponding actions on the Windows menu. These functions take no arguments.

The functions msw-get-profile-string and msw-write-profile-string can be used to access and modify user preference information. They require three and four arguments, respectively. The first and second arguments specify the section and item names as strings, and the last argument specifies the preference file name. A preference file name of nil refers to the system preference file. For msw-write-profile-string the third argument is a new value. This can be a string or nil; if it is nil, the entry is deleted. This function deletes a section if the item argument is nil.


next up previous contents
Next: Recompiling the System Up: More Advanced Features Previous: Using XLISP-STAT With NT

Luke Tierney
Mon Aug 30 09:50:11 CDT 1999