● 小池邦人のMac OS Xへの道　2000/08/10

〜　Carbon対応の実際　その4　〜

既存のソースコードをCarbon APIに対応させ、Mac OS X環境でも起動できるアプリを作るための工程のうち、今回は（6）のScrap Managerの書き換えの工程について解説します。

（6）Scrap Manager関連のAPIを変更

前回、CarbonLibでAPIが完全に書き換えられているManagerがふたつ存在すると話しました。そのうちのひとつがPrint Managerでしたが、もうひとつが、今回解説する「Scrap Manager」です。Scrap Managerは、編集メニューのカット（コピー）＆ペーストを実行した時に、複数アプリケーション間で、指定タイプのデータをクリップボード経由で受け渡すために用いられます。Scrap ManagerもPrint Manager同様に、ToolBoxの中で変更されることがなかった古い古いManagerです。よって、Appleがこの機会に改造を決めたのは当然かもしれません。ただ、このManagerに定義されているAPIの数はそんなに多くはありませんので、変更による一般アプリケーションへの影響は最小限だと思われます。

Scrap Managerに関するヘッダーファイルは「Scrap.h」です。このヘッダーファイルには、Scrap Managerの新APIに関する詳しい解説がコメント行として追加されています。ひょっとするとCarbon SDKに含まれている「CarbonScrapMgr.pdf」よりも、こちらの内容の方が詳しいかもしれません（笑）よって、これらの新APIを使用される前に、まずヘッダーファイルを一読されることをお薦めします。また、Carbon Scrap Managerにはデータの受け渡しに役に立つ若干の新機能も追加されています。

例えば、任意のデータタイプ（PICTとかTEXTとか）のデータハンドラを渡し、それをクリップボードに保存するルーチンは、旧APIを使うと以下のように記載できました。



これとまったく同じ機能を持ったルーチンをCaroboLibの新APIで記述すると、以下のようになります。これを見ると、新たに「ScrapRef」という識別子（構造体へのポインタ）が導入されたことが分かります。



次は、旧APIを利用したのクリップボードから指定タイプデータを抽出するルーチンです。Carbon Scrap Managerのドキュメントを読むと、Mac OS 8でCarbonアプリケーションを使う場合には、今まで通りLoadScrap()やUnloadScrap()を用いる必要があると記載されています。しかし残念ながら、この件については未確認のままです。



以下が、新APIを使った同じ機能のルーチンです。とりあえずMac OS 9.04上で動作させている分には、まったく問題ないようです。指定タイプのデータを読み込む前に、その容量（サイズ）をチェックしなければいけないところが旧APIと異なります。また、GetScrapFlavorData()に渡すデータ読み込み場所（バッファ）もハンドラではなくポインタとなっていますので注意してください。



次回は（7）以降の工程についてお話しする予定です。Mac OS Xに対応したメニュー構築の話しです。