QT TABBAR 1.1.0.1

QTTabBar プラグイン インストラクション rev 1.0 / 070904 1.0β2 / 070727 1) プラグインをつくるには i) QTPluginLib.dll を参照に追加 ii) すくなくとも IPluginClient インターフェイスを継承 iii) PluginAttribute をそのクラスに適用 するだけです。 配布はプラグインのdllだけで可能です。 開発中のテストはシェルとは別のエクスプローラ プロセスでした方がいいでしょう。 現状ではQTTabBarは一度読み込んだプラグインファイルをプロセスが終了するまで握っているからです。 2) ネーミングのガイドライン アセンブリにはAssemblyTitleAttribute をつけてください。 プラグインクラスを含む namespace は、作者ごとに一意であることを推奨します。(例えば作者名を含む等。) AssemblyTitle と AssemblyVersion、および各クラスのType.FullName ("NAMESPACE.PLUGINCLASSNAME")、dllファイルの完全パスは、 内部でプラグインを識別・管理するのに使用されます。 ひとつのアセンブリ/namespaceに複数のプラグインクラスを持つことが可能です。 3) プラグインの画像 オプション等にプラグインの画像を表示するためには、 厳密に型付けされたリソースをプロジェクトに追加し、名前を "NAMESPACE.Resource" としてください。 ( 通常、アセンブリリソースを追加すると "Resource1.resx" という名前がつきますので、"Resource.resx" とリネームするだけです。) そして大小の画像ファイルを各クラスにつき一組そのリソースに追加してください。 24x24ピクセルの大きい方は "CLASSNAME_large"、 16x16 の画像には"CLASSNAME_small" という名前をつけてください。 IBarButton インターフェイスを継承する場合は、GetImage()メソッドでそれらの画像を返すことを推奨します。 例) 添付の"Sample"は "QuizoPlugins.Resource" クラス, および "SampleSplitButton_large" と "SampleSplitButton_small" というイメージのリソースをもちます。 4) 設定の保存のガイドライン プラグインがレジストリに設定を保存する場合、レジストリキー HKEY_CURRENT_USER\Software\Quizo\QTTabBar\Plugins\Settings\ 以下に一意の名前をもつサブキーを作成することができます。 推奨するキー名は "author name + GUID" または "Type.Fullname + GUID" ですが、 Type.FullName でも重複することは(多分)ないでしょう。ないと思います。まあ…… 例) サンプルのプラグインがもしレジストリに設定を保存するとしたら、 HKEY_CURRENT_USER\Software\Quizo\QTTabBar\Plugins\Settings\Quizo\QuizoPlugins.SampleSplitButton に保存するでしょう。 "CONSTANTS.REGISTRY_PLUGINSETTINGS" を使用してください。 5) アンインストール レジストリに限らず何か設定を保存したら、プラグインのアンインストール時にそれらを削除する "Uninstall()" メソッドを追加することを推奨します。 ユーザーがオプション画面からプラグインを削除したとき、QTTabBar はメソッドをその型から探し、実行します。 Uninstall メソッドは public static void Uninstall() {...} のように、publicで, static, 戻り値・引数なしのメソッドでなくてはなりません。 設定を保存しない場合はこのメソッドを追加する必要はありません。 6) 多言語化 ユーザーは、QTTabBarのオプション -> プラグイン -> "プラグイン言語ファイル" にて XMLファイルを指定することによって、すべてのプラグインをローカライズすることができます。 文字列リソースをもつプラグインの作者は、XML要素を含むテンプレートを提供し、 IPluginServer.TryGetLocalizedStrings メソッドを通して文字列リソース取得をこころみるべきです。 例) ViewModeButton プラグインは7つの文字列リソースをもち、以下のような(奇妙な)XML要素を含む テキストファイルを添付しています。 <QuizoPlugins.ViewModeButton> FilmStrip Thumbnails Tiles Icons Lists Details View mode </QuizoPlugins.ViewModeButton> ( ViewModeButton プラグインのソース参照。 ) ユーザーがこの要素を翻訳して言語ファイル追加すると、プラグインは IPluginServer.TryGetLocalizedStrings メソッドによって 文字列リソースを取得できるようになります。 ひとつのプラグインクラスはその Type.FullName を要素名にもつ要素をひとつだけ使うことができます。 7) 配布 プラグイン作者は自由にプラグインを配布できます。ただしセキュリティ上の理由から、 ソースの公開されていないものについてはQuizoはそのWebサイト上で再配布しないでしょう。