37.8. Mac OS Toolbox Modules

There are a set of modules that provide interfaces to various Mac OS 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 __doc__ string describing their arguments and return values, and for additional description you are referred to Inside Macintosh or similar works.

These modules all live in a package called 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

from Carbon import AE

Note

The Carbon modules have been removed in Python 3.0.

37.8.1. Carbon.AE — Apple Events

Platforms: Mac

37.8.2. Carbon.AH — Apple Help

Platforms: Mac

37.8.3. Carbon.App — Appearance Manager

Platforms: Mac

37.8.4. Carbon.Appearance — Appearance Manager constants

Platforms: Mac

37.8.5. Carbon.CF — Core Foundation

Platforms: Mac

The CFBase, CFArray, CFData, CFDictionary, CFString and CFURL objects are supported, some only partially.

37.8.6. Carbon.CG — Core Graphics

Platforms: Mac

37.8.7. Carbon.CarbonEvt — Carbon Event Manager

Platforms: Mac

37.8.8. Carbon.CarbonEvents — Carbon Event Manager constants

Platforms: Mac

37.8.9. Carbon.Cm — Component Manager

Platforms: Mac

37.8.10. Carbon.Components — Component Manager constants

Platforms: Mac

37.8.11. Carbon.ControlAccessor — Control Manager accssors

Platforms: Mac

37.8.12. Carbon.Controls — Control Manager constants

Platforms: Mac

37.8.13. Carbon.CoreFounation — CoreFounation constants

Platforms: Mac

37.8.14. Carbon.CoreGraphics — CoreGraphics constants

Platforms: Mac

37.8.15. Carbon.Ctl — Control Manager

Platforms: Mac

37.8.16. Carbon.Dialogs — Dialog Manager constants

Platforms: Mac

37.8.17. Carbon.Dlg — Dialog Manager

Platforms: Mac

37.8.18. Carbon.Drag — Drag and Drop Manager

Platforms: Mac

37.8.19. Carbon.Dragconst — Drag and Drop Manager constants

Platforms: Mac

37.8.20. Carbon.Events — Event Manager constants

Platforms: Mac

37.8.21. Carbon.Evt — Event Manager

Platforms: Mac

37.8.22. Carbon.File — File Manager

Platforms: Mac

37.8.23. Carbon.Files — File Manager constants

Platforms: Mac

37.8.24. Carbon.Fm — Font Manager

Platforms: Mac

37.8.25. Carbon.Folder — Folder Manager

Platforms: Mac

37.8.26. Carbon.Folders — Folder Manager constants

Platforms: Mac

37.8.27. Carbon.Fonts — Font Manager constants

Platforms: Mac

37.8.28. Carbon.Help — Help Manager

Platforms: Mac

37.8.29. Carbon.IBCarbon — Carbon InterfaceBuilder

Platforms: Mac

37.8.30. Carbon.IBCarbonRuntime — Carbon InterfaceBuilder constants

Platforms: Mac

37.8.31. Carbon.Icn — Carbon Icon Manager

Platforms: Mac

37.8.32. Carbon.Icons — Carbon Icon Manager constants

Platforms: Mac

37.8.33. Carbon.Launch — Carbon Launch Services

Platforms: Mac

37.8.34. Carbon.LaunchServices — Carbon Launch Services constants

Platforms: Mac

37.8.35. Carbon.List — List Manager

Platforms: Mac

37.8.36. Carbon.Lists — List Manager constants

Platforms: Mac

37.8.37. Carbon.MacHelp — Help Manager constants

Platforms: Mac

37.8.38. Carbon.MediaDescr — Parsers and generators for Quicktime Media descriptors

Platforms: Mac

37.8.39. Carbon.Menu — Menu Manager

Platforms: Mac

37.8.40. Carbon.Menus — Menu Manager constants

Platforms: Mac

37.8.41. Carbon.Mlte — MultiLingual Text Editor

Platforms: Mac

37.8.42. Carbon.OSA — Carbon OSA Interface

Platforms: Mac

37.8.43. Carbon.OSAconst — Carbon OSA Interface constants

Platforms: Mac

37.8.44. Carbon.QDOffscreen — QuickDraw Offscreen constants

Platforms: Mac

37.8.45. Carbon.Qd — QuickDraw

Platforms: Mac

37.8.46. Carbon.Qdoffs — QuickDraw Offscreen

Platforms: Mac

37.8.47. Carbon.Qt — QuickTime

Platforms: Mac

37.8.48. Carbon.QuickDraw — QuickDraw constants

Platforms: Mac

37.8.49. Carbon.QuickTime — QuickTime constants

Platforms: Mac

37.8.50. Carbon.Res — Resource Manager and Handles

Platforms: Mac

37.8.51. Carbon.Resources — Resource Manager and Handles constants

Platforms: Mac

37.8.52. Carbon.Scrap — Scrap Manager

Platforms: Mac

This module is only fully available on Mac OS 9 and earlier under classic PPC MacPython. Very limited functionality is available under Carbon MacPython.

The Scrap 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 Scrap module provides low-level access to the functions of the Scrap Manager. It contains the following functions:

Carbon.Scrap.InfoScrap()

Return current information about the scrap. The information is encoded as a tuple containing the fields (size, handle, count, state, path).

Field	Meaning
size	Size of the scrap in bytes.
handle	Resource object representing the scrap.
count	Serial number of the scrap contents.
state	Integer; positive if in memory, 0 if on disk, negative if uninitialized.
path	Filename of the scrap when stored on disk.

See also

Scrap Manager

Apple’s documentation for the Scrap Manager gives a lot of useful information about using the Scrap Manager in applications.

37.8.53. Carbon.Snd — Sound Manager

Platforms: Mac

37.8.54. Carbon.Sound — Sound Manager constants

Platforms: Mac

37.8.55. Carbon.TE — TextEdit

Platforms: Mac

37.8.56. Carbon.TextEdit — TextEdit constants

Platforms: Mac

37.8.57. Carbon.Win — Window Manager

Platforms: Mac

37.8.58. Carbon.Windows — Window Manager constants

Platforms: Mac