cpython/Doc/mac/libmacconsole.tex

114 lines
2.9 KiB
TeX
Raw Normal View History

\section{Built-in Module \module{macconsole}}
\declaremodule{builtin}{macconsole}
\modulesynopsis{Think C's console package is available using this module.}
1995-02-28 11:46:09 -04:00
1995-02-28 11:46:09 -04:00
This module is available on the Macintosh, provided Python has been
1998-03-14 17:53:48 -04:00
built using the Think \C{} compiler. It provides an interface to the
1995-02-28 11:46:09 -04:00
Think console package, with which basic text windows can be created.
\begin{datadesc}{options}
An object allowing you to set various options when creating windows,
see below.
\end{datadesc}
\begin{datadesc}{C_ECHO}
\dataline{C_NOECHO}
\dataline{C_CBREAK}
\dataline{C_RAW}
1998-03-14 17:53:48 -04:00
Options for the \code{setmode} method. \constant{C_ECHO} and
\constant{C_CBREAK} enable character echo, the other two disable it,
\constant{C_ECHO} and \constant{C_NOECHO} enable line-oriented input
(erase/kill processing, etc).
1995-02-28 11:46:09 -04:00
\end{datadesc}
\begin{funcdesc}{copen}{}
1995-03-13 06:03:32 -04:00
Open a new console window. Return a console window object.
1995-02-28 11:46:09 -04:00
\end{funcdesc}
\begin{funcdesc}{fopen}{fp}
Return the console window object corresponding with the given file
1995-03-13 06:03:32 -04:00
object. \var{fp} should be one of \code{sys.stdin}, \code{sys.stdout} or
\code{sys.stderr}.
1995-02-28 11:46:09 -04:00
\end{funcdesc}
\subsection{macconsole options object}
These options are examined when a window is created:
\setindexsubitem{(macconsole option)}
1995-02-28 11:46:09 -04:00
\begin{datadesc}{top}
\dataline{left}
The origin of the window.
\end{datadesc}
\begin{datadesc}{nrows}
\dataline{ncols}
The size of the window.
\end{datadesc}
\begin{datadesc}{txFont}
\dataline{txSize}
\dataline{txStyle}
The font, fontsize and fontstyle to be used in the window.
\end{datadesc}
\begin{datadesc}{title}
The title of the window.
\end{datadesc}
\begin{datadesc}{pause_atexit}
1995-03-13 06:03:32 -04:00
If set non-zero, the window will wait for user action before closing.
1995-02-28 11:46:09 -04:00
\end{datadesc}
\subsection{console window object}
\setindexsubitem{(console window attribute)}
1995-02-28 11:46:09 -04:00
\begin{datadesc}{file}
The file object corresponding to this console window. If the file is
1998-03-14 17:53:48 -04:00
buffered, you should call \code{\var{file}.flush()} between
\code{write()} and \code{read()} calls.
1995-02-28 11:46:09 -04:00
\end{datadesc}
\setindexsubitem{(console window method)}
1995-02-28 11:46:09 -04:00
\begin{funcdesc}{setmode}{mode}
1998-03-14 17:53:48 -04:00
Set the input mode of the console to \constant{C_ECHO}, etc.
1995-02-28 11:46:09 -04:00
\end{funcdesc}
\begin{funcdesc}{settabs}{n}
Set the tabsize to \var{n} spaces.
\end{funcdesc}
\begin{funcdesc}{cleos}{}
Clear to end-of-screen.
\end{funcdesc}
\begin{funcdesc}{cleol}{}
Clear to end-of-line.
\end{funcdesc}
\begin{funcdesc}{inverse}{onoff}
1995-03-13 06:03:32 -04:00
Enable inverse-video mode:\ characters with the high bit set are
1995-02-28 11:46:09 -04:00
displayed in inverse video (this disables the upper half of a
1995-03-13 06:03:32 -04:00
non-\ASCII{} character set).
1995-02-28 11:46:09 -04:00
\end{funcdesc}
\begin{funcdesc}{gotoxy}{x, y}
1995-03-13 06:03:32 -04:00
Set the cursor to position \code{(\var{x}, \var{y})}.
1995-02-28 11:46:09 -04:00
\end{funcdesc}
\begin{funcdesc}{hide}{}
Hide the window, remembering the contents.
\end{funcdesc}
\begin{funcdesc}{show}{}
Show the window again.
\end{funcdesc}
\begin{funcdesc}{echo2printer}{}
Copy everything written to the window to the printer as well.
\end{funcdesc}