CReBarCtrl::InsertBand

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

Windows SDK に記述されている Win32 メッセージ RB_INSERTBAND の動作を実装します。

BOOL InsertBand(
   UINT uIndex,
   REBARBANDINFO* prbbi 
);

パラメータ

uIndex
バンドの挿入位置を示すインデックス (開始値 0)。このパラメータを -1 に設定すると、新しいバンドが末尾に追加されます。
prbbi
挿入するバンドを定義する REBARBANDINFO 構造体へのポインタ。この関数を呼び出す前に、この構造体の cbSize メンバを sizeof(REBARBANDINFO) に設定する必要があります。

戻り値

正常終了した場合は 0 以外を返します。それ以外の場合は 0 を返します。

使用例

REBARBANDINFO rbbi = {0};
rbbi.cbSize = sizeof(rbbi);

TCHAR szText[80];
rbbi.lpText = szText;
rbbi.cch = sizeof(szText) / sizeof(szText[0]);

rbbi.fMask = RBBIM_BACKGROUND | RBBIM_CHILD |
    RBBIM_CHILDSIZE | RBBIM_COLORS | RBBIM_HEADERSIZE |
    RBBIM_IDEALSIZE | RBBIM_ID | RBBIM_IMAGE |
    RBBIM_LPARAM | RBBIM_SIZE | RBBIM_STYLE | RBBIM_TEXT;

m_wndReBar.GetReBarCtrl().GetBandInfo(0, &rbbi);

m_wndReBar.GetReBarCtrl().InsertBand(1, &rbbi);