mirror of
https://github.com/python/cpython.git
synced 2025-10-30 05:01:30 +00: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!
154 lines
4.5 KiB
TeX
154 lines
4.5 KiB
TeX
\chapter{MacOS Toolbox Modules \label{toolbox}}
|
|
|
|
There are a set of modules that provide interfaces to various MacOS
|
|
toolboxes. If applicable the module will define a number of Python
|
|
objects for the various structures declared by the toolbox, and
|
|
operations will be implemented as methods of the object. Other
|
|
operations will be implemented as functions in the module. Not all
|
|
operations possible in C will also be possible in Python (callbacks
|
|
are often a problem), and parameters will occasionally be different in
|
|
Python (input and output buffers, especially). All methods and
|
|
functions have a \member{__doc__} string describing their arguments
|
|
and return values, and for additional description you are referred to
|
|
\citetitle[http://developer.apple.com/techpubs/macos8/mac8.html]{Inside
|
|
Macintosh} or similar works.
|
|
|
|
These modules all live in a package called \module{Carbon}. Despite the
|
|
name Carbon they are also available under classic PPC MacPython.
|
|
The normal use pattern is
|
|
|
|
\begin{verbatim}
|
|
from Carbon import AE
|
|
\end{verbatim}
|
|
|
|
\strong{Warning!} These modules are not yet documented. If you
|
|
wish to contribute documentation of any of these modules, please get
|
|
in touch with \email{python-docs@python.org}.
|
|
|
|
\localmoduletable
|
|
|
|
|
|
%\section{Argument Handling for Toolbox Modules}
|
|
|
|
|
|
\section{\module{Carbon.AE} --- Apple Events}
|
|
\declaremodule{standard}{Carbon.AE}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the Apple Events toolbox.}
|
|
|
|
|
|
\section{\module{Carbon.App} --- Appearance Manager}
|
|
\declaremodule{standard}{Carbon.App}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the Appearance Manager.}
|
|
|
|
|
|
\section{\module{Carbon.CF} --- Core Foundation}
|
|
\declaremodule{standard}{Carbon.CF}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the Core Foundation.}
|
|
|
|
This module is only available under Carbon MacPython. The
|
|
\code{CFBase}, \code{CFArray}, \code{CFData}, \code{CFDictionary},
|
|
\code{CFString} and \code{CFURL} objects are supported, some
|
|
only partially.
|
|
|
|
\section{\module{Carbon.Cm} --- Component Manager}
|
|
\declaremodule{standard}{Carbon.Cm}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the Component Manager.}
|
|
|
|
|
|
\section{\module{Carbon.Ctl} --- Control Manager}
|
|
\declaremodule{standard}{Carbon.Ctl}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the Control Manager.}
|
|
|
|
|
|
\section{\module{Carbon.Dlg} --- Dialog Manager}
|
|
\declaremodule{standard}{Carbon.Dlg}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the Dialog Manager.}
|
|
|
|
|
|
\section{\module{Carbon.Evt} --- Event Manager}
|
|
\declaremodule{standard}{Carbon.Evt}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the Event Manager.}
|
|
|
|
|
|
\section{\module{Carbon.Fm} --- Font Manager}
|
|
\declaremodule{standard}{Carbon.Fm}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the Font Manager.}
|
|
|
|
|
|
\section{\module{Carbon.Help} --- Help Manager}
|
|
\declaremodule{standard}{Carbon.Help}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the Balloon Help Manager.}
|
|
|
|
This module is only available under MacOS9 and earlier in
|
|
classic PPC MacPython.
|
|
|
|
\section{\module{Carbon.List} --- List Manager}
|
|
\declaremodule{standard}{Carbon.List}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the List Manager.}
|
|
|
|
|
|
\section{\module{Carbon.Menu} --- Menu Manager}
|
|
\declaremodule{standard}{Carbon.Menu}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the Menu Manager.}
|
|
|
|
|
|
\section{\module{Carbon.Mlte} --- MultiLingual Text Editor}
|
|
\declaremodule{standard}{Carbon.Mlte}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the MultiLingual Text Editor.}
|
|
|
|
|
|
\section{\module{Carbon.Qd} --- QuickDraw}
|
|
\declaremodule{builtin}{Carbon.Qd}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the QuickDraw toolbox.}
|
|
|
|
|
|
\section{\module{Carbon.Qdoffs} --- QuickDraw Offscreen}
|
|
\declaremodule{builtin}{Carbon.Qdoffs}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the QuickDraw Offscreen APIs.}
|
|
|
|
|
|
\section{\module{Carbon.Qt} --- QuickTime}
|
|
\declaremodule{standard}{Carbon.Qt}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the QuickTime toolbox.}
|
|
|
|
|
|
\section{\module{Carbon.Res} --- Resource Manager and Handles}
|
|
\declaremodule{standard}{Carbon.Res}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the Resource Manager and Handles.}
|
|
|
|
|
|
\input{libscrap}
|
|
|
|
|
|
\section{\module{Carbon.Snd} --- Sound Manager}
|
|
\declaremodule{standard}{Carbon.Snd}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the Sound Manager.}
|
|
|
|
|
|
\section{\module{Carbon.TE} --- TextEdit}
|
|
\declaremodule{standard}{Carbon.TE}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to TextEdit.}
|
|
|
|
|
|
\section{\module{Carbon.Win} --- Window Manager}
|
|
\declaremodule{standard}{Carbon.Win}
|
|
\platform{Mac}
|
|
\modulesynopsis{Interface to the Window Manager.}
|