console.html
来自「perl教程」· HTML 代码 · 共 1,003 行 · 第 1/3 页
HTML
1,003 行
<?xml version="1.0" ?>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<!-- saved from url=(0017)http://localhost/ -->
<script language="JavaScript" src="../../displayToc.js"></script>
<script language="JavaScript" src="../../tocParas.js"></script>
<script language="JavaScript" src="../../tocTab.js"></script>
<link rel="stylesheet" type="text/css" href="../../scineplex.css">
<title>Win32::Console - Win32 Console and Character Mode Functions</title>
<link rel="stylesheet" href="../../Active.css" type="text/css" />
<meta http-equiv="content-type" content="text/html; charset=utf-8" />
<link rev="made" href="mailto:" />
</head>
<body>
<script>writelinks('__top__',2);</script>
<h1><a>Win32::Console - Win32 Console and Character Mode Functions</a></h1>
<p><a name="__index__"></a></p>
<!-- INDEX BEGIN -->
<ul>
<li><a href="#name">NAME</a></li>
<li><a href="#description">DESCRIPTION</a></li>
<li><a href="#reference">REFERENCE</a></li>
<ul>
<li><a href="#methods">Methods</a></li>
<li><a href="#constants">Constants</a></li>
<li><a href="#microsoft_s_documentation">Microsoft's Documentation</a></li>
</ul>
<li><a href="#author">AUTHOR</a></li>
<li><a href="#credits">CREDITS</a></li>
<li><a href="#disclaimer">DISCLAIMER</a></li>
</ul>
<!-- INDEX END -->
<hr />
<p>
</p>
<h1><a name="name">NAME</a></h1>
<p>Win32::Console - Win32 Console and Character Mode Functions</p>
<p>
</p>
<hr />
<h1><a name="description">DESCRIPTION</a></h1>
<p>This module implements the Win32 console and character mode
functions. They give you full control on the console input and output,
including: support of off-screen console buffers (eg. multiple screen
pages)</p>
<ul>
<li>
<p>reading and writing of characters, attributes and whole portions of
the screen</p>
</li>
<li>
<p>complete processing of keyboard and mouse events</p>
</li>
<li>
<p>some very funny additional features :)</p>
</li>
</ul>
<p>Those functions should also make possible a port of the Unix's curses
library; if there is anyone interested (and/or willing to contribute)
to this project, e-mail me. Thank you.</p>
<p>
</p>
<hr />
<h1><a name="reference">REFERENCE</a></h1>
<p>
</p>
<h2><a name="methods">Methods</a></h2>
<dl>
<dt><strong><a name="item_alloc">Alloc</a></strong>
<dd>
<p>Allocates a new console for the process. Returns <a href="../../lib/Pod/perlfunc.html#item_undef"><code>undef</code></a> on errors, a
nonzero value on success. A process cannot be associated with more
than one console, so this method will fail if there is already an
allocated console. Use Free to detach the process from the console,
and then call Alloc to create a new console. See also: <a href="#item_free"><code>Free</code></a></p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
<span class="variable">$CONSOLE</span><span class="operator">-></span><span class="variable">Alloc</span><span class="operator">();</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_attr__5battr_5d">Attr [attr]</a></strong>
<dd>
<p>Gets or sets the current console attribute. This attribute is used by
the Write method.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
<span class="variable">$attr</span> <span class="operator">=</span> <span class="variable">$CONSOLE</span><span class="operator">-></span><span class="variable">Attr</span><span class="operator">();</span>
<span class="variable">$CONSOLE</span><span class="operator">-></span><span class="variable">Attr</span><span class="operator">(</span><span class="variable">$FG_YELLOW</span> <span class="operator">|</span> <span class="variable">$BG_BLUE</span><span class="operator">);</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_close">Close</a></strong>
<dd>
<p>Closes a shortcut object. Note that it is not "strictly" required to
close the objects you created, since the Win32::Shortcut objects are
automatically closed when the program ends (or when you elsehow
destroy such an object).</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
<span class="variable">$LINK</span><span class="operator">-></span><span class="variable">Close</span><span class="operator">();</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_cls__5battr_5d">Cls [attr]</a></strong>
<dd>
<p>Clear the console, with the specified <em>attr</em> if given, or using
ATTR_NORMAL otherwise.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
<span class="variable">$CONSOLE</span><span class="operator">-></span><span class="variable">Cls</span><span class="operator">();</span>
<span class="variable">$CONSOLE</span><span class="operator">-></span><span class="variable">Cls</span><span class="operator">(</span><span class="variable">$FG_WHITE</span> <span class="operator">|</span> <span class="variable">$BG_GREEN</span><span class="operator">);</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_cursor__5bx_2c_y_2c_size_2c_visible_5d">Cursor [x, y, size, visible]</a></strong>
<dd>
<p>Gets or sets cursor position and appearance. Returns <a href="../../lib/Pod/perlfunc.html#item_undef"><code>undef</code></a> on
errors, or a 4-element list containing: <em>x</em>, <em>y</em>, <em>size</em>,
<em>visible</em>. <em>x</em> and <em>y</em> are the current cursor position; ...</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
<span class="operator">(</span><span class="variable">$x</span><span class="operator">,</span> <span class="variable">$y</span><span class="operator">,</span> <span class="variable">$size</span><span class="operator">,</span> <span class="variable">$visible</span><span class="operator">)</span> <span class="operator">=</span> <span class="variable">$CONSOLE</span><span class="operator">-></span><span class="variable">Cursor</span><span class="operator">();</span>
</pre>
</dd>
<dd>
<pre>
<span class="comment"># Get position only</span>
<span class="operator">(</span><span class="variable">$x</span><span class="operator">,</span> <span class="variable">$y</span><span class="operator">)</span> <span class="operator">=</span> <span class="variable">$CONSOLE</span><span class="operator">-></span><span class="variable">Cursor</span><span class="operator">();</span>
</pre>
</dd>
<dd>
<pre>
<span class="variable">$CONSOLE</span><span class="operator">-></span><span class="variable">Cursor</span><span class="operator">(</span><span class="number">40</span><span class="operator">,</span> <span class="number">13</span><span class="operator">,</span> <span class="number">50</span><span class="operator">,</span> <span class="number">1</span><span class="operator">);</span>
</pre>
</dd>
<dd>
<pre>
<span class="comment"># Set position only</span>
<span class="variable">$CONSOLE</span><span class="operator">-></span><span class="variable">Cursor</span><span class="operator">(</span><span class="number">40</span><span class="operator">,</span> <span class="number">13</span><span class="operator">);</span>
</pre>
</dd>
<dd>
<pre>
<span class="comment"># Set size and visibility without affecting position</span>
<span class="variable">$CONSOLE</span><span class="operator">-></span><span class="variable">Cursor</span><span class="operator">(-</span><span class="number">1</span><span class="operator">,</span> <span class="operator">-</span><span class="number">1</span><span class="operator">,</span> <span class="number">50</span><span class="operator">,</span> <span class="number">1</span><span class="operator">);</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_display">Display</a></strong>
<dd>
<p>Displays the specified console on the screen. Returns <a href="../../lib/Pod/perlfunc.html#item_undef"><code>undef</code></a> on errors,
a nonzero value on success.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
<span class="variable">$CONSOLE</span><span class="operator">-></span><span class="variable">Display</span><span class="operator">();</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_fillattr__5battribute_2c_number_2c_col_2c_row_5d">FillAttr [attribute, number, col, row]</a></strong>
<dd>
<p>Fills the specified number of consecutive attributes, beginning at
<em>col</em>, <em>row</em>, with the value specified in <em>attribute</em>. Returns the
number of attributes filled, or <a href="../../lib/Pod/perlfunc.html#item_undef"><code>undef</code></a> on errors. See also:
<code>FillChar</code>.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
<span class="variable">$CONSOLE</span><span class="operator">-></span><span class="variable">FillAttr</span><span class="operator">(</span><span class="variable">$FG_BLACK</span> <span class="operator">|</span> <span class="variable">$BG_BLACK</span><span class="operator">,</span> <span class="number">80</span><span class="operator">*</span><span class="number">25</span><span class="operator">,</span> <span class="number">0</span><span class="operator">,</span> <span class="number">0</span><span class="operator">);</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_fillchar_char_2c_number_2c_col_2c_row">FillChar char, number, col, row</a></strong>
<dd>
<p>Fills the specified number of consecutive characters, beginning at
<em>col</em>, <em>row</em>, with the character specified in <em>char</em>. Returns the
number of characters filled, or <a href="../../lib/Pod/perlfunc.html#item_undef"><code>undef</code></a> on errors. See also:
<code>FillAttr</code>.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
<span class="variable">$CONSOLE</span><span class="operator">-></span><span class="variable">FillChar</span><span class="operator">(</span><span class="string">"X"</span><span class="operator">,</span> <span class="number">80</span><span class="operator">*</span><span class="number">25</span><span class="operator">,</span> <span class="number">0</span><span class="operator">,</span> <span class="number">0</span><span class="operator">);</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_flush">Flush</a></strong>
<dd>
<p>Flushes the console input buffer. All the events in the buffer are
discarded. Returns <a href="../../lib/Pod/perlfunc.html#item_undef"><code>undef</code></a> on errors, a nonzero value on success.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
<span class="variable">$CONSOLE</span><span class="operator">-></span><span class="variable">Flush</span><span class="operator">();</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_free">Free</a></strong>
<dd>
<p>Detaches the process from the console. Returns <a href="../../lib/Pod/perlfunc.html#item_undef"><code>undef</code></a> on errors, a
nonzero value on success. See also: <a href="#item_alloc"><code>Alloc</code></a>.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
<span class="variable">$CONSOLE</span><span class="operator">-></span><span class="variable">Free</span><span class="operator">();</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_generatectrlevent__5btype_2c_processgroup_5d">GenerateCtrlEvent [type, processgroup]</a></strong>
<dd>
<p>Sends a break signal of the specified <em>type</em> to the specified
<em>processgroup</em>. <em>type</em> can be one of the following constants:</p>
</dd>
<dd>
<pre>
CTRL_BREAK_EVENT
CTRL_C_EVENT</pre>
</dd>
<dd>
<p>they signal, respectively, the pressing of Control + Break and of
Control + C; if not specified, it defaults to CTRL_C_EVENT.
<em>processgroup</em> is the pid of a process sharing the same console. If
omitted, it defaults to 0 (the current process), which is also the
only meaningful value that you can pass to this function. Returns
<a href="../../lib/Pod/perlfunc.html#item_undef"><code>undef</code></a> on errors, a nonzero value on success.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
<span class="comment"># break this script now</span>
<span class="variable">$CONSOLE</span><span class="operator">-></span><span class="variable">GenerateCtrlEvent</span><span class="operator">();</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_getevents">GetEvents</a></strong>
<dd>
<p>Returns the number of unread input events in the console's input
buffer, or <a href="../../lib/Pod/perlfunc.html#item_undef"><code>undef</code></a> on errors. See also: <a href="#item_input"><code>Input</code></a>, <code>InputChar</code>,
<a href="#item_peekinput"><code>PeekInput</code></a>, <a href="#item_writeinput"><code>WriteInput</code></a>.</p>
</dd>
<dd>
<p>Example:</p>
</dd>
<dd>
<pre>
<span class="variable">$events</span> <span class="operator">=</span> <span class="variable">$CONSOLE</span><span class="operator">-></span><span class="variable">GetEvents</span><span class="operator">();</span>
</pre>
</dd>
</li>
<dt><strong><a name="item_info">Info</a></strong>
<dd>
<p>Returns an array of informations about the console (or <a href="../../lib/Pod/perlfunc.html#item_undef"><code>undef</code></a> on
errors), which contains:</p>
</dd>
<ul>
<li>
<p>columns (X size) of the console buffer.</p>
</li>
<li>
<p>rows (Y size) of the console buffer.</p>
</li>
<li>
<p>current column (X position) of the cursor.</p>
</li>
<li>
<p>current row (Y position) of the cursor.</p>
</li>
<li>
<p>current attribute used for <code>Write</code>.</p>
</li>
<li>
<p>left column (X of the starting point) of the current console window.</p>
</li>
<li>
<p>top row (Y of the starting point) of the current console window.</p>
</li>
⌨️ 快捷键说明
复制代码Ctrl + C
搜索代码Ctrl + F
全屏模式F11
增大字号Ctrl + =
减小字号Ctrl + -
显示快捷键?