37.8. Mac OS ツールボックスモジュール

各種のレガシーな Mac OS ツールボックスへのインターフェースを与えるモジュール群があります。対応するモジュールがあるなら、そのモジュールではツールボックスで宣言された各種の構造体の Python オブジェクトが定義され、操作は定義されたオブジェクトのメソッドとして実装されています。その他の操作はモジュールの関数として実装されています。 C で可能な操作がすべて Python で可能なわけではありませんし (コールバックはよく問題になります)、パラメータが Python だと違ってしまうことはよくあります (特に入力バッファや出力バッファ)。全てのメソッドと関数は __doc__ 文字列があるので、引数と返り値の説明を得る事ができます。他の情報源としては、 Inside Macintosh などを参照してください。

これらのモジュールは全て Carbon パッケージに含まれています。この名前にもかかわらずそれら全てが Carbon フレームワークの一部なわけではありません。CF は、CoreFoundation フレームワークの中に実際はありますし、Qt は QuickTime フレームワークにあります。ツールボックスモジュールは普通以下のようにして利用します:

from Carbon import AE

注釈

最新バージョンの OS X では、このモジュールが使っている OS X API のほとんどが非推奨になっているか、もしくは削除されています。多くは Python が 64 ビットモードで動作している場合には利用出来ません。Carbon モジュール群は Python 3 では削除済みです。Python 2 でもこれらのモジュールの利用は避けるべきです。

37.8.1. Carbon.AE --- Apple Events

37.8.2. Carbon.AH --- Apple ヘルプ

37.8.3. Carbon.App --- Appearance Manager

37.8.4. Carbon.Appearance --- Appearance Manager 定数

37.8.5. Carbon.CF --- Core Foundation

CFBase, CFArray, CFData, CFDictionary, CFStringCFURL オブジェクトがいくらか部分的にサポートされています。

37.8.6. Carbon.CG --- Core Graphics

37.8.7. Carbon.CarbonEvt --- Carbon Event Manager

37.8.8. Carbon.CarbonEvents --- Carbon Event Manager 定数

37.8.9. Carbon.Cm --- Component Manager

37.8.10. Carbon.Components --- Component Manager 定数

37.8.11. Carbon.ControlAccessor --- Control Manager アクセッサ

37.8.12. Carbon.Controls --- Control Manager 定数

37.8.13. Carbon.CoreFounation --- CoreFounation 定数

37.8.14. Carbon.CoreGraphics --- CoreGraphics 定数

37.8.15. Carbon.Ctl --- Control Manager

37.8.16. Carbon.Dialogs --- Dialog Manager 定数

37.8.17. Carbon.Dlg --- Dialog Manager

37.8.18. Carbon.Drag --- Drag and Drop Manager

37.8.19. Carbon.Dragconst --- Drag and Drop Manager 定数

37.8.20. Carbon.Events --- Event Manager 定数

37.8.21. Carbon.Evt --- Event Manager

37.8.22. Carbon.File --- File Manager

37.8.23. Carbon.Files --- File Manager 定数

37.8.24. Carbon.Fm --- Font Manager

37.8.25. Carbon.Folder --- Folder Manager

37.8.26. Carbon.Folders --- Folder Manager 定数

37.8.27. Carbon.Fonts --- Font Manager 定数

37.8.28. Carbon.Help --- Help Manager

37.8.29. Carbon.IBCarbon --- Carbon InterfaceBuilder

37.8.30. Carbon.IBCarbonRuntime --- Carbon InterfaceBuilder 定数

37.8.31. Carbon.Icn --- Carbon Icon Manager

37.8.32. Carbon.Icons --- Carbon Icon Manager 定数

37.8.33. Carbon.Launch --- Carbon Launch Services

37.8.34. Carbon.LaunchServices --- Carbon Launch Services 定数

37.8.35. Carbon.List --- List Manager

37.8.36. Carbon.Lists --- List Manager 定数

37.8.37. Carbon.MacHelp --- Help Manager 定数

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

37.8.39. Carbon.Menu --- Menu Manager

37.8.40. Carbon.Menus --- Menu Manager 定数

37.8.41. Carbon.Mlte --- MultiLingual Text Editor

37.8.42. Carbon.OSA --- Carbon OSA Interface

37.8.43. Carbon.OSAconst --- Carbon OSA Interface 定数

37.8.44. Carbon.QDOffscreen --- QuickDraw Offscreen 定数

37.8.45. Carbon.Qd --- QuickDraw

37.8.46. Carbon.Qdoffs --- QuickDraw Offscreen

37.8.47. Carbon.Qt --- QuickTime

37.8.48. Carbon.QuickDraw --- QuickDraw 定数

37.8.49. Carbon.QuickTime --- QuickTime 定数

37.8.50. Carbon.Res --- Resource Manager and Handles

37.8.51. Carbon.Resources --- Resource Manager and Handles 定数

37.8.52. Carbon.Scrap --- スクラップマネージャ

このモジュールは Mac OS 9 とそれ以前の OS 上の Classic PPC MacPython で完全に利用可能です。 Carbon 版の MacPython ではほんの限られた機能だけが利用可能です。

スクラップマネージャは Macintosh 上でのカット & ペースト操作の最もシンプルな形式をサポートします。アプリケーション間とアプリケーション内での両方のクリップボード操作が可能です。

Scrap モジュールはスクラップマネージャの関数へのローレベルでのアクセスを提供します。以下の関数が定義されています:

Carbon.Scrap.InfoScrap()

スクラップについて現在の情報を返します。この情報は (size, handle, count, state, path) を含むタプルでエンコードされます。

フィールド 意味
size スクラップのサイズをバイト数で示したもの。
handle スクラップを表現するリソースオブジェクト。
count スクラップの内容のシリアルナンバー。
state 整数。メモリー内にあるなら正、ディスク上にあるなら 0 、初期化されていないなら負。
path ディスク上に保存されているなら、そのスクラップのファイルネーム。

参考

Scrap Manager
Apple のスクラップマネージャに関する文書には、アプリケーションでスクラップマネージャを使用する上での便利な情報がたくさんあります。

37.8.53. Carbon.Snd --- Sound Manager

37.8.54. Carbon.Sound --- Sound Manager 定数

37.8.55. Carbon.TE --- TextEdit

37.8.56. Carbon.TextEdit --- TextEdit 定数

37.8.57. Carbon.Win --- Window Manager

37.8.58. Carbon.Windows --- Window Manager 定数