CReBarCtrl::SetBandInfo

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

更新 : 2007 年 11 月

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

BOOL SetBandInfo(
   UINT uBand,
   REBARBANDINFO* prbbi 
);

パラメータ

uBand
新しい設定を受け取るバンドのインデックス (開始値 0)。
prbbi
挿入するバンドを定義する REBARBANDINFO 構造体へのポインタ。このメッセージを送る前に、この構造体の cbSize メンバを sizeof(REBARBANDINFO) に設定する必要があります。

戻り値

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

使用例

int nCount = m_wndReBar.GetReBarCtrl().GetBandCount();
CString strText;
REBARBANDINFO rbbi = {0};
rbbi.cbSize = sizeof(rbbi);
for (int i = 0; i < nCount; i++)
{
   strText.Format(_T("Band #: %d"), i);
   rbbi.lpText = strText.GetBuffer();
   rbbi.cch = strText.GetLength() + 1;
   rbbi.fMask = RBBIM_TEXT;

   m_wndReBar.GetReBarCtrl().SetBandInfo(i, &rbbi);

   strText.ReleaseBuffer();
}