第３０８章 シェブロンの基礎

シェブロンとは、左の図に見られるようにツールバーのボタンなどが 隠された時に出現する、不等号を２つ並べたようなものです。

そもそもシェブロンとは、軍人や警官の袖に付いている山形の袖章の ことをいうのだそうです(多分)。

実は簡単そうで、結構面倒な部分があります。

シェブロンそのものを表示するのは簡単ですが、これをクリックしたときの処理が 以外に面倒です。VC++6.0のヘルプに書いてあるとおりにしてもうまくいきません(と、いうか 不親切な書き方です)。

シェブロンの出し方は次の通りです。

０．Comctl32.dllのバージョンが5.80以降であること(IE5.0以降がインストールされていること)(*注)
１．レバーコントロールを作ってこれにRB_INSERTBANDメッセージを送るとき
　　REBARBANDINFO構造体のfStyleメンバにRBBS_USECHEVRONを加えます。
２．シェブロンがクリックされるとRBN_CHEVRONPUSHED通知メッセージが来るので
　　必要な処理をする。(隠れているボタンを調べてポップアップメニューなどを出す)

１．RB_GETRECTメッセージを選択されたバンドに送って、バンドの境界矩形を取得する
２．このバンドにのっているツールバーにTB_BUTTONCOUNTメッセージを送ってボタンの数を取得する
３．ツールバーの左端のボタンから順にTB_GETITEMRECTメッセージを送り、ボタンの境界矩形を取得する
４．ボタンとバンドの矩形の重なり合う部分の矩形を求める(IntersectRect関数を使う)
５．重なり合う矩形とボタンの矩形が同じかどうかを調べる(EqualRect関数を使う)
６．もし同じならば、このボタンは隠されていないということがわかるので、次のボタンを調べる。
　　同一でないものが現れたらそのボタンより右にあるものは隠されている
７．隠されているボタンのポップアップメニューを作る
８．ポップアップメニューをTrackPopupMenu関数で表示する。
９．メニューコマンドを処理する

上の通りにプログラムを書くと、「あれーーー、変だなーー」ということになります。 TB_GETITEMRECTメッセージで取得した矩形と、RB_GETRECTメッセージで取得した矩形は 座標系が異なるので、そのまま共通部分などを求めても意味がありません。 スクリーン座標系など同一の座標系に変換しておく必要があります。

筆者はいろいろ試行錯誤で試したところ、結局の所ツールバーの長さと、これにのっている ツールバーのボタンの数がわかれば隠されているボタンの数がわかるということに気づきました。 もしくはバンドの長さがわかっても隠されているボタンの数を知ることができます。 これが、最も簡単です。

せっかく名前が出てきたのでIntersectRect, EqualRect関数の解説を書いておきます。

BOOL IntersectRect(
  LPRECT lprcDst, 
  CONST RECT *lprcSrc1,
  CONST RECT *lprcSrc2
);

lprcDstは、計算結果を格納するRECT構造体へのポインタです。

lprcSrc1は最初の矩形、lprcSrc2は２番目の矩形のRECT構造体へのポインタです。

重なり合わないときはこの関数は０を返し、重なり合う部分が存在するときは０以外を返します。

BOOL EqualRect(
  CONST RECT *lprc1,
  CONST RECT *lprc2
);

lprc1は、最初の矩形、lprc2は２番目の矩形ののRECT構造体へのポインタです。

等しければ０以外、等しくない場合は０が返されます。

さて、バンドの長さはどのように取得すればよいでしょうか。 これは、バンドの矩形(rcband)を求めてrcband.right - rcband.leftで求まります。

バンドの矩形を知るにはRB_GETRECTメッセージをレバーコントロールに送ります。 この時WPARAMには何番目のバンドかを指定する必要があります。 バンドはユーザーが自由に位置を動かすことができるので、最初にあった位置とは 異なる可能性があります。これは、どうしたらよいのでしょうか。

これを解決するにはRBN_CHEVRONPUSHED通知メッセージが来たときに、LPARAMには NMREBARCHEVRON構造体へのポインタが入っているのでこれを調べるとわかります。

typedef struct tagNMREBARCHEVRON{
    NMHDR hdr;
    UINT uBand;
    UINT wID;
    LPARAM lParam;
    RECT rc;
    LPARAM lParamNM;
} NMREBARCHEVRON, *LPNMREBARCHEVRON;

uBandは、通知メッセージを送ってきたバンドのID(０から始まる)です。

wIDは、アプリケーション定義のバンドのIDです。

lParamは、バンドに関連したアプリケーション定義の値です。

rcは、シェブロンによってカバーされた領域です。

lParamNMは、アプリケーション定義の値です。RBN_CHEVRONPUSHEDが、RB_PUSHCHEVRON メッセージの結果として送られてきた場合、lAppValue値を含みます。その他の場合は０です。

この構造体のuBandメンバを調べるとどのバンドのシェブロンがクリックされたかがわかります。

次に、このバンドにのっているツールバーのウィンドウハンドルが必要となります。

これは、レバーコントロールにRB_GETBANDINFOメッセージを送るとわかります。

RB_GETBANDINFO
    wParam = (WPARAM)(UINT) uBand;
    lParam = (LPARAM)(LPREBARBANDINFO) lprbbi;

lprbbiは、結果を格納するREBARBANDINFO構造体へのポインタです。REBARBANDINFO構造体については 第１８２章を参照してください。

ここで注意すべき点はREBARBANDINFO構造体のfMaskにほしい情報のフラグを指定してから RB_GETBANDINFOメッセージを送信しないと、何も情報が得られません。また、cbSizeメンバにも 正しい値を指定しておく必要があります。

バンド、もしくはこれにのっているツールバーの長さと隠されているボタンの数の関係は あれこれ計算するよりも、実際に試してみるとわかりやすいです。いろいろ試してみてください。

隠されているボタンの数がわかったらあとは簡単です。次回は、実際のプログラミングを行います。