1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173
|
\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/documentation/macos8/mac8.html]{Inside
Macintosh} or similar works.
These modules all live in a package called \module{Carbon}. Despite that name
they are not all part of the Carbon framework: CF is really in the CoreFoundation
framework and Qt is in the QuickTime framework.
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{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.AH} --- Apple Help}
\declaremodule{standard}{Carbon.AH}
\platform{Mac}
\modulesynopsis{Interface to the Apple Help manager.}
\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.}
The
\code{CFBase}, \code{CFArray}, \code{CFData}, \code{CFDictionary},
\code{CFString} and \code{CFURL} objects are supported, some
only partially.
\section{\module{Carbon.CG} --- Core Graphics}
\declaremodule{standard}{Carbon.CG}
\platform{Mac}
\modulesynopsis{Interface to the Component Manager.}
\section{\module{Carbon.CarbonEvt} --- Carbon Event Manager}
\declaremodule{standard}{Carbon.CaronEvt}
\platform{Mac}
\modulesynopsis{Interface to the Carbon Event Manager.}
\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 classic Event Manager.}
\section{\module{Carbon.Fm} --- Font Manager}
\declaremodule{standard}{Carbon.Fm}
\platform{Mac}
\modulesynopsis{Interface to the Font Manager.}
\section{\module{Carbon.Folder} --- Folder Manager}
\declaremodule{standard}{Carbon.Folder}
\platform{Mac}
\modulesynopsis{Interface to the Folder Manager.}
\section{\module{Carbon.Help} --- Help Manager}
\declaremodule{standard}{Carbon.Help}
\platform{Mac}
\modulesynopsis{Interface to the Carbon Help Manager.}
\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.}
\section{\module{Carbon.Scrap} --- Scrap Manager}
\declaremodule{standard}{Carbon.Scrap}
\platform{Mac}
\modulesynopsis{Interface to the Carbon Scrap Manager.}
\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.}
|