Windowsのコントロールパネルを開くと、複数のアイコンが並んでいる。
例えば、こんな感じだ。
Windows NT 4.0
Windows XP
バージョンや機種・インストールされているアプリケーションの種類などによって、その内容は様々に変わりうる。中には、明らかにWindowsの持ち物と思われるものもあれば、逆に、どう見てもサードパーティにより提供されていると思われるアイコンもある。
ということはつまり、このアイコンは、自分で作って組み込むことができるということを意味している。であれば、オリジナルのものを作って組み入れてみようと思うのは人間としての正常な欲求である。違うか？
ということでこのページでは、Windowsのコントロールパネルにオリジナルのアイコンを追加する方法について解説する。
簡潔に言うならコントロールパネルのアイコンは、誰だか知らないが恐らくはエクスプローラが、所定の場所に格納された「CPlAppletという関数をエクスポートするDLL」を読み込むことによって表示している。
つまり、「CPlAppletという関数をエクスポートするDLL」が、エクスプローラか何か知らない奴に対して、コントロールパネルに表示するアイコンの情報と、それがダブルクリックされたときに行うべき機能を提供していると言うことだ。
だから、そのCPlAppletという関数を自分で実装して、それをDLLにして、所定の方法でインストールしてやれば、コントロールパネルに好きな機能を持った好きなアイコンを追加することができるようになる。
CPlAppletという関数は、下記のようなプロトタイプを持っている。
LONG CPlApplet(
HWND hwndCPl,
UINT uMsg,
LONG lParam1,
LONG lParam2
);
いつかどこかで見たことがあるような関数。
この関数に対して、どこかの誰かが下記のようなメッセージを送りつけてくるから、それぞれのメッセージを適当に捌いて処理するような機能を実装してあげればいい。
DLLがロードされた直後に、このメッセージが送られてくる。
何かすることがあるなら、ここで然るべき処理を行えばいい。何もないなら、何もする必要はない。
なお、このメッセージの処理が正常に終了した場合には、CPlApplet関数の戻り値はTRUEでなければならない。0を返すと、コントロールパネルにアイコンを表示してくれなくなる。
CPL_INITの後に送られてくる。
このDLLが、コントロールパネルにいくつのアイコンを表示したいのかを戻り値として返してやる。ごく普通に、一種類のダイアログボックスを表示したいだけであれば、1を返してやればいい。
CPL_GETCOUNTの後に送られてくる。
コントロールパネルに表示するアイコンの情報を返してやる。このメッセージが送られてくる場合、CPlApplet関数の引数lParam2は、CPLINFOという構造体のアドレスになっているから、その構造体に然るべき値を設定してやる。
CPLINFOは下記のような構造体である。
typedef struct tagCPLINFO {
int idIcon;
int idName;
int idInfo;
LONG lData;
} CPLINFO;３．３．１ idIcon
コントロールパネルに表示するアイコンの、リソースのIDを設定する。
トップ10 Javaアプレット３．３．２ idName
コントロールパネル中のアイコンの下に表示する名前を定義した、リソースのIDを設定する。
３．３．３ idInfo
コントロールパネルを詳細表示にした場合に表示される、「説明」のカラムに表示する文字列を定義した、リソースのIDを設定する。
３．３．４ lData
CPL_DBLCLKとCPL_STOPのメッセージが送られてくるとき、CPlApplet関数の引数lParam2に、このlDataに指定された値が設定される。
システム側ではこの値を直接使用することはなく、アプリケーションが勝手に使っていいらしい。
CPL_INQUIREと同じようなものだが、CPL_NEWINQUIREメッセージの応答として返した情報の方が優先的に使用される。
ただMSDNには、CPL_INQUIREの方が性能的に有利だから、CPL_INQUIREの処理だけを行って、CPL_NEWINQUIREは無視しろと書いてある。
一応説明しておくと、CPL_NEWINQUIREメッセージが送られてくるとき、lParam2にはNEWCPLINFO構造体のアドレス値が設定される。だから、そのNEWCPLINFO構想対の各メンバに適切な値を設定してやればいいことになる。
NEWCPLINFO構造体は下記のような構造となっている。
typedef struct tagNEWCPLINFO {
DWORD dwSize;
DWORD dwFlags;
DWORD dwHelpContext;
LONG lData;
HICON hIcon;
TCHAR szName[32];
TCHAR szInfo[64];
TCHAR szHelpFile[128];
} NEWCPLINFO;３．４．１ dwSize
NEWCPLINFO構造体のサイズ、すなわちsizeof( NEWCPLINFO )の値を設定してやる。
３．４．２ dwFlags
使ってないらしい。無視されると書いてある。
３．４．３ dwHelpContex
これも使っていないらしい。無視されると書いてある。
３．４．４ lData
CPL_DBLCLKとCPL_STOPのメッセージが送られてくるとき、CPlApplet関数の引数lParam2に、このlDataに指定された値が設定される。
システム側ではこの値を直接使用することはなく、アプリケーションが勝手に使っていいらしい。
３．４．５ hIcon
コントロールパネルに表示するアイコンのハンドルを指定する。
CPLINFO::idIconだとリソースのIDを指定すればよかったのだが、NEWCPLINFO::hIconの場合は自分でアイコンを読み込んで、ハンドルを取得してやらなければならない。
３．４．６ szName
コントロールパネル中のアイコンの下に表示する名前を設定する。
３．４．７ szInfo
コントロールパネルを詳細表示にしたときに表示される、「説明」のカラムに表示する説明文の文字列を設定する。
３．４．８ szHelpFile
これも使っていないらしい。無視されると書いてある。
MSDNには書いてあるが、送られてくることはないらしい。
このメッセージは、コントロールパネルに表示されたアイコンがダブルクリックされたときに送られてくる。
このメッセージを受け取ったときに、普通にダイアログボックスを表示してやればいい。また、関数の制御はダイアログボックスが閉じられたときに返せばいいので、MFCであればCDialog::DoModal()を使うと、簡単に実装できる。
ドック後のインストール方法処理が終わったら、0でも返しておけばよろしい。
ダイアログボックスが閉じられるときに送られてくる。何かすることがあればすればいいし、何もすることがないなら、何もする必要はないらしい。
DLLが解放されるとき、つまりFreeLibrary関数によりDLLがアンロードされるときに、このメッセージが送られてくる。何かすることがあるなら、ここでしかるべき処理を行う。何もないなら、何もする必要はない。
Windows 2000以降から追加された。
CPL_DBLCLKと似たような奴で、ユーザがアイコンを選択したときに送られてくる。プログラムとしては、このタイミングでダイアログボックスを表示してやれば良いらしい。
なお、このメッセージが送られてくる場合は、lParam1にはサブプログラム番号が、lParam2には文字列の拡張情報が渡されるらしい。
以上の説明を基に、コントロールパネルのアイコンを実装してみることにする。
とりあえずここでは、Win NT 4.0上のVisual Studio 6.0を使っている。ずいぶん、前時代的な気がしなくもないが、基本的なところは環境が変わっても同じはず。
とりあえず横着をするために、MFCを利用するDLLを作るものとする。
cpltest.cppファイルに、下記の記述を追記する
ここままではswitch文の中身が空で、何の役にも立たないため、各メッセージを処理するロジックを実装してやる必要がある。
４．３．１ CPL_INIT
ここでは特にすることはないので、とりあえず1を返しておく。
４．３．２ CPL_GETCOUNT
表示したいアイコンの個数を返す。とりあえずここでは1を返しておく。
４．３．３ CPL_INQUIRE
このメッセージは、CPL_GETCOUNTの時に返した値の数だけ送られてくるのだが、ここでは固定的に1を返しているため、細かいことは気にしないものとする。とりあえず、CPLINFO構造体に値を設定してやればいい。
だがその前に、構造体に設定するためのリソースの定義を行ってやる。
アイコン
ストリングテーブル
そして、定義したリソースを構造体に設定してやる。
どのように私はLinux上でPHPを再起動しない
case CPL_INQUIRE: ((CPLINFO*)lParam2)->idIcon = IDI_ICON1; ((CPLINFO*)lParam2)->idName = IDS_STRING1; ((CPLINFO*)lParam2)->idInfo = IDS_STRING2; ((CPLINFO*)lParam2)->lData = 0;４．３．４ CPL_NEWINQUIRE
することはないから無視する。
４．３．５ CPL_SELECT
送られてくることもないはずだし、とりあえず無視する。
４．３．５ CPL_DBLCLK
MFCで普通にダイアログボックスを定義して、DoModalを呼び出してやればいい。
ダイアログの追加
cpltest.cppにヘッダファイルをインクルード
CPlApplet関数のswitch文に、CPL_DBLCLKメッセージを処理する記述を追記。
４．３．６ CPL_STOP
することはないから無視。
４．３．７ CPL_EXIT
することはないから無視。
作成したCPlApplet関数をエクスポートする必要があるため、defファイルに以下の記述を追記する。
うまくコンパイルが通ることを神に祈る。祈りが通じればcpltest.dllファイルが生成されるはずである。
作成したDLLをインストールして、コントロールパネルにアイコンとして表示させるには、以下の方法がある。
読んで字のごとく、system32のフォルダに格納してやる。
HKEY_CURRENT_USER¥Control Panel¥MMCPLに値を追加する。
名前は何でもいいらしい。文字列の値として、DLLのファイル名を指定する。
うまくいけば、コントロールパネルを開いたときに、新しいアイコンが表示されるはず。
Windows NT 4.0
Windows XP
もっとも、ちゃんとアイコンを書いていないから、真っ白なままだが。
でもって、このアイコンをダブルクリックすれば、下記の様な虚しいダイアログボックスが表示される。
一応、上記の説明で作ったプログラムを公開しておく。
cpltest.zip 12KB
CPL_GETCOUNTメッセージの戻り値として、2以上の値を返せば、1つのDLLで複数個のアイコンを表示させることが可能となる。
またその場合、CPL_INQUIRE・CPL_NEWINQUIRE・CPL_DBLCLK・CPL_STOPの各メッセージは、CPL_GETCOUNTで返した値の数だけメッセージが送信されてくる。
さらに、そのときlParam1には、当該のメッセージがどのアイコンに対するものなのかを表すインデックス値が指定される。すなわち、CPL_GETCOUNTで2を返した場合、CPL_INQUIRE・CPL_NEWINQUIRE・CPL_DBLCLK・CPL_STOPの各メッセージが、lParam1が0の場合と1の場合の2回ずつ送られてくることになる。
だから、上記の各メッセージを処理する際に、lParam1の値を見て、それぞれのアイコンに対する処理を行うようにしてあげれば、1つのDLLでアイコンを2つ表示することが可能となる。
プログラムにすると下記のようになる。
上記の要領で、アイコンを1つ表示させると、下記のようになる。
余り意味はないが、とりあえずアイコンを2つ表示させるプログラムも公開しておく。
cpltest2.zip 13KB
存外、普通のアプリケーションプログラムでは、コントロールパネルにアイコンを追加しなければならない要件というのは無いようだが、まぁ、好きならやってみるのも良いのではないだろうか。
もっとも、あんまり細かい芸を出し過ぎると、うざったがれることになりかねないがな。
0 件のコメント:
コメントを投稿