Lower Decks：dockling覚え書き

Docklingクラスとlibdockling_glue.aライブラリ 2001年7月5日

docklingのネイティブ・インターフェースはC言語形式であり、Cocoaのフレームワークを意識したものとはなっていません。 高い開発効率を誇るCocoaなのですから、dockilingについてもCocoaを利用して効率的に作成したいものです。

そこで、Brian Webster 氏の作成したlibdockling_glue.aというグルー・ライブラリを使用します。 このグルー・ライブラリは、前述のC言語形式のインターフェースをDocklingというクラスでラップしたものです。 Docklingクラスは、次のようなメソッドを持っています。

-(id)initWithBundle:(NSBundle*)bundle window:(NSWindow*)window

docklingの初期化処理を行います。

-(NSMenu*)menu

docklingのメニューを返します。

-(void)setMenu:(NSMenu*)menu

docklingにメニューを設定します。

-(BOOL)isMenuChanged

メニューの内容が更新された場合、YESを返します。

-(void)setMenuChanged:(BOOL)newState

メニューの内容を更新したことを設定します。

-(NSBundle*)bundle

docklingのバンドルを取得します。

-(NSWindow*)window

ドック内に描画する際に使用するウインドウを取得します。

docklingを作成する場合には、Docklingクラスのサブクラスを作成します。 そのサブクラスのなかで、必要に応じて上記のメソッドをオーバーライドして、docklingの振る舞いを記述します。

Interface Builderでデザインしたパネルを使う 2001年7月5日

nibファイルの作成とロード

1. Interface Builderを起動し、パネルのオーナー（コントローラ）となるオブジェクトのクラス （ここでは“PanelControler”とします）を定義します。
2. PanelControlerクラスにアウトレット（ここでは“panel”とします）を追加します。
3. Interface Builderの“Instances”タブを選択し、“File's Owner”アイコンをクリックします。 インスペクタ・パネルにて、“File's Owner”のクラスをPanelControlerに設定します。
4. Interface Builderで、パネルをデザインします。 デザインができたら、パネルのウインドウから、File's Ownerのpanelアウトレットへとコネクションを設定します。
5. 作成したデザインをnibファイル（ここでは“panel.nib”というファイル名とします）へと保存します。
6. Interface Builderで、PanelControlerクラスのソース・コードを生成します。 次に、生成したソース・コードをProject Bulderで編集し、PanelControler クラスの初期化メソッドを以下のように定義します。

-(id)initWithBundle:(NSBundle*)bundle
{
    self = [super init];
    if(self != nil) {
        NSDictionary *context = [NSDictionary dictionaryWithObject:self forKey:@"NSOwner"];
        [bundle loadNibFile:@"panel" externalNameTable:context withZone:nil];
    }
    return self;
}

普通のアプリケーションにおいてnibファイルをロードする場合には、NSBundleクラスのファクトリ・メソッドである loadNibNamed:owner:を使用します。 でも、docklingでは、上記のソース・コードのようにloadNibFile:externalNameTable:withZone: メソッドを使用し、docklingのバンドルを明示的に指定してnibファイルをロードします。 そうしないと、Mac OS X 10.0.4でdocklingを動かした時に、nibファイルのロードに失敗してしまうことがあるようです。

パネルの表示

ロードしたパネルを表示するshowPanelメソッドを、PanelControlerクラスへ追加します。

-(void)showPanel
{
    [panel center];
    [panel setLevel:NSModalPanelWindowLevel];
    [[NSApplication sharedApplication] activateIgnoringOtherApps:YES];
    [panel makeKeyAndOrderFront:nil];
}

ここで、NSApplicationのインスタンスに対してactivateIgnoringOtherApps: メッセージを送信するのがポイントです。 docklingの場合、この処理を行わないと、パネルが他のウインドウの背面に隠れて表示されてしまうことがあるようです。

メニューの更新 2001年7月5日

libdockling_glue.aライブラリを利用する場合、isMenuChangedメソッドの返り値としてYES を返すことで、ライブラリにメニューの更新が必要であることを伝えなくてはなりません。 メニュー・アイテムの個数や内容が変化した場合はもちろんですが、setState: メソッドによってメニュー・アイテムのチェック・マークの状態が変化した場合にも、isMenuChangedメソッドは YESを返さなくてはなりません。