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）若有建议，请留言，在此先感谢！