summaryrefslogtreecommitdiffstats
path: root/Doc/mac/toolbox.tex
blob: 69f5a504cd8b626fc354d97982b3825d78e581e4 (plain)
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
\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{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}


\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.

\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}


\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}