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.

The UIFC library uses the Synchronet Console I/O Library (CIOLIB).

UIFC apps are often not pretty when run from within Windows Terminal (wt.exe). To use the legacy Windows Console Host instead, run conhost.exe and pass the path and arguments to the UIFC application on the command-line.

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

The C API is exposed through the header file: uifc.h.

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.

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;
}