DOSWinOpen

Purpose

Opens the DOS compatibility window and gives it the specified title and attributes.

Warning

This function is no longer supported. This documentation is provided as a reference for understanding legacy code. In many cases, you may simply comment out calls to DOSWinOpen() and the program will run successfully in the Command window.

Format

ret = DOSWinOpen(title, attr)

Parameters:

• title (string) – window title.

• attr (5x1 vector or scalar missing) –

  window attributes.

  [1]	window x position
  [2]	window y position
  [3]	text foreground color
  [4]	text background color
  [5]	close action bit flags
  	bit 0 (1’s bit)	issue dialog
  	bit 1 (2’s bit)	close window
  	bit 2 (4’s bit)	stop program

Returns:

ret (scalar) – success flag, 1 if successful, 0 if not.

Examples

attr = { 50, 50, 7, 0, 7 };

if not DOSWinOpen("Legacy Window", attr);
   errorlog "Failed to open DOS window, aborting";
   stop;
endif;

This example opens the DOS window at screen location (50,50), with white text on a black background. The close action flags are 4 + 2 + 1 (stop program + close window + issue confirm dialog) = 7. Thus, if the user attempts to close the window while a program is running, he/she will be asked for confirmation. Upon confirmation, the window will be closed and the program terminated.

Remarks

If title is a null string ("") the window will be titled "GAUSS-DOS".

Defaults are defined for the elements of attr. To use the default, set an element to a missing value. Set attr to a scalar missing to use all defaults. The defaults are defined as follows:

[1]	varies	use x position of previous DOS window
[2]	varies	use y position of previous DOS window
[3]	7	white foreground
[4]	0	black background
[5]	6	4+2: stop program and close window without confirming

If the DOS window is already open, the new title and attr will be applied to it. Elements of attr that are missing are not reset to the default values, but are left as is.

To set the close action flags value (attr[5]), just sum the desired bit values. For example:

stop program (4) + close window (2) + confirm close (1) = 7

The close action flags are only relevant when a user attempts to interactively close the DOS window while a program is running. If GAUSS is idle, the window will be closed immediately. Likewise, if a program calls DOSWinCloseall(), the window is closed, but the program does not get terminated.