2133 lines
183 KiB
HTML
2133 lines
183 KiB
HTML
|
||
<!DOCTYPE html>
|
||
|
||
<html xmlns="http://www.w3.org/1999/xhtml" lang="zh_CN">
|
||
<head>
|
||
<meta charset="utf-8" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
|
||
|
||
<title>curses --- 终端字符单元显示的处理 — Python 3.8.20 文档</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
|
||
<link rel="stylesheet" href="../_static/pydoctheme.css" type="text/css" />
|
||
<link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
|
||
|
||
<script id="documentation_options" data-url_root="../" src="../_static/documentation_options.js"></script>
|
||
<script src="../_static/jquery.js"></script>
|
||
<script src="../_static/underscore.js"></script>
|
||
<script src="../_static/doctools.js"></script>
|
||
<script src="../_static/language_data.js"></script>
|
||
<script src="../_static/translations.js"></script>
|
||
|
||
<script src="../_static/sidebar.js"></script>
|
||
|
||
<link rel="search" type="application/opensearchdescription+xml"
|
||
title="在 Python 3.8.20 文档 中搜索"
|
||
href="../_static/opensearch.xml"/>
|
||
<link rel="author" title="关于这些文档" href="../about.html" />
|
||
<link rel="index" title="索引" href="../genindex.html" />
|
||
<link rel="search" title="搜索" href="../search.html" />
|
||
<link rel="copyright" title="版权所有" href="../copyright.html" />
|
||
<link rel="next" title="curses.ascii --- 用于 ASCII 字符的工具" href="curses.ascii.html" />
|
||
<link rel="prev" title="getpass --- 便携式密码输入工具" href="getpass.html" />
|
||
<link rel="canonical" href="https://docs.python.org/3/library/curses.html" />
|
||
|
||
|
||
|
||
|
||
|
||
<style>
|
||
@media only screen {
|
||
table.full-width-table {
|
||
width: 100%;
|
||
}
|
||
}
|
||
</style>
|
||
<link rel="shortcut icon" type="image/png" href="../_static/py.svg" />
|
||
<script type="text/javascript" src="../_static/copybutton.js"></script>
|
||
<script type="text/javascript" src="../_static/menu.js"></script>
|
||
|
||
</head>
|
||
<body>
|
||
<div class="mobile-nav">
|
||
<input type="checkbox" id="menuToggler" class="toggler__input" aria-controls="navigation"
|
||
aria-pressed="false" aria-expanded="false" role="button" aria-label="Menu" />
|
||
<label for="menuToggler" class="toggler__label">
|
||
<span></span>
|
||
</label>
|
||
<nav class="nav-content" role="navigation">
|
||
<a href="https://www.python.org/" class="nav-logo">
|
||
<img src="../_static/py.svg" alt="Logo"/>
|
||
</a>
|
||
<div class="version_switcher_placeholder"></div>
|
||
<form role="search" class="search" action="../search.html" method="get">
|
||
<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" class="search-icon">
|
||
<path fill-rule="nonzero"
|
||
d="M15.5 14h-.79l-.28-.27a6.5 6.5 0 001.48-5.34c-.47-2.78-2.79-5-5.59-5.34a6.505 6.505 0 00-7.27 7.27c.34 2.8 2.56 5.12 5.34 5.59a6.5 6.5 0 005.34-1.48l.27.28v.79l4.25 4.25c.41.41 1.08.41 1.49 0 .41-.41.41-1.08 0-1.49L15.5 14zm-6 0C7.01 14 5 11.99 5 9.5S7.01 5 9.5 5 14 7.01 14 9.5 11.99 14 9.5 14z" fill="#444"></path>
|
||
</svg>
|
||
<input type="text" name="q" aria-label="快速搜索"/>
|
||
<input type="submit" value="转向"/>
|
||
</form>
|
||
</nav>
|
||
<div class="menu-wrapper">
|
||
<nav class="menu" role="navigation" aria-label="main navigation">
|
||
<div class="language_switcher_placeholder"></div>
|
||
<h3><a href="../contents.html">目录</a></h3>
|
||
<ul>
|
||
<li><a class="reference internal" href="#"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses</span></code> --- 终端字符单元显示的处理</a><ul>
|
||
<li><a class="reference internal" href="#functions">函数</a></li>
|
||
<li><a class="reference internal" href="#window-objects">Window 对象</a></li>
|
||
<li><a class="reference internal" href="#constants">常量</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a class="reference internal" href="#module-curses.textpad"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses.textpad</span></code> --- 用于 curses 程序的文本输入控件</a><ul>
|
||
<li><a class="reference internal" href="#textbox-objects">文本框对象</a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
|
||
<h4>上一个主题</h4>
|
||
<p class="topless"><a href="getpass.html"
|
||
title="上一章"><code class="xref py py-mod docutils literal notranslate"><span class="pre">getpass</span></code> --- 便携式密码输入工具</a></p>
|
||
<h4>下一个主题</h4>
|
||
<p class="topless"><a href="curses.ascii.html"
|
||
title="下一章"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses.ascii</span></code> --- 用于 ASCII 字符的工具</a></p>
|
||
<div role="note" aria-label="source link">
|
||
<h3>本页</h3>
|
||
<ul class="this-page-menu">
|
||
<li><a href="../bugs.html">报告 Bug</a></li>
|
||
<li>
|
||
<a href="https://github.com/python/cpython/blob/3.8/Doc/library/curses.rst"
|
||
rel="nofollow">显示源代码
|
||
</a>
|
||
</li>
|
||
</ul>
|
||
</div>
|
||
</nav>
|
||
</div>
|
||
</div>
|
||
|
||
<div id="outdated-warning" style="padding: .5em; text-align: center; background-color: #FFBABA; color: #6A0E0E;">
|
||
这个文档所针对的是一个已不再受支持的 Python 旧版本。
|
||
你应当升级版本，并阅读
|
||
<a href="/3/library/curses.html"> Python 当前稳定版本的文档</a>.
|
||
</div>
|
||
|
||
<div class="related" role="navigation" aria-label="related navigation">
|
||
<h3>导航</h3>
|
||
<ul>
|
||
<li class="right" style="margin-right: 10px">
|
||
<a href="../genindex.html" title="总目录"
|
||
accesskey="I">索引</a></li>
|
||
<li class="right" >
|
||
<a href="../py-modindex.html" title="Python 模块索引"
|
||
>模块</a> |</li>
|
||
<li class="right" >
|
||
<a href="curses.ascii.html" title="curses.ascii --- 用于 ASCII 字符的工具"
|
||
accesskey="N">下一页</a> |</li>
|
||
<li class="right" >
|
||
<a href="getpass.html" title="getpass --- 便携式密码输入工具"
|
||
accesskey="P">上一页</a> |</li>
|
||
|
||
<li><img src="../_static/py.svg" alt="python logo" style="vertical-align: middle; margin-top: -1px"/></li>
|
||
<li><a href="https://www.python.org/">Python</a> »</li>
|
||
<li class="switchers">
|
||
<div class="language_switcher_placeholder"></div>
|
||
<div class="version_switcher_placeholder"></div>
|
||
</li>
|
||
<li>
|
||
|
||
</li>
|
||
<li id="cpython-language-and-version">
|
||
<a href="../index.html">3.8.20 Documentation</a> »
|
||
</li>
|
||
|
||
<li class="nav-item nav-item-1"><a href="index.html" >Python 标准库</a> »</li>
|
||
<li class="nav-item nav-item-2"><a href="allos.html" accesskey="U">通用操作系统服务</a> »</li>
|
||
<li class="right">
|
||
|
||
|
||
<div class="inline-search" role="search">
|
||
<form class="inline-search" action="../search.html" method="get">
|
||
<input placeholder="快速搜索" aria-label="快速搜索" type="text" name="q" />
|
||
<input type="submit" value="转向" />
|
||
<input type="hidden" name="check_keywords" value="yes" />
|
||
<input type="hidden" name="area" value="default" />
|
||
</form>
|
||
</div>
|
||
|
|
||
</li>
|
||
|
||
</ul>
|
||
</div>
|
||
|
||
<div class="document">
|
||
<div class="documentwrapper">
|
||
<div class="bodywrapper">
|
||
<div class="body" role="main">
|
||
|
||
<section id="module-curses">
|
||
<span id="curses-terminal-handling-for-character-cell-displays"></span><h1><a class="reference internal" href="#module-curses" title="curses: An interface to the curses library, providing portable terminal handling. (Unix)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses</span></code></a> --- 终端字符单元显示的处理<a class="headerlink" href="#module-curses" title="永久链接至标题">¶</a></h1>
|
||
<hr class="docutils" />
|
||
<p><a class="reference internal" href="#module-curses" title="curses: An interface to the curses library, providing portable terminal handling. (Unix)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses</span></code></a> 模块提供了 curses 库的接口，这是可移植高级终端处理的事实标准。</p>
|
||
<p>虽然 curses 在 Unix 环境中使用最为广泛，但也有适用于 Windows，DOS 以及其他可能的系统的版本。此扩展模块旨在匹配 ncurses 的 API，这是一个部署在 Linux 和 Unix 的 BSD 变体上的开源 curses 库。</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">注解</p>
|
||
<p>每当文档提到 <strong>字符</strong> 时，它可以被指定为一个整数，一个单字符 Unicode 字符串或者一个单字节的字节字符串。</p>
|
||
<p>每当此文档提到 <strong>字符串</strong> 时，它可以被指定为一个 Unicode 字符串或者一个字节字符串。</p>
|
||
</div>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">注解</p>
|
||
<p>从 5.4 版本开始，ncurses 库使用 <code class="docutils literal notranslate"><span class="pre">nl_langinfo</span></code> 函数来决定如何解释非 ASCII 数据。这意味着你需要在程序中调用 <a class="reference internal" href="locale.html#locale.setlocale" title="locale.setlocale"><code class="xref py py-func docutils literal notranslate"><span class="pre">locale.setlocale()</span></code></a> 函数，并使用一种系统中可用的编码方法来编码 Unicode 字符串。这个例子使用了系统默认的编码:</p>
|
||
<div class="highlight-python3 notranslate"><div class="highlight"><pre><span></span><span class="kn">import</span> <span class="nn">locale</span>
|
||
<span class="n">locale</span><span class="o">.</span><span class="n">setlocale</span><span class="p">(</span><span class="n">locale</span><span class="o">.</span><span class="n">LC_ALL</span><span class="p">,</span> <span class="s1">''</span><span class="p">)</span>
|
||
<span class="n">code</span> <span class="o">=</span> <span class="n">locale</span><span class="o">.</span><span class="n">getpreferredencoding</span><span class="p">()</span>
|
||
</pre></div>
|
||
</div>
|
||
<p>然后使用 <em>code</em> 作为 <a class="reference internal" href="stdtypes.html#str.encode" title="str.encode"><code class="xref py py-meth docutils literal notranslate"><span class="pre">str.encode()</span></code></a> 调用的编码。</p>
|
||
</div>
|
||
<div class="admonition seealso">
|
||
<p class="admonition-title">参见</p>
|
||
<dl class="simple">
|
||
<dt>模块 <a class="reference internal" href="curses.ascii.html#module-curses.ascii" title="curses.ascii: Constants and set-membership functions for ASCII characters."><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses.ascii</span></code></a></dt><dd><p>在 ASCII 字符上工作的工具，无论你的区域设置是什么。</p>
|
||
</dd>
|
||
<dt>模块 <a class="reference internal" href="curses.panel.html#module-curses.panel" title="curses.panel: A panel stack extension that adds depth to curses windows."><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses.panel</span></code></a></dt><dd><p>为 curses 窗口添加深度的面板栈扩展。</p>
|
||
</dd>
|
||
<dt>模块 <a class="reference internal" href="#module-curses.textpad" title="curses.textpad: Emacs-like input editing in a curses window."><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses.textpad</span></code></a></dt><dd><p>用于使 curses 支持 <strong class="program">Emacs</strong> 式绑定的可编辑文本部件。</p>
|
||
</dd>
|
||
<dt><a class="reference internal" href="../howto/curses.html#curses-howto"><span class="std std-ref">用 Python 进行 Curses 编程</span></a></dt><dd><p>关于配合 Python 使用 curses 的教学材料，由 Andrew Kuchling 和 Eric Raymond 撰写。</p>
|
||
</dd>
|
||
</dl>
|
||
<p>Python 源码发布包的 <a class="reference external" href="https://github.com/python/cpython/tree/3.8/Tools/demo/">Tools/demo/</a> 目录包含了一些使用此模块所提供的 curses 绑定的示例程序。</p>
|
||
</div>
|
||
<section id="functions">
|
||
<span id="curses-functions"></span><h2>函数<a class="headerlink" href="#functions" title="永久链接至标题">¶</a></h2>
|
||
<p><a class="reference internal" href="#module-curses" title="curses: An interface to the curses library, providing portable terminal handling. (Unix)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses</span></code></a> 模块定义了以下异常：</p>
|
||
<dl class="exception">
|
||
<dt id="curses.error">
|
||
<em class="property">exception </em><code class="sig-prename descclassname">curses.</code><code class="sig-name descname">error</code><a class="headerlink" href="#curses.error" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>当 curses 库中函数返回一个错误时引发的异常。</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">注解</p>
|
||
<p>只要一个函数或方法的 <em>x</em> 或 <em>y</em> 参数是可选项，它们会默认为当前光标位置。 而当 <em>attr</em> 是可选项时，它会默认为 <code class="xref py py-const docutils literal notranslate"><span class="pre">A_NORMAL</span></code>。</p>
|
||
</div>
|
||
<p><a class="reference internal" href="#module-curses" title="curses: An interface to the curses library, providing portable terminal handling. (Unix)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses</span></code></a> 模块定义了以下函数：</p>
|
||
<dl class="function">
|
||
<dt id="curses.baudrate">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">baudrate</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.baudrate" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>以每秒比特数为单位返回终端输出速度。 在软件终端模拟器上它将具有一个固定的最高值。 此函数出于历史原因被包括；在以前，它被用于写输出循环以提供时间延迟，并偶尔根据线路速度来改变接口。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.beep">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">beep</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.beep" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>发出短促的提醒声音。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.can_change_color">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">can_change_color</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.can_change_color" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>根据程序员能否改变终端显示的颜色返回 <code class="docutils literal notranslate"><span class="pre">True</span></code> 或 <code class="docutils literal notranslate"><span class="pre">False</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.cbreak">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">cbreak</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.cbreak" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>进入 cbreak 模式。 在 cbreak 模式（有时也称为“稀有”模式）通常的 tty 行缓冲会被关闭并且字符可以被一个一个地读取。 但是，与原始模式不同，特殊字符（中断、退出、挂起和流程控制）会在 tty 驱动和调用程序上保留其效果。 首先调用 <a class="reference internal" href="#curses.raw" title="curses.raw"><code class="xref py py-func docutils literal notranslate"><span class="pre">raw()</span></code></a> 然后调用 <a class="reference internal" href="#curses.cbreak" title="curses.cbreak"><code class="xref py py-func docutils literal notranslate"><span class="pre">cbreak()</span></code></a> 会将终端置于 cbreak 模式。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.color_content">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">color_content</code><span class="sig-paren">(</span><em class="sig-param">color_number</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.color_content" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>返回颜色值 <em>color_number</em> 中红、绿和蓝（RGB）分量的强度，此强度值必须介于 <code class="docutils literal notranslate"><span class="pre">0</span></code> 和 <code class="docutils literal notranslate"><span class="pre">COLORS</span> <span class="pre">-</span> <span class="pre">1</span></code> 之间。 返回一个 3 元组，其中包含给定颜色的 R,G,B 值，它们必须介于 <code class="docutils literal notranslate"><span class="pre">0</span></code> (无分量) 和 <code class="docutils literal notranslate"><span class="pre">1000</span></code> (最大分量) 之间。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.color_pair">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">color_pair</code><span class="sig-paren">(</span><em class="sig-param">pair_number</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.color_pair" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>返回用于以指定颜色对显示文本的属性值。 仅支持前 256 个颜色对。 该属性值可与 <code class="xref py py-const docutils literal notranslate"><span class="pre">A_STANDOUT</span></code>, <code class="xref py py-const docutils literal notranslate"><span class="pre">A_REVERSE</span></code> 以及其他 <code class="xref py py-const docutils literal notranslate"><span class="pre">A_*</span></code> 属性组合使用。 <a class="reference internal" href="#curses.pair_number" title="curses.pair_number"><code class="xref py py-func docutils literal notranslate"><span class="pre">pair_number()</span></code></a> 是此函数的对应操作。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.curs_set">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">curs_set</code><span class="sig-paren">(</span><em class="sig-param">visibility</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.curs_set" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>设置光标状态。 <em>visibility</em> 可设为 <code class="docutils literal notranslate"><span class="pre">0</span></code>, <code class="docutils literal notranslate"><span class="pre">1</span></code> 或 <code class="docutils literal notranslate"><span class="pre">2</span></code> 表示不可见、正常与高度可见。 如果终端支持所请求的可见性，则返回之前的光标状态；否则会引发异常。 在许多终端上，“正常可见”模式为下划线光标而“高度可见”模式为方块形光标。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.def_prog_mode">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">def_prog_mode</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.def_prog_mode" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将当前终端模式保存为 "program" 模式，即正在运行的程序使用 curses 的模式。 （与其相对的是 "shell" 模式，即程序不使用 curses。） 对 <a class="reference internal" href="#curses.reset_prog_mode" title="curses.reset_prog_mode"><code class="xref py py-func docutils literal notranslate"><span class="pre">reset_prog_mode()</span></code></a> 的后续调用将恢复此模式。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.def_shell_mode">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">def_shell_mode</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.def_shell_mode" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将当前终端模式保存为 "shell" 模式，即正在运行的程序不使用 curses 的模式。 （与其相对的是 "program" 模式，即程序使用 功能。） 对 <a class="reference internal" href="#curses.reset_shell_mode" title="curses.reset_shell_mode"><code class="xref py py-func docutils literal notranslate"><span class="pre">reset_shell_mode()</span></code></a> 的后续调用将恢复此模式。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.delay_output">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">delay_output</code><span class="sig-paren">(</span><em class="sig-param">ms</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.delay_output" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>在输出中插入 <em>ms</em> 毫秒的暂停。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.doupdate">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">doupdate</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.doupdate" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>更新物理屏幕。 curses 库会保留两个数据结构，一个代表当前物理屏幕的内容以及一个虚拟屏幕代表需要的后续状态。 <a class="reference internal" href="#curses.doupdate" title="curses.doupdate"><code class="xref py py-func docutils literal notranslate"><span class="pre">doupdate()</span></code></a> 整体更新物理屏幕以匹配虚拟屏幕。</p>
|
||
<p>虚拟屏幕可以通过在写入操作例如在一个窗口上执行 <a class="reference internal" href="#curses.window.addstr" title="curses.window.addstr"><code class="xref py py-meth docutils literal notranslate"><span class="pre">addstr()</span></code></a> 之后调用 <a class="reference internal" href="#curses.window.noutrefresh" title="curses.window.noutrefresh"><code class="xref py py-meth docutils literal notranslate"><span class="pre">noutrefresh()</span></code></a> 来刷新。 普通的 <a class="reference internal" href="#curses.window.refresh" title="curses.window.refresh"><code class="xref py py-meth docutils literal notranslate"><span class="pre">refresh()</span></code></a> 调用只是简单的 <code class="xref py py-meth docutils literal notranslate"><span class="pre">noutrefresh()</span></code> 加 <code class="xref py py-func docutils literal notranslate"><span class="pre">doupdate()</span></code>；如果你需要更新多个窗口，你可以通过在所有窗口上发出 <code class="xref py py-meth docutils literal notranslate"><span class="pre">noutrefresh()</span></code> 调用再加单次 <code class="xref py py-func docutils literal notranslate"><span class="pre">doupdate()</span></code> 来提升性能并可减少屏幕闪烁。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.echo">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">echo</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.echo" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>进入 echo 模式。 在 echo 模式下，输入的每个字符都会在输入后回显到屏幕上。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.endwin">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">endwin</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.endwin" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>撤销库的初始化，使终端返回正常状态。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.erasechar">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">erasechar</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.erasechar" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将用户的当前擦除字符以单字节字节串对象的形式返回。 在 Unix 操作系统下这是 curses 程序用来控制 tty 的属性，而不是由 curses 库本身来设置的。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.filter">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">filter</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.filter" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果要使用 <a class="reference internal" href="#curses.filter" title="curses.filter"><code class="xref py py-func docutils literal notranslate"><span class="pre">filter()</span></code></a> 例程，它必须在调用 <a class="reference internal" href="#curses.initscr" title="curses.initscr"><code class="xref py py-func docutils literal notranslate"><span class="pre">initscr()</span></code></a> 之前被调用。 其效果是在这些调用期间，<span class="target" id="index-18"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">LINES</span></code> 会被设为 <code class="docutils literal notranslate"><span class="pre">1</span></code>；<code class="docutils literal notranslate"><span class="pre">clear</span></code>, <code class="docutils literal notranslate"><span class="pre">cup</span></code>, <code class="docutils literal notranslate"><span class="pre">cud</span></code>, <code class="docutils literal notranslate"><span class="pre">cud1</span></code>, <code class="docutils literal notranslate"><span class="pre">cuu1</span></code>, <code class="docutils literal notranslate"><span class="pre">cuu</span></code>, <code class="docutils literal notranslate"><span class="pre">vpa</span></code> 等功能会被禁用；而 <code class="docutils literal notranslate"><span class="pre">home</span></code> 字符串会被设为 <code class="docutils literal notranslate"><span class="pre">cr</span></code> 的值。 其影响是光标会被限制在当前行内，屏幕刷新也是如此。 这可被用于启用单字符模式的行编辑而不触及屏幕的其余部分。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.flash">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">flash</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.flash" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>闪烁屏幕。 也就是将其改为反显并在很短的时间内将其改回原状。 有些人更喜欢这样的‘视觉响铃’而非 <a class="reference internal" href="#curses.beep" title="curses.beep"><code class="xref py py-func docutils literal notranslate"><span class="pre">beep()</span></code></a> 所产生的听觉提醒信号。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.flushinp">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">flushinp</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.flushinp" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>刷新所有输入缓冲区。 这会丢弃任何已被用户输入但尚未被程序处理的预输入内容。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.getmouse">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">getmouse</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.getmouse" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>在 <a class="reference internal" href="#curses.window.getch" title="curses.window.getch"><code class="xref py py-meth docutils literal notranslate"><span class="pre">getch()</span></code></a> 返回 <code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_MOUSE</span></code> 以发出鼠标事件信号之后，应当调用此方法来获取加入队列的鼠标事件，事件以一个 5 元组 <code class="docutils literal notranslate"><span class="pre">(id,</span> <span class="pre">x,</span> <span class="pre">y,</span> <span class="pre">z,</span> <span class="pre">bstate)</span></code> 来表示。 <em>id</em> 为用于区分多个设置的 ID 值， <em>x</em>, <em>y</em>, <em>z</em> 为事件的坐标。 (<em>z</em> 目前未被使用。) <em>bstate</em> 为一个整数值，其各比特位将设置用于表示事件类型，并将是下列常量中一个或多个按位 OR 的结果，其中 <em>n</em> 是以 1 至 4 表示的键号: <code class="xref py py-const docutils literal notranslate"><span class="pre">BUTTONn_PRESSED</span></code>, <code class="xref py py-const docutils literal notranslate"><span class="pre">BUTTONn_RELEASED</span></code>, <code class="xref py py-const docutils literal notranslate"><span class="pre">BUTTONn_CLICKED</span></code>, <code class="xref py py-const docutils literal notranslate"><span class="pre">BUTTONn_DOUBLE_CLICKED</span></code>, <code class="xref py py-const docutils literal notranslate"><span class="pre">BUTTONn_TRIPLE_CLICKED</span></code>, <code class="xref py py-const docutils literal notranslate"><span class="pre">BUTTON_SHIFT</span></code>, <code class="xref py py-const docutils literal notranslate"><span class="pre">BUTTON_CTRL</span></code>, <code class="xref py py-const docutils literal notranslate"><span class="pre">BUTTON_ALT</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.getsyx">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">getsyx</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.getsyx" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将当前虚拟屏幕光标的坐标作为元组 <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> 返回。 如果 <a class="reference internal" href="#curses.window.leaveok" title="curses.window.leaveok"><code class="xref py py-meth docutils literal notranslate"><span class="pre">leaveok</span></code></a> 当前为 <code class="docutils literal notranslate"><span class="pre">True</span></code>，则返回 <code class="docutils literal notranslate"><span class="pre">(-1,</span> <span class="pre">-1)</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.getwin">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">getwin</code><span class="sig-paren">(</span><em class="sig-param">file</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.getwin" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>读取由之前的 <code class="xref py py-func docutils literal notranslate"><span class="pre">putwin()</span></code> 调用存放在文件中的窗口相关数据。 该例程随后将使用该数据创建并初始化一个新窗口，并返回该新窗口对象。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.has_colors">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">has_colors</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.has_colors" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果终端能显示彩色则返回 <code class="docutils literal notranslate"><span class="pre">True</span></code>；否则返回 <code class="docutils literal notranslate"><span class="pre">False</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.has_ic">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">has_ic</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.has_ic" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果终端具有插入和删除字符的功能则返回 <code class="docutils literal notranslate"><span class="pre">True</span></code>。 此函数仅是出于历史原因而被包括的，因为所有现代软件终端模拟器都具有这些功能。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.has_il">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">has_il</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.has_il" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果终端具有插入和删除字符功能，或者能够使用滚动区域来模拟这些功能则返回 <code class="docutils literal notranslate"><span class="pre">True</span></code>。 此函数仅是出于历史原因而被包括的，因为所有现代软件终端模拟器都具有这些功能。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.has_key">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">has_key</code><span class="sig-paren">(</span><em class="sig-param">ch</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.has_key" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>接受一个键值 <em>ch</em>，并在当前终端类型能识别出具有该值的键时返回 <code class="docutils literal notranslate"><span class="pre">True</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.halfdelay">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">halfdelay</code><span class="sig-paren">(</span><em class="sig-param">tenths</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.halfdelay" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>用于半延迟模式，与 cbreak 模式的类似之处是用户所键入的字符会立即对程序可用。 但是，在阻塞 <em>tenths</em> 个十分之一秒之后，如果还未输入任何内容则将引发异常。 <em>tenths</em> 值必须为 <code class="docutils literal notranslate"><span class="pre">1</span></code> 和 <code class="docutils literal notranslate"><span class="pre">255</span></code> 之间的数字。 使用 <a class="reference internal" href="#curses.nocbreak" title="curses.nocbreak"><code class="xref py py-func docutils literal notranslate"><span class="pre">nocbreak()</span></code></a> 可退出半延迟模式。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.init_color">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">init_color</code><span class="sig-paren">(</span><em class="sig-param">color_number</em>, <em class="sig-param">r</em>, <em class="sig-param">g</em>, <em class="sig-param">b</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.init_color" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>更改某个颜色的定义，接受要更改的颜色编号以及三个 RGB 值（表示红绿蓝三分量的强度）。 <em>color_number</em> 值必须为 <code class="docutils literal notranslate"><span class="pre">0</span></code> 和 <cite>COLORS - 1</cite> 之间的数字。 <em>r</em>, <em>g</em>, <em>b</em> 值必须为 <code class="docutils literal notranslate"><span class="pre">0</span></code> 和 <code class="docutils literal notranslate"><span class="pre">1000</span></code> 之间的数字。 当使用 <a class="reference internal" href="#curses.init_color" title="curses.init_color"><code class="xref py py-func docutils literal notranslate"><span class="pre">init_color()</span></code></a> 时，出现在屏幕上的对应颜色会立即按照新定义来更改。 此函数在大多数终端上都是无操作的；它仅会在 <a class="reference internal" href="#curses.can_change_color" title="curses.can_change_color"><code class="xref py py-func docutils literal notranslate"><span class="pre">can_change_color()</span></code></a> 返回 <code class="docutils literal notranslate"><span class="pre">True</span></code> 时生效。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.init_pair">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">init_pair</code><span class="sig-paren">(</span><em class="sig-param">pair_number</em>, <em class="sig-param">fg</em>, <em class="sig-param">bg</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.init_pair" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>更改某个颜色对的定义。 它接受三个参数：要更改的颜色对编号，前景色编号和背景色编号。 <em>pair_number</em> 值必须为 <code class="docutils literal notranslate"><span class="pre">1</span></code> 和 <code class="docutils literal notranslate"><span class="pre">COLOR_PAIRS</span> <span class="pre">-</span> <span class="pre">1</span></code> 之间的数字（并且 <code class="docutils literal notranslate"><span class="pre">0</span></code> 号颜色对固定为黑底白字而无法更改）。 <em>fg</em> 和 <em>bg</em> 参数必须为 <code class="docutils literal notranslate"><span class="pre">0</span></code> 和 <code class="docutils literal notranslate"><span class="pre">COLORS</span> <span class="pre">-</span> <span class="pre">1</span></code> 之间的数字，或者在调用 <a class="reference internal" href="#curses.use_default_colors" title="curses.use_default_colors"><code class="xref py py-func docutils literal notranslate"><span class="pre">use_default_colors()</span></code></a> 之后则为 <code class="docutils literal notranslate"><span class="pre">-1</span></code>。 如果颜色对之前已被初始化，则屏幕会被刷新使得出现在屏幕上的该颜色会立即按照新定义来更改。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.initscr">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">initscr</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.initscr" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>初始化库。 返回代表整个屏幕的 <a class="reference internal" href="#curses-window-objects"><span class="std std-ref">窗口</span></a> 对象。</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">注解</p>
|
||
<p>如果打开终端时发生错误，则下层的 curses 库可能会导致解释器退出。</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.is_term_resized">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">is_term_resized</code><span class="sig-paren">(</span><em class="sig-param">nlines</em>, <em class="sig-param">ncols</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.is_term_resized" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果 <a class="reference internal" href="#curses.resize_term" title="curses.resize_term"><code class="xref py py-func docutils literal notranslate"><span class="pre">resize_term()</span></code></a> 会修改窗口结构则返回 <code class="docutils literal notranslate"><span class="pre">True</span></code>，否则返回 <code class="docutils literal notranslate"><span class="pre">False</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.isendwin">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">isendwin</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.isendwin" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果 <a class="reference internal" href="#curses.endwin" title="curses.endwin"><code class="xref py py-func docutils literal notranslate"><span class="pre">endwin()</span></code></a> 已经被调用（即 curses 库已经被撤销初始化则返回 <code class="docutils literal notranslate"><span class="pre">True</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.keyname">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">keyname</code><span class="sig-paren">(</span><em class="sig-param">k</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.keyname" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将编号为 <em>k</em> 的键名称作为字节串对象返回。 生成可打印 ASCII 字符的键名称就是键所对应的字符。 Ctrl-键组合的键名称则是一个两字节的字节串对象，它由插入符 (<code class="docutils literal notranslate"><span class="pre">b'^'</span></code>) 加对应的可打印 ASCII 字符组成。 Alt-键组合 (128--255) 的键名称则是由前缀 <code class="docutils literal notranslate"><span class="pre">b'M-'</span></code> 加对应的可打印 ASCII 字符组成的字节串对象。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.killchar">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">killchar</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.killchar" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将用户的当前行删除字符以单字节字节串对象的形式返回。 在 Unix 操作系统下这是 curses 程序用来控制 tty 的属性，而不是由 curses 库本身来设置的。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.longname">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">longname</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.longname" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>返回一个字节串对象，其中包含描述当前终端的 terminfo 长名称字段。 详细描述的最大长度为 128 个字符。 它仅在调用 <a class="reference internal" href="#curses.initscr" title="curses.initscr"><code class="xref py py-func docutils literal notranslate"><span class="pre">initscr()</span></code></a> 之后才会被定义。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.meta">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">meta</code><span class="sig-paren">(</span><em class="sig-param">flag</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.meta" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">True</span></code>，则允许输入 8 比特位的字符。 如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">False</span></code>，则只允许 7 比特位的字符。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.mouseinterval">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">mouseinterval</code><span class="sig-paren">(</span><em class="sig-param">interval</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.mouseinterval" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>以毫秒为单位设置能够被识别为点击的按下和释放事件之间可以间隔的最长时间，并返回之前的间隔值。 默认值为 200 毫秒，即五分之一秒。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.mousemask">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">mousemask</code><span class="sig-paren">(</span><em class="sig-param">mousemask</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.mousemask" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>设置要报告的鼠标事件，并返回一个元组 <code class="docutils literal notranslate"><span class="pre">(availmask,</span> <span class="pre">oldmask)</span></code>。 <em>availmask</em> 表明指定的鼠标事件中哪些可以被报告；当完全失败时将返回 <code class="docutils literal notranslate"><span class="pre">0</span></code>。 <em>oldmask</em> 是给定窗口的鼠标事件之前的掩码值。 如果从未调用此函数，则不会报告任何鼠标事件。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.napms">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">napms</code><span class="sig-paren">(</span><em class="sig-param">ms</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.napms" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>休眠 <em>ms</em> 毫秒。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.newpad">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">newpad</code><span class="sig-paren">(</span><em class="sig-param">nlines</em>, <em class="sig-param">ncols</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.newpad" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>创建并返回一个指向具有给定行数和列数新的面板数据结构的指针。 将面板作为窗口对象返回。</p>
|
||
<p>面板类似于窗口，区别在于它不受屏幕大小的限制，并且不必与屏幕的特定部分相关联。 面板可以在需要使用大窗口时使用，并且每次只需将窗口的一部分放在屏幕上。 面板不会发生自动刷新（例如由于滚动或输入回显）。 面板的 <a class="reference internal" href="#curses.window.refresh" title="curses.window.refresh"><code class="xref py py-meth docutils literal notranslate"><span class="pre">refresh()</span></code></a> 和 <a class="reference internal" href="#curses.window.noutrefresh" title="curses.window.noutrefresh"><code class="xref py py-meth docutils literal notranslate"><span class="pre">noutrefresh()</span></code></a> 方法需要 6 个参数来指定面板要显示的部分以及要用于显示的屏幕位置。 这些参数是 <em>pminrow</em>, <em>pmincol</em>, <em>sminrow</em>, <em>smincol</em>, <em>smaxrow</em>, <em>smaxcol</em>；<em>p</em> 参数表示要显示的面板区域的左上角而 <em>s</em> 参数定义了要显示的面板区域在屏幕上的剪切框。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.newwin">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">newwin</code><span class="sig-paren">(</span><em class="sig-param">nlines</em>, <em class="sig-param">ncols</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.newwin" title="永久链接至目标">¶</a></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">newwin</code><span class="sig-paren">(</span><em class="sig-param">nlines</em>, <em class="sig-param">ncols</em>, <em class="sig-param">begin_y</em>, <em class="sig-param">begin_x</em><span class="sig-paren">)</span></dt>
|
||
<dd><p>返回一个新的 <a class="reference internal" href="#curses-window-objects"><span class="std std-ref">窗口</span></a>，其左上角位于 <code class="docutils literal notranslate"><span class="pre">(begin_y,</span> <span class="pre">begin_x)</span></code>，并且其高度/宽度为 <em>nlines</em>/<em>ncols</em>。</p>
|
||
<p>默认情况下，窗口将从指定位置扩展到屏幕的右下角。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.nl">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">nl</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.nl" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>进入 newline 模式。 此模式会在输入时将回车转换为换行符，并在输出时将换行符转换为回车加换行。 newline 模式会在初始时启用。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.nocbreak">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">nocbreak</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.nocbreak" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>退出 cbreak 模式。 返回具有行缓冲的正常 "cooked" 模式。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.noecho">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">noecho</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.noecho" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>退出 echo 模式。 关闭输入字符的回显。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.nonl">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">nonl</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.nonl" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>退出 newline 模式。 停止在输入时将回车转换为换行，并停止在输出时从换行到换行/回车的底层转换（但这不会改变 <code class="docutils literal notranslate"><span class="pre">addch('\n')</span></code> 的行为，此行为总是在虚拟屏幕上执行相当于回车加换行的操作）。 当停止转换时，curses 有时能使纵向移动加快一些；并且，它将能够在输入时检测回车键。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.noqiflush">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">noqiflush</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.noqiflush" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>当使用 <code class="xref py py-func docutils literal notranslate"><span class="pre">noqiflush()</span></code> 例程时，与 <code class="docutils literal notranslate"><span class="pre">INTR</span></code>, <code class="docutils literal notranslate"><span class="pre">QUIT</span></code> 和 <code class="docutils literal notranslate"><span class="pre">SUSP</span></code> 字符相关联的输入和输出队列的正常刷新将不会被执行。 如果你希望在处理程序退出后还能继续输出，就像没有发生过中断一样，你可能会想要在信号处理程序中调用 <code class="xref py py-func docutils literal notranslate"><span class="pre">noqiflush()</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.noraw">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">noraw</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.noraw" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>退出 raw 模式。 返回具有行缓冲的正常 "cooked" 模式。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.pair_content">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">pair_content</code><span class="sig-paren">(</span><em class="sig-param">pair_number</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.pair_content" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>返回包含对应于所请求颜色对的元组 <code class="docutils literal notranslate"><span class="pre">(fg,</span> <span class="pre">bg)</span></code>。 <em>pair_number</em> 的值必须在 <code class="docutils literal notranslate"><span class="pre">0</span></code> 和 <code class="docutils literal notranslate"><span class="pre">COLOR_PAIRS</span> <span class="pre">-</span> <span class="pre">1</span></code> 之间。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.pair_number">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">pair_number</code><span class="sig-paren">(</span><em class="sig-param">attr</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.pair_number" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>返回通过属性值 <em>attr</em> 所设置的颜色对的编号。 <a class="reference internal" href="#curses.color_pair" title="curses.color_pair"><code class="xref py py-func docutils literal notranslate"><span class="pre">color_pair()</span></code></a> 是此函数的对应操作。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.putp">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">putp</code><span class="sig-paren">(</span><em class="sig-param">str</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.putp" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>等价于 <code class="docutils literal notranslate"><span class="pre">tputs(str,</span> <span class="pre">1,</span> <span class="pre">putchar)</span></code>；为当前终端发出指定 terminfo 功能的值。 请注意 <a class="reference internal" href="#curses.putp" title="curses.putp"><code class="xref py py-func docutils literal notranslate"><span class="pre">putp()</span></code></a> 的输出总是前往标准输出。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.qiflush">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">qiflush</code><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param">flag</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.qiflush" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">False</span></code>，则效果与调用 <a class="reference internal" href="#curses.noqiflush" title="curses.noqiflush"><code class="xref py py-func docutils literal notranslate"><span class="pre">noqiflush()</span></code></a> 相同。 如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">True</span></code> 或未提供参数，则在读取这些控制字符时队列将被刷新。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.raw">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">raw</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.raw" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>进入 raw 模式。 在 raw 模式下，正常的行缓冲和对中断、退出、挂起和流程控制键的处理会被关闭；字符会被逐个地提交给 curses 输入函数。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.reset_prog_mode">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">reset_prog_mode</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.reset_prog_mode" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将终端恢复到 "program" 模式，如之前由 <a class="reference internal" href="#curses.def_prog_mode" title="curses.def_prog_mode"><code class="xref py py-func docutils literal notranslate"><span class="pre">def_prog_mode()</span></code></a> 所保存的一样。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.reset_shell_mode">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">reset_shell_mode</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.reset_shell_mode" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将终端恢复到 "shell" 模式，如之前由 <a class="reference internal" href="#curses.def_shell_mode" title="curses.def_shell_mode"><code class="xref py py-func docutils literal notranslate"><span class="pre">def_shell_mode()</span></code></a> 所保存的一样。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.resetty">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">resetty</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.resetty" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将终端模式恢复到最后一次调用 <a class="reference internal" href="#curses.savetty" title="curses.savetty"><code class="xref py py-func docutils literal notranslate"><span class="pre">savetty()</span></code></a> 时的状态。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.resize_term">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">resize_term</code><span class="sig-paren">(</span><em class="sig-param">nlines</em>, <em class="sig-param">ncols</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.resize_term" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>由 <a class="reference internal" href="#curses.resizeterm" title="curses.resizeterm"><code class="xref py py-func docutils literal notranslate"><span class="pre">resizeterm()</span></code></a> 用来执行大部分工作的后端函数；当调整窗口大小时，<a class="reference internal" href="#curses.resize_term" title="curses.resize_term"><code class="xref py py-func docutils literal notranslate"><span class="pre">resize_term()</span></code></a> 会以空白填充扩展区域。 调用方应用程序应当以适当的数据填充这些区域。 <code class="xref py py-func docutils literal notranslate"><span class="pre">resize_term()</span></code> 函数会尝试调整所有窗口的大小。 但是，由于面板的调用约定，在不与应用程序进行额外交互的情况下是无法调整其大小的。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.resizeterm">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">resizeterm</code><span class="sig-paren">(</span><em class="sig-param">nlines</em>, <em class="sig-param">ncols</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.resizeterm" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将标准窗口和当前窗口的大小调整为指定的尺寸，并调整由 curses 库所使用的记录窗口尺寸的其他记录数据（特别是 SIGWINCH 处理程序）。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.savetty">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">savetty</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.savetty" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将终端模式的当前状态保存在缓冲区中，可供 <a class="reference internal" href="#curses.resetty" title="curses.resetty"><code class="xref py py-func docutils literal notranslate"><span class="pre">resetty()</span></code></a> 使用。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.setsyx">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">setsyx</code><span class="sig-paren">(</span><em class="sig-param">y</em>, <em class="sig-param">x</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.setsyx" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将虚拟屏幕光标设置到 <em>y</em>, <em>x</em>。 如果 <em>y</em> 和 <em>x</em> 均为 <code class="docutils literal notranslate"><span class="pre">-1</span></code>，则 <a class="reference internal" href="#curses.window.leaveok" title="curses.window.leaveok"><code class="xref py py-meth docutils literal notranslate"><span class="pre">leaveok</span></code></a> 将设为 <code class="docutils literal notranslate"><span class="pre">True</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.setupterm">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">setupterm</code><span class="sig-paren">(</span><em class="sig-param">term=None</em>, <em class="sig-param">fd=-1</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.setupterm" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>初始化终端。 <em>term</em> 为给出终端名称的字符串或为 <code class="docutils literal notranslate"><span class="pre">None</span></code>；如果省略或为 <code class="docutils literal notranslate"><span class="pre">None</span></code>，则将使用 <span class="target" id="index-19"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">TERM</span></code> 环境变量的值。 <em>fd</em> 是任何初始化序列将被发送到的文件描述符；如未指定或为 <code class="docutils literal notranslate"><span class="pre">-1</span></code>，则将使用 <code class="docutils literal notranslate"><span class="pre">sys.stdout</span></code> 的文件描述符。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.start_color">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">start_color</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.start_color" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果程序员想要使用颜色，则必须在任何其他颜色操作例程被调用之前调用它。 在 <a class="reference internal" href="#curses.initscr" title="curses.initscr"><code class="xref py py-func docutils literal notranslate"><span class="pre">initscr()</span></code></a> 之后立即调用此例程是一个很好的做法。</p>
|
||
<p><a class="reference internal" href="#curses.start_color" title="curses.start_color"><code class="xref py py-func docutils literal notranslate"><span class="pre">start_color()</span></code></a> 会初始化八种基本颜色（黑、红、绿、黄、蓝、品、青和白）以及 <a class="reference internal" href="#module-curses" title="curses: An interface to the curses library, providing portable terminal handling. (Unix)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses</span></code></a> 模块中的两个全局变量 <code class="xref py py-const docutils literal notranslate"><span class="pre">COLORS</span></code> 和 <code class="xref py py-const docutils literal notranslate"><span class="pre">COLOR_PAIRS</span></code>，其中包含终端可支持的颜色和颜色对的最大数量。 它还会将终端中的颜色恢复为终端刚启动时的值。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.termattrs">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">termattrs</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.termattrs" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>返回终端所支持的所有视频属性逻辑 OR 的值。 此信息适用于当 curses 程序需要对屏幕外观进行完全控制的情况。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.termname">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">termname</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.termname" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将环境变量 <span class="target" id="index-20"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">TERM</span></code> 的值截短至 14 个字节，作为字节串对象返回。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.tigetflag">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">tigetflag</code><span class="sig-paren">(</span><em class="sig-param">capname</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.tigetflag" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将与 terminfo 功能名称 <em>capname</em> 相对应的布尔功能值以整数形式返回。 如果 <em>capname</em> 不是一个布尔功能则返回 <code class="docutils literal notranslate"><span class="pre">-1</span></code>，如果其被取消或不存在于终端描述中则返回 <code class="docutils literal notranslate"><span class="pre">0</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.tigetnum">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">tigetnum</code><span class="sig-paren">(</span><em class="sig-param">capname</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.tigetnum" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将与 terminfo 功能名称 <em>capname</em> 相对应的数字功能值以整数形式返回。 如果 <em>capname</em> 不是一个数字功能则返回 <code class="docutils literal notranslate"><span class="pre">-2</span></code>，如果其被取消或不存在于终端描述中则返回 <code class="docutils literal notranslate"><span class="pre">-1</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.tigetstr">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">tigetstr</code><span class="sig-paren">(</span><em class="sig-param">capname</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.tigetstr" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将与 terminfo 功能名称 <em>capname</em> 相对应的字符串功能值以字节串对象形式返回。 如果 <em>capname</em> 不是一个 terminfo "字符串功能" 或者如果其被取消或不存在于终端描述中则返回 <code class="docutils literal notranslate"><span class="pre">None</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.tparm">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">tparm</code><span class="sig-paren">(</span><em class="sig-param">str</em><span class="optional">[</span>, <em class="sig-param">...</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.tparm" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>使用提供的形参初始化字节串对象 <em>str</em>，其中 <em>str</em> 应当是从 terminfo 数据库获取的参数化字符串。 例如 <code class="docutils literal notranslate"><span class="pre">tparm(tigetstr("cup"),</span> <span class="pre">5,</span> <span class="pre">3)</span></code> 的结果可能为 <code class="docutils literal notranslate"><span class="pre">b'\033[6;4H'</span></code>，实际结果将取决于终端类型。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.typeahead">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">typeahead</code><span class="sig-paren">(</span><em class="sig-param">fd</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.typeahead" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>指定将被用于预输入检查的文件描述符 <em>fd</em>。 如果 <em>fd</em> 为 <code class="docutils literal notranslate"><span class="pre">-1</span></code>，则不执行预输入检查。</p>
|
||
<p>curses 库会在更新屏幕时通过定期查找预输入来执行 "断行优化"。 如果找到了输入，并且输入是来自于 tty，则会将当前更新推迟至 refresh 或 doupdate 再次被调用的时候，以便允许更快地响应预先输入的命令。 此函数允许为预输入检查指定其他的文件描述符。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.unctrl">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">unctrl</code><span class="sig-paren">(</span><em class="sig-param">ch</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.unctrl" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>返回一个字节串对象作为字符 <em>ch</em> 的可打印表示形式。 控制字符会表示为一个变换符加相应的字符，例如 <code class="docutils literal notranslate"><span class="pre">b'^C'</span></code>。 可打印字符则会保持原样。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.ungetch">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">ungetch</code><span class="sig-paren">(</span><em class="sig-param">ch</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.ungetch" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>推送 <em>ch</em> 以便让下一个 <a class="reference internal" href="#curses.window.getch" title="curses.window.getch"><code class="xref py py-meth docutils literal notranslate"><span class="pre">getch()</span></code></a> 返回该字符。</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">注解</p>
|
||
<p>在 <code class="xref py py-meth docutils literal notranslate"><span class="pre">getch()</span></code> 被调用之前只能推送一个 <em>ch</em>。</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.update_lines_cols">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">update_lines_cols</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.update_lines_cols" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>更新 <span class="target" id="index-21"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">LINES</span></code> 和 <span class="target" id="index-22"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">COLS</span></code>。 适用于检测屏幕大小的手动调整。</p>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">3.5 新版功能.</span></p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.unget_wch">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">unget_wch</code><span class="sig-paren">(</span><em class="sig-param">ch</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.unget_wch" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>推送 <em>ch</em> 以便让下一个 <a class="reference internal" href="#curses.window.get_wch" title="curses.window.get_wch"><code class="xref py py-meth docutils literal notranslate"><span class="pre">get_wch()</span></code></a> 返回该字符。</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">注解</p>
|
||
<p>在 <code class="xref py py-meth docutils literal notranslate"><span class="pre">get_wch()</span></code> 被调用之前只能推送一个 <em>ch</em>。</p>
|
||
</div>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">3.3 新版功能.</span></p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.ungetmouse">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">ungetmouse</code><span class="sig-paren">(</span><em class="sig-param">id</em>, <em class="sig-param">x</em>, <em class="sig-param">y</em>, <em class="sig-param">z</em>, <em class="sig-param">bstate</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.ungetmouse" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将 <code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_MOUSE</span></code> 事件推送到输入队列，将其与给定的状态数据进行关联。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.use_env">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">use_env</code><span class="sig-paren">(</span><em class="sig-param">flag</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.use_env" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果使用此函数，则应当在调用 <a class="reference internal" href="#curses.initscr" title="curses.initscr"><code class="xref py py-func docutils literal notranslate"><span class="pre">initscr()</span></code></a> 或 newterm 之前调用它。 当 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">False</span></code> 时，将会使用在 terminfo 数据库中指定的行和列的值，即使设置了环境变量 <span class="target" id="index-23"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">LINES</span></code> 和 <span class="target" id="index-24"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">COLUMNS</span></code> (默认使用)，或者如果 curses 是在窗口中运行（在此情况下如果未设置 <span class="target" id="index-25"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">LINES</span></code> 和 <span class="target" id="index-26"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">COLUMNS</span></code> 则默认行为将是使用窗口大小）。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.use_default_colors">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">use_default_colors</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.use_default_colors" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>允许在支持此特性的终端上使用默认的颜色值。 使用此函数可在你的应用程序中支持透明效果。 默认颜色会被赋给颜色编号 <code class="docutils literal notranslate"><span class="pre">-1</span></code>。 举例来说，在调用此函数后，<code class="docutils literal notranslate"><span class="pre">init_pair(x,</span> <span class="pre">curses.COLOR_RED,</span> <span class="pre">-1)</span></code> 会将颜色对 <em>x</em> 初始化为红色前景和默认颜色背景。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="function">
|
||
<dt id="curses.wrapper">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">wrapper</code><span class="sig-paren">(</span><em class="sig-param">func</em>, <em class="sig-param">...</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.wrapper" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>初始化 curses 并调用另一个可调用对象 <em>func</em>，该对象应当为你的使用 curses 的应用程序的其余部分。 如果应用程序引发了异常，此函数将在重新引发异常并生成回溯信息之前将终端恢复到正常状态。 随后可调用对象 <em>func</em> 会被传入主窗口 'stdscr' 作为其第一个参数，再带上其他所有传给 <code class="xref py py-func docutils literal notranslate"><span class="pre">wrapper()</span></code> 的参数。 在调用 <em>func</em> 之前，<code class="xref py py-func docutils literal notranslate"><span class="pre">wrapper()</span></code> 会启用 cbreak 模式，关闭回显，启用终端键盘，并在终端具有颜色支持的情况下初始化颜色。 在退出时（无论是正常退出还是异常退出）它会恢复 cooked 模式，打开回显，并禁用终端键盘。</p>
|
||
</dd></dl>
|
||
|
||
</section>
|
||
<section id="window-objects">
|
||
<span id="curses-window-objects"></span><h2>Window 对象<a class="headerlink" href="#window-objects" title="永久链接至标题">¶</a></h2>
|
||
<p>Window 对象会由上面的 <a class="reference internal" href="#curses.initscr" title="curses.initscr"><code class="xref py py-func docutils literal notranslate"><span class="pre">initscr()</span></code></a> 和 <a class="reference internal" href="#curses.newwin" title="curses.newwin"><code class="xref py py-func docutils literal notranslate"><span class="pre">newwin()</span></code></a> 返回，它具有以下方法和属性:</p>
|
||
<dl class="method">
|
||
<dt id="curses.window.addch">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">addch</code><span class="sig-paren">(</span><em class="sig-param">ch</em><span class="optional">[</span>, <em class="sig-param">attr</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.addch" title="永久链接至目标">¶</a></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">addch</code><span class="sig-paren">(</span><em class="sig-param">y</em>, <em class="sig-param">x</em>, <em class="sig-param">ch</em><span class="optional">[</span>, <em class="sig-param">attr</em><span class="optional">]</span><span class="sig-paren">)</span></dt>
|
||
<dd><p>将带有属性 <em>attr</em> 的字符 <em>ch</em> 绘制到 <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code>，覆盖之前在该位置上绘制的任何字符。 默认情况下，字符的位置和属性均为窗口对象的当前设置。</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">注解</p>
|
||
<p>在窗口、子窗口或面板之外写入会引发 <a class="reference internal" href="#curses.error" title="curses.error"><code class="xref py py-exc docutils literal notranslate"><span class="pre">curses.error</span></code></a>。 尝试在窗口、子窗口或面板的右下角写入将在字符被打印之后导致异常被引发。</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.addnstr">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">addnstr</code><span class="sig-paren">(</span><em class="sig-param">str</em>, <em class="sig-param">n</em><span class="optional">[</span>, <em class="sig-param">attr</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.addnstr" title="永久链接至目标">¶</a></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">addnstr</code><span class="sig-paren">(</span><em class="sig-param">y</em>, <em class="sig-param">x</em>, <em class="sig-param">str</em>, <em class="sig-param">n</em><span class="optional">[</span>, <em class="sig-param">attr</em><span class="optional">]</span><span class="sig-paren">)</span></dt>
|
||
<dd><p>将带有属性 <em>attr</em> 的字符串 <em>str</em> 中的至多 <em>n</em> 个字符绘制到 <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code>，覆盖之前在屏幕上的任何内容。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.addstr">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">addstr</code><span class="sig-paren">(</span><em class="sig-param">str</em><span class="optional">[</span>, <em class="sig-param">attr</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.addstr" title="永久链接至目标">¶</a></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">addstr</code><span class="sig-paren">(</span><em class="sig-param">y</em>, <em class="sig-param">x</em>, <em class="sig-param">str</em><span class="optional">[</span>, <em class="sig-param">attr</em><span class="optional">]</span><span class="sig-paren">)</span></dt>
|
||
<dd><p>将带有属性 <em>attr</em> 的字符串 <em>str</em> 绘制到 <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code>，覆盖之前在屏幕上的任何内容。</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">注解</p>
|
||
<ul class="simple">
|
||
<li><p>在窗口、子窗口或面板之外写入会引发 <a class="reference internal" href="#curses.error" title="curses.error"><code class="xref py py-exc docutils literal notranslate"><span class="pre">curses.error</span></code></a>。 尝试在窗口、子窗口或面板的右下角写入将在字符串被打印之后导致异常被引发。</p></li>
|
||
<li><p>此 Python 模块的后端 <a class="reference external" href="https://bugs.python.org/issue35924">ncurses 中的一个缺陷</a> 会在调整窗口大小时导致段错误。 此缺陷已在 ncurses-6.1-20190511 中被修复。 如果你必须使用较早版本的 ncurses，则你只要在调用 <a class="reference internal" href="#curses.window.addstr" title="curses.window.addstr"><code class="xref py py-func docutils literal notranslate"><span class="pre">addstr()</span></code></a> 时不传入嵌入了换行符的 <em>str</em> 即可避免触发此错误。 请为每一行分别调用 <a class="reference internal" href="#curses.window.addstr" title="curses.window.addstr"><code class="xref py py-func docutils literal notranslate"><span class="pre">addstr()</span></code></a>。</p></li>
|
||
</ul>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.attroff">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">attroff</code><span class="sig-paren">(</span><em class="sig-param">attr</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.attroff" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>从应用于写入到当前窗口的 "background" 集中移除属性 <em>attr</em>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.attron">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">attron</code><span class="sig-paren">(</span><em class="sig-param">attr</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.attron" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>向应用于写入到当前窗口的 "background" 集中添加属性 <em>attr</em>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.attrset">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">attrset</code><span class="sig-paren">(</span><em class="sig-param">attr</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.attrset" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将 "background" 属性集设为 <em>attr</em>。 该集合初始时为 <code class="docutils literal notranslate"><span class="pre">0</span></code> (无属性)。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.bkgd">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">bkgd</code><span class="sig-paren">(</span><em class="sig-param">ch</em><span class="optional">[</span>, <em class="sig-param">attr</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.bkgd" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将窗口 background 特征属性设为带有属性 <em>attr</em> 的字符 <em>ch</em>。 随后此修改将应用于放置到该窗口中的每个字符。</p>
|
||
<ul class="simple">
|
||
<li><p>窗口中每个字符的属性会被修改为新的 background 属性。</p></li>
|
||
<li><p>不论之前的 background 字符出现在哪里，它都会被修改为新的 background 字符。</p></li>
|
||
</ul>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.bkgdset">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">bkgdset</code><span class="sig-paren">(</span><em class="sig-param">ch</em><span class="optional">[</span>, <em class="sig-param">attr</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.bkgdset" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>设置窗口的背景。 窗口的背景由字符和属性的任意组合构成。 背景的属性部分会与写入窗口的所有非空白字符合并（即 OR 运算）。 背景和字符和属性部分均会与空白字符合并。 背景将成为字符的特征属性并在任何滚动与插入/删除行/字符操作中与字符一起移动。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.border">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">border</code><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param">ls</em><span class="optional">[</span>, <em class="sig-param">rs</em><span class="optional">[</span>, <em class="sig-param">ts</em><span class="optional">[</span>, <em class="sig-param">bs</em><span class="optional">[</span>, <em class="sig-param">tl</em><span class="optional">[</span>, <em class="sig-param">tr</em><span class="optional">[</span>, <em class="sig-param">bl</em><span class="optional">[</span>, <em class="sig-param">br</em><span class="optional">]</span><span class="optional">]</span><span class="optional">]</span><span class="optional">]</span><span class="optional">]</span><span class="optional">]</span><span class="optional">]</span><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.border" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>在窗口边缘绘制边框。每个参数指定用于边界特定部分的字符;请参阅下表了解更多详情。</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">注解</p>
|
||
<p>任何形参的值为 <code class="docutils literal notranslate"><span class="pre">0</span></code> 都将导致该形参使用默认字符。 关键字形参 <em>不可</em> 被使用。 默认字符在下表中列出:</p>
|
||
</div>
|
||
<table class="docutils align-default">
|
||
<colgroup>
|
||
<col style="width: 20%" />
|
||
<col style="width: 38%" />
|
||
<col style="width: 42%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>参数</p></th>
|
||
<th class="head"><p>描述</p></th>
|
||
<th class="head"><p>默认值</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><p><em>ls</em></p></td>
|
||
<td><p>左侧</p></td>
|
||
<td><p><code class="xref py py-const docutils literal notranslate"><span class="pre">ACS_VLINE</span></code></p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><em>rs</em></p></td>
|
||
<td><p>右侧</p></td>
|
||
<td><p><code class="xref py py-const docutils literal notranslate"><span class="pre">ACS_VLINE</span></code></p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><em>ts</em></p></td>
|
||
<td><p>顶部</p></td>
|
||
<td><p><code class="xref py py-const docutils literal notranslate"><span class="pre">ACS_HLINE</span></code></p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><em>bs</em></p></td>
|
||
<td><p>底部</p></td>
|
||
<td><p><code class="xref py py-const docutils literal notranslate"><span class="pre">ACS_HLINE</span></code></p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><em>tl</em></p></td>
|
||
<td><p>左上角</p></td>
|
||
<td><p><code class="xref py py-const docutils literal notranslate"><span class="pre">ACS_ULCORNER</span></code></p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><em>tr</em></p></td>
|
||
<td><p>右上角</p></td>
|
||
<td><p><code class="xref py py-const docutils literal notranslate"><span class="pre">ACS_URCORNER</span></code></p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><em>bl</em></p></td>
|
||
<td><p>左下角</p></td>
|
||
<td><p><code class="xref py py-const docutils literal notranslate"><span class="pre">ACS_LLCORNER</span></code></p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><em>br</em></p></td>
|
||
<td><p>右下角</p></td>
|
||
<td><p><code class="xref py py-const docutils literal notranslate"><span class="pre">ACS_LRCORNER</span></code></p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.box">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">box</code><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param">vertch</em>, <em class="sig-param">horch</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.box" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>类似于 <a class="reference internal" href="#curses.window.border" title="curses.window.border"><code class="xref py py-meth docutils literal notranslate"><span class="pre">border()</span></code></a>，但 <em>ls</em> 和 <em>rs</em> 均为 <em>vertch</em> 而 <em>ts</em> 和 <em>bs</em> 均为 <em>horch</em>。 此函数总是会使用默认的转角字符。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.chgat">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">chgat</code><span class="sig-paren">(</span><em class="sig-param">attr</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.chgat" title="永久链接至目标">¶</a></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">chgat</code><span class="sig-paren">(</span><em class="sig-param">num</em>, <em class="sig-param">attr</em><span class="sig-paren">)</span></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">chgat</code><span class="sig-paren">(</span><em class="sig-param">y</em>, <em class="sig-param">x</em>, <em class="sig-param">attr</em><span class="sig-paren">)</span></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">chgat</code><span class="sig-paren">(</span><em class="sig-param">y</em>, <em class="sig-param">x</em>, <em class="sig-param">num</em>, <em class="sig-param">attr</em><span class="sig-paren">)</span></dt>
|
||
<dd><p>在当前光标位置或是在所提供的位置 <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> 设置 <em>num</em> 个字符的属性。 如果 <em>num</em> 未给出或为 <code class="docutils literal notranslate"><span class="pre">-1</span></code>，则将属性设置到所有字符上直至行尾。 如果提供了位置 <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> 则此函数会将光标移至该位置。 修改过的行将使用 <a class="reference internal" href="#curses.window.touchline" title="curses.window.touchline"><code class="xref py py-meth docutils literal notranslate"><span class="pre">touchline()</span></code></a> 方法处理以便下次窗口刷新时内容会重新显示。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.clear">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">clear</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.clear" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>类似于 <a class="reference internal" href="#curses.window.erase" title="curses.window.erase"><code class="xref py py-meth docutils literal notranslate"><span class="pre">erase()</span></code></a>，但还会导致在下次调用 <a class="reference internal" href="#curses.window.refresh" title="curses.window.refresh"><code class="xref py py-meth docutils literal notranslate"><span class="pre">refresh()</span></code></a> 时整个窗口被重新绘制。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.clearok">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">clearok</code><span class="sig-paren">(</span><em class="sig-param">flag</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.clearok" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">True</span></code>，则在下次调用 <a class="reference internal" href="#curses.window.refresh" title="curses.window.refresh"><code class="xref py py-meth docutils literal notranslate"><span class="pre">refresh()</span></code></a> 时将完全清除窗口。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.clrtobot">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">clrtobot</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.clrtobot" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>从光标位置开始擦除直至窗口末端：光标以下的所有行都会被删除，然后会执行 <a class="reference internal" href="#curses.window.clrtoeol" title="curses.window.clrtoeol"><code class="xref py py-meth docutils literal notranslate"><span class="pre">clrtoeol()</span></code></a> 的等效操作。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.clrtoeol">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">clrtoeol</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.clrtoeol" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>从光标位置开始擦除直至行尾。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.cursyncup">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">cursyncup</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.cursyncup" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>更新窗口所有上级窗口的当前光标位置以反映窗口的当前光标位置。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.delch">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">delch</code><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param">y</em>, <em class="sig-param">x</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.delch" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>删除位于 <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> 的任何字符。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.deleteln">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">deleteln</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.deleteln" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>删除在光标之下的行。 所有后续的行都会上移一行。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.derwin">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">derwin</code><span class="sig-paren">(</span><em class="sig-param">begin_y</em>, <em class="sig-param">begin_x</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.derwin" title="永久链接至目标">¶</a></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">derwin</code><span class="sig-paren">(</span><em class="sig-param">nlines</em>, <em class="sig-param">ncols</em>, <em class="sig-param">begin_y</em>, <em class="sig-param">begin_x</em><span class="sig-paren">)</span></dt>
|
||
<dd><p>"derive window" 的缩写，<a class="reference internal" href="#curses.window.derwin" title="curses.window.derwin"><code class="xref py py-meth docutils literal notranslate"><span class="pre">derwin()</span></code></a> 与调用 <a class="reference internal" href="#curses.window.subwin" title="curses.window.subwin"><code class="xref py py-meth docutils literal notranslate"><span class="pre">subwin()</span></code></a> 等效，不同之处在于 <em>begin_y</em> 和 <em>begin_x</em> 是想对于窗口的初始位置，而不是相对于整个屏幕。 返回代表所派生窗口的窗口对象。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.echochar">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">echochar</code><span class="sig-paren">(</span><em class="sig-param">ch</em><span class="optional">[</span>, <em class="sig-param">attr</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.echochar" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>使用属性 <em>attr</em> 添加字符 <em>ch</em>，并立即在窗口上调用 <a class="reference internal" href="#curses.window.refresh" title="curses.window.refresh"><code class="xref py py-meth docutils literal notranslate"><span class="pre">refresh()</span></code></a>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.enclose">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">enclose</code><span class="sig-paren">(</span><em class="sig-param">y</em>, <em class="sig-param">x</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.enclose" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>检测给定的相对屏幕的字符-单元格坐标是否被给定的窗口所包围，返回 <code class="docutils literal notranslate"><span class="pre">True</span></code> 或 <code class="docutils literal notranslate"><span class="pre">False</span></code>。 它适用于确定是哪个屏幕窗口子集包围着某个鼠标事件的位置。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="attribute">
|
||
<dt id="curses.window.encoding">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">encoding</code><a class="headerlink" href="#curses.window.encoding" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>用于编码方法参数（Unicode 字符串和字符）的编码格式。 encoding 属性是在创建子窗口时从父窗口继承的，例如通过 <a class="reference internal" href="#curses.window.subwin" title="curses.window.subwin"><code class="xref py py-meth docutils literal notranslate"><span class="pre">window.subwin()</span></code></a>。 默认情况下，会使用当前区域的编码格式 (参见 <a class="reference internal" href="locale.html#locale.getpreferredencoding" title="locale.getpreferredencoding"><code class="xref py py-func docutils literal notranslate"><span class="pre">locale.getpreferredencoding()</span></code></a>)。</p>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">3.3 新版功能.</span></p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.erase">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">erase</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.erase" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>清空窗口。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.getbegyx">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">getbegyx</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.getbegyx" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>返回左上角坐标的元组 <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.getbkgd">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">getbkgd</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.getbkgd" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>返回给定窗口的当前背景字符/属性对。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.getch">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">getch</code><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param">y</em>, <em class="sig-param">x</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.getch" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>获取一个字符。 请注意所返回的整数 <em>不一定</em> 要在 ASCII 范围以内：功能键、小键盘键等等是由大于 255 的数字表示的。 在无延迟模式下，如果没有输入则返回 <code class="docutils literal notranslate"><span class="pre">-1</span></code>，在其他情况下都会等待直至有键被按下。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.get_wch">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">get_wch</code><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param">y</em>, <em class="sig-param">x</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.get_wch" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>获取一个宽字符。 对于大多数键都是返回一个字符，对于功能键、小键盘键和其他特殊键则是返回一个整数。 在无延迟模式下，如果没有输入则引发一个异常。</p>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">3.3 新版功能.</span></p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.getkey">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">getkey</code><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param">y</em>, <em class="sig-param">x</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.getkey" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>获取一个字符，返回一个字符串而不是像 <a class="reference internal" href="#curses.window.getch" title="curses.window.getch"><code class="xref py py-meth docutils literal notranslate"><span class="pre">getch()</span></code></a> 那样返回一个整数。 功能键、小键盘键和其他特殊键则是返回一个包含键名的多字节字符串。 在无延迟模式下，如果没有输入则引发一个异常。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.getmaxyx">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">getmaxyx</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.getmaxyx" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>返回窗口高度和宽度的元组 <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.getparyx">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">getparyx</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.getparyx" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将此窗口相对于父窗口的起始坐标作为元组 <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> 返回。 如果此窗口没有父窗口则返回 <code class="docutils literal notranslate"><span class="pre">(-1,</span> <span class="pre">-1)</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.getstr">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">getstr</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.getstr" title="永久链接至目标">¶</a></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">getstr</code><span class="sig-paren">(</span><em class="sig-param">n</em><span class="sig-paren">)</span></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">getstr</code><span class="sig-paren">(</span><em class="sig-param">y</em>, <em class="sig-param">x</em><span class="sig-paren">)</span></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">getstr</code><span class="sig-paren">(</span><em class="sig-param">y</em>, <em class="sig-param">x</em>, <em class="sig-param">n</em><span class="sig-paren">)</span></dt>
|
||
<dd><p>从用户读取一个字节串对象，附带基本的行编辑功能。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.getyx">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">getyx</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.getyx" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>返回当前光标相对于窗口左上角的位置的元组 <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.hline">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">hline</code><span class="sig-paren">(</span><em class="sig-param">ch</em>, <em class="sig-param">n</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.hline" title="永久链接至目标">¶</a></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">hline</code><span class="sig-paren">(</span><em class="sig-param">y</em>, <em class="sig-param">x</em>, <em class="sig-param">ch</em>, <em class="sig-param">n</em><span class="sig-paren">)</span></dt>
|
||
<dd><p>显示一条起始于 <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> 长度为 <em>n</em> 个字符 <em>ch</em> 的水平线。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.idcok">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">idcok</code><span class="sig-paren">(</span><em class="sig-param">flag</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.idcok" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">False</span></code>，curses 将不再考虑使用终端的硬件插入/删除字符功能；如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">True</span></code>，则会启用字符插入和删除。 当 curses 首次初始化时，默认会启用字符插入/删除。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.idlok">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">idlok</code><span class="sig-paren">(</span><em class="sig-param">flag</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.idlok" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">True</span></code>，<a class="reference internal" href="#module-curses" title="curses: An interface to the curses library, providing portable terminal handling. (Unix)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses</span></code></a> 将尝试使用硬件行编辑功能。 否则，行插入/删除会被禁用。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.immedok">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">immedok</code><span class="sig-paren">(</span><em class="sig-param">flag</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.immedok" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">True</span></code>，窗口图像中的任何改变都会自动导致窗口被刷新；你不必再自己调用 <a class="reference internal" href="#curses.window.refresh" title="curses.window.refresh"><code class="xref py py-meth docutils literal notranslate"><span class="pre">refresh()</span></code></a>。 但是，这可能会由于重复调用 wrefresh 而显著降低性能。 此选项默认被禁用。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.inch">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">inch</code><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param">y</em>, <em class="sig-param">x</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.inch" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>返回窗口中给定位置上的字符。 下面的 8 个比特位是字符本身，上面的比特位则为属性。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.insch">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">insch</code><span class="sig-paren">(</span><em class="sig-param">ch</em><span class="optional">[</span>, <em class="sig-param">attr</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.insch" title="永久链接至目标">¶</a></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">insch</code><span class="sig-paren">(</span><em class="sig-param">y</em>, <em class="sig-param">x</em>, <em class="sig-param">ch</em><span class="optional">[</span>, <em class="sig-param">attr</em><span class="optional">]</span><span class="sig-paren">)</span></dt>
|
||
<dd><p>将带有属性 <em>attr</em> 的字符 <em>ch</em> 绘制到 <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code>，将该行从位置 <em>x</em> 开始右移一个字符。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.insdelln">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">insdelln</code><span class="sig-paren">(</span><em class="sig-param">nlines</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.insdelln" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>在指定窗口的当前行上方插入 <em>nlines</em> 行。 下面的 <em>nlines</em> 行将丢失。 对于 <em>nlines</em> 为负值的情况，则从光标下方的行开始删除 <em>nlines</em> 行，并将其余的行向上移动。 下面的 <em>nlines</em> 行会被清空。 当前光标位置将保持不变。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.insertln">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">insertln</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.insertln" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>在光标下方插入一个空行。 所有后续的行都会下移一行。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.insnstr">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">insnstr</code><span class="sig-paren">(</span><em class="sig-param">str</em>, <em class="sig-param">n</em><span class="optional">[</span>, <em class="sig-param">attr</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.insnstr" title="永久链接至目标">¶</a></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">insnstr</code><span class="sig-paren">(</span><em class="sig-param">y</em>, <em class="sig-param">x</em>, <em class="sig-param">str</em>, <em class="sig-param">n</em><span class="optional">[</span>, <em class="sig-param">attr</em><span class="optional">]</span><span class="sig-paren">)</span></dt>
|
||
<dd><p>在光标下方的字符之前插入一个至多为 <em>n</em> 个字符的字符串（字符数量将与该行相匹配）。 如果 <em>n</em> 为零或负数，则插入整个字符串。 光标右边的所有字符将被右移，该行右端的字符将丢失。 光标位置将保持不变（在移到可能指定的 <em>y</em>, <em>x</em> 之后）。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.insstr">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">insstr</code><span class="sig-paren">(</span><em class="sig-param">str</em><span class="optional">[</span>, <em class="sig-param">attr</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.insstr" title="永久链接至目标">¶</a></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">insstr</code><span class="sig-paren">(</span><em class="sig-param">y</em>, <em class="sig-param">x</em>, <em class="sig-param">str</em><span class="optional">[</span>, <em class="sig-param">attr</em><span class="optional">]</span><span class="sig-paren">)</span></dt>
|
||
<dd><p>在光标下方的字符之前插入一个字符串（字符数量将与该行相匹配）。 光标右边的所有字符将被右移，该行右端的字符将丢失。 光标位置将保持不变（在移到可能指定的 <em>y</em>, <em>x</em> 之后）。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.instr">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">instr</code><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param">n</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.instr" title="永久链接至目标">¶</a></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">instr</code><span class="sig-paren">(</span><em class="sig-param">y</em>, <em class="sig-param">x</em><span class="optional">[</span>, <em class="sig-param">n</em><span class="optional">]</span><span class="sig-paren">)</span></dt>
|
||
<dd><p>返回从窗口的当前光标位置，或者指定的 <em>y</em>, <em>x</em> 开始提取的字符所对应的字节串对象。 属性会从字符中去除。 如果指定了 <em>n</em>，<a class="reference internal" href="#curses.window.instr" title="curses.window.instr"><code class="xref py py-meth docutils literal notranslate"><span class="pre">instr()</span></code></a> 将返回长度至多为 <em>n</em> 个字符的字符串（不包括末尾的 NUL）。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.is_linetouched">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">is_linetouched</code><span class="sig-paren">(</span><em class="sig-param">line</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.is_linetouched" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果指定的行自上次调用 <a class="reference internal" href="#curses.window.refresh" title="curses.window.refresh"><code class="xref py py-meth docutils literal notranslate"><span class="pre">refresh()</span></code></a> 后发生了改变则返回 <code class="docutils literal notranslate"><span class="pre">True</span></code>；否则返回 <code class="docutils literal notranslate"><span class="pre">False</span></code>。 如果 <em>line</em> 对于给定的窗口不可用则会引发 <a class="reference internal" href="#curses.error" title="curses.error"><code class="xref py py-exc docutils literal notranslate"><span class="pre">curses.error</span></code></a> 异常。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.is_wintouched">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">is_wintouched</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.is_wintouched" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果指定的窗口自上次调用 <a class="reference internal" href="#curses.window.refresh" title="curses.window.refresh"><code class="xref py py-meth docutils literal notranslate"><span class="pre">refresh()</span></code></a> 后发生了改变则返回 <code class="docutils literal notranslate"><span class="pre">True</span></code>；否则返回 <code class="docutils literal notranslate"><span class="pre">False</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.keypad">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">keypad</code><span class="sig-paren">(</span><em class="sig-param">flag</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.keypad" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">True</span></code>，则某些键（小键盘键、功能键等）生成的转义序列将由 <a class="reference internal" href="#module-curses" title="curses: An interface to the curses library, providing portable terminal handling. (Unix)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses</span></code></a> 来解析。 如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">False</span></code>，转义序列将保持在输入流中的原样。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.leaveok">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">leaveok</code><span class="sig-paren">(</span><em class="sig-param">flag</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.leaveok" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">True</span></code>，则在更新时光标将停留在原地，而不是在“光标位置”。 这将可以减少光标的移动。 在可能的情况下光标将变为不可见。</p>
|
||
<p>如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">False</span></code>，光标在更新后将总是位于“光标位置”。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.move">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">move</code><span class="sig-paren">(</span><em class="sig-param">new_y</em>, <em class="sig-param">new_x</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.move" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将光标移至 <code class="docutils literal notranslate"><span class="pre">(new_y,</span> <span class="pre">new_x)</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.mvderwin">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">mvderwin</code><span class="sig-paren">(</span><em class="sig-param">y</em>, <em class="sig-param">x</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.mvderwin" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>让窗口在其父窗口内移动。 窗口相对于屏幕的参数不会被更改。 此例程用于在屏幕的相同物理位置显示父窗口的不同部分。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.mvwin">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">mvwin</code><span class="sig-paren">(</span><em class="sig-param">new_y</em>, <em class="sig-param">new_x</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.mvwin" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>移动窗口以使其左上角位于 <code class="docutils literal notranslate"><span class="pre">(new_y,</span> <span class="pre">new_x)</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.nodelay">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">nodelay</code><span class="sig-paren">(</span><em class="sig-param">flag</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.nodelay" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">True</span></code>，则 <a class="reference internal" href="#curses.window.getch" title="curses.window.getch"><code class="xref py py-meth docutils literal notranslate"><span class="pre">getch()</span></code></a> 将为非阻塞的。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.notimeout">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">notimeout</code><span class="sig-paren">(</span><em class="sig-param">flag</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.notimeout" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">True</span></code>，则转义序列将不会发生超时。</p>
|
||
<p>如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">False</span></code>，则在几毫秒之后，转义序列将不会被解析，并将保持在输入流中的原样。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.noutrefresh">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">noutrefresh</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.noutrefresh" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>标记为刷新但保持等待。 此函数会更新代表预期窗口状态的数据结构，但并不强制更新物理屏幕。 要完成后者，请调用 <a class="reference internal" href="#curses.doupdate" title="curses.doupdate"><code class="xref py py-func docutils literal notranslate"><span class="pre">doupdate()</span></code></a>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.overlay">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">overlay</code><span class="sig-paren">(</span><em class="sig-param">destwin</em><span class="optional">[</span>, <em class="sig-param">sminrow</em>, <em class="sig-param">smincol</em>, <em class="sig-param">dminrow</em>, <em class="sig-param">dmincol</em>, <em class="sig-param">dmaxrow</em>, <em class="sig-param">dmaxcol</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.overlay" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将窗口覆盖在 <em>destwin</em> 上方。 窗口的大小不必相同，只有重叠的区域会被复制。 此复制是非破坏性的，这意味着当前背景字符不会覆盖掉 <em>destwin</em> 的旧内容。</p>
|
||
<p>为了获得对被复制区域的细粒度控制，可以使用 <a class="reference internal" href="#curses.window.overlay" title="curses.window.overlay"><code class="xref py py-meth docutils literal notranslate"><span class="pre">overlay()</span></code></a> 的第二种形式。 <em>sminrow</em> 和 <em>smincol</em> 是源窗口的左上角坐标，而其他变量则在目标窗口中标记出一个矩形。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.overwrite">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">overwrite</code><span class="sig-paren">(</span><em class="sig-param">destwin</em><span class="optional">[</span>, <em class="sig-param">sminrow</em>, <em class="sig-param">smincol</em>, <em class="sig-param">dminrow</em>, <em class="sig-param">dmincol</em>, <em class="sig-param">dmaxrow</em>, <em class="sig-param">dmaxcol</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.overwrite" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将窗口覆盖在 <em>destwin</em> 上方。 窗口的大小不必相同，此时只有重叠的区域会被复制。 此复制是破坏性的，这意味着当前背景字符会覆盖掉 <em>destwin</em> 的旧内容。</p>
|
||
<p>为了获得对被复制区域的细粒度控制，可以使用 <a class="reference internal" href="#curses.window.overwrite" title="curses.window.overwrite"><code class="xref py py-meth docutils literal notranslate"><span class="pre">overwrite()</span></code></a> 的第二种形式。 <em>sminrow</em> 和 <em>smincol</em> 是源窗口的左上角坐标，而其他变量则在目标窗口中标记出一个矩形。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.putwin">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">putwin</code><span class="sig-paren">(</span><em class="sig-param">file</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.putwin" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将关联到窗口的所有数据写入到所提供的文件对象。 此信息可在以后使用 <a class="reference internal" href="#curses.getwin" title="curses.getwin"><code class="xref py py-func docutils literal notranslate"><span class="pre">getwin()</span></code></a> 函数来提取。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.redrawln">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">redrawln</code><span class="sig-paren">(</span><em class="sig-param">beg</em>, <em class="sig-param">num</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.redrawln" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>指明从 <em>beg</em> 行开始的 <em>num</em> 个屏幕行已被破坏并且应当在下次 <a class="reference internal" href="#curses.window.refresh" title="curses.window.refresh"><code class="xref py py-meth docutils literal notranslate"><span class="pre">refresh()</span></code></a> 调用时完全重绘。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.redrawwin">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">redrawwin</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.redrawwin" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>触碰整个窗口，以使其在下次 <a class="reference internal" href="#curses.window.refresh" title="curses.window.refresh"><code class="xref py py-meth docutils literal notranslate"><span class="pre">refresh()</span></code></a> 调用时完全重绘。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.refresh">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">refresh</code><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param">pminrow</em>, <em class="sig-param">pmincol</em>, <em class="sig-param">sminrow</em>, <em class="sig-param">smincol</em>, <em class="sig-param">smaxrow</em>, <em class="sig-param">smaxcol</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.refresh" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>立即更新显示（将实际屏幕与之前的绘制/删除方法进行同步）。</p>
|
||
<p>6 个可选参数仅在窗口为使用 <a class="reference internal" href="#curses.newpad" title="curses.newpad"><code class="xref py py-func docutils literal notranslate"><span class="pre">newpad()</span></code></a> 创建的面板时可被指定。 需要额外的形参来指定所涉及到的是面板和屏幕的哪一部分。 <em>pminrow</em> 和 <em>pmincol</em> 指定要在面板中显示的矩形的左上角。 <em>sminrow</em>, <em>smincol</em>, <em>smaxrow</em> 和 <em>smaxcol</em> 指定要在屏幕中显示的矩形的边。 要在面板中显示的矩形的右下角是根据屏幕坐标计算出来的，由于矩形的大小必须相同。 两个矩形都必须完全包含在其各自的结构之内。 负的 <em>pminrow</em>, <em>pmincol</em>, <em>sminrow</em> 或 <em>smincol</em> 值会被视为将它们设为零值。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.resize">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">resize</code><span class="sig-paren">(</span><em class="sig-param">nlines</em>, <em class="sig-param">ncols</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.resize" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>为 curses 窗口重新分配存储空间以将其尺寸调整为指定的值。 如果任一维度的尺寸大于当前值，则窗口的数据将以具有合并了当前背景渲染（由 <a class="reference internal" href="#curses.window.bkgdset" title="curses.window.bkgdset"><code class="xref py py-meth docutils literal notranslate"><span class="pre">bkgdset()</span></code></a> 设置）的空白来填充。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.scroll">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">scroll</code><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param">lines=1</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.scroll" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将屏幕或滚动区域向上滚动 <em>lines</em> 行。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.scrollok">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">scrollok</code><span class="sig-paren">(</span><em class="sig-param">flag</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.scrollok" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>控制当一个窗口的光标移出窗口或滚动区域边缘时会发生什么，这可能是在底端行执行换行操作，或者在最后一行输入最后一个字符导致的结果。 如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">False</span></code>，光标会留在底端行。 如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">True</span></code>，窗口会向上滚动一行。 请注意为了在终端上获得实际的滚动效果，还需要调用 <a class="reference internal" href="#curses.window.idlok" title="curses.window.idlok"><code class="xref py py-meth docutils literal notranslate"><span class="pre">idlok()</span></code></a>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.setscrreg">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">setscrreg</code><span class="sig-paren">(</span><em class="sig-param">top</em>, <em class="sig-param">bottom</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.setscrreg" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>设置从 <em>top</em> 行至 <em>bottom</em> 行的滚动区域。 所有滚动操作将在此区域中进行。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.standend">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">standend</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.standend" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>关闭 standout 属性。 在某些终端上此操作会有关闭所有属性的副作用。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.standout">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">standout</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.standout" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>启用属性 <em>A_STANDOUT</em>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.subpad">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">subpad</code><span class="sig-paren">(</span><em class="sig-param">begin_y</em>, <em class="sig-param">begin_x</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.subpad" title="永久链接至目标">¶</a></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">subpad</code><span class="sig-paren">(</span><em class="sig-param">nlines</em>, <em class="sig-param">ncols</em>, <em class="sig-param">begin_y</em>, <em class="sig-param">begin_x</em><span class="sig-paren">)</span></dt>
|
||
<dd><p>返回一个子窗口，其左上角位于 <code class="docutils literal notranslate"><span class="pre">(begin_y,</span> <span class="pre">begin_x)</span></code>，并且其宽度/高度为 <em>ncols</em>/<em>nlines</em>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.subwin">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">subwin</code><span class="sig-paren">(</span><em class="sig-param">begin_y</em>, <em class="sig-param">begin_x</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.subwin" title="永久链接至目标">¶</a></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">subwin</code><span class="sig-paren">(</span><em class="sig-param">nlines</em>, <em class="sig-param">ncols</em>, <em class="sig-param">begin_y</em>, <em class="sig-param">begin_x</em><span class="sig-paren">)</span></dt>
|
||
<dd><p>返回一个子窗口，其左上角位于 <code class="docutils literal notranslate"><span class="pre">(begin_y,</span> <span class="pre">begin_x)</span></code>，并且其宽度/高度为 <em>ncols</em>/<em>nlines</em>。</p>
|
||
<p>默认情况下，子窗口将从指定位置扩展到窗口的右下角。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.syncdown">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">syncdown</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.syncdown" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>触碰已在上级窗口上被触碰的每个位置。 此例程由 <a class="reference internal" href="#curses.window.refresh" title="curses.window.refresh"><code class="xref py py-meth docutils literal notranslate"><span class="pre">refresh()</span></code></a> 调用，因此几乎从不需要手动调用。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.syncok">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">syncok</code><span class="sig-paren">(</span><em class="sig-param">flag</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.syncok" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>如果 <em>flag</em> 为 <code class="docutils literal notranslate"><span class="pre">True</span></code>，则 <a class="reference internal" href="#curses.window.syncup" title="curses.window.syncup"><code class="xref py py-meth docutils literal notranslate"><span class="pre">syncup()</span></code></a> 会在窗口发生改变的任何时候自动被调用。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.syncup">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">syncup</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.syncup" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>触碰已在窗口中被改变的此窗口的各个上级窗口中的所有位置。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.timeout">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">timeout</code><span class="sig-paren">(</span><em class="sig-param">delay</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.timeout" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>为窗口设置阻塞或非阻塞读取行为。 如果 <em>delay</em> 为负值，则会使用阻塞读取（这将无限期地等待输入）。 如果 <em>delay</em> 为零，则会使用非阻塞读取，并且当没有输入在等待时 <a class="reference internal" href="#curses.window.getch" title="curses.window.getch"><code class="xref py py-meth docutils literal notranslate"><span class="pre">getch()</span></code></a> 将返回 <code class="docutils literal notranslate"><span class="pre">-1</span></code>。 如果 <em>delay</em> 为正值，则 <a class="reference internal" href="#curses.window.getch" title="curses.window.getch"><code class="xref py py-meth docutils literal notranslate"><span class="pre">getch()</span></code></a> 将阻塞 <em>delay</em> 毫秒，并且当此延时结束时仍无输入将返回 <code class="docutils literal notranslate"><span class="pre">-1</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.touchline">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">touchline</code><span class="sig-paren">(</span><em class="sig-param">start</em>, <em class="sig-param">count</em><span class="optional">[</span>, <em class="sig-param">changed</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.touchline" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>假定从行 <em>start</em> 开始的 <em>count</em> 行已被更改。 如果提供了 <em>changed</em>，它将指明是将受影响的行标记为已更改 (<em>changed</em><code class="docutils literal notranslate"><span class="pre">=True</span></code>) 还是未更改 (<em>changed</em><code class="docutils literal notranslate"><span class="pre">=False</span></code>)。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.touchwin">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">touchwin</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.touchwin" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>假定整个窗口已被更改，其目的是用于绘制优化。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.untouchwin">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">untouchwin</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.untouchwin" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>将自上次调用 <a class="reference internal" href="#curses.window.refresh" title="curses.window.refresh"><code class="xref py py-meth docutils literal notranslate"><span class="pre">refresh()</span></code></a> 以来窗口中的所有行标记为未改变。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.window.vline">
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">vline</code><span class="sig-paren">(</span><em class="sig-param">ch</em>, <em class="sig-param">n</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.vline" title="永久链接至目标">¶</a></dt>
|
||
<dt>
|
||
<code class="sig-prename descclassname">window.</code><code class="sig-name descname">vline</code><span class="sig-paren">(</span><em class="sig-param">y</em>, <em class="sig-param">x</em>, <em class="sig-param">ch</em>, <em class="sig-param">n</em><span class="sig-paren">)</span></dt>
|
||
<dd><p>显示一条起始于 <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> 长度为 <em>n</em> 个字符 <em>ch</em> 的垂直线。</p>
|
||
</dd></dl>
|
||
|
||
</section>
|
||
<section id="constants">
|
||
<h2>常量<a class="headerlink" href="#constants" title="永久链接至标题">¶</a></h2>
|
||
<p><a class="reference internal" href="#module-curses" title="curses: An interface to the curses library, providing portable terminal handling. (Unix)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses</span></code></a> 模块定义了以下数据成员:</p>
|
||
<dl class="data">
|
||
<dt id="curses.ERR">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">ERR</code><a class="headerlink" href="#curses.ERR" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>一些返回整数的 curses 例程，例如 <a class="reference internal" href="#curses.window.getch" title="curses.window.getch"><code class="xref py py-meth docutils literal notranslate"><span class="pre">getch()</span></code></a>，在失败时将返回 <a class="reference internal" href="#curses.ERR" title="curses.ERR"><code class="xref py py-const docutils literal notranslate"><span class="pre">ERR</span></code></a>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="data">
|
||
<dt id="curses.OK">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">OK</code><a class="headerlink" href="#curses.OK" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>一些返回整数的 curses 例程，例如 <a class="reference internal" href="#curses.napms" title="curses.napms"><code class="xref py py-func docutils literal notranslate"><span class="pre">napms()</span></code></a>，在成功时将返回 <a class="reference internal" href="#curses.OK" title="curses.OK"><code class="xref py py-const docutils literal notranslate"><span class="pre">OK</span></code></a>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="data">
|
||
<dt id="curses.version">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">version</code><a class="headerlink" href="#curses.version" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>一个代表当前模块版本的字节串对象。 也作 <code class="xref py py-const docutils literal notranslate"><span class="pre">__version__</span></code>。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="data">
|
||
<dt id="curses.ncurses_version">
|
||
<code class="sig-prename descclassname">curses.</code><code class="sig-name descname">ncurses_version</code><a class="headerlink" href="#curses.ncurses_version" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>一个具名元组，它包含构成 ncurses 库版本号的三个数字: <em>major</em>, <em>minor</em> 和 <em>patch</em>。 三个值均为整数。 三个值也可通过名称来访问，因此 <code class="docutils literal notranslate"><span class="pre">curses.ncurses_version[0]</span></code> 等价于 <code class="docutils literal notranslate"><span class="pre">curses.ncurses_version.major</span></code>，依此类推。</p>
|
||
<p>可用性：如果使用了 ncurses 库。</p>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">3.8 新版功能.</span></p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<p>有些常量可用于指定字符单元属性。 实际可用的常量取决于具体的系统。</p>
|
||
<table class="docutils align-default">
|
||
<colgroup>
|
||
<col style="width: 37%" />
|
||
<col style="width: 63%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>属性</p></th>
|
||
<th class="head"><p>含意</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">A_ALTCHARSET</span></code></p></td>
|
||
<td><p>备用字符集模式</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">A_BLINK</span></code></p></td>
|
||
<td><p>闪烁模式</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">A_BOLD</span></code></p></td>
|
||
<td><p>粗体模式</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">A_DIM</span></code></p></td>
|
||
<td><p>暗淡模式</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">A_INVIS</span></code></p></td>
|
||
<td><p>不可见或空白模式</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">A_ITALIC</span></code></p></td>
|
||
<td><p>斜体模式</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">A_NORMAL</span></code></p></td>
|
||
<td><p>正常属性</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">A_PROTECT</span></code></p></td>
|
||
<td><p>保护模式</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">A_REVERSE</span></code></p></td>
|
||
<td><p>反转背景色和前景色</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">A_STANDOUT</span></code></p></td>
|
||
<td><p>突出模式</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">A_UNDERLINE</span></code></p></td>
|
||
<td><p>下划线模式</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">A_HORIZONTAL</span></code></p></td>
|
||
<td><p>水平突出显示</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">A_LEFT</span></code></p></td>
|
||
<td><p>左高亮</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">A_LOW</span></code></p></td>
|
||
<td><p>底部高亮</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">A_RIGHT</span></code></p></td>
|
||
<td><p>右高亮</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">A_TOP</span></code></p></td>
|
||
<td><p>顶部高亮</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">A_VERTICAL</span></code></p></td>
|
||
<td><p>垂直突出显示</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">A_CHARTEXT</span></code></p></td>
|
||
<td><p>用于提取字符的位掩码</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">3.7 新版功能: </span><code class="docutils literal notranslate"><span class="pre">A_ITALIC</span></code> was added.</p>
|
||
</div>
|
||
<p>有几个常量可用于提取某些方法返回的相应属性。</p>
|
||
<table class="docutils align-default">
|
||
<colgroup>
|
||
<col style="width: 37%" />
|
||
<col style="width: 63%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>位掩码</p></th>
|
||
<th class="head"><p>含意</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">A_ATTRIBUTES</span></code></p></td>
|
||
<td><p>用于提取属性的位掩码</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">A_CHARTEXT</span></code></p></td>
|
||
<td><p>用于提取字符的位掩码</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">A_COLOR</span></code></p></td>
|
||
<td><p>用于提取颜色对字段信息的位掩码</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<p>键由名称以 <code class="docutils literal notranslate"><span class="pre">KEY_</span></code> 开头的整数常量引用。确切的可用键取决于系统。</p>
|
||
<table class="docutils align-default">
|
||
<colgroup>
|
||
<col style="width: 30%" />
|
||
<col style="width: 70%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>关键常数</p></th>
|
||
<th class="head"><p>键</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_MIN</span></code></p></td>
|
||
<td><p>最小键值</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_BREAK</span></code></p></td>
|
||
<td><p>中断键（不可靠）</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_DOWN</span></code></p></td>
|
||
<td><p>向下箭头</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_UP</span></code></p></td>
|
||
<td><p>向上箭头</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_LEFT</span></code></p></td>
|
||
<td><p>向左箭头</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_RIGHT</span></code></p></td>
|
||
<td><p>向右箭头</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_HOME</span></code></p></td>
|
||
<td><p>Home 键 (上+左箭头)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_BACKSPACE</span></code></p></td>
|
||
<td><p>退格（不可靠）</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_F0</span></code></p></td>
|
||
<td><p>功能键。 支持至多 64 个功能键。</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_Fn</span></code></p></td>
|
||
<td><p>功能键 <em>n</em> 的值</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_DL</span></code></p></td>
|
||
<td><p>删除行</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_IL</span></code></p></td>
|
||
<td><p>插入行</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_DC</span></code></p></td>
|
||
<td><p>删除字符</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_IC</span></code></p></td>
|
||
<td><p>插入字符或进入插入模式</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_EIC</span></code></p></td>
|
||
<td><p>退出插入字符模式</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_CLEAR</span></code></p></td>
|
||
<td><p>清空屏幕</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_EOS</span></code></p></td>
|
||
<td><p>清空至屏幕底部</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_EOL</span></code></p></td>
|
||
<td><p>清空至行尾</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SF</span></code></p></td>
|
||
<td><p>向前滚动 1 行</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SR</span></code></p></td>
|
||
<td><p>向后滚动 1 行 (反转)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_NPAGE</span></code></p></td>
|
||
<td><p>下一页</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_PPAGE</span></code></p></td>
|
||
<td><p>上一页</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_STAB</span></code></p></td>
|
||
<td><p>设置制表符</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_CTAB</span></code></p></td>
|
||
<td><p>清除制表符</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_CATAB</span></code></p></td>
|
||
<td><p>清除所有制表符</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_ENTER</span></code></p></td>
|
||
<td><p>回车或发送 (不可靠)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SRESET</span></code></p></td>
|
||
<td><p>软 (部分) 重置 (不可靠)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_RESET</span></code></p></td>
|
||
<td><p>重置或硬重置 (不可靠)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_PRINT</span></code></p></td>
|
||
<td><p>打印</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_LL</span></code></p></td>
|
||
<td><p>Home 向下或到底 (左下)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_A1</span></code></p></td>
|
||
<td><p>键盘的左上角</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_A3</span></code></p></td>
|
||
<td><p>键盘的右上角</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_B2</span></code></p></td>
|
||
<td><p>键盘的中心</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_C1</span></code></p></td>
|
||
<td><p>键盘左下方</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_C3</span></code></p></td>
|
||
<td><p>键盘右下方</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_BTAB</span></code></p></td>
|
||
<td><p>回退制表符</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_BEG</span></code></p></td>
|
||
<td><p>Beg (开始)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_CANCEL</span></code></p></td>
|
||
<td><p>取消</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_CLOSE</span></code></p></td>
|
||
<td><p>关闭</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_COMMAND</span></code></p></td>
|
||
<td><p>Cmd (命令行)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_COPY</span></code></p></td>
|
||
<td><p>复制</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_CREATE</span></code></p></td>
|
||
<td><p>创建</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_END</span></code></p></td>
|
||
<td><p>End</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_EXIT</span></code></p></td>
|
||
<td><p>退出</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_FIND</span></code></p></td>
|
||
<td><p>查找</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_HELP</span></code></p></td>
|
||
<td><p>帮助</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_MARK</span></code></p></td>
|
||
<td><p>标记</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_MESSAGE</span></code></p></td>
|
||
<td><p>消息</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_MOVE</span></code></p></td>
|
||
<td><p>移动</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_NEXT</span></code></p></td>
|
||
<td><p>下一个</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_OPEN</span></code></p></td>
|
||
<td><p>打开</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_OPTIONS</span></code></p></td>
|
||
<td><p>属性</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_PREVIOUS</span></code></p></td>
|
||
<td><p>Prev (上一个)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_REDO</span></code></p></td>
|
||
<td><p>重做</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_REFERENCE</span></code></p></td>
|
||
<td><p>Ref (引用)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_REFRESH</span></code></p></td>
|
||
<td><p>刷新</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_REPLACE</span></code></p></td>
|
||
<td><p>替换</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_RESTART</span></code></p></td>
|
||
<td><p>重启</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_RESUME</span></code></p></td>
|
||
<td><p>恢复</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SAVE</span></code></p></td>
|
||
<td><p>保存</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SBEG</span></code></p></td>
|
||
<td><p>Shift + Beg (开始)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SCANCEL</span></code></p></td>
|
||
<td><p>Shift + Cancel</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SCOMMAND</span></code></p></td>
|
||
<td><p>Shift + Command</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SCOPY</span></code></p></td>
|
||
<td><p>Shift + Copy</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SCREATE</span></code></p></td>
|
||
<td><p>Shift + Create</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SDC</span></code></p></td>
|
||
<td><p>Shift + 删除字符</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SDL</span></code></p></td>
|
||
<td><p>Shift + 删除行</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SELECT</span></code></p></td>
|
||
<td><p>选择</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SEND</span></code></p></td>
|
||
<td><p>Shift + End</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SEOL</span></code></p></td>
|
||
<td><p>Shift + 清空行</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SEXIT</span></code></p></td>
|
||
<td><p>Shift + 退出</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SFIND</span></code></p></td>
|
||
<td><p>Shift + 查找</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SHELP</span></code></p></td>
|
||
<td><p>Shift + 帮助</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SHOME</span></code></p></td>
|
||
<td><p>Shift + Home</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SIC</span></code></p></td>
|
||
<td><p>Shift + 输入</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SLEFT</span></code></p></td>
|
||
<td><p>Shift + 向左箭头</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SMESSAGE</span></code></p></td>
|
||
<td><p>Shift + 消息</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SMOVE</span></code></p></td>
|
||
<td><p>Shift + 移动</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SNEXT</span></code></p></td>
|
||
<td><p>Shift + 下一个</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SOPTIONS</span></code></p></td>
|
||
<td><p>Shift + 选项</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SPREVIOUS</span></code></p></td>
|
||
<td><p>Shift + 上一个</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SPRINT</span></code></p></td>
|
||
<td><p>Shift + 打印</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SREDO</span></code></p></td>
|
||
<td><p>Shift + 重做</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SREPLACE</span></code></p></td>
|
||
<td><p>Shift + 替换</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SRIGHT</span></code></p></td>
|
||
<td><p>Shift + 向右箭头</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SRSUME</span></code></p></td>
|
||
<td><p>Shift + 恢复</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SSAVE</span></code></p></td>
|
||
<td><p>Shift + 保存</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SSUSPEND</span></code></p></td>
|
||
<td><p>Shift + 挂起</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SUNDO</span></code></p></td>
|
||
<td><p>Shift + 撤销</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_SUSPEND</span></code></p></td>
|
||
<td><p>挂起</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_UNDO</span></code></p></td>
|
||
<td><p>撤销操作</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_MOUSE</span></code></p></td>
|
||
<td><p>鼠标事件已发生</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_RESIZE</span></code></p></td>
|
||
<td><p>终端大小改变事件</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">KEY_MAX</span></code></p></td>
|
||
<td><p>最大键值</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<p>在VT100及其软件仿真（例如X终端仿真器）上，通常至少有四个功能键（ <code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_F1</span></code>, <code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_F2</span></code>, <code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_F3</span></code>, <code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_F4</span></code> ）可用，并且箭头键以明显的方式映射到 <code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_UP</span></code>, <code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_DOWN</span></code>, <code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_LEFT</span></code> 和 <code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_RIGHT</span></code> 。如果您的机器有一个PC键盘，可以安全地使用箭头键和十二个功能键（旧的PC键盘可能只有十个功能键）;此外，以下键盘映射是标准的：</p>
|
||
<table class="docutils align-default">
|
||
<colgroup>
|
||
<col style="width: 62%" />
|
||
<col style="width: 38%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>键帽</p></th>
|
||
<th class="head"><p>常量</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">Insert</kbd></p></td>
|
||
<td><p>KEY_IC</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">Delete</kbd></p></td>
|
||
<td><p>KEY_DC</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">Home</kbd></p></td>
|
||
<td><p>KEY_HOME</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">End</kbd></p></td>
|
||
<td><p>KEY_END</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">Page Up</kbd></p></td>
|
||
<td><p>KEY_PPAGE</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">Page Down</kbd></p></td>
|
||
<td><p>KEY_NPAGE</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<p>下表列出了替代字符集中的字符。 这些字符继承自 VT100 终端，在 X 终端等软件模拟器上通常均为可用。 当没有可用的图形时，curses 会回退为粗糙的可打印 ASCII 近似符号。</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">注解</p>
|
||
<p>只有在调用 <a class="reference internal" href="#curses.initscr" title="curses.initscr"><code class="xref py py-func docutils literal notranslate"><span class="pre">initscr()</span></code></a> 之后才能使用它们</p>
|
||
</div>
|
||
<table class="docutils align-default">
|
||
<colgroup>
|
||
<col style="width: 30%" />
|
||
<col style="width: 70%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>ACS代码</p></th>
|
||
<th class="head"><p>含意</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_BBSS</span></code></p></td>
|
||
<td><p>右上角的别名</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_BLOCK</span></code></p></td>
|
||
<td><p>实心方块</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_BOARD</span></code></p></td>
|
||
<td><p>正方形</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_BSBS</span></code></p></td>
|
||
<td><p>水平线的别名</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_BSSB</span></code></p></td>
|
||
<td><p>左上角的别名</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_BSSS</span></code></p></td>
|
||
<td><p>顶部 T 型的别名</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_BTEE</span></code></p></td>
|
||
<td><p>底部 T 型</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_BULLET</span></code></p></td>
|
||
<td><p>正方形</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_CKBOARD</span></code></p></td>
|
||
<td><p>棋盘（点刻）</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_DARROW</span></code></p></td>
|
||
<td><p>向下箭头</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_DEGREE</span></code></p></td>
|
||
<td><p>等级符</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_DIAMOND</span></code></p></td>
|
||
<td><p>菱形</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_GEQUAL</span></code></p></td>
|
||
<td><p>大于或等于</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_HLINE</span></code></p></td>
|
||
<td><p>水平线</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_LANTERN</span></code></p></td>
|
||
<td><p>灯形符号</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_LARROW</span></code></p></td>
|
||
<td><p>向左箭头</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_LEQUAL</span></code></p></td>
|
||
<td><p>小于或等于</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_LLCORNER</span></code></p></td>
|
||
<td><p>左下角</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_LRCORNER</span></code></p></td>
|
||
<td><p>右下角</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_LTEE</span></code></p></td>
|
||
<td><p>左侧 T 型</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_NEQUAL</span></code></p></td>
|
||
<td><p>不等号</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_PI</span></code></p></td>
|
||
<td><p>字母π</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_PLMINUS</span></code></p></td>
|
||
<td><p>正负号</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_PLUS</span></code></p></td>
|
||
<td><p>加号</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_RARROW</span></code></p></td>
|
||
<td><p>向右箭头</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_RTEE</span></code></p></td>
|
||
<td><p>右侧 T 型</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_S1</span></code></p></td>
|
||
<td><p>扫描线 1</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_S3</span></code></p></td>
|
||
<td><p>扫描线3</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_S7</span></code></p></td>
|
||
<td><p>扫描线7</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_S9</span></code></p></td>
|
||
<td><p>扫描线 9</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_SBBS</span></code></p></td>
|
||
<td><p>右下角的别名</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_SBSB</span></code></p></td>
|
||
<td><p>垂直线的别名</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_SBSS</span></code></p></td>
|
||
<td><p>右侧 T 型的别名</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_SSBB</span></code></p></td>
|
||
<td><p>左下角的别名</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_SSBS</span></code></p></td>
|
||
<td><p>底部 T 型的别名</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_SSSB</span></code></p></td>
|
||
<td><p>左侧 T 型的别名</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_SSSS</span></code></p></td>
|
||
<td><p>交叉或大加号的替代名称</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_STERLING</span></code></p></td>
|
||
<td><p>英镑</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_TTEE</span></code></p></td>
|
||
<td><p>顶部 T 型</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_UARROW</span></code></p></td>
|
||
<td><p>向上箭头</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_ULCORNER</span></code></p></td>
|
||
<td><p>左上角</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_URCORNER</span></code></p></td>
|
||
<td><p>右上角</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">ACS_VLINE</span></code></p></td>
|
||
<td><p>垂线</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<p>下表列出了预定义的颜色：</p>
|
||
<table class="docutils align-default">
|
||
<colgroup>
|
||
<col style="width: 40%" />
|
||
<col style="width: 60%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>常量</p></th>
|
||
<th class="head"><p>颜色</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">COLOR_BLACK</span></code></p></td>
|
||
<td><p>黑色</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">COLOR_BLUE</span></code></p></td>
|
||
<td><p>蓝色</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">COLOR_CYAN</span></code></p></td>
|
||
<td><p>青色（浅绿蓝色）</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">COLOR_GREEN</span></code></p></td>
|
||
<td><p>绿色</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">COLOR_MAGENTA</span></code></p></td>
|
||
<td><p>洋红色（紫红色）</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">COLOR_RED</span></code></p></td>
|
||
<td><p>红色</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="docutils literal notranslate"><span class="pre">COLOR_WHITE</span></code></p></td>
|
||
<td><p>白色</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="docutils literal notranslate"><span class="pre">COLOR_YELLOW</span></code></p></td>
|
||
<td><p>黄色</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</section>
|
||
</section>
|
||
<section id="module-curses.textpad">
|
||
<span id="curses-textpad-text-input-widget-for-curses-programs"></span><h1><a class="reference internal" href="#module-curses.textpad" title="curses.textpad: Emacs-like input editing in a curses window."><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses.textpad</span></code></a> --- 用于 curses 程序的文本输入控件<a class="headerlink" href="#module-curses.textpad" title="永久链接至标题">¶</a></h1>
|
||
<p><a class="reference internal" href="#module-curses.textpad" title="curses.textpad: Emacs-like input editing in a curses window."><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses.textpad</span></code></a> 模块提供了一个 <a class="reference internal" href="#curses.textpad.Textbox" title="curses.textpad.Textbox"><code class="xref py py-class docutils literal notranslate"><span class="pre">Textbox</span></code></a> 类，该类在 curses 窗口中处理基本的文本编辑，支持一组与 Emacs 类似的键绑定（因此这也适用于 Netscape Navigator, BBedit 6.x, FrameMaker 和许多其他程序）。 该模块还提供了一个绘制矩形的函数，适用于容纳文本框或其他目的。</p>
|
||
<p><a class="reference internal" href="#module-curses.textpad" title="curses.textpad: Emacs-like input editing in a curses window."><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses.textpad</span></code></a> 模块定义了以下函数:</p>
|
||
<dl class="function">
|
||
<dt id="curses.textpad.rectangle">
|
||
<code class="sig-prename descclassname">curses.textpad.</code><code class="sig-name descname">rectangle</code><span class="sig-paren">(</span><em class="sig-param">win</em>, <em class="sig-param">uly</em>, <em class="sig-param">ulx</em>, <em class="sig-param">lry</em>, <em class="sig-param">lrx</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.textpad.rectangle" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>绘制一个矩形。 第一个参数必须为窗口对象；其余参数均为相对于该窗口的坐标值。 第二和第三个参数为要绘制的矩形的左上角的 y 和 x 坐标值；第四和第五个参数为其右下角的 y 和 x 坐标值。 将会使用 VT100/IBM PC 形式的字符在可用的终端上（包括 xterm 和大多数其他软件终端模拟器）绘制矩形。 在其他情况下则将使用 ASCII 横杠、竖线和加号绘制。</p>
|
||
</dd></dl>
|
||
|
||
<section id="textbox-objects">
|
||
<span id="curses-textpad-objects"></span><h2>文本框对象<a class="headerlink" href="#textbox-objects" title="永久链接至标题">¶</a></h2>
|
||
<p>你可以通过如下方式实例化一个 <a class="reference internal" href="#curses.textpad.Textbox" title="curses.textpad.Textbox"><code class="xref py py-class docutils literal notranslate"><span class="pre">Textbox</span></code></a>:</p>
|
||
<dl class="class">
|
||
<dt id="curses.textpad.Textbox">
|
||
<em class="property">class </em><code class="sig-prename descclassname">curses.textpad.</code><code class="sig-name descname">Textbox</code><span class="sig-paren">(</span><em class="sig-param">win</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.textpad.Textbox" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>返回一个文本框控件对象。 <em>win</em> 参数必须是一个 curses <a class="reference internal" href="#curses-window-objects"><span class="std std-ref">窗口</span></a> 对象，文本框将被包含在其中。 文本框的编辑光标在初始时位于包含窗口的左上角，坐标值为 <code class="docutils literal notranslate"><span class="pre">(0,</span> <span class="pre">0)</span></code>。 实例的 <a class="reference internal" href="#curses.textpad.Textbox.stripspaces" title="curses.textpad.Textbox.stripspaces"><code class="xref py py-attr docutils literal notranslate"><span class="pre">stripspaces</span></code></a> 旗标初始时为启用。</p>
|
||
<p><a class="reference internal" href="#curses.textpad.Textbox" title="curses.textpad.Textbox"><code class="xref py py-class docutils literal notranslate"><span class="pre">Textbox</span></code></a> 对象具有以下方法:</p>
|
||
<dl class="method">
|
||
<dt id="curses.textpad.Textbox.edit">
|
||
<code class="sig-name descname">edit</code><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param">validator</em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.textpad.Textbox.edit" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>这是你通常将使用的入口点。 它接受编辑按键直到键入了一个终止按键。 如果提供了 <em>validator</em>，它必须是一个函数。 它将在每次按键时被调用并传入相应的按键作作为形参；命令发送将在结果上执行。 此方法会以字符串形式返回窗口内容；是否包括窗口中的空白将受到 <a class="reference internal" href="#curses.textpad.Textbox.stripspaces" title="curses.textpad.Textbox.stripspaces"><code class="xref py py-attr docutils literal notranslate"><span class="pre">stripspaces</span></code></a> 属性的影响。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.textpad.Textbox.do_command">
|
||
<code class="sig-name descname">do_command</code><span class="sig-paren">(</span><em class="sig-param">ch</em><span class="sig-paren">)</span><a class="headerlink" href="#curses.textpad.Textbox.do_command" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>处理单个按键命令。以下是支持的特殊按键：</p>
|
||
<table class="docutils align-default">
|
||
<colgroup>
|
||
<col style="width: 30%" />
|
||
<col style="width: 70%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>按键</p></th>
|
||
<th class="head"><p>动作</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">Control-A</kbd></p></td>
|
||
<td><p>转到窗口的左边缘。</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">Control-B</kbd></p></td>
|
||
<td><p>光标向左，如果可能，包含前一行。</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">Control-D</kbd></p></td>
|
||
<td><p>删除光标下的字符。</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">Control-E</kbd></p></td>
|
||
<td><p>前往右边缘（stripspaces 关闭时）或者行尾（stripspaces 启用时）。</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">Control-F</kbd></p></td>
|
||
<td><p>向右移动光标，适当时换行到下一行。</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">Control-G</kbd></p></td>
|
||
<td><p>终止，返回窗口内容。</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">Control-H</kbd></p></td>
|
||
<td><p>向后删除字符。</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">Control-J</kbd></p></td>
|
||
<td><p>如果窗口是1行则终止，否则插入换行符。</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">Control-K</kbd></p></td>
|
||
<td><p>如果行为空，则删除它，否则清除到行尾。</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">Control-L</kbd></p></td>
|
||
<td><p>刷新屏幕。</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">Control-N</kbd></p></td>
|
||
<td><p>光标向下;向下移动一行。</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">Control-O</kbd></p></td>
|
||
<td><p>在光标位置插入一个空行。</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">Control-P</kbd></p></td>
|
||
<td><p>光标向上;向上移动一行。</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<p>如果光标位于无法移动的边缘，则移动操作不执行任何操作。在可能的情况下，支持以下同义词：</p>
|
||
<table class="docutils align-default">
|
||
<colgroup>
|
||
<col style="width: 57%" />
|
||
<col style="width: 43%" />
|
||
</colgroup>
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>常量</p></th>
|
||
<th class="head"><p>按键</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><p><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_LEFT</span></code></p></td>
|
||
<td><p><kbd class="kbd docutils literal notranslate">Control-B</kbd></p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_RIGHT</span></code></p></td>
|
||
<td><p><kbd class="kbd docutils literal notranslate">Control-F</kbd></p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_UP</span></code></p></td>
|
||
<td><p><kbd class="kbd docutils literal notranslate">Control-P</kbd></p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_DOWN</span></code></p></td>
|
||
<td><p><kbd class="kbd docutils literal notranslate">Control-N</kbd></p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_BACKSPACE</span></code></p></td>
|
||
<td><p><kbd class="kbd docutils literal notranslate">Control-h</kbd></p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<p>所有其他按键将被视为插入给定字符并右移的命令（带有自动折行）。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="method">
|
||
<dt id="curses.textpad.Textbox.gather">
|
||
<code class="sig-name descname">gather</code><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.textpad.Textbox.gather" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>以字符串形式返回窗口内容；是否包括窗口中的空白将受到 <a class="reference internal" href="#curses.textpad.Textbox.stripspaces" title="curses.textpad.Textbox.stripspaces"><code class="xref py py-attr docutils literal notranslate"><span class="pre">stripspaces</span></code></a> 成员的影响。</p>
|
||
</dd></dl>
|
||
|
||
<dl class="attribute">
|
||
<dt id="curses.textpad.Textbox.stripspaces">
|
||
<code class="sig-name descname">stripspaces</code><a class="headerlink" href="#curses.textpad.Textbox.stripspaces" title="永久链接至目标">¶</a></dt>
|
||
<dd><p>此属性是控制窗口中空白解读方式的旗标。 当启用时，每一行的末尾空白会被忽略；任何将光标定位至末尾空白的光标动作都将改为前往该行末尾，并且在收集窗口内容时将去除末尾空白。</p>
|
||
</dd></dl>
|
||
|
||
</dd></dl>
|
||
|
||
</section>
|
||
</section>
|
||
|
||
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
|
||
<div class="sphinxsidebarwrapper">
|
||
<h3><a href="../contents.html">目录</a></h3>
|
||
<ul>
|
||
<li><a class="reference internal" href="#"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses</span></code> --- 终端字符单元显示的处理</a><ul>
|
||
<li><a class="reference internal" href="#functions">函数</a></li>
|
||
<li><a class="reference internal" href="#window-objects">Window 对象</a></li>
|
||
<li><a class="reference internal" href="#constants">常量</a></li>
|
||
</ul>
|
||
</li>
|
||
<li><a class="reference internal" href="#module-curses.textpad"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses.textpad</span></code> --- 用于 curses 程序的文本输入控件</a><ul>
|
||
<li><a class="reference internal" href="#textbox-objects">文本框对象</a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
|
||
<h4>上一个主题</h4>
|
||
<p class="topless"><a href="getpass.html"
|
||
title="上一章"><code class="xref py py-mod docutils literal notranslate"><span class="pre">getpass</span></code> --- 便携式密码输入工具</a></p>
|
||
<h4>下一个主题</h4>
|
||
<p class="topless"><a href="curses.ascii.html"
|
||
title="下一章"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses.ascii</span></code> --- 用于 ASCII 字符的工具</a></p>
|
||
<div role="note" aria-label="source link">
|
||
<h3>本页</h3>
|
||
<ul class="this-page-menu">
|
||
<li><a href="../bugs.html">报告 Bug</a></li>
|
||
<li>
|
||
<a href="https://github.com/python/cpython/blob/3.8/Doc/library/curses.rst"
|
||
rel="nofollow">显示源代码
|
||
</a>
|
||
</li>
|
||
</ul>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="clearer"></div>
|
||
</div>
|
||
<div class="related" role="navigation" aria-label="related navigation">
|
||
<h3>导航</h3>
|
||
<ul>
|
||
<li class="right" style="margin-right: 10px">
|
||
<a href="../genindex.html" title="总目录"
|
||
>索引</a></li>
|
||
<li class="right" >
|
||
<a href="../py-modindex.html" title="Python 模块索引"
|
||
>模块</a> |</li>
|
||
<li class="right" >
|
||
<a href="curses.ascii.html" title="curses.ascii --- 用于 ASCII 字符的工具"
|
||
>下一页</a> |</li>
|
||
<li class="right" >
|
||
<a href="getpass.html" title="getpass --- 便携式密码输入工具"
|
||
>上一页</a> |</li>
|
||
|
||
<li><img src="../_static/py.svg" alt="python logo" style="vertical-align: middle; margin-top: -1px"/></li>
|
||
<li><a href="https://www.python.org/">Python</a> »</li>
|
||
<li class="switchers">
|
||
<div class="language_switcher_placeholder"></div>
|
||
<div class="version_switcher_placeholder"></div>
|
||
</li>
|
||
<li>
|
||
|
||
</li>
|
||
<li id="cpython-language-and-version">
|
||
<a href="../index.html">3.8.20 Documentation</a> »
|
||
</li>
|
||
|
||
<li class="nav-item nav-item-1"><a href="index.html" >Python 标准库</a> »</li>
|
||
<li class="nav-item nav-item-2"><a href="allos.html" >通用操作系统服务</a> »</li>
|
||
<li class="right">
|
||
|
||
|
||
<div class="inline-search" role="search">
|
||
<form class="inline-search" action="../search.html" method="get">
|
||
<input placeholder="快速搜索" aria-label="快速搜索" type="text" name="q" />
|
||
<input type="submit" value="转向" />
|
||
<input type="hidden" name="check_keywords" value="yes" />
|
||
<input type="hidden" name="area" value="default" />
|
||
</form>
|
||
</div>
|
||
|
|
||
</li>
|
||
|
||
</ul>
|
||
</div>
|
||
<div class="footer">
|
||
© <a href="../copyright.html">版权所有</a> 2001-2024, Python Software Foundation.
|
||
<br />
|
||
This page is licensed under the Python Software Foundation License Version 2.
|
||
<br />
|
||
Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License.
|
||
<br />
|
||
|
||
<br />
|
||
|
||
The Python Software Foundation is a non-profit corporation.
|
||
<a href="https://www.python.org/psf/donations/">Please donate.</a>
|
||
<br />
|
||
<br />
|
||
|
||
最后更新于 12月 09, 2024.
|
||
<a href="https://docs.python.org/3/bugs.html">Found a bug</a>?
|
||
<br />
|
||
|
||
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 2.4.4.
|
||
</div>
|
||
|
||
</body>
|
||
</html> |