功能

模块 curses 定义以下异常：

exception curses.error

当Curses库函数返回错误时引发异常。

模块 curses 定义以下函数：

curses.baudrate()

返回终端的输出速度（位/秒）。在软件终端模拟器上，它将具有固定的高值。由于历史原因而包括在内；在以前，它被用来为时间延迟编写输出循环，有时还根据线速度更改接口。

curses.beep()

发出短暂的注意声。

curses.can_change_color()

返回 True 或 False ，取决于程序员是否可以更改终端显示的颜色。

curses.cbreak()

进入cbreak模式。在cbreak模式（有时称为“稀有”模式）下，正常的tty行缓冲被关闭，可以逐个读取字符。但是，与原始模式不同，特殊字符（中断、退出、挂起和流控制）保留它们对TTY驱动程序和调用程序的影响。先调用 raw() 然后 cbreak() 使终端处于CBreak模式。

curses.color_content(color_number)

返回颜色中红、绿、蓝(RGB)分量的强度 color_number ，它必须介于 0 和 COLORS - 1 。返回一个三元组，包含给定颜色的R、G、B值，它将介于 0 (无组件)和 1000 (组件的最大数量)。

curses.color_pair(pair_number)

返回用于以指定颜色对显示文本的属性值。仅支持前256个颜色对。此属性值可以与 A_STANDOUT ， A_REVERSE ，和另一个 A_* 属性。 pair_number() 是此函数的对应函数。

curses.curs_set(visibility)

设置光标状态。 能见度 可以设置为 0 ， 1 或 2 ，表示不可见、正常或非常可见。如果终端支持请求的可见性，则返回上一个光标状态；否则引发异常。在许多终端上，“可见”模式是下划线光标，“非常可见”模式是块光标。

curses.def_prog_mode()

将当前终端模式保存为“程序”模式，即运行程序使用curses时的模式。（它的对应项是“shell”模式，当程序不在curses中时。）随后调用 reset_prog_mode() 将恢复此模式。

curses.def_shell_mode()

将当前终端模式保存为“shell”模式，即运行程序不使用curses时的模式。（当程序使用Curses功能时，其对应的模式是“程序”模式。）随后调用 reset_shell_mode() 将恢复此模式。

curses.delay_output(ms)

插入一个 ms 输出暂停毫秒。

curses.doupdate()

更新物理屏幕。Curses库保留两个数据结构，一个表示当前物理屏幕内容，一个表示所需下一个状态的虚拟屏幕。这个 doupdate() 地面更新物理屏幕以匹配虚拟屏幕。

虚拟屏幕可以通过 noutrefresh() 在写入操作后调用，例如 addstr() 已在窗口上执行。正常人 refresh() 调用是简单的 noutrefresh() 然后 doupdate() ；如果必须更新多个窗口，可以通过发出 noutrefresh() 调用所有窗口，然后调用一个 doupdate() .

curses.echo()

进入回声模式。在echo模式下，每个字符输入在输入时都会回显到屏幕上。

curses.endwin()

取消对库的初始化，并将终端恢复到正常状态。

curses.erasechar()

以单字节字节对象的形式返回用户当前的擦除字符。在Unix操作系统下，这是curses程序控制tty的一个属性，而不是由curses库本身设置的。

curses.filter()

这个 filter() 如果使用例程，则必须在 initscr() 被调用。结果是，在这些通话中， LINES 设置为 1 ；能力 clear ， cup ， cud ， cud1 ， cuu1 ， cuu ， vpa 残疾人；以及 home 字符串被设置为 cr .其效果是光标仅限于当前行，屏幕更新也是如此。这可用于在不接触屏幕其余部分的情况下启用字符一次行编辑。

curses.flash()

闪烁屏幕。也就是说，将其更改为反转视频，然后在短时间内将其重新更改。有些人类似于“可视铃”，而不是 beep() .

curses.flushinp()

刷新所有输入缓冲区。这将丢弃用户键入但程序尚未处理的任何提前输入。

curses.getmouse()

之后 getch() 退货 KEY_MOUSE 若要发出鼠标事件信号，应调用此方法来检索排队的鼠标事件，表示为5元组 (id, x, y, z, bstate) 。 id 是用于区分多个设备的ID值，并且 x ， y ， z 是事件的坐标。( z 当前未使用。) bstate 是一个整数值，其位将被设置以指示事件类型，并且将是以下一个或多个常量的按位OR，其中 n 是从1到5的按键数字： BUTTONn_PRESSED ， BUTTONn_RELEASED ， BUTTONn_CLICKED ， BUTTONn_DOUBLE_CLICKED ， BUTTONn_TRIPLE_CLICKED ， BUTTON_SHIFT ， BUTTON_CTRL ， BUTTON_ALT 。

在 3.10 版更改: 这个 BUTTON5_* 如果常量是由底层的curses库提供的，那么它们现在是公开的。

curses.getsyx()

以元组形式返回虚拟屏幕光标的当前坐标 (y, x) . 如果 leaveok 目前 True ，然后返回 (-1, -1) .

curses.getwin(file)

读取以前存储在文件中的与窗口相关的数据 putwin() 调用。然后，该例程使用该数据创建并初始化一个新窗口，返回新窗口对象。

curses.has_colors()

返回 True 如果终端可以显示颜色，则返回 False .

curses.has_extended_color_support()

返回 True 如果模块支持扩展颜色；否则，返回 False . 扩展颜色支持允许支持超过16种颜色（例如xterm-256color）的终端使用256种以上的颜色对。

扩展颜色支持需要ncurses 6.1或更高版本。

3.10 新版功能.

curses.has_ic()

返回 True 如果终端具有插入和删除字符功能。由于所有现代软件终端仿真器都具有这样的功能，因此仅出于历史原因才包含此功能。

curses.has_il()

返回 True 如果终端具有插入和删除行功能，或者可以使用滚动区域来模拟它们。由于所有现代软件终端仿真器都具有这样的功能，因此仅出于历史原因才包含此功能。

curses.has_key(ch)

获取键值 ch 并返回 True 如果当前终端类型识别具有该值的键。

curses.halfdelay(tenths)

用于半延迟模式，类似于cbreak模式，因为用户键入的字符可立即用于程序。但是，在封锁后 十分之一 十分之一秒，如果未键入任何内容，则引发异常。价值 十分之一 必须是介于 1 和 255 . 使用 nocbreak() 离开半延迟模式。

curses.init_color(color_number, r, g, b)

更改颜色的定义，采用要更改的颜色编号，后跟三个RGB值(表示红色、绿色和蓝色分量的量)。的价值 color_number 必须介于 0 和 COLORS - 1 。每一个 r ， g ， b ，必须是介于 0 和 1000 。什么时候 init_color() 则屏幕上该颜色的所有匹配项都会立即更改为新定义。此功能在大多数终端上是无操作的；只有在以下情况下才会激活 can_change_color() 退货 True 。

curses.init_pair(pair_number, fg, bg)

更改颜色对的定义。它有三个参数：要更改的颜色对的编号、前景颜色编号和背景颜色编号。的价值 pair_number 必须介于 1 和 COLOR_PAIRS - 1 ( 0 颜色对在黑色上接线为白色，并且不能更改)。的价值 fg 和 bg 参数必须介于 0 和 COLORS - 1 ，或者，在调用 use_default_colors() ， -1 。如果颜色对先前已初始化，则屏幕将刷新，并且该颜色对的所有匹配项都将更改为新定义。

curses.initscr()

初始化库。返回A window 表示整个屏幕的对象。

注解

如果打开终端时出错，底层的Curses库可能会导致解释器退出。

curses.is_term_resized(nlines, ncols)

返回 True 如果 resize_term() 会修改窗口结构， False 否则。

curses.isendwin()

返回 True 如果 endwin() 被称为（即curses类库已被神化）。

curses.keyname(k)

返回编号的密钥的名称 k 作为字节对象。生成可打印ASCII字符的密钥的名称是密钥的字符。控制键组合的名称是由插入符号组成的双字节字节对象 (b'^' ）然后是相应的可打印的ASCII字符。alt-key组合的名称（128-255）是一个由前缀组成的bytes对象。 b'M-' 后跟相应的ASCII字符的名称。

curses.killchar()

以单字节字节对象的形式返回用户的当前行终止字符。在Unix操作系统下，这是curses程序控制tty的一个属性，而不是由curses库本身设置的。

curses.longname()

返回一个bytes对象，该对象包含描述当前终端的terminfo long name字段。详细描述的最大长度为128个字符。只有在调用 initscr() .

curses.meta(flag)

如果 flag 是 True ，允许输入8位字符。如果 flag 是 False ，仅允许7位字符。

curses.mouseinterval(interval)

设置新闻和发布事件之间的最长时间（毫秒），以便将它们识别为单击，并返回上一个间隔值。默认值为200毫秒或五分之一秒。

curses.mousemask(mousemask)

设置要报告的鼠标事件，并返回元组 (availmask, oldmask) . 有效掩码 指示可以报告指定的鼠标事件中的哪一个；一旦完全失败，它将返回 0 . 旧掩模 是给定窗口的鼠标事件掩码的前一个值。如果从未调用此函数，则不会报告任何鼠标事件。

curses.napms(ms)

睡觉 ms 毫秒。

curses.newpad(nlines, ncols)

创建并返回一个指向具有给定行数和列数的新PAD数据结构的指针。返回一个pad作为窗口对象。

pad就像一个窗口，只是它不受屏幕大小的限制，也不一定与屏幕的特定部分相关联。当需要大窗口时，可以使用垫子，一次只有一部分窗口在屏幕上。不会自动刷新焊盘（如从滚动或回音输入）。这个 refresh() 和 noutrefresh() PAD的方法需要6个参数来指定要显示的PAD部分和屏幕上用于显示的位置。这些参数是 普米罗 ， 普米科尔 ， 斯米罗 ， 斯米科尔 ， 斯马克罗 ， 斯马科尔 ； p 参数是指要显示的焊盘区域的左上角，以及 s 参数定义屏幕上要显示填充区域的剪切框。

curses.newwin(nlines, ncols)

curses.newwin(nlines, ncols, begin_y, begin_x)

返回一个新的 window ，其左上角位于 (begin_y, begin_x) ，其高度/宽度为 非线性 / 恩科斯 .

默认情况下，窗口将从指定位置延伸到屏幕的右下角。

curses.nl()

进入换行模式。此模式在输入时将返回键转换为换行符，并在输出时将换行符转换为返回和换行符。换行模式最初打开。

curses.nocbreak()

离开cbreak模式。恢复正常的“煮熟”模式和线路缓冲。

curses.noecho()

离开回声模式。输入字符的回显被关闭。

curses.nonl()

保持换行模式。禁用在输入时将返回转换为换行，并禁用将换行转换为换行/输出时返回的低级转换（但这不会更改 addch('\n') ，它总是在虚拟屏幕上执行相当于返回和换行的操作）。关闭翻译后，curses有时会使垂直运动加快一点；此外，它还可以检测输入时的返回键。

curses.noqiflush()

当 noqiflush() 使用常规程序，正常刷新与 INTR ， QUIT 和 SUSP 字符将无法完成。你可能想调用 noqiflush() 在信号处理程序中，如果希望在处理程序退出后继续输出，就像没有发生中断一样。

curses.noraw()

离开原始模式。恢复正常的“煮熟”模式和线路缓冲。

curses.pair_content(pair_number)

返回元组 (fg, bg) 包含请求的颜色对的颜色。的价值 pair_number 必须介于 0 和 COLOR_PAIRS - 1 。

curses.pair_number(attr)

返回由属性值设置的颜色对的数目 attr . color_pair() 是这个功能的对应物。

curses.putp(str)

相当于 tputs(str, 1, putchar) ；为当前终端发出指定terminfo功能的值。注意，输出 putp() 总是转到标准输出。

curses.qiflush([flag])

如果 flag 是 False ，效果与调用相同 noqiflush() .如果 flag 是 True 或者不提供参数，则在读取这些控制字符时将刷新队列。

curses.raw()

进入原始模式。在原始模式下，正常的线路缓冲和中断、退出、暂停和流控制键的处理被关闭；字符被一个接一个地表示为对输入函数的curses。

curses.reset_prog_mode()

将终端恢复到“程序”模式，如之前保存的 def_prog_mode() .

curses.reset_shell_mode()

将终端恢复到“shell”模式，如之前保存的 def_shell_mode() .

curses.resetty()

将终端模式的状态恢复到上次调用时的状态 savetty() .

curses.resize_term(nlines, ncols)

后端功能由使用 resizeterm() ，执行大部分工作；调整窗口大小时， resize_term() 空白填充扩展的区域。调用应用程序应该用适当的数据填充这些区域。这个 resize_term() 函数尝试调整所有窗口的大小。但是，由于pad的调用约定，如果不与应用程序进行额外的交互，就无法调整这些pad的大小。

curses.resizeterm(nlines, ncols)

将标准窗口和当前窗口调整为指定的尺寸，并调整记录窗口尺寸的Curses库（尤其是SigWinch处理程序）使用的其他簿记数据。

curses.savetty()

将终端模式的当前状态保存在缓冲区中，可由 resetty() .

curses.get_escdelay()

检索由设置的值 set_escdelay() .

3.9 新版功能.

curses.set_escdelay(ms)

设置读取转义字符后等待的毫秒数，以区分键盘上输入的单个转义字符与光标和功能键发送的转义序列。

3.9 新版功能.

curses.get_tabsize()

检索由设置的值 set_tabsize() .

3.9 新版功能.

curses.set_tabsize(size)

设置光标库在将制表符添加到窗口时将制表符转换为空格时使用的列数。

3.9 新版功能.

curses.setsyx(y, x)

将虚拟屏幕光标设置为 y ， x .如果 y 和 x 都是 -1 然后 leaveok 被设定 True .

curses.setupterm(term=None, fd=- 1)

初始化终端。 term 是提供终端名称的字符串，或 None 如果省略或 None ，的值 TERM 将使用环境变量。 fd 是任何初始化序列将发送到的文件描述符；如果未提供或 -1 ，的文件描述符 sys.stdout 将被使用。

curses.start_color()

如果程序员想使用颜色，必须在调用任何其他颜色操作例程之前调用。很好的做法是在 initscr() .

start_color() 初始化中的八种基本颜色（黑色、红色、绿色、黄色、蓝色、洋红、青色和白色）和两个全局变量 curses 模块， COLORS 和 COLOR_PAIRS ，包含终端可以支持的最大颜色数和颜色对。它还将终端上的颜色恢复为终端刚打开时的值。

curses.termattrs()

返回终端支持的所有视频属性的逻辑或。当Curses程序需要完全控制屏幕外观时，此信息非常有用。

curses.termname()

返回环境变量的值 TERM ，作为字节对象，截断为14个字符。

curses.tigetflag(capname)

返回与terminfo功能名称对应的布尔功能值 卡佩克 作为整数。返回值 -1 如果 卡佩克 不是布尔能力，或 0 如果它被取消或不在终端描述中。

curses.tigetnum(capname)

返回与terminfo能力名称对应的数值能力值 卡佩克 作为整数。返回值 -2 如果 卡佩克 不是数字能力，或 -1 如果它被取消或不在终端描述中。

curses.tigetstr(capname)

返回与terminfo功能名称对应的字符串功能的值 卡佩克 作为字节对象。返回 None 如果 卡佩克 不是terminfo“字符串功能”，或者在终端描述中取消或不存在。

curses.tparm(str[, ...])

实例化bytes对象 str 使用提供的参数，其中 str 应该是从terminfo数据库获取的参数化字符串。例如。 tparm(tigetstr("cup"), 5, 3) 可能导致 b'\033[6;4H' ，具体结果取决于终端类型。

curses.typeahead(fd)

指定文件描述符 fd 用于打印前检查。如果 fd 是 -1 ，则不进行预输入检查。

Curses库通过在更新屏幕时定期查找提前排字来进行“换行优化”。如果找到输入，并且它来自tty，则当前更新将被推迟，直到再次调用refresh或doupdate，从而可以更快地响应预先输入的命令。此函数允许指定一个不同的文件描述符来进行预先排版检查。

curses.unctrl(ch)

返回字节对象，该对象是字符的可打印表示形式 ch . 控制字符表示为插入符号，后跟字符，例如 b'^C' . 打印字符保持原样。

curses.ungetch(ch)

推 ch 所以下一个 getch() 将返回它。

注解

只有一个 ch 之前可以推 getch() 被称为。

curses.update_lines_cols()

更新 LINES 和 COLS .用于检测手动调整屏幕大小。

3.5 新版功能.

curses.unget_wch(ch)

推 ch 所以下一个 get_wch() 将返回它。

注解

只有一个 ch 之前可以推 get_wch() 被称为。

3.3 新版功能.

curses.ungetmouse(id, x, y, z, bstate)

推A KEY_MOUSE 事件，将给定的状态数据与其关联。

curses.use_env(flag)

如果使用此函数，则应在 initscr() 或者称为新术语。什么时候？ flag 是 False ，将使用terminfo数据库中指定的行和列的值，即使环境变量 LINES 和 COLUMNS （默认使用）被设置，或者如果curses正在窗口中运行（在这种情况下，默认行为将使用窗口大小，如果 LINES 和 COLUMNS 未设置）。

curses.use_default_colors()

允许在支持此功能的终端上使用颜色的默认值。使用它可以支持应用程序中的透明度。将默认颜色指定给颜色编号 -1 . 调用此函数后， init_pair(x, curses.COLOR_RED, -1) 初始化，例如，颜色对 x 默认背景上的红色前景色。

curses.wrapper(func, /, *args, **kwargs)

初始化curses并调用另一个可调用对象， func 这应该是您使用应用程序的其他curses。如果应用程序引发异常，此函数将在重新引发异常并生成回溯之前将终端恢复到正常状态。可调用对象 func 然后将主窗口“stdscr”作为其第一个参数传递，后跟传递给 wrapper() . 调用之前 func ， wrapper() 打开cbreak模式，关闭echo，启用终端键盘，如果终端支持颜色，则初始化颜色。在退出时（无论正常还是异常），它会恢复烹饪模式，打开回声，并禁用终端键盘。

窗口对象

窗口对象，由返回 initscr() 和 newwin() 上面有以下方法和属性：

window.addch(ch[, attr])

window.addch(y, x, ch[, attr])

涂料特性 ch 在 (y, x) 带属性 attr ，覆盖先前在该位置绘制的任何字符。默认情况下，角色位置和属性是窗口对象的当前设置。

注解

在窗口、子窗口或PAD外写入将引发 curses.error . 试图写入窗口、子窗口或便笺簿的右下角将导致打印字符后引发异常。

window.addnstr(str, n[, attr])

window.addnstr(y, x, str, n[, attr])

油漆最多 n 字符串的字符 str 在 (y, x) 带属性 attr ，覆盖以前显示的任何内容。

window.addstr(str[, attr])

window.addstr(y, x, str[, attr])

绘制字符串 str 在 (y, x) 带属性 attr ，覆盖以前显示的任何内容。

注解

• 在窗口、子窗口或便笺簿外书写会升高 curses.error . 试图写入窗口、子窗口或便笺簿的右下角将导致打印字符串后引发异常。

• A bug in ncurses 在调整窗口大小时，此python模块的后端可能会导致segfaults。这是在NCURSES-6.1-20190511中修复的。如果你陷入了早先的困境，如果你不打电话，你可以避免触发这个。 addstr() 用一个 str 嵌入了换行符。相反，打电话 addstr() 每行单独填写。

window.attroff(attr)

删除属性 attr 从应用于当前窗口所有写入操作的“后台”设置。

window.attron(attr)

添加属性 attr 从应用于当前窗口所有写入操作的“后台”设置。

window.attrset(attr)

将“背景”属性集设置为 attr . 这套最初是 0 （无属性）。

window.bkgd(ch[, attr])

将窗口的background属性设置为字符 ch ，具有属性 attr . 然后将更改应用于该窗口中的每个字符位置：

• 窗口中每个字符的属性都将更改为新的背景属性。

• 无论前一个背景字符出现在何处，它都将更改为新的背景字符。

window.bkgdset(ch[, attr])

设置窗口的背景。窗口的背景由字符和任何属性组合组成。背景的属性部分与写入窗口的所有非空白字符组合（或编辑）。背景的字符和属性部分都与空白字符相结合。背景将成为字符的一个属性，并随字符一起在任何滚动和插入/删除行/字符操作中移动。

window.border([ls[, rs[, ts[, bs[, tl[, tr[, bl[, br]]]]]]]])

在窗口边缘周围画一个边框。每个参数指定用于边框特定部分的字符；有关详细信息，请参阅下表。

注解

A 0 任何参数的值都将导致该参数使用默认字符。关键字参数可以 not 被使用。此表列出了默认值：

参数	描述	默认值
ls	左侧	ACS_VLINE
rs	右侧	ACS_VLINE
ts	顶部	ACS_HLINE
bs	底部	ACS_HLINE
tl	左上角	ACS_ULCORNER
tr	右上角	ACS_URCORNER
bl	左下角	ACS_LLCORNER
br	右下角	ACS_LRCORNER

window.box([vertch, horch])

类似 border() ，但两者 ls 和 rs 是 维尔奇 而且两者 ts 和 bs 是 霍奇 . 此函数始终使用默认的角字符。

window.chgat(attr)

window.chgat(num, attr)

window.chgat(y, x, attr)

window.chgat(y, x, num, attr)

设置的属性 num 当前光标位置或位置处的字符 (y, x) 如果提供。如果 num 没有给出或是 -1 ，属性将设置在所有字符的行尾。此函数将光标移动到位置 (y, x) 如果提供。将使用 touchline() 方法，以便在下次刷新窗口时重新显示内容。

window.clear()

类似于 erase() ，但也会在下次调用时重新绘制整个窗口 refresh() .

window.clearok(flag)

如果 flag 是 True ，下次调用 refresh() 将完全清除窗口。

window.clrtobot()

从光标到窗口末端的擦除：删除光标下的所有行，然后等效于 clrtoeol() 执行。

window.clrtoeol()

从光标到行尾擦除。

window.cursyncup()

更新窗口所有祖先的当前光标位置，以反映窗口的当前光标位置。

window.delch([y, x])

删除任何字符 (y, x) .

window.deleteln()

删除光标下的行。以下所有行都上移一行。

window.derwin(begin_y, begin_x)

window.derwin(nlines, ncols, begin_y, begin_x)

“派生窗口”的缩写， derwin() 和调用一样吗 subwin() 除了 begin_y 和 begin_x 相对于窗口的原点，而不是整个屏幕。返回派生窗口的窗口对象。

window.echochar(ch[, attr])

添加字符 ch 带属性 attr ，然后立即调用 refresh() 在Windows上。

window.enclose(y, x)

测试给定的一对屏幕相对字符单元格坐标是否被给定的窗口包围，返回 True 或 False .它可用于确定屏幕窗口的哪些子集包含鼠标事件的位置。

window.encoding

用于编码方法参数（Unicode字符串和字符）的编码。创建子窗口时，编码属性从父窗口继承，例如 window.subwin() . 默认情况下，使用区域设置编码（请参见 locale.getpreferredencoding() ）

3.3 新版功能.

window.erase()

打开窗口。

window.getbegyx()

返回元组 (y, x) 左上角的坐标。

window.getbkgd()

返回给定窗口的当前背景字符/属性对。

window.getch([y, x])

获得一个角色。请注意，返回的整数为 not 必须在ASCII范围内：功能键、键盘键等由大于255的数字表示。在无延迟模式下，返回 -1 如果没有输入，则等待按键。

window.get_wch([y, x])

获得广泛的字符。为大多数键返回一个字符，或为功能键、键盘键和其他特殊键返回一个整数。在无延迟模式下，如果没有输入，则引发异常。

3.3 新版功能.

window.getkey([y, x])

获取一个字符，返回一个字符串而不是一个整数，如 getch() 做。功能键、键盘键和其他特殊键返回包含键名的多字节字符串。在无延迟模式下，如果没有输入，则引发异常。

window.getmaxyx()

返回元组 (y, x) 窗口的高度和宽度。

window.getparyx()

以元组形式返回此窗口相对于其父窗口的起始坐标 (y, x) . 返回 (-1, -1) 如果此窗口没有父窗口。

window.getstr()

window.getstr(n)

window.getstr(y, x)

window.getstr(y, x, n)

从用户读取一个具有基本行编辑能力的bytes对象。

window.getyx()

返回元组 (y, x) 当前光标相对于窗口左上角的位置。

window.hline(ch, n)

window.hline(y, x, ch, n)

显示从以下位置开始的水平线 (y, x) 有长度 n 由角色组成 ch .

window.idcok(flag)

如果 flag 是 False ，curses不再考虑使用终端的硬件插入/删除字符功能；如果 flag 是 True ，启用字符插入和删除。首次初始化curses时，默认情况下启用字符插入/删除。

window.idlok(flag)

如果 flag 是 True ， curses 将尝试使用硬件线路编辑设备。否则，将禁用行插入/删除。

window.immedok(flag)

如果 flag 是 True 窗口图像中的任何更改都会自动刷新窗口；您不再需要调用 refresh() 你自己。但是，由于对wrefresh的重复调用，它可能会大大降低性能。默认情况下禁用此选项。

window.inch([y, x])

返回窗口中给定位置的字符。下面的8位是字符本身，上面的位是属性。

window.insch(ch[, attr])

window.insch(y, x, ch[, attr])

涂料特性 ch 在 (y, x) 带属性 attr ，从位置移动线条 x 就一个字符。

window.insdelln(nlines)

插入 非线性 行到当前行上方的指定窗口中。这个 非线性 底线丢失。否定的 非线性 删除 非线性 从光标下的一行开始，并向上移动其余行。底部 非线性 行被清除。当前光标位置保持不变。

window.insertln()

在光标下插入空行。以下所有行都向下移动一行。

window.insnstr(str, n[, attr])

window.insnstr(y, x, str, n[, attr])

在光标下的字符之前插入一个字符串（最多可插入行中的字符数） n 字符。如果 n 为零或负数，将插入整个字符串。光标右侧的所有字符都右移，行中最右侧的字符将丢失。光标位置不变（移动到 y ， x ，如果指定）。

window.insstr(str[, attr])

window.insstr(y, x, str[, attr])

在光标下的字符之前插入一个字符串（尽可能多的字符适合行）。光标右侧的所有字符都右移，行中最右侧的字符将丢失。光标位置不变（移动到 y ， x ，如果指定）。

window.instr([n])

window.instr(y, x[, n])

返回从当前光标位置开始的窗口中提取的字符字节对象，或返回 y ， x 如果指定。从字符中去除属性。如果 n 已指定， instr() 最多返回一个字符串 n 字符长（不包括尾随的nul）。

window.is_linetouched(line)

返回 True 如果自上次调用以来修改了指定的行 refresh() ；否则返回 False . 举起一个 curses.error 例外如果 line 对于给定的窗口无效。

window.is_wintouched()

返回 True 如果自上次调用以来修改了指定的窗口 refresh() ；否则返回 False .

window.keypad(flag)

如果 flag 是 True ，某些键（键盘、功能键）生成的转义序列将由 curses .如果 flag 是 False ，转义序列将保留在输入流中。

window.leaveok(flag)

如果 flag 是 True ，光标位于更新时的左侧，而不是位于“光标位置”。这将尽可能减少光标的移动。如果可能，光标将变为不可见。

如果 flag 是 False ，更新后光标将始终位于“光标位置”。

window.move(new_y, new_x)

移动光标到 (new_y, new_x) .

window.mvderwin(y, x)

将窗口移动到其父窗口中。窗口的屏幕相关参数没有更改。此例程用于在屏幕上相同物理位置显示父窗口的不同部分。

window.mvwin(new_y, new_x)

移动窗口，使其左上角位于 (new_y, new_x) .

window.nodelay(flag)

如果 flag 是 True ， getch() 将不阻塞。

window.notimeout(flag)

如果 flag 是 True ，转义序列不会超时。

如果 flag 是 False ，几毫秒后，转义序列将不会被解释，并将保留在输入流中。

window.noutrefresh()

标记为刷新，但请稍候。此函数更新表示窗口所需状态的数据结构，但不强制更新物理屏幕。为此，请致电 doupdate() .

window.overlay(destwin[, sminrow, smincol, dminrow, dmincol, dmaxrow, dmaxcol])

将窗口覆盖在 德斯文 . 窗口大小不必相同，只复制重叠区域。此副本是非破坏性的，这意味着当前背景字符不会覆盖 德斯文 .

为了对复制的区域进行细粒度控制，第二种形式的 overlay() 可以使用。 斯米罗 和 斯米科尔 是源窗口的左上角坐标，其他变量在目标窗口中标记一个矩形。

window.overwrite(destwin[, sminrow, smincol, dminrow, dmincol, dmaxrow, dmaxcol])

覆盖窗口顶部 德斯文 . 窗口的大小不必相同，在这种情况下，只复制重叠区域。此副本具有破坏性，这意味着当前背景字符将覆盖 德斯文 .

为了对复制的区域进行细粒度控制，第二种形式的 overwrite() 可以使用。 斯米罗 和 斯米科尔 是源窗口的左上角坐标，其他变量在目标窗口中标记一个矩形。

window.putwin(file)

将与窗口关联的所有数据写入提供的文件对象。稍后可以使用 getwin() 功能。

window.redrawln(beg, num)

表明 num 屏幕行，从行开始 beg ，已损坏，应在下一个 refresh() 调用。

window.redrawwin()

触摸整个窗口，使其在下一个窗口上完全重新绘制 refresh() 调用。

window.refresh([pminrow, pmincol, sminrow, smincol, smaxrow, smaxcol])

立即更新显示（将实际屏幕与以前的绘图/删除方法同步）。

6个可选参数只能在窗口是用创建的PAD时指定。 newpad() . 需要额外的参数来指示所涉及的焊盘和屏幕的哪个部分。 普米罗 和 普米科尔 指定要在填充中显示的矩形的左上角。 斯米罗 ， 斯米科尔 ， 斯马克罗 和 斯马科尔 指定要在屏幕上显示的矩形的边缘。由于矩形的大小必须相同，因此要在填充板中显示的矩形的右下角是根据屏幕坐标计算的。两个矩形必须完全包含在各自的结构中。的负值 普米罗 ， 普米科尔 ， 斯米罗 或 斯米科尔 被视为零。

window.resize(nlines, ncols)

重新分配Curses窗口的存储空间，以将其维度调整为指定的值。如果任何一个维度大于当前值，则窗口的数据将填充具有当前背景格式副本的空白（由设置 bkgdset() ）融入其中。

window.scroll([lines=1])

向上滚动屏幕或滚动区域 线 线。

window.scrollok(flag)

控制当窗口的光标移离窗口边缘或滚动区域时发生的情况，无论是由于底线上的换行操作，还是键入最后一行的最后一个字符。如果 flag 是 False ，光标留在底线上。如果 flag 是 True ，窗口向上滚动一行。请注意，为了在终端上获得物理滚动效果，还需要调用 idlok() .

window.setscrreg(top, bottom)

从行设置滚动区域 top 连线 底部 . 所有滚动操作都将在此区域中进行。

window.standend()

关闭“突出显示”属性。在某些终端上，这有关闭所有属性的副作用。

window.standout()

启用属性 A_STANDOUT .

window.subpad(begin_y, begin_x)

window.subpad(nlines, ncols, begin_y, begin_x)

返回一个子窗口，其左上角位于 (begin_y, begin_x) ，宽度/高度为 恩科斯 / 非线性 .

window.subwin(begin_y, begin_x)

window.subwin(nlines, ncols, begin_y, begin_x)

返回一个子窗口，其左上角位于 (begin_y, begin_x) ，宽度/高度为 恩科斯 / 非线性 .

默认情况下，子窗口将从指定位置延伸到窗口的右下角。

window.syncdown()

触摸窗口中在其任何祖先窗口中被触摸过的每个位置。此例程由调用 refresh() ，所以几乎不需要手动调用它。

window.syncok(flag)

如果 flag 是 True 然后 syncup() 每当窗口发生更改时自动调用。

window.syncup()

触摸已在窗口中更改的窗口祖先中的所有位置。

window.timeout(delay)

设置窗口的阻塞或非阻塞读取行为。如果 延迟 为负，使用阻塞读取（将无限期等待输入）。如果 延迟 为零，则使用非阻塞读取，并且 getch() 将返回 -1 如果没有输入等待。如果 延迟 是肯定的，那么 getch() 将阻止 延迟 毫秒，然后返回 -1 如果在该时间结束时仍然没有输入。

window.touchline(start, count[, changed])

假装 计数 行已更改，从行开始 开始 . 如果 改变 它指定受影响的行是否标记为已更改。（ 改变 =True ）或不变（ 改变 =False ）

window.touchwin()

假设整个窗口已更改，以便进行绘图优化。

window.untouchwin()

将窗口中的所有行标记为自上次调用以来未更改 refresh() .

window.vline(ch, n)

window.vline(y, x, ch, n)

显示从开始的垂直线 (y, x) 有长度 n 由角色组成 ch .

常量

这个 curses 模块定义以下数据成员：

curses.ERR

一些返回整数的curses例程，例如 getch() 返回 ERR 失败后。

curses.OK

一些返回整数的curses例程，例如 napms() 返回 OK 成功了。

curses.version

表示模块当前版本的bytes对象。也可作为 __version__ .

curses.ncurses_version

包含ncurses库版本的三个组件的命名元组： 专业 ， 少数的 和 补丁 . 所有值都是整数。组件也可以按名称访问，因此 curses.ncurses_version[0] 等于 curses.ncurses_version.major 等等。

可用性：如果使用了ncurses库。

3.8 新版功能.

有些常量可用于指定字符单元属性。可用的确切常数取决于系统。

有几个常量可用于提取某些方法返回的相应属性。

键由名称以开头的整数常量引用 KEY_ . 可用的确切键帽取决于系统。

在VT100及其软件仿真（如X终端仿真器）上，通常至少有四个功能键 (KEY_F1 ， KEY_F2 ， KEY_F3 ， KEY_F4 ）可用，箭头键映射到 KEY_UP ， KEY_DOWN ， KEY_LEFT 和 KEY_RIGHT 很明显。如果您的机器有一个PC键盘，则可以安全地使用箭头键和十二个功能键（较旧的PC键盘可能只有十个功能键）；此外，以下键盘映射是标准的：

下表列出了备用字符集中的字符。这些都是从VT100终端继承的，通常在软件仿真（如X终端）上可用。当没有可用的图形时，curses会回到一个粗糙的可打印的ASCII近似值上。

下表列出了预定义的颜色：