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", "CFString" と "CFURL"
オブジェクトがいくらか部分的にサポートされています。


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 定数
=================================================
