UIFC

UIFC (User InterFaCe) is the text mode full-screen user interface library used by SCFG, echocfg, and others. It was originally inspired by the text mode user interface for NetWare 2.x server management utilities for DOS (e.g. SYSCON), and was written from scratch by Digital Man.

Over the years, a few different implementations have been ported/written.

The original DOS 16-bit implementation, initialized using uifcini(). This implementation is no longer supported and may have problems due to the size of integers.

The 32-bit port of the DOS version, initialized using uifcini32(). This is the best supported version and is reccomended for effectively every use.

The command-line version using standard I/O, initialized using uifcinix(). This version is a “last resort” type of implementation. Many features don't work as intended and it can be difficult to navigate the menus. it is intended to work though.

The Javascript implementation that can be utilized with jsexec.js.

In most environments, UIFC applications support mouse input:

• Left-click to select a menu option
• Left-click outside of active window to move backwards
• Right-click to move backwards/exit
• Left-click [■] to move backwards/exit
• Left-click [?] for a context-sensitive help screen
• Left-click ▼ to scroll down one page
• Left-click ▲ to scroll up one page

See JavaScript Object Reference

When using uifc.list, you can pass the WIN_SAV option, along with a context object to preserve the menu selection index.

The context object is created as follows:

var ctx = new uifc.list.CTX(
  0, // current
  0, // bar
  0, // left
  0, // top
  0 // width
);

Use these masks to check for specific inputs.

Example Javascript Usage:

if ((selection & MSK_ON) == MSK_DEL) {
    // delete key pressed
    selection &= MSK_OFF;
}