第十六章：面板库（上）现在你应该已经很精通curses库了，你可能会想试着做一些更大的项目。为了让界面看起来更专业，于是你就创建了许多重叠的窗口。但很不幸的是，你很快会发现它们变得难以管理，多次的更新窗口使开发变成了一场恶梦。如果你没有按照适当的顺序刷新那些窗口的话，它们就会给你带来很多麻烦。
不过别失望，面板库（Panel Library）提供了一个很好的解决方案。用ncureses 的开发者的话来说就是：
如果你的界面设计需要使窗口在运行的时候置底或者置顶，你就会发现不光显示正确的结果很困难，而且为此付出得代价很大。这时候Panels库就可以派上用场了。
如果你要处理很多重叠的窗口，选择panels 库绝对没错。通过一系列的wnoutrefresh()函数和doupdate()函数调用可以大大减少工作量。面板库实时控制着窗口的顺序信息，并且可以处理好重叠顺序，而且可以适时的更新屏幕。读到这里，你是不是又开始激动了呢？那还等什么呢，让我们继续！
16.1 基础知识面板对象实际上也是一个窗口，它被认为是一块包含所有面板对象的一个平台。这个平台可以看作是一个栈，栈顶的面板是完全可见的，其它的面板就被"压"在下面。所有面板根据所处栈的位置不同从而决定它是否可见。基本思想就是：创建一个栈来保存那些重叠的面板，然后使用面板库来正确的显示它们。可以调用一个类似于 refresh（）的函数来以正确的显示顺序显示这些面板。 面板库提供了一些可以隐藏、显示、移动和改变其大小等操作的函数。这样，我们就可以通过调用面板库提供的函数来解决重叠的窗口的问题了。
一般的，一个面板程序的设计流程如下：
1、 创建要添加到面板里面去的窗口（使用newwin（））。
2、 创建一个有合适可见顺序的面板，根据需要的可见顺序把它们压进栈。函数new_panel() 可以用来创建面板。
3、 调用update_panels() 把面板按正确的顺序写到虚拟屏幕上，调用doupdate()让它在现实器上显示。
4、 调用show_panel(), hide_panel(), move_panel()等函数来对面板进行操作。可以使用一些例如panel_hidden() 和 panel_window()之类的辅助函数。你也可以使用用户指针来存储为一个定制面板的数据。而且可以使用函数 set_panel_userptr() 和 panel_userptr() 来设置和取得一个面板的用户指针。
5、 所有的工作都做完后用del_panel() 删除这个面板。
接下来我们通过一些程序来加深一下对这些概念的理解。下面的将要看到的程序创建了3个重叠的面板并把它们按次序显示在屏幕上。
16.2 编译包含面板库的程序要使用面板库里的函数，你首先要把panel.h这个头文件包含到你的代码中。如果要把编译并连接与面板库相关的程序的话就要同时添加-lpanel和 -lncurses两个参数。
#include <panel.h>
.
.
.
编译和连接: gcc <program file> -lpanel -lncurses
例14．一个有关面板库的基础例子
#include <panel.h>
int main()
{
WINDOW *my_wins[3];
PANEL *my_panels[3];
int lines = 10, cols = 40, y = 2, x = 4, i;
initscr();
cbreak();
noecho();
/* 为每个面板创建窗口 */
my_wins[0] = newwin(lines, cols, y, x);
my_wins[1] = newwin(lines, cols, y + 1, x + 5);
my_wins[2] = newwin(lines, cols, y + 2, x + 10);
/* 为窗口添加创建边框以便你能看到面板的效果 */
for(i = 0; i < 3; +++i)
box(my_wins[i], 0, 0);
/* 按自底向上的顺序，把给每个窗口添加进一个面板 */
my_panels[0] = new_panel(my_wins[0]);/* 把面板0压进栈, 叠放顺序: stdscr-0 */
my_panels[1] = new_panel(my_wins[1]);/* 把面板1压进栈, 叠放顺序: stdscr-0-1 */
my_panels[2] = new_panel(my_wins[2]);/* 把面板2压进栈, 叠放顺序: stdscr-0-1-2 */
/* 更新栈的顺序。把面板2置于栈顶 */
update_panels();
/* 在屏幕上显示 */
doupdate();
getch();
endwin();
}
如你所见，上面的这个程序就是按照前面所讲的那个流程进行的。用newwin() 创建窗口，然后用new_panel()把它们添加到面板库里面去，当我们把那些面板一个一个压进栈的时候，panels栈也就随之更新了。调用update_panels() 和 doupdate() 就可以让它们在屏幕上显示出来。
16.3 面板窗口浏览下面给出一个稍微复杂点的例子。这个程序创建了3个窗口，通过使用<TAB>键可以使它们循环置顶显示。让我们来看一下代码：
例15 一个面板窗口浏览的例子
#include <panel.h>
#define NLINES 10
#define NCOLS 40
void init_wins(WINDOW **wins, int n);
void win_show(WINDOW *win, char *label, int label_color);
void print_in_middle(WINDOW *win, int starty, int startx, int width, char *string, chtype color);
int main()
{ WINDOW *my_wins[3];
PANEL *my_panels[3];
PANEL *top;
int ch;
/*初始化curses */
initscr();
start_color();
cbreak();
noecho();
keypad(stdscr, TRUE);
/* 初始化所有的颜色 */
init_pair(1, COLOR_RED, COLOR_BLACK);
init_pair(2, COLOR_GREEN, COLOR_BLACK);
init_pair(3, COLOR_BLUE, COLOR_BLACK);
init_pair(4, COLOR_CYAN, COLOR_BLACK);
init_wins(my_wins, 3);
/* 按自底向上的顺序，把每个窗口添加进一个面板 */
my_panels[0] = new_panel(my_wins[0]);/* 把面板0压入栈， 顺序: stdscr-0 */
my_panels[1] = new_panel(my_wins[1]); /* 把面板1压入栈，顺序: stdscr-0-1 */
my_panels[2] = new_panel(my_wins[2]); /* 把面板2压入栈，顺序: stdscr-0-1-2 */
/* 为下一个面板建立用户指针 */
set_panel_userptr(my_panels[0], my_panels[1]);
set_panel_userptr(my_panels[1], my_panels[2]);
set_panel_userptr(my_panels[2], my_panels[0]);
/* 更新面板栈的顺序。把面板2置于栈顶*/
update_panels();
/* 在屏幕上显示*/
attron(COLOR_PAIR(4));
mvprintw(LINES - 2, 0, "Use tab to browse through the windows (F1 to Exit)");
attroff(COLOR_PAIR(4));
doupdate();
top = my_panels[2];
while((ch = getch()) != KEY_F(1))
{ switch(ch)
{ case 9:
top = (PANEL *)panel_userptr(top);
top_panel(top);
break;
}
update_panels();
doupdate();
}
endwin();
return 0;
}
/* 显示所有的窗口 */
void init_wins(WINDOW **wins, int n)
{ int x, y, i;
char label[80];
y = 2;
x = 10;
for(i = 0; i < n; ++i)
{ wins[i] = newwin(NLINES, NCOLS, y, x);
sprintf(label, "Window Number %d", i + 1);
win_show(wins[i], label, i + 1);
y += 3;
x += 7;
}
}
/* 用一个边框和控件显示所有的窗口 */
void win_show(WINDOW *win, char *label, int label_color)
{ int startx, starty, height, width;
getbegyx(win, starty, startx);
getmaxyx(win, height, width);
box(win, 0, 0);
mvwaddch(win, 2, 0, ACS_LTEE);
mvwhline(win, 2, 1, ACS_HLINE, width - 2);
mvwaddch(win, 2, width - 1, ACS_RTEE);
print_in_middle(win, 1, 0, width, label, COLOR_PAIR(label_color));
}
void print_in_middle(WINDOW *win, int starty, int startx, int width, char *string, chtype color)
{ int length, x, y;
float temp;
if(win == NULL)
win = stdscr;
getyx(win, y, x);
if(startx != 0)
x = startx;
if(starty != 0)
y = starty;
if(width == 0)
width = 80;
length = strlen(string);
temp = (width - length)/ 2;
x = startx + (int)temp;
wattron(win, color);
mvwprintw(win, y, x, "%s", string);
wattroff(win, color);
refresh();
}
16.4 使用用户指针在上面的例子中，为了在这个循环例查找下一个窗口我使用了用户指针。我们可以通过指定一个用户指针给面板增加自定义信息，这个指针可以指向你想要存储的任何信息。在这个例子中，我往指针里面存储了循环中的下一个面板。一个面板的用户指针可以用函数set_panel_userptr() 来设定。用面板作为函数panel_userptr() 参变量可以访问它，函数将返回这个面板的用户指针。在循环中查找下一个面板结束后，通过使用函数top_panel() 可以将其置于顶层。用给定的面板作为参变量，这个函数将会把这个面板置于面板栈的顶层。
