Freigeben über

CReBarCtrl::InsertBand

  • Artikel

Implementiert das Verhalten der Win32-Meldung RB_INSERTBAND, wie in Windows SDK beschrieben.

BOOL InsertBand( 
   UINT uIndex, 
   REBARBANDINFO* prbbi  
);

Parameter

  • uIndex
    Der nullbasierte Index des Verzeichnisses, in dem das Band eingefügt wird. Wenn Sie diesen Parameter auf -1 festgelegt, das Steuerelement das neue Band am letzten Speicherort hinzu.

  • prbbi
    Ein Zeiger auf eine REBARBANDINFO-Struktur, die das einzufügende definiert Band. Sie müssen den cbSize-Member dieser Struktur zu sizeof(REBARBANDINFO) festlegen, bevor Sie diese Funktion aufrufen.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; null andernfalls.

Beispiel

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);

Anforderungen

Header: afxcmn.h

Siehe auch

Referenz

CReBarCtrl-Klasse

Hierarchiediagramm