mirror of
https://github.com/python/cpython.git
synced 2024-11-28 16:45:42 +01:00
f3e6f06a45
it is difficult to do without a Mac box to try things out on. This expands on what was there only a little bit; hopefully someone with a Mac can work on this as well!
43 lines
1.6 KiB
TeX
43 lines
1.6 KiB
TeX
\section{\module{Carbon.Scrap} --- Scrap Manager}
|
|
\declaremodule{standard}{Carbon.Scrap}
|
|
\platform{Mac}
|
|
\modulesynopsis{The Scrap Manager provides basic services for
|
|
implementing cut \&\ paste and clipboard operations.}
|
|
|
|
|
|
This module is only fully available on MacOS9 and earlier under
|
|
classic PPC MacPython. Very limited functionality is available under
|
|
Carbon MacPython.
|
|
|
|
The Scrap\index{Scrap Manager} Manager supports the simplest form of
|
|
cut \&\ paste operations on the Macintosh. It can be use for both
|
|
inter- and intra-application clipboard operations.
|
|
|
|
The \module{Scrap} module provides low-level access to the functions
|
|
of the Scrap Manager. It contains the following functions:
|
|
|
|
|
|
\begin{funcdesc}{InfoScrap}{}
|
|
Return current information about the scrap. The information is
|
|
encoded as a tuple containing the fields \code{(\var{size},
|
|
\var{handle}, \var{count}, \var{state}, \var{path})}.
|
|
|
|
\begin{tableii}{l|l}{var}{Field}{Meaning}
|
|
\lineii{size}{Size of the scrap in bytes.}
|
|
\lineii{handle}{Resource object representing the scrap.}
|
|
\lineii{count}{Serial number of the scrap contents.}
|
|
\lineii{state}{Integer; positive if in memory, \code{0} if on
|
|
disk, negative if uninitialized.}
|
|
\lineii{path}{Filename of the scrap when stored on disk.}
|
|
\end{tableii}
|
|
\end{funcdesc}
|
|
|
|
|
|
|
|
\begin{seealso}
|
|
\seetitle[http://developer.apple.com/techpubs/mac/MoreToolbox/MoreToolbox-109.html]
|
|
{Scrap Manager}{Apple's documentation for the Scrap Manager
|
|
gives a lot of useful information about using the Scrap
|
|
Manager in applications.}
|
|
\end{seealso}
|