Ncurses学习经历（十）面板库详解

      在精通curses 库后，你可能会想尝试着做一些更大的项目。为了让界面看起来更专业，你
可能会创建许多重叠的窗口，但不幸的是，你很快会发现它们变得难以管理，多次的更新窗
口使开发变得异常困难。如果你没有按照适当的顺序刷新那些窗口的话，它们就会给你带来
很多麻烦。
    不过别失望，面板库（Panel Library）提供了一个很好的解决方案。用ncureses 的开发者
的话来说就是：
    如果你的界面设计需要使窗口在运行时置底或者置顶，虽然会为此付出很大代价，但是想要
显示正确的结果仍然很困难。这时候Panels 库就可以派上用场了。
如果你要处理重叠的窗口， panels 库就派上用场了。它使程序员避免使用大量的
wnoutrefresh()和doupdate()函数来处理这个问题，并且减轻了由底向上正确处理这些信息
的负担。这个库维持着窗口重叠关系以及窗口顺序，并在适当的时候更新它们。
那么还等什么呢？让我们开始吧！
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 个重叠的
面板并把它们按次序显示在屏幕上。
NCURSES Programming HOWTO 中文版（第二版）
49
2. 编译包含面板库的程序
要使用面板库里的函数，你首先要把panel.h 这个头文件包含到你的代码中，同时编译并连
接与面板库相关的程序必须添加lpanel

和–lncurses 两个参数。

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);
/* 按自底向上的顺序，把每个窗口添加进一个面板*/
NCURSES Programming HOWTO 中文版（第二版）
51
my_panels[0] = new_panel(my_wins[0]);
/* 把面板0 压入栈， 顺序: stdscr0
*/
my_panels[1] = new_panel(my_wins[1]);
/* 把面板1 压入栈，顺序: stdscr01
*/
my_panels[2] = new_panel(my_wins[2]);
/* 把面板2 压入栈，顺序: stdscr012
*/
/* 为下一个面板建立用户指针*/
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);
NCURSES Programming HOWTO 中文版（第二版）
52
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();
}