RedHad系统安装窗口界面开发库NEWT

一、简介

       NEWT是在Linux下一个基于文本方式的窗口开发工具，最初是为RedHad Linux的安装程序而设计的。NEWT提供C语言的应用程序接口（API），它不直接进行低级屏幕操作，是在S-Lang库上实现的。编程时包含头文件#include <newt.h>，在Linux上用gcc编译时带-lnewt 参数。
       考虑到 Red Hat Linux 有软盘安装这一安装方式，安装代码运行于有限的资源环境中，特别是在有限的文件空间中。NEWT 的大小一开始就成为一个重要的问题。为了最小化它所占的空间，NEWT 的设计思想有下面几点：（1）NEWT由C语言写成，而不是Ｃ++；（2）NEWT所有窗口的生成都是基于堆栈的数据结构，窗口的外观都是统一的模板，不由程序员修改；（3）输入设备只支持终端键盘。
      Linux系统安装过程NEWT的界面：

二、详解

1、简单程序      

#include <stdio.h>#include <newt.h>int main(){  newtInit();  newtCls();    int rc = newtWinChoice(("Disc Found"), ("OK"), ("Skip"),             ("To begin testing the media before installation press %s.\n\n"              "Choose %s to skip the media test and start the installation."),             ("OK"), ("Skip"));  if (rc == 1) {     newtDrawRootText(0,0,"you choose:ok");     newtRefresh();  }  sleep(3);  newtFinished();  return 0;}

编译：gcc -o newt newt.c -lnewt
运行：
   

2、NEWT解析

（1）组件(Components)
       每在NEWT中，每一个可显示的项目称为组件。组件主要有两类：Form组件与非Form组件。非Form组件是除Form以外的所有组件。Form逻辑地组织各个组件成为一个功能集。Form是一个容器组件，让其他组件都装在其上，有点类似gtk+中的垂直盒(Vbox)和水平盒(Hbox)。当一个应用准备从用户中获得输入，就要run一个Form，这也类似于gtk+中的gtk_widget_show()。Form组件可以包含其他任何组件，也包含其他的Form作为子Form。
       每一个组件都是由一个属于newtComponent数据类型的变量唯一标志，这一变量必须由生成该组件的函数建立，而不能由程序员自己建立。属于newtComponent数据类型的变量其实只是一个指针。
 （2）NEWT程序的开始与结束

int newtInit(void); void newtCls(void);

      newtInit()必须是每个NEWT程序第一个调用的函数，用于初始化数据结构和重置终端于raw模式。大多数应用在newtInit()后立即调用newtCls()，newtCls()用于清除屏幕（这个函数不是必须的，但有助于优化屏幕）。
       当一个NEWT程序准备结束时，就要调用以下函数。

int newtFinished(void);

       newtFinished()恢复终端在调用newtInit()前的状态，重置原来的输入状态。若没调用这函数，终端需重启才能回到命令行状态。
（3）编译NEWT程序
在Linux上用gcc编译时带-lnewt参数。以下所说的函数都可在/usr/include/newt.h（Red Hat Linux 7.1）中找到。
NEWT定义了若干个标志 (FLAG)，这里仅介绍常用的几个（若要使用多个标志，可对多个标志进行与操作 ('|'））：
NEWT_FLAG_RETURNEXIT    当在组件上按回车时程序退出
NEWT_FLAG_HIDDEN             输入不回显，大多数应用在输入密码的情况
NEWT_ENTRY_SCROLL         允许滚动输入
NEWT_FLAG_WRAP               换行时整个单词换行
NEWT_FLAG_BORDER          加边框
NEWT_FLAG_MULTIPLE        允许多选
（4）根窗口（root window）
       终端所显示的背景，只有不被任何窗口遮盖的部分称为根窗口。一般地，应用不需使用到根窗口，而把文字写到属于自己的窗口上。所有组件都不应放在根窗口上。根窗口只用于显示一些辅助信息，例如程序的作者姓名、版本等。NEWT提供两种在根窗口显示文字的方式，它们是唯一能越出组件自己当前窗口写文字的NEWT函数。

void newtDrawRootText(int left, int top, const char *text);

       该函数用于在根窗口指定位置写出text字苻串，left和top为字苻串text的开始处，left是屏幕x坐标，top是屏幕y坐标。Left和top允许为负数。屏幕坐标原点在显示器的左上角，x坐标从原点出发至左向右增大，y坐标从原点出发至上向下增大。点(10,5)表示以左上角为原点x=10,y=5,而left,top为负，表与为正数方向相对。点(－10,5)表以右上角为原点x=10，因此点(10,5)与点(-10,5)在屏幕左右两边相对，同理点(10,5)与点(10,-5)在屏幕上下两边相对。
       在文本方式下，通常屏幕的最后一行用于显示帮助信息，如每个快捷键所对应的功能等。这一提示行称为帮助行（help line）。正如前面所述，NEWT是基于堆栈，压栈Push操作显示帮助行，出栈Pop操作删除帮助行。基于栈的操作后面还回遇到。

void newtPushHelpLine(const char * text); void newtPopHelpLine(void);

          newtPushHelpLine()用于显示帮助行，text为所要显示的字苻串指针，若为NULL则显示缺省的帮助行。NewtPopHelpLine()则删除帮助行。
（5）非正常退出
       在缺省情况下，NEWT程序不能非正常退出，尽管大多数Unix程序可以通过按Ctrl-z强迫退出，但在NEWT不支持此功能。因NEWT初始化时屏蔽所有终端信号。

typedef void (*newtSuspendCallback)(void); void newtSetSuspendCallback(newtSuspendCallback cb);

        但可通过调用newtSetSuspendCallback()实现Ctrl-z强迫退出的功能，cb是相应的回调函数，它不带参数，只做清理工作，如newtFinished（）等。早期Red Hat Linux的安装程序当运行到硬盘分区时，若你使用Fdisk则屏幕回到命令行状态运行Fdisk进行分区，退出Fdisk时又回到当前窗口。要实现这种功能，在回调函数中加入下面两个函数：

void newtSuspend(void); void newtResume(void);

       newtSuspend()告诉NEWT程序回到终端初始化前的状态，做需要做的工作。如需要回到NEWT界面，调用newtResume()恢复。
（6）窗口
生成窗口有两种主要方式：

int newtCenteredWindow(int width, int height, const char * title); int newtOpenWindow(int left, int top, int width, int height, const char * title);

       由名字可知,newtCenteredWindow()在屏幕中心生成窗口，width为窗口宽度，height为窗口高度，title为窗口标题字串指针，标题文字为红色。由newtOpenWindow()生成的窗口位置由left,top 确定，其余参数同上。
       所有窗口的删除都是用同一种方式，由于NEWT是基于堆栈来操作，只有在栈顶的窗口才能被删除，位于栈顶的窗口即当前你能看到的不被任何其他窗口遮盖的窗口。

void newtPopWindow(void);

      这函数删除屏幕最顶层的窗口，并重画被该窗口遮盖的部分。
（7）Form
正如前述那样，Form是一个容器组件，同一时间只能生成一个Form，所有组件都必须放在Form上，然后运行它。生成一个Form用以下函数：

newtComponent newtForm(newtComponent vertBar, const char * help, int flags);

       vertBar是垂直滚动条，help是提示信息，通常这两个参数都不会用到，用NULL即可，flags就是前述的标志。该函数返回标志所生成的Form 的变量。
        把组件放在 Form 上用以下函数：

void newtFormAddComponent(newtComponent form, newtComponent co); void newtFormAddComponents(newtComponent form, ...);

        newtFormAddComponent()只放一个组件在Form上，而newtFormAddComponents()则可放多个组件，最后用NULL结束。然后就运行它：

newtComponent newtRunForm(newtComponent form);

其中Form参数是newtForm()返回的变量。
删除一个 Form（当一个Form被删除时，其上的组件一同被删除，并释放内存资源）：

void newtFormDestroy(newtComponent form);

（8）按钮
        几乎所有的Form都包含最小一个按钮。按钮分两类：完全按钮(full button)和紧缩按钮(compact button)。完全按钮富有立体感，紧缩按钮则单调些。

newtComponent newtButton(int left, int top, const char * text);newtComponent newtCompactButton(int left, int top, const char * text);

       newtButton()生成完全按钮，letf，top指定该按钮位置，text是指向按钮文字的指针，该函数返回按钮的newtComponent变量。NewtCompactButton()生成紧缩按钮，参数及返回值同上。
（9）标签
标签是NEWT程序最简单的组件，用于显示给定的文本但不允许用户输入。

newtComponent newtLabel(int left, int top, const char * text); void newtLabelSetText(newtComponent co, const char * text);

       newtLabel()生成标签组件，并返回它的newtComponent变量，参数left,top指定标签组件位置，text为给定的文本。NewtLabelSetText()用于动态改变标签组件的文字，co是要改变的标签组件，test是要改变的字串指针。
（10）输入盒(Entry Box)
输入盒可让用户输入字符串到 Form 中然后由应用接收。

newtComponent newtEntry(int left, int top, const char * initialValue, int width,char ** resultPtr, int flags); void newtEntrySet(newtComponent co, const char * value, int cursorAtEnd); char * newtEntryGetValue(newtComponent co);

        newtEntry()生成输入盒组件，其中initialValue为初始化字符串指针，若不需则用NULL，width为宽度，resultPtr为指向当前输入的字符，flags为标志。Flags设为NEWT_ENTRY_SCROLL，当输入的字串长度等于输入盒的宽度时输入盒将往后滚动，否则不能再输入；Flags设为 NEWT_FLAG_HIDDEN输入不回显，主要应用于输入密码方面。NewtEntrySet()用于动态地改变输入盒的内容，value为字符串指针，cursorAtEnd实质是一个逻辑变量，由于C语言没有逻辑类型变量，仅用int代替，若为0则表TRUE，指定光标跟随，非0光标不跟随输入。NewtEntryGetValue()返回输入的字串。
（11）检查盒 (Checkbox)
检查盒可对其代表的内容通过按空格键切换预定的各种状态。

newtComponent newtCheckbox(int left, int top, const char * text, char defValue,const char * seq, char * result); char newtCheckboxGetValue(newtComponent co);

        newtCheckbox()生成一个检查盒，text标明它所代表的内容，defValue为缺省值也即初始值，seq为切换的顺序，result指向当前状态。如 defValue='@'，seq="@*X"，则初始时为[@]，当按空格键＝＝》[*]再按空格键＝＝》 [X]，如此循环。若result为NULL则需NewtCheckboxGetValue()获取当前状态。
（12）单选按钮(Radio Button)
单选按钮的外观与检查盒非常相似。不同的是单选按钮是由若干个组成一个集合，当一个单选按钮被选中时，其他单选按钮则被清除。若集合中只有一个单选按钮，它总会被选中，因而就失去了选择的意义。

newtComponent newtRadiobutton(int left, int top, const char * text, int isDefault, newtComponent prevButton); newtComponent newtRadioGetCurrent(newtComponent setMember);

       newtRadiobutton()建立单选按钮集合，text为代表单选按钮的字符串指针，isDefault是逻辑开关，为1表逻辑TRUE, 初始状态为选中；为0表FALSE，初始状态为不选中。若当前单选按钮是集合中的第一个，prevButton为NULL让newtRadiobutton()自动建立一个集合；若不是第一个，prevButton为前一个由newtRadiobutton()生成的单选按钮。
（13）范围(Scale)
范围组件通常用于制作水平进度条。

newtComponent newtScale(int left, int top, int width, long long fullValue); void newtScaleSet(newtComponent co, unsigned long long amount);

       newtScale()生成水平进度条，width为宽度，fullValue为进度条的最大值。NewtScaleSet()用于设置进度条的值。
（14）文本盒 (Textbox)
        文本盒能让终端显示一个文本块。newtTextbox()建立一个文本盒，其中flags可设为NEWT_FLAG_WRAP、NEWT_FLAG_SCROLL和它们的与操作。文本盒建立后，由newtTextbox()填充文本。

newtComponent newtTextbox(int left, int top, int width, int height, int flags); void newtTextboxSetText(newtComponent co, const char * text);

（15）滚动条(Scrollbar)

newtComponent newtVerticalScrollbar(int left, int top, int height, int normalColorset, int thumbColorset);

       newtVerticalScrollbar()生成滚动条，normalColorset为滚动条颜色，thumbColorset为滚动块颜色。
（16）列表盒(Listboxe)
列表和是 NEWT 中最重要的组件，允许多选或单选。

newtComponent newtListbox(int left, int top, int height, int flags); int newtListboxAppendEntry(newtComponent co, const char * text, const void * data); void * newtListboxGetCurrent(newtComponent co); void newtListboxSetWidth(newtComponent co, int width); void newtListboxSetCurrent(newtComponent co, int num); void newtListboxSetCurrentByKey(newtComponent co, void * key);

       newtListbox()生产列表盒，flags可设为NEWT_FLAG_SCROLL、NEWT_FLAG_RETURNEXIT、NEWT_FLAG_BORDER、 NEWT_FLAG_MULTIPLE和它们的与操作。NewtListboxAppendEntry() 用于在当前列表盒最后追加一个列表项，每一个个列表项由key唯一标志，key可为任意类型，只要能和其他列表项区别开来就可以了。data为key数据。操作列表盒的函数还有：

void newtListboxSetEntry(newtComponent co, void * key, const char * text); int newtListboxInsertEntry(newtComponent co, const char * text, const void * data, void * key); int newtListboxDeleteEntry(newtComponent co, void * key); void newtListboxClear(newtComponent co);

3、范例

代码newt2.c：

#include <newt.h> #include <stdio.h> #include <stdlib.h>void rootwin_show() {        newtCls();        /* 请观察 left,top 为正数 , 为负数地情形 */        newtDrawRootText(0, 0, "左上角");        newtDrawRootText(-6, 0, "右上角");        newtDrawRootText(0, -3, "左下角");        newtDrawRootText(-6, -3, "右下角");        /* 注意 helpline 缺省时的内容 */        newtPushHelpLine(NULL);        newtRefresh();        sleep(10);        newtPushHelpLine("我的帮助行");        newtRefresh();        sleep(3);        newtPopHelpLine();        newtRefresh();        sleep(1); } void label_button() {        newtComponent form, label, entry, button,cb;        char * entryValue;        newtCls();        newtCenteredWindow(50,10,"输入与标签演示");        /*left,top 是相对于中心窗口而言 */        label = newtLabel(10, 1, "请输入 :");        entry = newtEntry(19, 1, NULL, 20, (const char **)&entryValue, NEWT_FLAG_SCROLL);        newtEntrySet(entry,"\0",0);        button = newtButton(10, 5, "完全按钮");        cb=newtCompactButton(25,5,"紧缩按钮");        form = newtForm(NULL,NULL, 0);        newtFormAddComponents(form, label, entry, button,cb, NULL);        newtRunForm(form);        if(*entryValue!='\0')        {                newtDrawRootText(0,0,"你输入了 :");                newtDrawRootText(12,0,entryValue);        }        else                newtDrawRootText(0,0,"无输入 !");        newtRefresh();        newtFormDestroy(form);        sleep(5); } void check_radio() {        newtComponent form, checkbox, rb[3], button,lable1,lable2;        char cbValue,cv[2];        int i;        newtCls();        newtOpenWindow(10, 8, 40, 11, "检查盒与单选盒演示");        lable1 = newtLabel(2, 1, "检查盒 :");        checkbox = newtCheckbox(10, 1, "A checkbox", ' ', " *X", &cbValue);        lable2 = newtLabel(2, 4, "单选盒 :");        rb[0] = newtRadiobutton(10, 3, "Choice 1", 1, NULL);        rb[1] = newtRadiobutton(10, 4, "Choice 2", 0, rb[0]);        rb[2] = newtRadiobutton(10, 5, "Choice 3", 0, rb[1]);        button = newtButton(15, 7, "退出");        form = newtForm(NULL, NULL, 0);        newtFormAddComponent(form, checkbox);        newtFormAddComponent(form, lable1);        newtFormAddComponent(form, lable2);        for (i = 0; i < 3; i++)                newtFormAddComponent(form, rb[i]);        newtFormAddComponent(form, button);        newtPushHelpLine("< 空格健 > 选择");        newtRefresh();        newtRunForm(form);        for (i = 0; i < 3; i++)                if (newtRadioGetCurrent(rb[0]) == rb[i])                {       newtDrawRootText(0, 0, "单选盒 :");                        newtDrawRootText(9, 0, "第");                        if(i==0)newtDrawRootText(11, 0,"1");                        if(i==1)newtDrawRootText(11, 0,"2");                        if(i==2)newtDrawRootText(11, 0,"3");                        newtDrawRootText(12, 0, "个");                 }        newtDrawRootText(0, 3, "检查盒状态 :");        cv[0]=cbValue;cv[1]='\0';        newtDrawRootText(13, 3, cv);        newtRefresh();        newtFormDestroy(form);        sleep(5); } void test() {        char message[] = "This is a pretty long message. It will be displayed "                "in a newt textbox, and illustrates how to construct "                "a textbox from arbitrary text which may not have "                "very good line breaks.\n\n"                "Notice how literal \\n characters are respected, and "                "may be used to force line breaks and blank lines.";        newtComponent form, text, button;        newtCls();        text = newtTextboxReflowed(1, 1, message, 30, 5, 5, 0);        button = newtButton(12, newtTextboxGetNumLines(text) + 2, "退出");        newtOpenWindow(10, 5, 37,                   newtTextboxGetNumLines(text) + 7, "文本盒");        form = newtForm(NULL, NULL, 0);        newtFormAddComponents(form, text, button, NULL);        newtRunForm(form);        newtFormDestroy(form); } main() {  newtComponent ls,fm;  int p = 1, q = 2, r = 3, s = 4, t = 5, *u;  newtInit();  do {    newtCls();    newtRefresh();    newtDrawRootText(0,0,"这是我的一个 NEWT 演示程序");    newtCenteredWindow(50,10,"请选择");    ls = newtListbox(18,3,5,NEWT_FLAG_RETURNEXIT);    newtListboxAppendEntry(ls,"根窗口演示",&p);    newtListboxAppendEntry(ls,"输入盒与按钮",&q);    newtListboxAppendEntry(ls,"检查盒与单选盒",&r);    newtListboxAppendEntry(ls,"文本盒",&s);    newtListboxAppendEntry(ls,"退出 ",&t);    newtPushHelpLine(" Move using the arrow keys and press ENTER to select");    fm = newtForm(NULL,NULL,0);    newtFormAddComponents(fm,ls,NULL);    newtRunForm(fm);    u = newtListboxGetCurrent(ls);    newtPopWindow();    newtFormDestroy(fm);    switch(*u) {    case 1:      rootwin_show();      break;    case 2:      label_button();      break;    case 3:      check_radio();      break;    case 4:      test();      break;    case 5:      newtFinished();      exit(0);    }  } while(1); }

编译运行：gcc -o newt2 newt2.c -lnewt

三、总结

（1）Newt是在S-Lang库的基础上开发的，S-Lang库参考：https://en.wikipedia.org/wiki/S-Lang_%28programming_library%29。
（2）Newt的库还有很多接口，可以参考网上其他的文档。
（3）若有建议，请留言，在此先感谢！