3559 lines
270 KiB
HTML
3559 lines
270 KiB
HTML
<!DOCTYPE html>
|
||
|
||
<html lang="en" data-content_root="../">
|
||
<head>
|
||
<meta charset="utf-8" />
|
||
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />
|
||
<meta property="og:title" content="curses — Terminal handling for character-cell displays" />
|
||
<meta property="og:type" content="website" />
|
||
<meta property="og:url" content="https://docs.python.org/3/library/curses.html" />
|
||
<meta property="og:site_name" content="Python documentation" />
|
||
<meta property="og:description" content="Source code: Lib/curses The curses module provides an interface to the curses library, the de-facto standard for portable advanced terminal handling. While curses is most widely used in the Unix en..." />
|
||
<meta property="og:image" content="https://docs.python.org/3/_static/og-image.png" />
|
||
<meta property="og:image:alt" content="Python documentation" />
|
||
<meta name="description" content="Source code: Lib/curses The curses module provides an interface to the curses library, the de-facto standard for portable advanced terminal handling. While curses is most widely used in the Unix en..." />
|
||
<meta property="og:image:width" content="200">
|
||
<meta property="og:image:height" content="200">
|
||
<meta name="theme-color" content="#3776ab">
|
||
|
||
<title>curses — Terminal handling for character-cell displays — Python 3.13.3 documentation</title><meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
|
||
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=b86133f3" />
|
||
<link rel="stylesheet" type="text/css" href="../_static/pydoctheme.css?v=23252803" />
|
||
<link id="pygments_dark_css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css" href="../_static/pygments_dark.css?v=5349f25f" />
|
||
|
||
<script src="../_static/documentation_options.js?v=5d57ca2d"></script>
|
||
<script src="../_static/doctools.js?v=9bcbadda"></script>
|
||
<script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
|
||
|
||
<script src="../_static/sidebar.js"></script>
|
||
|
||
<link rel="search" type="application/opensearchdescription+xml"
|
||
title="Search within Python 3.13.3 documentation"
|
||
href="../_static/opensearch.xml"/>
|
||
<link rel="author" title="About these documents" href="../about.html" />
|
||
<link rel="index" title="Index" href="../genindex.html" />
|
||
<link rel="search" title="Search" href="../search.html" />
|
||
<link rel="copyright" title="Copyright" href="../copyright.html" />
|
||
<link rel="next" title="curses.ascii — Utilities for ASCII characters" href="curses.ascii.html" />
|
||
<link rel="prev" title="fileinput — Iterate over lines from multiple input streams" href="fileinput.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="stylesheet" href="../_static/pydoctheme_dark.css" media="(prefers-color-scheme: dark)" id="pydoctheme_dark_css">
|
||
<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>
|
||
<script type="text/javascript" src="../_static/search-focus.js"></script>
|
||
<script type="text/javascript" src="../_static/themetoggle.js"></script>
|
||
<script type="text/javascript" src="../_static/rtd_switcher.js"></script>
|
||
<meta name="readthedocs-addons-api-version" content="1">
|
||
|
||
</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" />
|
||
<nav class="nav-content" role="navigation">
|
||
<label for="menuToggler" class="toggler__label">
|
||
<span></span>
|
||
</label>
|
||
<span class="nav-items-wrapper">
|
||
<a href="https://www.python.org/" class="nav-logo">
|
||
<img src="../_static/py.svg" alt="Python logo"/>
|
||
</a>
|
||
<span class="version_switcher_placeholder"></span>
|
||
<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" fill="currentColor" 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"></path>
|
||
</svg>
|
||
<input placeholder="Quick search" aria-label="Quick search" type="search" name="q" />
|
||
<input type="submit" value="Go"/>
|
||
</form>
|
||
</span>
|
||
</nav>
|
||
<div class="menu-wrapper">
|
||
<nav class="menu" role="navigation" aria-label="main navigation">
|
||
<div class="language_switcher_placeholder"></div>
|
||
|
||
<label class="theme-selector-label">
|
||
Theme
|
||
<select class="theme-selector" oninput="activateTheme(this.value)">
|
||
<option value="auto" selected>Auto</option>
|
||
<option value="light">Light</option>
|
||
<option value="dark">Dark</option>
|
||
</select>
|
||
</label>
|
||
<div>
|
||
<h3><a href="../contents.html">Table of Contents</a></h3>
|
||
<ul>
|
||
<li><a class="reference internal" href="#"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses</span></code> — Terminal handling for character-cell displays</a><ul>
|
||
<li><a class="reference internal" href="#functions">Functions</a></li>
|
||
<li><a class="reference internal" href="#window-objects">Window Objects</a></li>
|
||
<li><a class="reference internal" href="#constants">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> — Text input widget for curses programs</a><ul>
|
||
<li><a class="reference internal" href="#textbox-objects">Textbox objects</a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
|
||
</div>
|
||
<div>
|
||
<h4>Previous topic</h4>
|
||
<p class="topless"><a href="fileinput.html"
|
||
title="previous chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">fileinput</span></code> — Iterate over lines from multiple input streams</a></p>
|
||
</div>
|
||
<div>
|
||
<h4>Next topic</h4>
|
||
<p class="topless"><a href="curses.ascii.html"
|
||
title="next chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses.ascii</span></code> — Utilities for ASCII characters</a></p>
|
||
</div>
|
||
<div role="note" aria-label="source link">
|
||
<h3>This Page</h3>
|
||
<ul class="this-page-menu">
|
||
<li><a href="../bugs.html">Report a Bug</a></li>
|
||
<li>
|
||
<a href="https://github.com/python/cpython/blob/main/Doc/library/curses.rst"
|
||
rel="nofollow">Show Source
|
||
</a>
|
||
</li>
|
||
</ul>
|
||
</div>
|
||
</nav>
|
||
</div>
|
||
</div>
|
||
|
||
|
||
<div class="related" role="navigation" aria-label="Related">
|
||
<h3>Navigation</h3>
|
||
<ul>
|
||
<li class="right" style="margin-right: 10px">
|
||
<a href="../genindex.html" title="General Index"
|
||
accesskey="I">index</a></li>
|
||
<li class="right" >
|
||
<a href="../py-modindex.html" title="Python Module Index"
|
||
>modules</a> |</li>
|
||
<li class="right" >
|
||
<a href="curses.ascii.html" title="curses.ascii — Utilities for ASCII characters"
|
||
accesskey="N">next</a> |</li>
|
||
<li class="right" >
|
||
<a href="fileinput.html" title="fileinput — Iterate over lines from multiple input streams"
|
||
accesskey="P">previous</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.13.3 Documentation</a> »
|
||
</li>
|
||
|
||
<li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> »</li>
|
||
<li class="nav-item nav-item-2"><a href="cmdlinelibs.html" accesskey="U">Command Line Interface Libraries</a> »</li>
|
||
<li class="nav-item nav-item-this"><a href=""><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses</span></code> — Terminal handling for character-cell displays</a></li>
|
||
<li class="right">
|
||
|
||
|
||
<div class="inline-search" role="search">
|
||
<form class="inline-search" action="../search.html" method="get">
|
||
<input placeholder="Quick search" aria-label="Quick search" type="search" name="q" id="search-box" />
|
||
<input type="submit" value="Go" />
|
||
</form>
|
||
</div>
|
||
|
|
||
</li>
|
||
<li class="right">
|
||
<label class="theme-selector-label">
|
||
Theme
|
||
<select class="theme-selector" oninput="activateTheme(this.value)">
|
||
<option value="auto" selected>Auto</option>
|
||
<option value="light">Light</option>
|
||
<option value="dark">Dark</option>
|
||
</select>
|
||
</label> |</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><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses</span></code> — Terminal handling for character-cell displays<a class="headerlink" href="#module-curses" title="Link to this heading">¶</a></h1>
|
||
<p><strong>Source code:</strong> <a class="extlink-source reference external" href="https://github.com/python/cpython/tree/3.13/Lib/curses">Lib/curses</a></p>
|
||
<hr class="docutils" />
|
||
<p>The <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> module provides an interface to the curses library, the
|
||
de-facto standard for portable advanced terminal handling.</p>
|
||
<p>While curses is most widely used in the Unix environment, versions are available
|
||
for Windows, DOS, and possibly other systems as well. This extension module is
|
||
designed to match the API of ncurses, an open-source curses library hosted on
|
||
Linux and the BSD variants of Unix.</p>
|
||
<div class="availability docutils container">
|
||
<p><a class="reference internal" href="intro.html#availability"><span class="std std-ref">Availability</span></a>: not Android, not iOS, not WASI.</p>
|
||
<p>This module is not supported on <a class="reference internal" href="intro.html#mobile-availability"><span class="std std-ref">mobile platforms</span></a>
|
||
or <a class="reference internal" href="intro.html#wasm-availability"><span class="std std-ref">WebAssembly platforms</span></a>.</p>
|
||
</div>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p>Whenever the documentation mentions a <em>character</em> it can be specified
|
||
as an integer, a one-character Unicode string or a one-byte byte string.</p>
|
||
<p>Whenever the documentation mentions a <em>character string</em> it can be specified
|
||
as a Unicode string or a byte string.</p>
|
||
</div>
|
||
<div class="admonition seealso">
|
||
<p class="admonition-title">See also</p>
|
||
<dl class="simple">
|
||
<dt>Module <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>Utilities for working with ASCII characters, regardless of your locale settings.</p>
|
||
</dd>
|
||
<dt>Module <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>A panel stack extension that adds depth to curses windows.</p>
|
||
</dd>
|
||
<dt>Module <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>Editable text widget for curses supporting <strong class="program">Emacs</strong>-like bindings.</p>
|
||
</dd>
|
||
<dt><a class="reference internal" href="../howto/curses.html#curses-howto"><span class="std std-ref">Curses Programming with Python</span></a></dt><dd><p>Tutorial material on using curses with Python, by Andrew Kuchling and Eric
|
||
Raymond.</p>
|
||
</dd>
|
||
</dl>
|
||
</div>
|
||
<section id="functions">
|
||
<span id="curses-functions"></span><h2>Functions<a class="headerlink" href="#functions" title="Link to this heading">¶</a></h2>
|
||
<p>The module <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> defines the following exception:</p>
|
||
<dl class="py exception">
|
||
<dt class="sig sig-object py" id="curses.error">
|
||
<em class="property"><span class="k"><span class="pre">exception</span></span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">error</span></span><a class="headerlink" href="#curses.error" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Exception raised when a curses library function returns an error.</p>
|
||
</dd></dl>
|
||
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p>Whenever <em>x</em> or <em>y</em> arguments to a function or a method are optional, they
|
||
default to the current cursor location. Whenever <em>attr</em> is optional, it defaults
|
||
to <a class="reference internal" href="#curses.A_NORMAL" title="curses.A_NORMAL"><code class="xref py py-const docutils literal notranslate"><span class="pre">A_NORMAL</span></code></a>.</p>
|
||
</div>
|
||
<p>The module <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> defines the following functions:</p>
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.baudrate">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">baudrate</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.baudrate" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return the output speed of the terminal in bits per second. On software
|
||
terminal emulators it will have a fixed high value. Included for historical
|
||
reasons; in former times, it was used to write output loops for time delays and
|
||
occasionally to change interfaces depending on the line speed.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.beep">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">beep</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.beep" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Emit a short attention sound.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.can_change_color">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">can_change_color</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.can_change_color" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return <code class="docutils literal notranslate"><span class="pre">True</span></code> or <code class="docutils literal notranslate"><span class="pre">False</span></code>, depending on whether the programmer can change the colors
|
||
displayed by the terminal.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.cbreak">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">cbreak</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.cbreak" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Enter cbreak mode. In cbreak mode (sometimes called “rare” mode) normal tty
|
||
line buffering is turned off and characters are available to be read one by one.
|
||
However, unlike raw mode, special characters (interrupt, quit, suspend, and flow
|
||
control) retain their effects on the tty driver and calling program. Calling
|
||
first <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> then <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> leaves the terminal in cbreak mode.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.color_content">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">color_content</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">color_number</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.color_content" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return the intensity of the red, green, and blue (RGB) components in the color
|
||
<em>color_number</em>, which must be between <code class="docutils literal notranslate"><span class="pre">0</span></code> and <code class="docutils literal notranslate"><span class="pre">COLORS</span> <span class="pre">-</span> <span class="pre">1</span></code>. Return a 3-tuple,
|
||
containing the R,G,B values for the given color, which will be between
|
||
<code class="docutils literal notranslate"><span class="pre">0</span></code> (no component) and <code class="docutils literal notranslate"><span class="pre">1000</span></code> (maximum amount of component).</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.color_pair">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">color_pair</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">pair_number</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.color_pair" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return the attribute value for displaying text in the specified color pair.
|
||
Only the first 256 color pairs are supported. This
|
||
attribute value can be combined with <a class="reference internal" href="#curses.A_STANDOUT" title="curses.A_STANDOUT"><code class="xref py py-const docutils literal notranslate"><span class="pre">A_STANDOUT</span></code></a>, <a class="reference internal" href="#curses.A_REVERSE" title="curses.A_REVERSE"><code class="xref py py-const docutils literal notranslate"><span class="pre">A_REVERSE</span></code></a>,
|
||
and the other <code class="xref py py-const docutils literal notranslate"><span class="pre">A_*</span></code> attributes. <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> is the counterpart
|
||
to this function.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.curs_set">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">curs_set</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">visibility</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.curs_set" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Set the cursor state. <em>visibility</em> can be set to <code class="docutils literal notranslate"><span class="pre">0</span></code>, <code class="docutils literal notranslate"><span class="pre">1</span></code>, or <code class="docutils literal notranslate"><span class="pre">2</span></code>, for invisible,
|
||
normal, or very visible. If the terminal supports the visibility requested, return the
|
||
previous cursor state; otherwise raise an exception. On many
|
||
terminals, the “visible” mode is an underline cursor and the “very visible” mode
|
||
is a block cursor.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.def_prog_mode">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">def_prog_mode</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.def_prog_mode" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Save the current terminal mode as the “program” mode, the mode when the running
|
||
program is using curses. (Its counterpart is the “shell” mode, for when the
|
||
program is not in curses.) Subsequent calls to <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> will
|
||
restore this mode.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.def_shell_mode">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">def_shell_mode</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.def_shell_mode" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Save the current terminal mode as the “shell” mode, the mode when the running
|
||
program is not using curses. (Its counterpart is the “program” mode, when the
|
||
program is using curses capabilities.) Subsequent calls to
|
||
<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> will restore this mode.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.delay_output">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">delay_output</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ms</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.delay_output" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Insert an <em>ms</em> millisecond pause in output.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.doupdate">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">doupdate</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.doupdate" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Update the physical screen. The curses library keeps two data structures, one
|
||
representing the current physical screen contents and a virtual screen
|
||
representing the desired next state. The <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> ground updates the
|
||
physical screen to match the virtual screen.</p>
|
||
<p>The virtual screen may be updated by 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> call after write
|
||
operations such as <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> have been performed on a window. The normal
|
||
<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> call is simply <code class="xref py py-meth docutils literal notranslate"><span class="pre">noutrefresh()</span></code> followed by <code class="xref py py-func docutils literal notranslate"><span class="pre">doupdate()</span></code>;
|
||
if you have to update multiple windows, you can speed performance and perhaps
|
||
reduce screen flicker by issuing <code class="xref py py-meth docutils literal notranslate"><span class="pre">noutrefresh()</span></code> calls on all windows,
|
||
followed by a single <code class="xref py py-func docutils literal notranslate"><span class="pre">doupdate()</span></code>.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.echo">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">echo</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.echo" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Enter echo mode. In echo mode, each character input is echoed to the screen as
|
||
it is entered.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.endwin">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">endwin</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.endwin" title="Link to this definition">¶</a></dt>
|
||
<dd><p>De-initialize the library, and return terminal to normal status.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.erasechar">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">erasechar</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.erasechar" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return the user’s current erase character as a one-byte bytes object. Under Unix operating systems this
|
||
is a property of the controlling tty of the curses program, and is not set by
|
||
the curses library itself.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.filter">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">filter</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.filter" title="Link to this definition">¶</a></dt>
|
||
<dd><p>The <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> routine, if used, must be called before <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> is
|
||
called. The effect is that, during those calls, <span class="target" id="index-0"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">LINES</span></code> is set to <code class="docutils literal notranslate"><span class="pre">1</span></code>; the
|
||
capabilities <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> are disabled; and the <code class="docutils literal notranslate"><span class="pre">home</span></code>
|
||
string is set to the value of <code class="docutils literal notranslate"><span class="pre">cr</span></code>. The effect is that the cursor is confined to
|
||
the current line, and so are screen updates. This may be used for enabling
|
||
character-at-a-time line editing without touching the rest of the screen.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.flash">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">flash</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.flash" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Flash the screen. That is, change it to reverse-video and then change it back
|
||
in a short interval. Some people prefer such as ‘visible bell’ to the audible
|
||
attention signal produced by <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="py function">
|
||
<dt class="sig sig-object py" id="curses.flushinp">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">flushinp</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.flushinp" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Flush all input buffers. This throws away any typeahead that has been typed
|
||
by the user and has not yet been processed by the program.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.getmouse">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">getmouse</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.getmouse" title="Link to this definition">¶</a></dt>
|
||
<dd><p>After <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> returns <a class="reference internal" href="#curses.KEY_MOUSE" title="curses.KEY_MOUSE"><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_MOUSE</span></code></a> to signal a mouse event, this
|
||
method should be called to retrieve the queued mouse event, represented as a
|
||
5-tuple <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> is an ID value used to distinguish
|
||
multiple devices, and <em>x</em>, <em>y</em>, <em>z</em> are the event’s coordinates. (<em>z</em> is
|
||
currently unused.) <em>bstate</em> is an integer value whose bits will be set to
|
||
indicate the type of event, and will be the bitwise OR of one or more of the
|
||
following constants, where <em>n</em> is the button number from 1 to 5:
|
||
<a class="reference internal" href="#curses.BUTTONn_PRESSED" title="curses.BUTTONn_PRESSED"><code class="xref py py-const docutils literal notranslate"><span class="pre">BUTTONn_PRESSED</span></code></a>, <a class="reference internal" href="#curses.BUTTONn_RELEASED" title="curses.BUTTONn_RELEASED"><code class="xref py py-const docutils literal notranslate"><span class="pre">BUTTONn_RELEASED</span></code></a>, <a class="reference internal" href="#curses.BUTTONn_CLICKED" title="curses.BUTTONn_CLICKED"><code class="xref py py-const docutils literal notranslate"><span class="pre">BUTTONn_CLICKED</span></code></a>,
|
||
<a class="reference internal" href="#curses.BUTTONn_DOUBLE_CLICKED" title="curses.BUTTONn_DOUBLE_CLICKED"><code class="xref py py-const docutils literal notranslate"><span class="pre">BUTTONn_DOUBLE_CLICKED</span></code></a>, <a class="reference internal" href="#curses.BUTTONn_TRIPLE_CLICKED" title="curses.BUTTONn_TRIPLE_CLICKED"><code class="xref py py-const docutils literal notranslate"><span class="pre">BUTTONn_TRIPLE_CLICKED</span></code></a>,
|
||
<a class="reference internal" href="#curses.BUTTON_SHIFT" title="curses.BUTTON_SHIFT"><code class="xref py py-const docutils literal notranslate"><span class="pre">BUTTON_SHIFT</span></code></a>, <a class="reference internal" href="#curses.BUTTON_CTRL" title="curses.BUTTON_CTRL"><code class="xref py py-const docutils literal notranslate"><span class="pre">BUTTON_CTRL</span></code></a>, <a class="reference internal" href="#curses.BUTTON_ALT" title="curses.BUTTON_ALT"><code class="xref py py-const docutils literal notranslate"><span class="pre">BUTTON_ALT</span></code></a>.</p>
|
||
<div class="versionchanged">
|
||
<p><span class="versionmodified changed">Changed in version 3.10: </span>The <code class="docutils literal notranslate"><span class="pre">BUTTON5_*</span></code> constants are now exposed if they are provided by the
|
||
underlying curses library.</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.getsyx">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">getsyx</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.getsyx" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return the current coordinates of the virtual screen cursor as a tuple
|
||
<code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code>. If <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> is currently <code class="docutils literal notranslate"><span class="pre">True</span></code>, then return <code class="docutils literal notranslate"><span class="pre">(-1,</span> <span class="pre">-1)</span></code>.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.getwin">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">getwin</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">file</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.getwin" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Read window related data stored in the file by an earlier <a class="reference internal" href="#curses.window.putwin" title="curses.window.putwin"><code class="xref py py-func docutils literal notranslate"><span class="pre">window.putwin()</span></code></a> call.
|
||
The routine then creates and initializes a new window using that data, returning
|
||
the new window object.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.has_colors">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">has_colors</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.has_colors" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return <code class="docutils literal notranslate"><span class="pre">True</span></code> if the terminal can display colors; otherwise, return <code class="docutils literal notranslate"><span class="pre">False</span></code>.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.has_extended_color_support">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">has_extended_color_support</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.has_extended_color_support" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return <code class="docutils literal notranslate"><span class="pre">True</span></code> if the module supports extended colors; otherwise, return
|
||
<code class="docutils literal notranslate"><span class="pre">False</span></code>. Extended color support allows more than 256 color pairs for
|
||
terminals that support more than 16 colors (e.g. xterm-256color).</p>
|
||
<p>Extended color support requires ncurses version 6.1 or later.</p>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">Added in version 3.10.</span></p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.has_ic">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">has_ic</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.has_ic" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return <code class="docutils literal notranslate"><span class="pre">True</span></code> if the terminal has insert- and delete-character capabilities.
|
||
This function is included for historical reasons only, as all modern software
|
||
terminal emulators have such capabilities.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.has_il">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">has_il</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.has_il" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return <code class="docutils literal notranslate"><span class="pre">True</span></code> if the terminal has insert- and delete-line capabilities, or can
|
||
simulate them using scrolling regions. This function is included for
|
||
historical reasons only, as all modern software terminal emulators have such
|
||
capabilities.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.has_key">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">has_key</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ch</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.has_key" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Take a key value <em>ch</em>, and return <code class="docutils literal notranslate"><span class="pre">True</span></code> if the current terminal type recognizes
|
||
a key with that value.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.halfdelay">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">halfdelay</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">tenths</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.halfdelay" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Used for half-delay mode, which is similar to cbreak mode in that characters
|
||
typed by the user are immediately available to the program. However, after
|
||
blocking for <em>tenths</em> tenths of seconds, raise an exception if nothing has
|
||
been typed. The value of <em>tenths</em> must be a number between <code class="docutils literal notranslate"><span class="pre">1</span></code> and <code class="docutils literal notranslate"><span class="pre">255</span></code>. Use
|
||
<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> to leave half-delay mode.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.init_color">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">init_color</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">color_number</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">r</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">g</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">b</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.init_color" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Change the definition of a color, taking the number of the color to be changed
|
||
followed by three RGB values (for the amounts of red, green, and blue
|
||
components). The value of <em>color_number</em> must be between <code class="docutils literal notranslate"><span class="pre">0</span></code> and
|
||
<code class="docutils literal notranslate"><span class="pre">COLORS</span> <span class="pre">-</span> <span class="pre">1</span></code>. Each of <em>r</em>, <em>g</em>, <em>b</em>, must be a value between <code class="docutils literal notranslate"><span class="pre">0</span></code> and
|
||
<code class="docutils literal notranslate"><span class="pre">1000</span></code>. When <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> is used, all occurrences of that color on the
|
||
screen immediately change to the new definition. This function is a no-op on
|
||
most terminals; it is active only if <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> returns <code class="docutils literal notranslate"><span class="pre">True</span></code>.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.init_pair">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">init_pair</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">pair_number</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">fg</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">bg</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.init_pair" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Change the definition of a color-pair. It takes three arguments: the number of
|
||
the color-pair to be changed, the foreground color number, and the background
|
||
color number. The value of <em>pair_number</em> must be between <code class="docutils literal notranslate"><span class="pre">1</span></code> and
|
||
<code class="docutils literal notranslate"><span class="pre">COLOR_PAIRS</span> <span class="pre">-</span> <span class="pre">1</span></code> (the <code class="docutils literal notranslate"><span class="pre">0</span></code> color pair is wired to white on black and cannot
|
||
be changed). The value of <em>fg</em> and <em>bg</em> arguments must be between <code class="docutils literal notranslate"><span class="pre">0</span></code> and
|
||
<code class="docutils literal notranslate"><span class="pre">COLORS</span> <span class="pre">-</span> <span class="pre">1</span></code>, or, after calling <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>.
|
||
If the color-pair was previously initialized, the screen is
|
||
refreshed and all occurrences of that color-pair are changed to the new
|
||
definition.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.initscr">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">initscr</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.initscr" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Initialize the library. Return a <a class="reference internal" href="#curses-window-objects"><span class="std std-ref">window</span></a> object
|
||
which represents the whole screen.</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p>If there is an error opening the terminal, the underlying curses library may
|
||
cause the interpreter to exit.</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.is_term_resized">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">is_term_resized</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">nlines</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ncols</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.is_term_resized" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return <code class="docutils literal notranslate"><span class="pre">True</span></code> if <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> would modify the window structure,
|
||
<code class="docutils literal notranslate"><span class="pre">False</span></code> otherwise.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.isendwin">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">isendwin</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.isendwin" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return <code class="docutils literal notranslate"><span class="pre">True</span></code> if <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> has been called (that is, the curses library has
|
||
been deinitialized).</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.keyname">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">keyname</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">k</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.keyname" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return the name of the key numbered <em>k</em> as a bytes object. The name of a key generating printable
|
||
ASCII character is the key’s character. The name of a control-key combination
|
||
is a two-byte bytes object consisting of a caret (<code class="docutils literal notranslate"><span class="pre">b'^'</span></code>) followed by the corresponding
|
||
printable ASCII character. The name of an alt-key combination (128–255) is a
|
||
bytes object consisting of the prefix <code class="docutils literal notranslate"><span class="pre">b'M-'</span></code> followed by the name of the corresponding
|
||
ASCII character.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.killchar">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">killchar</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.killchar" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return the user’s current line kill character as a one-byte bytes object. Under Unix operating systems
|
||
this is a property of the controlling tty of the curses program, and is not set
|
||
by the curses library itself.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.longname">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">longname</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.longname" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return a bytes object containing the terminfo long name field describing the current
|
||
terminal. The maximum length of a verbose description is 128 characters. It is
|
||
defined only after the call to <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="py function">
|
||
<dt class="sig sig-object py" id="curses.meta">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">meta</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">flag</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.meta" title="Link to this definition">¶</a></dt>
|
||
<dd><p>If <em>flag</em> is <code class="docutils literal notranslate"><span class="pre">True</span></code>, allow 8-bit characters to be input. If
|
||
<em>flag</em> is <code class="docutils literal notranslate"><span class="pre">False</span></code>, allow only 7-bit chars.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.mouseinterval">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">mouseinterval</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">interval</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.mouseinterval" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Set the maximum time in milliseconds that can elapse between press and release
|
||
events in order for them to be recognized as a click, and return the previous
|
||
interval value. The default value is 200 milliseconds, or one fifth of a second.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.mousemask">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">mousemask</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">mousemask</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.mousemask" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Set the mouse events to be reported, and return a tuple <code class="docutils literal notranslate"><span class="pre">(availmask,</span>
|
||
<span class="pre">oldmask)</span></code>. <em>availmask</em> indicates which of the specified mouse events can be
|
||
reported; on complete failure it returns <code class="docutils literal notranslate"><span class="pre">0</span></code>. <em>oldmask</em> is the previous value of
|
||
the given window’s mouse event mask. If this function is never called, no mouse
|
||
events are ever reported.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.napms">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">napms</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ms</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.napms" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Sleep for <em>ms</em> milliseconds.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.newpad">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">newpad</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">nlines</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ncols</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.newpad" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Create and return a pointer to a new pad data structure with the given number
|
||
of lines and columns. Return a pad as a window object.</p>
|
||
<p>A pad is like a window, except that it is not restricted by the screen size, and
|
||
is not necessarily associated with a particular part of the screen. Pads can be
|
||
used when a large window is needed, and only a part of the window will be on the
|
||
screen at one time. Automatic refreshes of pads (such as from scrolling or
|
||
echoing of input) do not occur. The <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> and <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>
|
||
methods of a pad require 6 arguments to specify the part of the pad to be
|
||
displayed and the location on the screen to be used for the display. The
|
||
arguments are <em>pminrow</em>, <em>pmincol</em>, <em>sminrow</em>, <em>smincol</em>, <em>smaxrow</em>, <em>smaxcol</em>; the <em>p</em>
|
||
arguments refer to the upper left corner of the pad region to be displayed and
|
||
the <em>s</em> arguments define a clipping box on the screen within which the pad region
|
||
is to be displayed.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.newwin">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">newwin</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">nlines</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ncols</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.newwin" title="Link to this definition">¶</a></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">newwin</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">nlines</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ncols</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">begin_y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">begin_x</span></span></em><span class="sig-paren">)</span></dt>
|
||
<dd><p>Return a new <a class="reference internal" href="#curses-window-objects"><span class="std std-ref">window</span></a>, whose left-upper corner
|
||
is at <code class="docutils literal notranslate"><span class="pre">(begin_y,</span> <span class="pre">begin_x)</span></code>, and whose height/width is <em>nlines</em>/<em>ncols</em>.</p>
|
||
<p>By default, the window will extend from the specified position to the lower
|
||
right corner of the screen.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.nl">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">nl</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.nl" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Enter newline mode. This mode translates the return key into newline on input,
|
||
and translates newline into return and line-feed on output. Newline mode is
|
||
initially on.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.nocbreak">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">nocbreak</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.nocbreak" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Leave cbreak mode. Return to normal “cooked” mode with line buffering.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.noecho">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">noecho</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.noecho" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Leave echo mode. Echoing of input characters is turned off.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.nonl">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">nonl</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.nonl" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Leave newline mode. Disable translation of return into newline on input, and
|
||
disable low-level translation of newline into newline/return on output (but this
|
||
does not change the behavior of <code class="docutils literal notranslate"><span class="pre">addch('\n')</span></code>, which always does the
|
||
equivalent of return and line feed on the virtual screen). With translation
|
||
off, curses can sometimes speed up vertical motion a little; also, it will be
|
||
able to detect the return key on input.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.noqiflush">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">noqiflush</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.noqiflush" title="Link to this definition">¶</a></dt>
|
||
<dd><p>When the <code class="xref py py-func docutils literal notranslate"><span class="pre">noqiflush()</span></code> routine is used, normal flush of input and output queues
|
||
associated with the <code class="docutils literal notranslate"><span class="pre">INTR</span></code>, <code class="docutils literal notranslate"><span class="pre">QUIT</span></code> and <code class="docutils literal notranslate"><span class="pre">SUSP</span></code> characters will not be done. You may
|
||
want to call <code class="xref py py-func docutils literal notranslate"><span class="pre">noqiflush()</span></code> in a signal handler if you want output to
|
||
continue as though the interrupt had not occurred, after the handler exits.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.noraw">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">noraw</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.noraw" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Leave raw mode. Return to normal “cooked” mode with line buffering.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.pair_content">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">pair_content</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">pair_number</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.pair_content" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return a tuple <code class="docutils literal notranslate"><span class="pre">(fg,</span> <span class="pre">bg)</span></code> containing the colors for the requested color pair.
|
||
The value of <em>pair_number</em> must be between <code class="docutils literal notranslate"><span class="pre">0</span></code> and <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="py function">
|
||
<dt class="sig sig-object py" id="curses.pair_number">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">pair_number</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.pair_number" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return the number of the color-pair set by the attribute value <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> is the counterpart to this function.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.putp">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">putp</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">str</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.putp" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Equivalent to <code class="docutils literal notranslate"><span class="pre">tputs(str,</span> <span class="pre">1,</span> <span class="pre">putchar)</span></code>; emit the value of a specified
|
||
terminfo capability for the current terminal. Note that the output of <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>
|
||
always goes to standard output.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.qiflush">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">qiflush</span></span><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param"><span class="n"><span class="pre">flag</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.qiflush" title="Link to this definition">¶</a></dt>
|
||
<dd><p>If <em>flag</em> is <code class="docutils literal notranslate"><span class="pre">False</span></code>, the effect is the same as calling <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>. If
|
||
<em>flag</em> is <code class="docutils literal notranslate"><span class="pre">True</span></code>, or no argument is provided, the queues will be flushed when
|
||
these control characters are read.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.raw">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">raw</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.raw" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Enter raw mode. In raw mode, normal line buffering and processing of
|
||
interrupt, quit, suspend, and flow control keys are turned off; characters are
|
||
presented to curses input functions one by one.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.reset_prog_mode">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">reset_prog_mode</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.reset_prog_mode" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Restore the terminal to “program” mode, as previously saved by
|
||
<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="py function">
|
||
<dt class="sig sig-object py" id="curses.reset_shell_mode">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">reset_shell_mode</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.reset_shell_mode" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Restore the terminal to “shell” mode, as previously saved by
|
||
<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="py function">
|
||
<dt class="sig sig-object py" id="curses.resetty">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">resetty</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.resetty" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Restore the state of the terminal modes to what it was at the last call to
|
||
<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="py function">
|
||
<dt class="sig sig-object py" id="curses.resize_term">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">resize_term</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">nlines</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ncols</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.resize_term" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Backend function used by <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>, performing most of the work;
|
||
when resizing the windows, <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> blank-fills the areas that are
|
||
extended. The calling application should fill in these areas with
|
||
appropriate data. The <code class="xref py py-func docutils literal notranslate"><span class="pre">resize_term()</span></code> function attempts to resize all
|
||
windows. However, due to the calling convention of pads, it is not possible
|
||
to resize these without additional interaction with the application.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.resizeterm">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">resizeterm</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">nlines</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ncols</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.resizeterm" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Resize the standard and current windows to the specified dimensions, and
|
||
adjusts other bookkeeping data used by the curses library that record the
|
||
window dimensions (in particular the SIGWINCH handler).</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.savetty">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">savetty</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.savetty" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Save the current state of the terminal modes in a buffer, usable by
|
||
<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="py function">
|
||
<dt class="sig sig-object py" id="curses.get_escdelay">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">get_escdelay</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.get_escdelay" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Retrieves the value set by <a class="reference internal" href="#curses.set_escdelay" title="curses.set_escdelay"><code class="xref py py-func docutils literal notranslate"><span class="pre">set_escdelay()</span></code></a>.</p>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">Added in version 3.9.</span></p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.set_escdelay">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">set_escdelay</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ms</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.set_escdelay" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Sets the number of milliseconds to wait after reading an escape character,
|
||
to distinguish between an individual escape character entered on the
|
||
keyboard from escape sequences sent by cursor and function keys.</p>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">Added in version 3.9.</span></p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.get_tabsize">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">get_tabsize</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.get_tabsize" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Retrieves the value set by <a class="reference internal" href="#curses.set_tabsize" title="curses.set_tabsize"><code class="xref py py-func docutils literal notranslate"><span class="pre">set_tabsize()</span></code></a>.</p>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">Added in version 3.9.</span></p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.set_tabsize">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">set_tabsize</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">size</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.set_tabsize" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Sets the number of columns used by the curses library when converting a tab
|
||
character to spaces as it adds the tab to a window.</p>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">Added in version 3.9.</span></p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.setsyx">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">setsyx</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.setsyx" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Set the virtual screen cursor to <em>y</em>, <em>x</em>. If <em>y</em> and <em>x</em> are both <code class="docutils literal notranslate"><span class="pre">-1</span></code>, then
|
||
<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> is set <code class="docutils literal notranslate"><span class="pre">True</span></code>.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.setupterm">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">setupterm</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">term</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">fd</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">-1</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.setupterm" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Initialize the terminal. <em>term</em> is a string giving
|
||
the terminal name, or <code class="docutils literal notranslate"><span class="pre">None</span></code>; if omitted or <code class="docutils literal notranslate"><span class="pre">None</span></code>, the value of the
|
||
<span class="target" id="index-1"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">TERM</span></code> environment variable will be used. <em>fd</em> is the
|
||
file descriptor to which any initialization sequences will be sent; if not
|
||
supplied or <code class="docutils literal notranslate"><span class="pre">-1</span></code>, the file descriptor for <code class="docutils literal notranslate"><span class="pre">sys.stdout</span></code> will be used.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.start_color">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">start_color</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.start_color" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Must be called if the programmer wants to use colors, and before any other color
|
||
manipulation routine is called. It is good practice to call this routine right
|
||
after <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> initializes eight basic colors (black, red, green, yellow,
|
||
blue, magenta, cyan, and white), and two global variables in the <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>
|
||
module, <a class="reference internal" href="#curses.COLORS" title="curses.COLORS"><code class="xref py py-const docutils literal notranslate"><span class="pre">COLORS</span></code></a> and <a class="reference internal" href="#curses.COLOR_PAIRS" title="curses.COLOR_PAIRS"><code class="xref py py-const docutils literal notranslate"><span class="pre">COLOR_PAIRS</span></code></a>, containing the maximum number
|
||
of colors and color-pairs the terminal can support. It also restores the colors
|
||
on the terminal to the values they had when the terminal was just turned on.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.termattrs">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">termattrs</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.termattrs" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return a logical OR of all video attributes supported by the terminal. This
|
||
information is useful when a curses program needs complete control over the
|
||
appearance of the screen.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.termname">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">termname</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.termname" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return the value of the environment variable <span class="target" id="index-2"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">TERM</span></code>, as a bytes object,
|
||
truncated to 14 characters.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.tigetflag">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">tigetflag</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">capname</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.tigetflag" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return the value of the Boolean capability corresponding to the terminfo
|
||
capability name <em>capname</em> as an integer. Return the value <code class="docutils literal notranslate"><span class="pre">-1</span></code> if <em>capname</em> is not a
|
||
Boolean capability, or <code class="docutils literal notranslate"><span class="pre">0</span></code> if it is canceled or absent from the terminal
|
||
description.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.tigetnum">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">tigetnum</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">capname</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.tigetnum" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return the value of the numeric capability corresponding to the terminfo
|
||
capability name <em>capname</em> as an integer. Return the value <code class="docutils literal notranslate"><span class="pre">-2</span></code> if <em>capname</em> is not a
|
||
numeric capability, or <code class="docutils literal notranslate"><span class="pre">-1</span></code> if it is canceled or absent from the terminal
|
||
description.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.tigetstr">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">tigetstr</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">capname</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.tigetstr" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return the value of the string capability corresponding to the terminfo
|
||
capability name <em>capname</em> as a bytes object. Return <code class="docutils literal notranslate"><span class="pre">None</span></code> if <em>capname</em>
|
||
is not a terminfo “string capability”, or is canceled or absent from the
|
||
terminal description.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.tparm">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">tparm</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">str</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">...</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.tparm" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Instantiate the bytes object <em>str</em> with the supplied parameters, where <em>str</em> should
|
||
be a parameterized string obtained from the terminfo database. E.g.
|
||
<code class="docutils literal notranslate"><span class="pre">tparm(tigetstr("cup"),</span> <span class="pre">5,</span> <span class="pre">3)</span></code> could result in <code class="docutils literal notranslate"><span class="pre">b'\033[6;4H'</span></code>, the exact
|
||
result depending on terminal type.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.typeahead">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">typeahead</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">fd</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.typeahead" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Specify that the file descriptor <em>fd</em> be used for typeahead checking. If <em>fd</em>
|
||
is <code class="docutils literal notranslate"><span class="pre">-1</span></code>, then no typeahead checking is done.</p>
|
||
<p>The curses library does “line-breakout optimization” by looking for typeahead
|
||
periodically while updating the screen. If input is found, and it is coming
|
||
from a tty, the current update is postponed until refresh or doupdate is called
|
||
again, allowing faster response to commands typed in advance. This function
|
||
allows specifying a different file descriptor for typeahead checking.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.unctrl">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">unctrl</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ch</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.unctrl" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return a bytes object which is a printable representation of the character <em>ch</em>.
|
||
Control characters are represented as a caret followed by the character, for
|
||
example as <code class="docutils literal notranslate"><span class="pre">b'^C'</span></code>. Printing characters are left as they are.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.ungetch">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ungetch</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ch</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.ungetch" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Push <em>ch</em> so the next <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> will return it.</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p>Only one <em>ch</em> can be pushed before <code class="xref py py-meth docutils literal notranslate"><span class="pre">getch()</span></code> is called.</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.update_lines_cols">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">update_lines_cols</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.update_lines_cols" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Update the <a class="reference internal" href="#curses.LINES" title="curses.LINES"><code class="xref py py-const docutils literal notranslate"><span class="pre">LINES</span></code></a> and <a class="reference internal" href="#curses.COLS" title="curses.COLS"><code class="xref py py-const docutils literal notranslate"><span class="pre">COLS</span></code></a> module variables.
|
||
Useful for detecting manual screen resize.</p>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">Added in version 3.5.</span></p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.unget_wch">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">unget_wch</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ch</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.unget_wch" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Push <em>ch</em> so the next <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> will return it.</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p>Only one <em>ch</em> can be pushed before <code class="xref py py-meth docutils literal notranslate"><span class="pre">get_wch()</span></code> is called.</p>
|
||
</div>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">Added in version 3.3.</span></p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.ungetmouse">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ungetmouse</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">id</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">z</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">bstate</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.ungetmouse" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Push a <a class="reference internal" href="#curses.KEY_MOUSE" title="curses.KEY_MOUSE"><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_MOUSE</span></code></a> event onto the input queue, associating the given
|
||
state data with it.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.use_env">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">use_env</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">flag</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.use_env" title="Link to this definition">¶</a></dt>
|
||
<dd><p>If used, this function should be called before <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> or newterm are
|
||
called. When <em>flag</em> is <code class="docutils literal notranslate"><span class="pre">False</span></code>, the values of lines and columns specified in the
|
||
terminfo database will be used, even if environment variables <span class="target" id="index-3"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">LINES</span></code>
|
||
and <span class="target" id="index-4"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">COLUMNS</span></code> (used by default) are set, or if curses is running in a
|
||
window (in which case default behavior would be to use the window size if
|
||
<span class="target" id="index-5"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">LINES</span></code> and <span class="target" id="index-6"></span><code class="xref std std-envvar docutils literal notranslate"><span class="pre">COLUMNS</span></code> are not set).</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.use_default_colors">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">use_default_colors</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.use_default_colors" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Allow use of default values for colors on terminals supporting this feature. Use
|
||
this to support transparency in your application. The default color is assigned
|
||
to the color number <code class="docutils literal notranslate"><span class="pre">-1</span></code>. After calling this function, <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> initializes, for instance, color pair <em>x</em> to a red
|
||
foreground color on the default background.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.wrapper">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">wrapper</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">func</span></span></em>, <em class="sig-param"><span class="positional-only-separator o"><abbr title="Positional-only parameter separator (PEP 570)"><span class="pre">/</span></abbr></span></em>, <em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.wrapper" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Initialize curses and call another callable object, <em>func</em>, which should be the
|
||
rest of your curses-using application. If the application raises an exception,
|
||
this function will restore the terminal to a sane state before re-raising the
|
||
exception and generating a traceback. The callable object <em>func</em> is then passed
|
||
the main window ‘stdscr’ as its first argument, followed by any other arguments
|
||
passed to <code class="xref py py-func docutils literal notranslate"><span class="pre">wrapper()</span></code>. Before calling <em>func</em>, <code class="xref py py-func docutils literal notranslate"><span class="pre">wrapper()</span></code> turns on
|
||
cbreak mode, turns off echo, enables the terminal keypad, and initializes colors
|
||
if the terminal has color support. On exit (whether normally or by exception)
|
||
it restores cooked mode, turns on echo, and disables the terminal keypad.</p>
|
||
</dd></dl>
|
||
|
||
</section>
|
||
<section id="window-objects">
|
||
<span id="curses-window-objects"></span><h2>Window Objects<a class="headerlink" href="#window-objects" title="Link to this heading">¶</a></h2>
|
||
<p>Window objects, as returned by <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> and <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> above, have
|
||
the following methods and attributes:</p>
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.addch">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">addch</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ch</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.addch" title="Link to this definition">¶</a></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">addch</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ch</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="optional">]</span><span class="sig-paren">)</span></dt>
|
||
<dd><p>Paint character <em>ch</em> at <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> with attributes <em>attr</em>, overwriting any
|
||
character previously painted at that location. By default, the character
|
||
position and attributes are the current settings for the window object.</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p>Writing outside the window, subwindow, or pad raises a <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>.
|
||
Attempting to write to the lower right corner of a window, subwindow,
|
||
or pad will cause an exception to be raised after the character is printed.</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.addnstr">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">addnstr</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.addnstr" title="Link to this definition">¶</a></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">addnstr</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="optional">]</span><span class="sig-paren">)</span></dt>
|
||
<dd><p>Paint at most <em>n</em> characters of the character string <em>str</em> at
|
||
<code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> with attributes
|
||
<em>attr</em>, overwriting anything previously on the display.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.addstr">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">addstr</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">str</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.addstr" title="Link to this definition">¶</a></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">addstr</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">str</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="optional">]</span><span class="sig-paren">)</span></dt>
|
||
<dd><p>Paint the character string <em>str</em> at <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> with attributes
|
||
<em>attr</em>, overwriting anything previously on the display.</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<ul class="simple">
|
||
<li><p>Writing outside the window, subwindow, or pad raises <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>.
|
||
Attempting to write to the lower right corner of a window, subwindow,
|
||
or pad will cause an exception to be raised after the string is printed.</p></li>
|
||
<li><p>A <a class="reference external" href="https://bugs.python.org/issue35924">bug in ncurses</a>, the backend
|
||
for this Python module, can cause SegFaults when resizing windows. This
|
||
is fixed in ncurses-6.1-20190511. If you are stuck with an earlier
|
||
ncurses, you can avoid triggering this if you do not call <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>
|
||
with a <em>str</em> that has embedded newlines. Instead, call <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>
|
||
separately for each line.</p></li>
|
||
</ul>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.attroff">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">attroff</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.attroff" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Remove attribute <em>attr</em> from the “background” set applied to all writes to the
|
||
current window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.attron">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">attron</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.attron" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Add attribute <em>attr</em> from the “background” set applied to all writes to the
|
||
current window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.attrset">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">attrset</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.attrset" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Set the “background” set of attributes to <em>attr</em>. This set is initially
|
||
<code class="docutils literal notranslate"><span class="pre">0</span></code> (no attributes).</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.bkgd">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">bkgd</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ch</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.bkgd" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Set the background property of the window to the character <em>ch</em>, with
|
||
attributes <em>attr</em>. The change is then applied to every character position in
|
||
that window:</p>
|
||
<ul class="simple">
|
||
<li><p>The attribute of every character in the window is changed to the new
|
||
background attribute.</p></li>
|
||
<li><p>Wherever the former background character appears, it is changed to the new
|
||
background character.</p></li>
|
||
</ul>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.bkgdset">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">bkgdset</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ch</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.bkgdset" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Set the window’s background. A window’s background consists of a character and
|
||
any combination of attributes. The attribute part of the background is combined
|
||
(OR’ed) with all non-blank characters that are written into the window. Both
|
||
the character and attribute parts of the background are combined with the blank
|
||
characters. The background becomes a property of the character and moves with
|
||
the character through any scrolling and insert/delete line/character operations.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.border">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">border</span></span><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param"><span class="n"><span class="pre">ls</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">rs</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">ts</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">bs</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">tl</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">tr</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">bl</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">br</span></span></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="Link to this definition">¶</a></dt>
|
||
<dd><p>Draw a border around the edges of the window. Each parameter specifies the
|
||
character to use for a specific part of the border; see the table below for more
|
||
details.</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p>A <code class="docutils literal notranslate"><span class="pre">0</span></code> value for any parameter will cause the default character to be used for
|
||
that parameter. Keyword parameters can <em>not</em> be used. The defaults are listed
|
||
in this table:</p>
|
||
</div>
|
||
<table class="docutils align-default">
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>Parameter</p></th>
|
||
<th class="head"><p>Description</p></th>
|
||
<th class="head"><p>Default value</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><p><em>ls</em></p></td>
|
||
<td><p>Left side</p></td>
|
||
<td><p><a class="reference internal" href="#curses.ACS_VLINE" title="curses.ACS_VLINE"><code class="xref py py-const docutils literal notranslate"><span class="pre">ACS_VLINE</span></code></a></p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><em>rs</em></p></td>
|
||
<td><p>Right side</p></td>
|
||
<td><p><a class="reference internal" href="#curses.ACS_VLINE" title="curses.ACS_VLINE"><code class="xref py py-const docutils literal notranslate"><span class="pre">ACS_VLINE</span></code></a></p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><em>ts</em></p></td>
|
||
<td><p>Top</p></td>
|
||
<td><p><a class="reference internal" href="#curses.ACS_HLINE" title="curses.ACS_HLINE"><code class="xref py py-const docutils literal notranslate"><span class="pre">ACS_HLINE</span></code></a></p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><em>bs</em></p></td>
|
||
<td><p>Bottom</p></td>
|
||
<td><p><a class="reference internal" href="#curses.ACS_HLINE" title="curses.ACS_HLINE"><code class="xref py py-const docutils literal notranslate"><span class="pre">ACS_HLINE</span></code></a></p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><em>tl</em></p></td>
|
||
<td><p>Upper-left corner</p></td>
|
||
<td><p><a class="reference internal" href="#curses.ACS_ULCORNER" title="curses.ACS_ULCORNER"><code class="xref py py-const docutils literal notranslate"><span class="pre">ACS_ULCORNER</span></code></a></p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><em>tr</em></p></td>
|
||
<td><p>Upper-right corner</p></td>
|
||
<td><p><a class="reference internal" href="#curses.ACS_URCORNER" title="curses.ACS_URCORNER"><code class="xref py py-const docutils literal notranslate"><span class="pre">ACS_URCORNER</span></code></a></p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><em>bl</em></p></td>
|
||
<td><p>Bottom-left corner</p></td>
|
||
<td><p><a class="reference internal" href="#curses.ACS_LLCORNER" title="curses.ACS_LLCORNER"><code class="xref py py-const docutils literal notranslate"><span class="pre">ACS_LLCORNER</span></code></a></p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><em>br</em></p></td>
|
||
<td><p>Bottom-right corner</p></td>
|
||
<td><p><a class="reference internal" href="#curses.ACS_LRCORNER" title="curses.ACS_LRCORNER"><code class="xref py py-const docutils literal notranslate"><span class="pre">ACS_LRCORNER</span></code></a></p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.box">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">box</span></span><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param"><span class="n"><span class="pre">vertch</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">horch</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.box" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Similar to <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>, but both <em>ls</em> and <em>rs</em> are <em>vertch</em> and both <em>ts</em> and
|
||
<em>bs</em> are <em>horch</em>. The default corner characters are always used by this function.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.chgat">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">chgat</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.chgat" title="Link to this definition">¶</a></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">chgat</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">num</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="sig-paren">)</span></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">chgat</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="sig-paren">)</span></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">chgat</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">num</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="sig-paren">)</span></dt>
|
||
<dd><p>Set the attributes of <em>num</em> characters at the current cursor position, or at
|
||
position <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> if supplied. If <em>num</em> is not given or is <code class="docutils literal notranslate"><span class="pre">-1</span></code>,
|
||
the attribute will be set on all the characters to the end of the line. This
|
||
function moves cursor to position <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> if supplied. The changed line
|
||
will be touched using the <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> method so that the contents will
|
||
be redisplayed by the next window refresh.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.clear">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">clear</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.clear" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Like <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>, but also cause the whole window to be repainted upon next
|
||
call to <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="py method">
|
||
<dt class="sig sig-object py" id="curses.window.clearok">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">clearok</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">flag</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.clearok" title="Link to this definition">¶</a></dt>
|
||
<dd><p>If <em>flag</em> is <code class="docutils literal notranslate"><span class="pre">True</span></code>, the next call to <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> will clear the window
|
||
completely.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.clrtobot">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">clrtobot</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.clrtobot" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Erase from cursor to the end of the window: all lines below the cursor are
|
||
deleted, and then the equivalent of <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> is performed.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.clrtoeol">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">clrtoeol</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.clrtoeol" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Erase from cursor to the end of the line.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.cursyncup">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">cursyncup</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.cursyncup" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Update the current cursor position of all the ancestors of the window to
|
||
reflect the current cursor position of the window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.delch">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">delch</span></span><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.delch" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Delete any character at <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code>.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.deleteln">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">deleteln</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.deleteln" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Delete the line under the cursor. All following lines are moved up by one line.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.derwin">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">derwin</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">begin_y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">begin_x</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.derwin" title="Link to this definition">¶</a></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">derwin</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">nlines</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ncols</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">begin_y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">begin_x</span></span></em><span class="sig-paren">)</span></dt>
|
||
<dd><p>An abbreviation for “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> is the same as calling
|
||
<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>, except that <em>begin_y</em> and <em>begin_x</em> are relative to the origin
|
||
of the window, rather than relative to the entire screen. Return a window
|
||
object for the derived window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.echochar">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">echochar</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ch</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.echochar" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Add character <em>ch</em> with attribute <em>attr</em>, and immediately call <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>
|
||
on the window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.enclose">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">enclose</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.enclose" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Test whether the given pair of screen-relative character-cell coordinates are
|
||
enclosed by the given window, returning <code class="docutils literal notranslate"><span class="pre">True</span></code> or <code class="docutils literal notranslate"><span class="pre">False</span></code>. It is useful for
|
||
determining what subset of the screen windows enclose the location of a mouse
|
||
event.</p>
|
||
<div class="versionchanged">
|
||
<p><span class="versionmodified changed">Changed in version 3.10: </span>Previously it returned <code class="docutils literal notranslate"><span class="pre">1</span></code> or <code class="docutils literal notranslate"><span class="pre">0</span></code> instead of <code class="docutils literal notranslate"><span class="pre">True</span></code> or <code class="docutils literal notranslate"><span class="pre">False</span></code>.</p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="py attribute">
|
||
<dt class="sig sig-object py" id="curses.window.encoding">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">encoding</span></span><a class="headerlink" href="#curses.window.encoding" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Encoding used to encode method arguments (Unicode strings and characters).
|
||
The encoding attribute is inherited from the parent window when a subwindow
|
||
is created, for example with <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>.
|
||
By default, current locale encoding is used (see <a class="reference internal" href="locale.html#locale.getencoding" title="locale.getencoding"><code class="xref py py-func docutils literal notranslate"><span class="pre">locale.getencoding()</span></code></a>).</p>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">Added in version 3.3.</span></p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.erase">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">erase</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.erase" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Clear the window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.getbegyx">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">getbegyx</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.getbegyx" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return a tuple <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> of coordinates of upper-left corner.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.getbkgd">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">getbkgd</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.getbkgd" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return the given window’s current background character/attribute pair.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.getch">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">getch</span></span><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.getch" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Get a character. Note that the integer returned does <em>not</em> have to be in ASCII
|
||
range: function keys, keypad keys and so on are represented by numbers higher
|
||
than 255. In no-delay mode, return <code class="docutils literal notranslate"><span class="pre">-1</span></code> if there is no input, otherwise
|
||
wait until a key is pressed.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.get_wch">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">get_wch</span></span><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.get_wch" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Get a wide character. Return a character for most keys, or an integer for
|
||
function keys, keypad keys, and other special keys.
|
||
In no-delay mode, raise an exception if there is no input.</p>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">Added in version 3.3.</span></p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.getkey">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">getkey</span></span><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.getkey" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Get a character, returning a string instead of an integer, as <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>
|
||
does. Function keys, keypad keys and other special keys return a multibyte
|
||
string containing the key name. In no-delay mode, raise an exception if
|
||
there is no input.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.getmaxyx">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">getmaxyx</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.getmaxyx" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return a tuple <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> of the height and width of the window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.getparyx">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">getparyx</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.getparyx" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return the beginning coordinates of this window relative to its parent window
|
||
as a tuple <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code>. Return <code class="docutils literal notranslate"><span class="pre">(-1,</span> <span class="pre">-1)</span></code> if this window has no
|
||
parent.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.getstr">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">getstr</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.getstr" title="Link to this definition">¶</a></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">getstr</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">n</span></span></em><span class="sig-paren">)</span></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">getstr</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em><span class="sig-paren">)</span></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">getstr</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n</span></span></em><span class="sig-paren">)</span></dt>
|
||
<dd><p>Read a bytes object from the user, with primitive line editing capacity.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.getyx">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">getyx</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.getyx" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return a tuple <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> of current cursor position relative to the window’s
|
||
upper-left corner.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.hline">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">hline</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ch</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.hline" title="Link to this definition">¶</a></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">hline</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ch</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n</span></span></em><span class="sig-paren">)</span></dt>
|
||
<dd><p>Display a horizontal line starting at <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> with length <em>n</em> consisting of
|
||
the character <em>ch</em>.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.idcok">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">idcok</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">flag</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.idcok" title="Link to this definition">¶</a></dt>
|
||
<dd><p>If <em>flag</em> is <code class="docutils literal notranslate"><span class="pre">False</span></code>, curses no longer considers using the hardware insert/delete
|
||
character feature of the terminal; if <em>flag</em> is <code class="docutils literal notranslate"><span class="pre">True</span></code>, use of character insertion
|
||
and deletion is enabled. When curses is first initialized, use of character
|
||
insert/delete is enabled by default.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.idlok">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">idlok</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">flag</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.idlok" title="Link to this definition">¶</a></dt>
|
||
<dd><p>If <em>flag</em> is <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> will try and use hardware line
|
||
editing facilities. Otherwise, line insertion/deletion are disabled.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.immedok">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">immedok</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">flag</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.immedok" title="Link to this definition">¶</a></dt>
|
||
<dd><p>If <em>flag</em> is <code class="docutils literal notranslate"><span class="pre">True</span></code>, any change in the window image automatically causes the
|
||
window to be refreshed; you no longer have to call <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> yourself.
|
||
However, it may degrade performance considerably, due to repeated calls to
|
||
wrefresh. This option is disabled by default.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.inch">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">inch</span></span><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.inch" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return the character at the given position in the window. The bottom 8 bits are
|
||
the character proper, and upper bits are the attributes.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.insch">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">insch</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ch</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.insch" title="Link to this definition">¶</a></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">insch</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ch</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="optional">]</span><span class="sig-paren">)</span></dt>
|
||
<dd><p>Paint character <em>ch</em> at <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> with attributes <em>attr</em>, moving the line from
|
||
position <em>x</em> right by one character.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.insdelln">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">insdelln</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">nlines</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.insdelln" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Insert <em>nlines</em> lines into the specified window above the current line. The
|
||
<em>nlines</em> bottom lines are lost. For negative <em>nlines</em>, delete <em>nlines</em> lines
|
||
starting with the one under the cursor, and move the remaining lines up. The
|
||
bottom <em>nlines</em> lines are cleared. The current cursor position remains the
|
||
same.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.insertln">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">insertln</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.insertln" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Insert a blank line under the cursor. All following lines are moved down by one
|
||
line.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.insnstr">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">insnstr</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.insnstr" title="Link to this definition">¶</a></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">insnstr</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">str</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="optional">]</span><span class="sig-paren">)</span></dt>
|
||
<dd><p>Insert a character string (as many characters as will fit on the line) before
|
||
the character under the cursor, up to <em>n</em> characters. If <em>n</em> is zero or
|
||
negative, the entire string is inserted. All characters to the right of the
|
||
cursor are shifted right, with the rightmost characters on the line being lost.
|
||
The cursor position does not change (after moving to <em>y</em>, <em>x</em>, if specified).</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.insstr">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">insstr</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">str</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.insstr" title="Link to this definition">¶</a></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">insstr</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">str</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="optional">]</span><span class="sig-paren">)</span></dt>
|
||
<dd><p>Insert a character string (as many characters as will fit on the line) before
|
||
the character under the cursor. All characters to the right of the cursor are
|
||
shifted right, with the rightmost characters on the line being lost. The cursor
|
||
position does not change (after moving to <em>y</em>, <em>x</em>, if specified).</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.instr">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">instr</span></span><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param"><span class="n"><span class="pre">n</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.instr" title="Link to this definition">¶</a></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">instr</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">n</span></span></em><span class="optional">]</span><span class="sig-paren">)</span></dt>
|
||
<dd><p>Return a bytes object of characters, extracted from the window starting at the
|
||
current cursor position, or at <em>y</em>, <em>x</em> if specified. Attributes are stripped
|
||
from the characters. If <em>n</em> is specified, <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> returns a string
|
||
at most <em>n</em> characters long (exclusive of the trailing NUL).</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.is_linetouched">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">is_linetouched</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">line</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.is_linetouched" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return <code class="docutils literal notranslate"><span class="pre">True</span></code> if the specified line was modified since the last call to
|
||
<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>; otherwise return <code class="docutils literal notranslate"><span class="pre">False</span></code>. Raise a <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>
|
||
exception if <em>line</em> is not valid for the given window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.is_wintouched">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">is_wintouched</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.is_wintouched" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return <code class="docutils literal notranslate"><span class="pre">True</span></code> if the specified window was modified since the last call to
|
||
<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>; otherwise return <code class="docutils literal notranslate"><span class="pre">False</span></code>.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.keypad">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">keypad</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">flag</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.keypad" title="Link to this definition">¶</a></dt>
|
||
<dd><p>If <em>flag</em> is <code class="docutils literal notranslate"><span class="pre">True</span></code>, escape sequences generated by some keys (keypad, function keys)
|
||
will be interpreted by <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>. If <em>flag</em> is <code class="docutils literal notranslate"><span class="pre">False</span></code>, escape sequences will be
|
||
left as is in the input stream.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.leaveok">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">leaveok</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">flag</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.leaveok" title="Link to this definition">¶</a></dt>
|
||
<dd><p>If <em>flag</em> is <code class="docutils literal notranslate"><span class="pre">True</span></code>, cursor is left where it is on update, instead of being at “cursor
|
||
position.” This reduces cursor movement where possible. If possible the cursor
|
||
will be made invisible.</p>
|
||
<p>If <em>flag</em> is <code class="docutils literal notranslate"><span class="pre">False</span></code>, cursor will always be at “cursor position” after an update.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.move">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">move</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">new_y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">new_x</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.move" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Move cursor to <code class="docutils literal notranslate"><span class="pre">(new_y,</span> <span class="pre">new_x)</span></code>.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.mvderwin">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">mvderwin</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.mvderwin" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Move the window inside its parent window. The screen-relative parameters of
|
||
the window are not changed. This routine is used to display different parts of
|
||
the parent window at the same physical position on the screen.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.mvwin">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">mvwin</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">new_y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">new_x</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.mvwin" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Move the window so its upper-left corner is at <code class="docutils literal notranslate"><span class="pre">(new_y,</span> <span class="pre">new_x)</span></code>.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.nodelay">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">nodelay</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">flag</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.nodelay" title="Link to this definition">¶</a></dt>
|
||
<dd><p>If <em>flag</em> is <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> will be non-blocking.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.notimeout">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">notimeout</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">flag</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.notimeout" title="Link to this definition">¶</a></dt>
|
||
<dd><p>If <em>flag</em> is <code class="docutils literal notranslate"><span class="pre">True</span></code>, escape sequences will not be timed out.</p>
|
||
<p>If <em>flag</em> is <code class="docutils literal notranslate"><span class="pre">False</span></code>, after a few milliseconds, an escape sequence will not be
|
||
interpreted, and will be left in the input stream as is.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.noutrefresh">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">noutrefresh</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.noutrefresh" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Mark for refresh but wait. This function updates the data structure
|
||
representing the desired state of the window, but does not force an update of
|
||
the physical screen. To accomplish that, call <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="py method">
|
||
<dt class="sig sig-object py" id="curses.window.overlay">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">overlay</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">destwin</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">sminrow</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">smincol</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dminrow</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dmincol</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dmaxrow</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dmaxcol</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.overlay" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Overlay the window on top of <em>destwin</em>. The windows need not be the same size,
|
||
only the overlapping region is copied. This copy is non-destructive, which means
|
||
that the current background character does not overwrite the old contents of
|
||
<em>destwin</em>.</p>
|
||
<p>To get fine-grained control over the copied region, the second form of
|
||
<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> can be used. <em>sminrow</em> and <em>smincol</em> are the upper-left
|
||
coordinates of the source window, and the other variables mark a rectangle in
|
||
the destination window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.overwrite">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">overwrite</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">destwin</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">sminrow</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">smincol</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dminrow</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dmincol</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dmaxrow</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">dmaxcol</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.overwrite" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Overwrite the window on top of <em>destwin</em>. The windows need not be the same size,
|
||
in which case only the overlapping region is copied. This copy is destructive,
|
||
which means that the current background character overwrites the old contents of
|
||
<em>destwin</em>.</p>
|
||
<p>To get fine-grained control over the copied region, the second form of
|
||
<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> can be used. <em>sminrow</em> and <em>smincol</em> are the upper-left
|
||
coordinates of the source window, the other variables mark a rectangle in the
|
||
destination window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.putwin">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">putwin</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">file</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.putwin" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Write all data associated with the window into the provided file object. This
|
||
information can be later retrieved using the <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> function.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.redrawln">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">redrawln</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">beg</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">num</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.redrawln" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Indicate that the <em>num</em> screen lines, starting at line <em>beg</em>, are corrupted and
|
||
should be completely redrawn on the next <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> call.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.redrawwin">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">redrawwin</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.redrawwin" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Touch the entire window, causing it to be completely redrawn on the next
|
||
<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> call.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.refresh">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">refresh</span></span><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param"><span class="n"><span class="pre">pminrow</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">pmincol</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">sminrow</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">smincol</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">smaxrow</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">smaxcol</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.refresh" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Update the display immediately (sync actual screen with previous
|
||
drawing/deleting methods).</p>
|
||
<p>The 6 optional arguments can only be specified when the window is a pad created
|
||
with <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>. The additional parameters are needed to indicate what part
|
||
of the pad and screen are involved. <em>pminrow</em> and <em>pmincol</em> specify the upper
|
||
left-hand corner of the rectangle to be displayed in the pad. <em>sminrow</em>,
|
||
<em>smincol</em>, <em>smaxrow</em>, and <em>smaxcol</em> specify the edges of the rectangle to be
|
||
displayed on the screen. The lower right-hand corner of the rectangle to be
|
||
displayed in the pad is calculated from the screen coordinates, since the
|
||
rectangles must be the same size. Both rectangles must be entirely contained
|
||
within their respective structures. Negative values of <em>pminrow</em>, <em>pmincol</em>,
|
||
<em>sminrow</em>, or <em>smincol</em> are treated as if they were zero.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.resize">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">resize</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">nlines</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ncols</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.resize" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Reallocate storage for a curses window to adjust its dimensions to the
|
||
specified values. If either dimension is larger than the current values, the
|
||
window’s data is filled with blanks that have the current background
|
||
rendition (as set by <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>) merged into them.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.scroll">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">scroll</span></span><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param"><span class="n"><span class="pre">lines=1</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.scroll" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Scroll the screen or scrolling region upward by <em>lines</em> lines.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.scrollok">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">scrollok</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">flag</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.scrollok" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Control what happens when the cursor of a window is moved off the edge of the
|
||
window or scrolling region, either as a result of a newline action on the bottom
|
||
line, or typing the last character of the last line. If <em>flag</em> is <code class="docutils literal notranslate"><span class="pre">False</span></code>, the
|
||
cursor is left on the bottom line. If <em>flag</em> is <code class="docutils literal notranslate"><span class="pre">True</span></code>, the window is scrolled up
|
||
one line. Note that in order to get the physical scrolling effect on the
|
||
terminal, it is also necessary to call <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="py method">
|
||
<dt class="sig sig-object py" id="curses.window.setscrreg">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">setscrreg</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">top</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">bottom</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.setscrreg" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Set the scrolling region from line <em>top</em> to line <em>bottom</em>. All scrolling actions
|
||
will take place in this region.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.standend">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">standend</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.standend" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Turn off the standout attribute. On some terminals this has the side effect of
|
||
turning off all attributes.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.standout">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">standout</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.standout" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Turn on attribute <em>A_STANDOUT</em>.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.subpad">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">subpad</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">begin_y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">begin_x</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.subpad" title="Link to this definition">¶</a></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">subpad</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">nlines</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ncols</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">begin_y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">begin_x</span></span></em><span class="sig-paren">)</span></dt>
|
||
<dd><p>Return a sub-window, whose upper-left corner is at <code class="docutils literal notranslate"><span class="pre">(begin_y,</span> <span class="pre">begin_x)</span></code>, and
|
||
whose width/height is <em>ncols</em>/<em>nlines</em>.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.subwin">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">subwin</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">begin_y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">begin_x</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.subwin" title="Link to this definition">¶</a></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">subwin</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">nlines</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ncols</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">begin_y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">begin_x</span></span></em><span class="sig-paren">)</span></dt>
|
||
<dd><p>Return a sub-window, whose upper-left corner is at <code class="docutils literal notranslate"><span class="pre">(begin_y,</span> <span class="pre">begin_x)</span></code>, and
|
||
whose width/height is <em>ncols</em>/<em>nlines</em>.</p>
|
||
<p>By default, the sub-window will extend from the specified position to the lower
|
||
right corner of the window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.syncdown">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">syncdown</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.syncdown" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Touch each location in the window that has been touched in any of its ancestor
|
||
windows. This routine is called by <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>, so it should almost never
|
||
be necessary to call it manually.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.syncok">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">syncok</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">flag</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.syncok" title="Link to this definition">¶</a></dt>
|
||
<dd><p>If <em>flag</em> is <code class="docutils literal notranslate"><span class="pre">True</span></code>, then <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> is called automatically
|
||
whenever there is a change in the window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.syncup">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">syncup</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.syncup" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Touch all locations in ancestors of the window that have been changed in the
|
||
window.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.timeout">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">timeout</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">delay</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.timeout" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Set blocking or non-blocking read behavior for the window. If <em>delay</em> is
|
||
negative, blocking read is used (which will wait indefinitely for input). If
|
||
<em>delay</em> is zero, then non-blocking read is used, and <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> will
|
||
return <code class="docutils literal notranslate"><span class="pre">-1</span></code> if no input is waiting. If <em>delay</em> is positive, then
|
||
<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> will block for <em>delay</em> milliseconds, and return <code class="docutils literal notranslate"><span class="pre">-1</span></code> if there is
|
||
still no input at the end of that time.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.touchline">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">touchline</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">start</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">count</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">changed</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.touchline" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Pretend <em>count</em> lines have been changed, starting with line <em>start</em>. If
|
||
<em>changed</em> is supplied, it specifies whether the affected lines are marked as
|
||
having been changed (<em>changed</em><code class="docutils literal notranslate"><span class="pre">=True</span></code>) or unchanged (<em>changed</em><code class="docutils literal notranslate"><span class="pre">=False</span></code>).</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.touchwin">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">touchwin</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.touchwin" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Pretend the whole window has been changed, for purposes of drawing
|
||
optimizations.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.window.untouchwin">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">untouchwin</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.untouchwin" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Mark all lines in the window as unchanged since the last call to
|
||
<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="py method">
|
||
<dt class="sig sig-object py" id="curses.window.vline">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">vline</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ch</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.window.vline" title="Link to this definition">¶</a></dt>
|
||
<dt class="sig sig-object py">
|
||
<span class="sig-prename descclassname"><span class="pre">window.</span></span><span class="sig-name descname"><span class="pre">vline</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">y</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">x</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ch</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">n</span></span></em><span class="optional">[</span>, <em class="sig-param"><span class="n"><span class="pre">attr</span></span></em><span class="optional">]</span><span class="sig-paren">)</span></dt>
|
||
<dd><p>Display a vertical line starting at <code class="docutils literal notranslate"><span class="pre">(y,</span> <span class="pre">x)</span></code> with length <em>n</em> consisting of the
|
||
character <em>ch</em> with attributes <em>attr</em>.</p>
|
||
</dd></dl>
|
||
|
||
</section>
|
||
<section id="constants">
|
||
<h2>Constants<a class="headerlink" href="#constants" title="Link to this heading">¶</a></h2>
|
||
<p>The <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> module defines the following data members:</p>
|
||
<dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ERR">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ERR</span></span><a class="headerlink" href="#curses.ERR" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Some curses routines that return an integer, such as <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>, return
|
||
<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> upon failure.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.OK">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">OK</span></span><a class="headerlink" href="#curses.OK" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Some curses routines that return an integer, such as <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>, return
|
||
<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> upon success.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.version">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">version</span></span><a class="headerlink" href="#curses.version" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
<dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.__version__">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">__version__</span></span><a class="headerlink" href="#curses.__version__" title="Link to this definition">¶</a></dt>
|
||
<dd><p>A bytes object representing the current version of the module.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ncurses_version">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ncurses_version</span></span><a class="headerlink" href="#curses.ncurses_version" title="Link to this definition">¶</a></dt>
|
||
<dd><p>A named tuple containing the three components of the ncurses library
|
||
version: <em>major</em>, <em>minor</em>, and <em>patch</em>. All values are integers. The
|
||
components can also be accessed by name, so <code class="docutils literal notranslate"><span class="pre">curses.ncurses_version[0]</span></code>
|
||
is equivalent to <code class="docutils literal notranslate"><span class="pre">curses.ncurses_version.major</span></code> and so on.</p>
|
||
<p>Availability: if the ncurses library is used.</p>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">Added in version 3.8.</span></p>
|
||
</div>
|
||
</dd></dl>
|
||
|
||
<dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.COLORS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">COLORS</span></span><a class="headerlink" href="#curses.COLORS" title="Link to this definition">¶</a></dt>
|
||
<dd><p>The maximum number of colors the terminal can support.
|
||
It is defined only after the call to <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>.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.COLOR_PAIRS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">COLOR_PAIRS</span></span><a class="headerlink" href="#curses.COLOR_PAIRS" title="Link to this definition">¶</a></dt>
|
||
<dd><p>The maximum number of color pairs the terminal can support.
|
||
It is defined only after the call to <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>.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.COLS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">COLS</span></span><a class="headerlink" href="#curses.COLS" title="Link to this definition">¶</a></dt>
|
||
<dd><p>The width of the screen, i.e., the number of columns.
|
||
It is defined only after the call to <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>.
|
||
Updated by <a class="reference internal" href="#curses.update_lines_cols" title="curses.update_lines_cols"><code class="xref py py-func docutils literal notranslate"><span class="pre">update_lines_cols()</span></code></a>, <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> and
|
||
<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>.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.LINES">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">LINES</span></span><a class="headerlink" href="#curses.LINES" title="Link to this definition">¶</a></dt>
|
||
<dd><p>The height of the screen, i.e., the number of lines.
|
||
It is defined only after the call to <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>.
|
||
Updated by <a class="reference internal" href="#curses.update_lines_cols" title="curses.update_lines_cols"><code class="xref py py-func docutils literal notranslate"><span class="pre">update_lines_cols()</span></code></a>, <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> and
|
||
<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>.</p>
|
||
</dd></dl>
|
||
|
||
<p>Some constants are available to specify character cell attributes.
|
||
The exact constants available are system dependent.</p>
|
||
<table class="docutils align-default">
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>Attribute</p></th>
|
||
<th class="head"><p>Meaning</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_ALTCHARSET">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_ALTCHARSET</span></span><a class="headerlink" href="#curses.A_ALTCHARSET" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Alternate character set mode</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_BLINK">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_BLINK</span></span><a class="headerlink" href="#curses.A_BLINK" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Blink mode</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_BOLD">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_BOLD</span></span><a class="headerlink" href="#curses.A_BOLD" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Bold mode</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_DIM">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_DIM</span></span><a class="headerlink" href="#curses.A_DIM" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Dim mode</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_INVIS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_INVIS</span></span><a class="headerlink" href="#curses.A_INVIS" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Invisible or blank mode</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_ITALIC">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_ITALIC</span></span><a class="headerlink" href="#curses.A_ITALIC" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Italic mode</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_NORMAL">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_NORMAL</span></span><a class="headerlink" href="#curses.A_NORMAL" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Normal attribute</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_PROTECT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_PROTECT</span></span><a class="headerlink" href="#curses.A_PROTECT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Protected mode</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_REVERSE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_REVERSE</span></span><a class="headerlink" href="#curses.A_REVERSE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Reverse background and
|
||
foreground colors</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_STANDOUT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_STANDOUT</span></span><a class="headerlink" href="#curses.A_STANDOUT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Standout mode</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_UNDERLINE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_UNDERLINE</span></span><a class="headerlink" href="#curses.A_UNDERLINE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Underline mode</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_HORIZONTAL">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_HORIZONTAL</span></span><a class="headerlink" href="#curses.A_HORIZONTAL" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Horizontal highlight</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_LEFT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_LEFT</span></span><a class="headerlink" href="#curses.A_LEFT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Left highlight</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_LOW">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_LOW</span></span><a class="headerlink" href="#curses.A_LOW" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Low highlight</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_RIGHT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_RIGHT</span></span><a class="headerlink" href="#curses.A_RIGHT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Right highlight</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_TOP">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_TOP</span></span><a class="headerlink" href="#curses.A_TOP" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Top highlight</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_VERTICAL">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_VERTICAL</span></span><a class="headerlink" href="#curses.A_VERTICAL" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Vertical highlight</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<div class="versionadded">
|
||
<p><span class="versionmodified added">Added in version 3.7: </span><code class="docutils literal notranslate"><span class="pre">A_ITALIC</span></code> was added.</p>
|
||
</div>
|
||
<p>Several constants are available to extract corresponding attributes returned
|
||
by some methods.</p>
|
||
<table class="docutils align-default">
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>Bit-mask</p></th>
|
||
<th class="head"><p>Meaning</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_ATTRIBUTES">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_ATTRIBUTES</span></span><a class="headerlink" href="#curses.A_ATTRIBUTES" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Bit-mask to extract
|
||
attributes</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_CHARTEXT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_CHARTEXT</span></span><a class="headerlink" href="#curses.A_CHARTEXT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Bit-mask to extract a
|
||
character</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.A_COLOR">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">A_COLOR</span></span><a class="headerlink" href="#curses.A_COLOR" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Bit-mask to extract
|
||
color-pair field information</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<p>Keys are referred to by integer constants with names starting with <code class="docutils literal notranslate"><span class="pre">KEY_</span></code>.
|
||
The exact keycaps available are system dependent.</p>
|
||
<table class="docutils align-default">
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>Key constant</p></th>
|
||
<th class="head"><p>Key</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_MIN">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_MIN</span></span><a class="headerlink" href="#curses.KEY_MIN" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Minimum key value</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_BREAK">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_BREAK</span></span><a class="headerlink" href="#curses.KEY_BREAK" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Break key (unreliable)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_DOWN">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_DOWN</span></span><a class="headerlink" href="#curses.KEY_DOWN" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Down-arrow</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_UP">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_UP</span></span><a class="headerlink" href="#curses.KEY_UP" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Up-arrow</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_LEFT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_LEFT</span></span><a class="headerlink" href="#curses.KEY_LEFT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Left-arrow</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_RIGHT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_RIGHT</span></span><a class="headerlink" href="#curses.KEY_RIGHT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Right-arrow</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_HOME">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_HOME</span></span><a class="headerlink" href="#curses.KEY_HOME" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Home key (upward+left arrow)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_BACKSPACE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_BACKSPACE</span></span><a class="headerlink" href="#curses.KEY_BACKSPACE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Backspace (unreliable)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_F0">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_F0</span></span><a class="headerlink" href="#curses.KEY_F0" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Function keys. Up to 64 function keys are
|
||
supported.</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_Fn">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_Fn</span></span><a class="headerlink" href="#curses.KEY_Fn" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Value of function key <em>n</em></p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_DL">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_DL</span></span><a class="headerlink" href="#curses.KEY_DL" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Delete line</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_IL">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_IL</span></span><a class="headerlink" href="#curses.KEY_IL" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Insert line</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_DC">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_DC</span></span><a class="headerlink" href="#curses.KEY_DC" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Delete character</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_IC">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_IC</span></span><a class="headerlink" href="#curses.KEY_IC" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Insert char or enter insert mode</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_EIC">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_EIC</span></span><a class="headerlink" href="#curses.KEY_EIC" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Exit insert char mode</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_CLEAR">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_CLEAR</span></span><a class="headerlink" href="#curses.KEY_CLEAR" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Clear screen</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_EOS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_EOS</span></span><a class="headerlink" href="#curses.KEY_EOS" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Clear to end of screen</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_EOL">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_EOL</span></span><a class="headerlink" href="#curses.KEY_EOL" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Clear to end of line</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SF">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SF</span></span><a class="headerlink" href="#curses.KEY_SF" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Scroll 1 line forward</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SR">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SR</span></span><a class="headerlink" href="#curses.KEY_SR" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Scroll 1 line backward (reverse)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_NPAGE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_NPAGE</span></span><a class="headerlink" href="#curses.KEY_NPAGE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Next page</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_PPAGE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_PPAGE</span></span><a class="headerlink" href="#curses.KEY_PPAGE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Previous page</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_STAB">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_STAB</span></span><a class="headerlink" href="#curses.KEY_STAB" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Set tab</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_CTAB">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_CTAB</span></span><a class="headerlink" href="#curses.KEY_CTAB" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Clear tab</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_CATAB">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_CATAB</span></span><a class="headerlink" href="#curses.KEY_CATAB" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Clear all tabs</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_ENTER">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_ENTER</span></span><a class="headerlink" href="#curses.KEY_ENTER" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Enter or send (unreliable)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SRESET">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SRESET</span></span><a class="headerlink" href="#curses.KEY_SRESET" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Soft (partial) reset (unreliable)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_RESET">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_RESET</span></span><a class="headerlink" href="#curses.KEY_RESET" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Reset or hard reset (unreliable)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_PRINT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_PRINT</span></span><a class="headerlink" href="#curses.KEY_PRINT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Print</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_LL">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_LL</span></span><a class="headerlink" href="#curses.KEY_LL" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Home down or bottom (lower left)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_A1">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_A1</span></span><a class="headerlink" href="#curses.KEY_A1" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Upper left of keypad</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_A3">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_A3</span></span><a class="headerlink" href="#curses.KEY_A3" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Upper right of keypad</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_B2">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_B2</span></span><a class="headerlink" href="#curses.KEY_B2" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Center of keypad</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_C1">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_C1</span></span><a class="headerlink" href="#curses.KEY_C1" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Lower left of keypad</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_C3">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_C3</span></span><a class="headerlink" href="#curses.KEY_C3" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Lower right of keypad</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_BTAB">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_BTAB</span></span><a class="headerlink" href="#curses.KEY_BTAB" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Back tab</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_BEG">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_BEG</span></span><a class="headerlink" href="#curses.KEY_BEG" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Beg (beginning)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_CANCEL">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_CANCEL</span></span><a class="headerlink" href="#curses.KEY_CANCEL" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Cancel</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_CLOSE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_CLOSE</span></span><a class="headerlink" href="#curses.KEY_CLOSE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Close</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_COMMAND">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_COMMAND</span></span><a class="headerlink" href="#curses.KEY_COMMAND" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Cmd (command)</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_COPY">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_COPY</span></span><a class="headerlink" href="#curses.KEY_COPY" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Copy</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_CREATE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_CREATE</span></span><a class="headerlink" href="#curses.KEY_CREATE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Create</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_END">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_END</span></span><a class="headerlink" href="#curses.KEY_END" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>End</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_EXIT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_EXIT</span></span><a class="headerlink" href="#curses.KEY_EXIT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Exit</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_FIND">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_FIND</span></span><a class="headerlink" href="#curses.KEY_FIND" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Find</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_HELP">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_HELP</span></span><a class="headerlink" href="#curses.KEY_HELP" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Help</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_MARK">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_MARK</span></span><a class="headerlink" href="#curses.KEY_MARK" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Mark</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_MESSAGE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_MESSAGE</span></span><a class="headerlink" href="#curses.KEY_MESSAGE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Message</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_MOVE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_MOVE</span></span><a class="headerlink" href="#curses.KEY_MOVE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Move</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_NEXT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_NEXT</span></span><a class="headerlink" href="#curses.KEY_NEXT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Next</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_OPEN">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_OPEN</span></span><a class="headerlink" href="#curses.KEY_OPEN" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Open</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_OPTIONS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_OPTIONS</span></span><a class="headerlink" href="#curses.KEY_OPTIONS" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Options</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_PREVIOUS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_PREVIOUS</span></span><a class="headerlink" href="#curses.KEY_PREVIOUS" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Prev (previous)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_REDO">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_REDO</span></span><a class="headerlink" href="#curses.KEY_REDO" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Redo</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_REFERENCE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_REFERENCE</span></span><a class="headerlink" href="#curses.KEY_REFERENCE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Ref (reference)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_REFRESH">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_REFRESH</span></span><a class="headerlink" href="#curses.KEY_REFRESH" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Refresh</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_REPLACE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_REPLACE</span></span><a class="headerlink" href="#curses.KEY_REPLACE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Replace</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_RESTART">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_RESTART</span></span><a class="headerlink" href="#curses.KEY_RESTART" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Restart</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_RESUME">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_RESUME</span></span><a class="headerlink" href="#curses.KEY_RESUME" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Resume</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SAVE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SAVE</span></span><a class="headerlink" href="#curses.KEY_SAVE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Save</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SBEG">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SBEG</span></span><a class="headerlink" href="#curses.KEY_SBEG" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Beg (beginning)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SCANCEL">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SCANCEL</span></span><a class="headerlink" href="#curses.KEY_SCANCEL" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Cancel</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SCOMMAND">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SCOMMAND</span></span><a class="headerlink" href="#curses.KEY_SCOMMAND" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Command</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SCOPY">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SCOPY</span></span><a class="headerlink" href="#curses.KEY_SCOPY" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Copy</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SCREATE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SCREATE</span></span><a class="headerlink" href="#curses.KEY_SCREATE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Create</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SDC">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SDC</span></span><a class="headerlink" href="#curses.KEY_SDC" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Delete char</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SDL">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SDL</span></span><a class="headerlink" href="#curses.KEY_SDL" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Delete line</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SELECT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SELECT</span></span><a class="headerlink" href="#curses.KEY_SELECT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Select</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SEND">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SEND</span></span><a class="headerlink" href="#curses.KEY_SEND" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted End</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SEOL">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SEOL</span></span><a class="headerlink" href="#curses.KEY_SEOL" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Clear line</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SEXIT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SEXIT</span></span><a class="headerlink" href="#curses.KEY_SEXIT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Exit</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SFIND">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SFIND</span></span><a class="headerlink" href="#curses.KEY_SFIND" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Find</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SHELP">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SHELP</span></span><a class="headerlink" href="#curses.KEY_SHELP" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Help</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SHOME">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SHOME</span></span><a class="headerlink" href="#curses.KEY_SHOME" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Home</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SIC">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SIC</span></span><a class="headerlink" href="#curses.KEY_SIC" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Input</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SLEFT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SLEFT</span></span><a class="headerlink" href="#curses.KEY_SLEFT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Left arrow</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SMESSAGE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SMESSAGE</span></span><a class="headerlink" href="#curses.KEY_SMESSAGE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Message</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SMOVE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SMOVE</span></span><a class="headerlink" href="#curses.KEY_SMOVE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Move</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SNEXT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SNEXT</span></span><a class="headerlink" href="#curses.KEY_SNEXT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Next</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SOPTIONS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SOPTIONS</span></span><a class="headerlink" href="#curses.KEY_SOPTIONS" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Options</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SPREVIOUS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SPREVIOUS</span></span><a class="headerlink" href="#curses.KEY_SPREVIOUS" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Prev</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SPRINT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SPRINT</span></span><a class="headerlink" href="#curses.KEY_SPRINT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Print</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SREDO">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SREDO</span></span><a class="headerlink" href="#curses.KEY_SREDO" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Redo</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SREPLACE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SREPLACE</span></span><a class="headerlink" href="#curses.KEY_SREPLACE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Replace</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SRIGHT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SRIGHT</span></span><a class="headerlink" href="#curses.KEY_SRIGHT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Right arrow</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SRSUME">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SRSUME</span></span><a class="headerlink" href="#curses.KEY_SRSUME" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Resume</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SSAVE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SSAVE</span></span><a class="headerlink" href="#curses.KEY_SSAVE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Save</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SSUSPEND">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SSUSPEND</span></span><a class="headerlink" href="#curses.KEY_SSUSPEND" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Suspend</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SUNDO">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SUNDO</span></span><a class="headerlink" href="#curses.KEY_SUNDO" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shifted Undo</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_SUSPEND">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_SUSPEND</span></span><a class="headerlink" href="#curses.KEY_SUSPEND" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Suspend</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_UNDO">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_UNDO</span></span><a class="headerlink" href="#curses.KEY_UNDO" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Undo</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_MOUSE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_MOUSE</span></span><a class="headerlink" href="#curses.KEY_MOUSE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Mouse event has occurred</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_RESIZE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_RESIZE</span></span><a class="headerlink" href="#curses.KEY_RESIZE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Terminal resize event</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.KEY_MAX">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">KEY_MAX</span></span><a class="headerlink" href="#curses.KEY_MAX" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Maximum key value</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<p>On VT100s and their software emulations, such as X terminal emulators, there are
|
||
normally at least four function keys (<a class="reference internal" href="#curses.KEY_Fn" title="curses.KEY_Fn"><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_F1</span></code></a>, <a class="reference internal" href="#curses.KEY_Fn" title="curses.KEY_Fn"><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_F2</span></code></a>,
|
||
<a class="reference internal" href="#curses.KEY_Fn" title="curses.KEY_Fn"><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_F3</span></code></a>, <a class="reference internal" href="#curses.KEY_Fn" title="curses.KEY_Fn"><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_F4</span></code></a>) available, and the arrow keys mapped to
|
||
<a class="reference internal" href="#curses.KEY_UP" title="curses.KEY_UP"><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_UP</span></code></a>, <a class="reference internal" href="#curses.KEY_DOWN" title="curses.KEY_DOWN"><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_DOWN</span></code></a>, <a class="reference internal" href="#curses.KEY_LEFT" title="curses.KEY_LEFT"><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_LEFT</span></code></a> and <a class="reference internal" href="#curses.KEY_RIGHT" title="curses.KEY_RIGHT"><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_RIGHT</span></code></a> in
|
||
the obvious way. If your machine has a PC keyboard, it is safe to expect arrow
|
||
keys and twelve function keys (older PC keyboards may have only ten function
|
||
keys); also, the following keypad mappings are standard:</p>
|
||
<table class="docutils align-default">
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>Keycap</p></th>
|
||
<th class="head"><p>Constant</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 id="curses-acs-codes">The following table lists characters from the alternate character set. These are
|
||
inherited from the VT100 terminal, and will generally be available on software
|
||
emulations such as X terminals. When there is no graphic available, curses
|
||
falls back on a crude printable ASCII approximation.</p>
|
||
<div class="admonition note">
|
||
<p class="admonition-title">Note</p>
|
||
<p>These are available only after <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> has been called.</p>
|
||
</div>
|
||
<table class="docutils align-default">
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>ACS code</p></th>
|
||
<th class="head"><p>Meaning</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_BBSS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_BBSS</span></span><a class="headerlink" href="#curses.ACS_BBSS" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>alternate name for upper right corner</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_BLOCK">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_BLOCK</span></span><a class="headerlink" href="#curses.ACS_BLOCK" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>solid square block</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_BOARD">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_BOARD</span></span><a class="headerlink" href="#curses.ACS_BOARD" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>board of squares</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_BSBS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_BSBS</span></span><a class="headerlink" href="#curses.ACS_BSBS" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>alternate name for horizontal line</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_BSSB">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_BSSB</span></span><a class="headerlink" href="#curses.ACS_BSSB" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>alternate name for upper left corner</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_BSSS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_BSSS</span></span><a class="headerlink" href="#curses.ACS_BSSS" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>alternate name for top tee</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_BTEE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_BTEE</span></span><a class="headerlink" href="#curses.ACS_BTEE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>bottom tee</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_BULLET">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_BULLET</span></span><a class="headerlink" href="#curses.ACS_BULLET" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>bullet</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_CKBOARD">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_CKBOARD</span></span><a class="headerlink" href="#curses.ACS_CKBOARD" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>checker board (stipple)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_DARROW">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_DARROW</span></span><a class="headerlink" href="#curses.ACS_DARROW" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>arrow pointing down</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_DEGREE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_DEGREE</span></span><a class="headerlink" href="#curses.ACS_DEGREE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>degree symbol</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_DIAMOND">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_DIAMOND</span></span><a class="headerlink" href="#curses.ACS_DIAMOND" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>diamond</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_GEQUAL">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_GEQUAL</span></span><a class="headerlink" href="#curses.ACS_GEQUAL" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>greater-than-or-equal-to</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_HLINE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_HLINE</span></span><a class="headerlink" href="#curses.ACS_HLINE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>horizontal line</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_LANTERN">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_LANTERN</span></span><a class="headerlink" href="#curses.ACS_LANTERN" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>lantern symbol</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_LARROW">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_LARROW</span></span><a class="headerlink" href="#curses.ACS_LARROW" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>left arrow</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_LEQUAL">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_LEQUAL</span></span><a class="headerlink" href="#curses.ACS_LEQUAL" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>less-than-or-equal-to</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_LLCORNER">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_LLCORNER</span></span><a class="headerlink" href="#curses.ACS_LLCORNER" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>lower left-hand corner</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_LRCORNER">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_LRCORNER</span></span><a class="headerlink" href="#curses.ACS_LRCORNER" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>lower right-hand corner</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_LTEE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_LTEE</span></span><a class="headerlink" href="#curses.ACS_LTEE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>left tee</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_NEQUAL">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_NEQUAL</span></span><a class="headerlink" href="#curses.ACS_NEQUAL" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>not-equal sign</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_PI">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_PI</span></span><a class="headerlink" href="#curses.ACS_PI" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>letter pi</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_PLMINUS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_PLMINUS</span></span><a class="headerlink" href="#curses.ACS_PLMINUS" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>plus-or-minus sign</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_PLUS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_PLUS</span></span><a class="headerlink" href="#curses.ACS_PLUS" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>big plus sign</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_RARROW">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_RARROW</span></span><a class="headerlink" href="#curses.ACS_RARROW" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>right arrow</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_RTEE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_RTEE</span></span><a class="headerlink" href="#curses.ACS_RTEE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>right tee</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_S1">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_S1</span></span><a class="headerlink" href="#curses.ACS_S1" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>scan line 1</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_S3">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_S3</span></span><a class="headerlink" href="#curses.ACS_S3" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>scan line 3</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_S7">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_S7</span></span><a class="headerlink" href="#curses.ACS_S7" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>scan line 7</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_S9">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_S9</span></span><a class="headerlink" href="#curses.ACS_S9" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>scan line 9</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_SBBS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_SBBS</span></span><a class="headerlink" href="#curses.ACS_SBBS" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>alternate name for lower right corner</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_SBSB">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_SBSB</span></span><a class="headerlink" href="#curses.ACS_SBSB" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>alternate name for vertical line</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_SBSS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_SBSS</span></span><a class="headerlink" href="#curses.ACS_SBSS" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>alternate name for right tee</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_SSBB">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_SSBB</span></span><a class="headerlink" href="#curses.ACS_SSBB" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>alternate name for lower left corner</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_SSBS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_SSBS</span></span><a class="headerlink" href="#curses.ACS_SSBS" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>alternate name for bottom tee</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_SSSB">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_SSSB</span></span><a class="headerlink" href="#curses.ACS_SSSB" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>alternate name for left tee</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_SSSS">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_SSSS</span></span><a class="headerlink" href="#curses.ACS_SSSS" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>alternate name for crossover or big plus</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_STERLING">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_STERLING</span></span><a class="headerlink" href="#curses.ACS_STERLING" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>pound sterling</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_TTEE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_TTEE</span></span><a class="headerlink" href="#curses.ACS_TTEE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>top tee</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_UARROW">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_UARROW</span></span><a class="headerlink" href="#curses.ACS_UARROW" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>up arrow</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_ULCORNER">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_ULCORNER</span></span><a class="headerlink" href="#curses.ACS_ULCORNER" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>upper left corner</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_URCORNER">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_URCORNER</span></span><a class="headerlink" href="#curses.ACS_URCORNER" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>upper right corner</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.ACS_VLINE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">ACS_VLINE</span></span><a class="headerlink" href="#curses.ACS_VLINE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>vertical line</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<p>The following table lists mouse button constants used by <a class="reference internal" href="#curses.getmouse" title="curses.getmouse"><code class="xref py py-meth docutils literal notranslate"><span class="pre">getmouse()</span></code></a>:</p>
|
||
<table class="docutils align-default">
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>Mouse button constant</p></th>
|
||
<th class="head"><p>Meaning</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.BUTTONn_PRESSED">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">BUTTONn_PRESSED</span></span><a class="headerlink" href="#curses.BUTTONn_PRESSED" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Mouse button <em>n</em> pressed</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.BUTTONn_RELEASED">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">BUTTONn_RELEASED</span></span><a class="headerlink" href="#curses.BUTTONn_RELEASED" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Mouse button <em>n</em> released</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.BUTTONn_CLICKED">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">BUTTONn_CLICKED</span></span><a class="headerlink" href="#curses.BUTTONn_CLICKED" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Mouse button <em>n</em> clicked</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.BUTTONn_DOUBLE_CLICKED">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">BUTTONn_DOUBLE_CLICKED</span></span><a class="headerlink" href="#curses.BUTTONn_DOUBLE_CLICKED" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Mouse button <em>n</em> double clicked</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.BUTTONn_TRIPLE_CLICKED">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">BUTTONn_TRIPLE_CLICKED</span></span><a class="headerlink" href="#curses.BUTTONn_TRIPLE_CLICKED" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Mouse button <em>n</em> triple clicked</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.BUTTON_SHIFT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">BUTTON_SHIFT</span></span><a class="headerlink" href="#curses.BUTTON_SHIFT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Shift was down during button state change</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.BUTTON_CTRL">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">BUTTON_CTRL</span></span><a class="headerlink" href="#curses.BUTTON_CTRL" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Control was down during button state change</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.BUTTON_ALT">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">BUTTON_ALT</span></span><a class="headerlink" href="#curses.BUTTON_ALT" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Control was down during button state change</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<div class="versionchanged">
|
||
<p><span class="versionmodified changed">Changed in version 3.10: </span>The <code class="docutils literal notranslate"><span class="pre">BUTTON5_*</span></code> constants are now exposed if they are provided by the
|
||
underlying curses library.</p>
|
||
</div>
|
||
<p>The following table lists the predefined colors:</p>
|
||
<table class="docutils align-default">
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>Constant</p></th>
|
||
<th class="head"><p>Color</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.COLOR_BLACK">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">COLOR_BLACK</span></span><a class="headerlink" href="#curses.COLOR_BLACK" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Black</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.COLOR_BLUE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">COLOR_BLUE</span></span><a class="headerlink" href="#curses.COLOR_BLUE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Blue</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.COLOR_CYAN">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">COLOR_CYAN</span></span><a class="headerlink" href="#curses.COLOR_CYAN" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Cyan (light greenish blue)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.COLOR_GREEN">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">COLOR_GREEN</span></span><a class="headerlink" href="#curses.COLOR_GREEN" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Green</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.COLOR_MAGENTA">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">COLOR_MAGENTA</span></span><a class="headerlink" href="#curses.COLOR_MAGENTA" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Magenta (purplish red)</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.COLOR_RED">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">COLOR_RED</span></span><a class="headerlink" href="#curses.COLOR_RED" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Red</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.COLOR_WHITE">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">COLOR_WHITE</span></span><a class="headerlink" href="#curses.COLOR_WHITE" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>White</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><dl class="py data">
|
||
<dt class="sig sig-object py" id="curses.COLOR_YELLOW">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.</span></span><span class="sig-name descname"><span class="pre">COLOR_YELLOW</span></span><a class="headerlink" href="#curses.COLOR_YELLOW" title="Link to this definition">¶</a></dt>
|
||
<dd></dd></dl>
|
||
|
||
</td>
|
||
<td><p>Yellow</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> — Text input widget for curses programs<a class="headerlink" href="#module-curses.textpad" title="Link to this heading">¶</a></h1>
|
||
<p>The <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> module provides 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> class that handles
|
||
elementary text editing in a curses window, supporting a set of keybindings
|
||
resembling those of Emacs (thus, also of Netscape Navigator, BBedit 6.x,
|
||
FrameMaker, and many other programs). The module also provides a
|
||
rectangle-drawing function useful for framing text boxes or for other purposes.</p>
|
||
<p>The module <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> defines the following function:</p>
|
||
<dl class="py function">
|
||
<dt class="sig sig-object py" id="curses.textpad.rectangle">
|
||
<span class="sig-prename descclassname"><span class="pre">curses.textpad.</span></span><span class="sig-name descname"><span class="pre">rectangle</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">win</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">uly</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">ulx</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">lry</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">lrx</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.textpad.rectangle" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Draw a rectangle. The first argument must be a window object; the remaining
|
||
arguments are coordinates relative to that window. The second and third
|
||
arguments are the y and x coordinates of the upper left hand corner of the
|
||
rectangle to be drawn; the fourth and fifth arguments are the y and x
|
||
coordinates of the lower right hand corner. The rectangle will be drawn using
|
||
VT100/IBM PC forms characters on terminals that make this possible (including
|
||
xterm and most other software terminal emulators). Otherwise it will be drawn
|
||
with ASCII dashes, vertical bars, and plus signs.</p>
|
||
</dd></dl>
|
||
|
||
<section id="textbox-objects">
|
||
<span id="curses-textpad-objects"></span><h2>Textbox objects<a class="headerlink" href="#textbox-objects" title="Link to this heading">¶</a></h2>
|
||
<p>You can instantiate 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> object as follows:</p>
|
||
<dl class="py class">
|
||
<dt class="sig sig-object py" id="curses.textpad.Textbox">
|
||
<em class="property"><span class="k"><span class="pre">class</span></span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">curses.textpad.</span></span><span class="sig-name descname"><span class="pre">Textbox</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">win</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.textpad.Textbox" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return a textbox widget object. The <em>win</em> argument should be a curses
|
||
<a class="reference internal" href="#curses-window-objects"><span class="std std-ref">window</span></a> object in which the textbox is to
|
||
be contained. The edit cursor of the textbox is initially located at the
|
||
upper left hand corner of the containing window, with coordinates <code class="docutils literal notranslate"><span class="pre">(0,</span> <span class="pre">0)</span></code>.
|
||
The instance’s <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> flag is initially on.</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> objects have the following methods:</p>
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.textpad.Textbox.edit">
|
||
<span class="sig-name descname"><span class="pre">edit</span></span><span class="sig-paren">(</span><span class="optional">[</span><em class="sig-param"><span class="n"><span class="pre">validator</span></span></em><span class="optional">]</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.textpad.Textbox.edit" title="Link to this definition">¶</a></dt>
|
||
<dd><p>This is the entry point you will normally use. It accepts editing
|
||
keystrokes until one of the termination keystrokes is entered. If
|
||
<em>validator</em> is supplied, it must be a function. It will be called for
|
||
each keystroke entered with the keystroke as a parameter; command dispatch
|
||
is done on the result. This method returns the window contents as a
|
||
string; whether blanks in the window are included is affected by the
|
||
<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> attribute.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.textpad.Textbox.do_command">
|
||
<span class="sig-name descname"><span class="pre">do_command</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">ch</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#curses.textpad.Textbox.do_command" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Process a single command keystroke. Here are the supported special
|
||
keystrokes:</p>
|
||
<table class="docutils align-default">
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>Keystroke</p></th>
|
||
<th class="head"><p>Action</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">A</kbd></p></td>
|
||
<td><p>Go to left edge of window.</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">B</kbd></p></td>
|
||
<td><p>Cursor left, wrapping to previous line if
|
||
appropriate.</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">D</kbd></p></td>
|
||
<td><p>Delete character under cursor.</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">E</kbd></p></td>
|
||
<td><p>Go to right edge (stripspaces off) or end
|
||
of line (stripspaces on).</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">F</kbd></p></td>
|
||
<td><p>Cursor right, wrapping to next line when
|
||
appropriate.</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">G</kbd></p></td>
|
||
<td><p>Terminate, returning the window contents.</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">H</kbd></p></td>
|
||
<td><p>Delete character backward.</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">J</kbd></p></td>
|
||
<td><p>Terminate if the window is 1 line,
|
||
otherwise insert newline.</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">K</kbd></p></td>
|
||
<td><p>If line is blank, delete it, otherwise
|
||
clear to end of line.</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">L</kbd></p></td>
|
||
<td><p>Refresh screen.</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">N</kbd></p></td>
|
||
<td><p>Cursor down; move down one line.</p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">O</kbd></p></td>
|
||
<td><p>Insert a blank line at cursor location.</p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">P</kbd></p></td>
|
||
<td><p>Cursor up; move up one line.</p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<p>Move operations do nothing if the cursor is at an edge where the movement
|
||
is not possible. The following synonyms are supported where possible:</p>
|
||
<table class="docutils align-default">
|
||
<thead>
|
||
<tr class="row-odd"><th class="head"><p>Constant</p></th>
|
||
<th class="head"><p>Keystroke</p></th>
|
||
</tr>
|
||
</thead>
|
||
<tbody>
|
||
<tr class="row-even"><td><p><a class="reference internal" href="#curses.KEY_LEFT" title="curses.KEY_LEFT"><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_LEFT</span></code></a></p></td>
|
||
<td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">B</kbd></p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><a class="reference internal" href="#curses.KEY_RIGHT" title="curses.KEY_RIGHT"><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_RIGHT</span></code></a></p></td>
|
||
<td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">F</kbd></p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><a class="reference internal" href="#curses.KEY_UP" title="curses.KEY_UP"><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_UP</span></code></a></p></td>
|
||
<td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">P</kbd></p></td>
|
||
</tr>
|
||
<tr class="row-odd"><td><p><a class="reference internal" href="#curses.KEY_DOWN" title="curses.KEY_DOWN"><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_DOWN</span></code></a></p></td>
|
||
<td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">N</kbd></p></td>
|
||
</tr>
|
||
<tr class="row-even"><td><p><a class="reference internal" href="#curses.KEY_BACKSPACE" title="curses.KEY_BACKSPACE"><code class="xref py py-const docutils literal notranslate"><span class="pre">KEY_BACKSPACE</span></code></a></p></td>
|
||
<td><p><kbd class="kbd docutils literal notranslate">Control</kbd>-<kbd class="kbd docutils literal notranslate">h</kbd></p></td>
|
||
</tr>
|
||
</tbody>
|
||
</table>
|
||
<p>All other keystrokes are treated as a command to insert the given
|
||
character and move right (with line wrapping).</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py method">
|
||
<dt class="sig sig-object py" id="curses.textpad.Textbox.gather">
|
||
<span class="sig-name descname"><span class="pre">gather</span></span><span class="sig-paren">(</span><span class="sig-paren">)</span><a class="headerlink" href="#curses.textpad.Textbox.gather" title="Link to this definition">¶</a></dt>
|
||
<dd><p>Return the window contents as a string; whether blanks in the
|
||
window are included is affected by the <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> member.</p>
|
||
</dd></dl>
|
||
|
||
<dl class="py attribute">
|
||
<dt class="sig sig-object py" id="curses.textpad.Textbox.stripspaces">
|
||
<span class="sig-name descname"><span class="pre">stripspaces</span></span><a class="headerlink" href="#curses.textpad.Textbox.stripspaces" title="Link to this definition">¶</a></dt>
|
||
<dd><p>This attribute is a flag which controls the interpretation of blanks in
|
||
the window. When it is on, trailing blanks on each line are ignored; any
|
||
cursor motion that would land the cursor on a trailing blank goes to the
|
||
end of that line instead, and trailing blanks are stripped when the window
|
||
contents are gathered.</p>
|
||
</dd></dl>
|
||
|
||
</dd></dl>
|
||
|
||
</section>
|
||
</section>
|
||
|
||
|
||
<div class="clearer"></div>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="sphinxsidebar" role="navigation" aria-label="Main">
|
||
<div class="sphinxsidebarwrapper">
|
||
<div>
|
||
<h3><a href="../contents.html">Table of Contents</a></h3>
|
||
<ul>
|
||
<li><a class="reference internal" href="#"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses</span></code> — Terminal handling for character-cell displays</a><ul>
|
||
<li><a class="reference internal" href="#functions">Functions</a></li>
|
||
<li><a class="reference internal" href="#window-objects">Window Objects</a></li>
|
||
<li><a class="reference internal" href="#constants">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> — Text input widget for curses programs</a><ul>
|
||
<li><a class="reference internal" href="#textbox-objects">Textbox objects</a></li>
|
||
</ul>
|
||
</li>
|
||
</ul>
|
||
|
||
</div>
|
||
<div>
|
||
<h4>Previous topic</h4>
|
||
<p class="topless"><a href="fileinput.html"
|
||
title="previous chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">fileinput</span></code> — Iterate over lines from multiple input streams</a></p>
|
||
</div>
|
||
<div>
|
||
<h4>Next topic</h4>
|
||
<p class="topless"><a href="curses.ascii.html"
|
||
title="next chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses.ascii</span></code> — Utilities for ASCII characters</a></p>
|
||
</div>
|
||
<div role="note" aria-label="source link">
|
||
<h3>This Page</h3>
|
||
<ul class="this-page-menu">
|
||
<li><a href="../bugs.html">Report a Bug</a></li>
|
||
<li>
|
||
<a href="https://github.com/python/cpython/blob/main/Doc/library/curses.rst"
|
||
rel="nofollow">Show Source
|
||
</a>
|
||
</li>
|
||
</ul>
|
||
</div>
|
||
</div>
|
||
<div id="sidebarbutton" title="Collapse sidebar">
|
||
<span>«</span>
|
||
</div>
|
||
|
||
</div>
|
||
<div class="clearer"></div>
|
||
</div>
|
||
<div class="related" role="navigation" aria-label="Related">
|
||
<h3>Navigation</h3>
|
||
<ul>
|
||
<li class="right" style="margin-right: 10px">
|
||
<a href="../genindex.html" title="General Index"
|
||
>index</a></li>
|
||
<li class="right" >
|
||
<a href="../py-modindex.html" title="Python Module Index"
|
||
>modules</a> |</li>
|
||
<li class="right" >
|
||
<a href="curses.ascii.html" title="curses.ascii — Utilities for ASCII characters"
|
||
>next</a> |</li>
|
||
<li class="right" >
|
||
<a href="fileinput.html" title="fileinput — Iterate over lines from multiple input streams"
|
||
>previous</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.13.3 Documentation</a> »
|
||
</li>
|
||
|
||
<li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> »</li>
|
||
<li class="nav-item nav-item-2"><a href="cmdlinelibs.html" >Command Line Interface Libraries</a> »</li>
|
||
<li class="nav-item nav-item-this"><a href=""><code class="xref py py-mod docutils literal notranslate"><span class="pre">curses</span></code> — Terminal handling for character-cell displays</a></li>
|
||
<li class="right">
|
||
|
||
|
||
<div class="inline-search" role="search">
|
||
<form class="inline-search" action="../search.html" method="get">
|
||
<input placeholder="Quick search" aria-label="Quick search" type="search" name="q" id="search-box" />
|
||
<input type="submit" value="Go" />
|
||
</form>
|
||
</div>
|
||
|
|
||
</li>
|
||
<li class="right">
|
||
<label class="theme-selector-label">
|
||
Theme
|
||
<select class="theme-selector" oninput="activateTheme(this.value)">
|
||
<option value="auto" selected>Auto</option>
|
||
<option value="light">Light</option>
|
||
<option value="dark">Dark</option>
|
||
</select>
|
||
</label> |</li>
|
||
|
||
</ul>
|
||
</div>
|
||
<div class="footer">
|
||
©
|
||
<a href="../copyright.html">
|
||
|
||
Copyright
|
||
|
||
</a>
|
||
2001-2025, 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 />
|
||
|
||
See <a href="/license.html">History and License</a> for more information.<br />
|
||
|
||
|
||
<br />
|
||
|
||
The Python Software Foundation is a non-profit corporation.
|
||
<a href="https://www.python.org/psf/donations/">Please donate.</a>
|
||
<br />
|
||
<br />
|
||
Last updated on Apr 08, 2025 (14:33 UTC).
|
||
|
||
<a href="/bugs.html">Found a bug</a>?
|
||
|
||
<br />
|
||
|
||
Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.2.3.
|
||
</div>
|
||
|
||
</body>
|
||
</html> |